Различия

Показаны различия между двумя версиями страницы.

--- dpi:dpi_options:use_cases:qs_rateplans:start [2023/10/13 12:40] – ↷ Операцией перемещения обновлены ссылки elena.krasnobryzh
+++ dpi:dpi_options:use_cases:qs_rateplans:start [Дата неизвестна] (текущий) – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1
@@ Строка 1: / Строка 1: @@
-====== Быстрый старт: Тарифный план и Captive Portal (доступ к СЗР) ======
-{{indexmenu_n>3}}
-====== Введение ======
-Для реализации [[playground:opt_bras_l3:bras_steps:start|BRAS]] в данном разделе приведен пример создания двух тарифных планов (policing) и услуги Captive Portal:
-  * **rate_10M** - базовый тарифный план, который используется после авторизации абонента.
-  * **blocked** - тарифный план, который используется для блокировки абонента и предоставления доступа только по определенным протоколам. Его имя необходимо передавать в Radius Access-Reject.
-  * При блокировке совместно с тарифным планом **blocked** абоненту назначается (Услуга 5) **my_white_list** - Белый список  ресурсов, на которые у него есть доступ для оплаты услуги. Также осуществляется редирект для HTTP ресурсов на Captive Portal.
-<note important>[[dpi:bras_bng:radius_integration:radius_auth_server_integration:radius_auth_response:start|Имена данных профилей необходимо передавать в соотвествующих атрибутах сообщений Radius Access-Accept, Access-Reject.]]</note>
-===== Распределение трафика по классам для тарифного плана =====
-Для разметки приоритетов используем опцию [[dpi:dpi_options:opt_priority:priority_config:start|Назначение приоритетов в зависимости от протокола]].\\
-. Создаем файл **protocols.txt** c описанием групп протоколов, которые мы хотим выделить из общего трафика, и назначенных им приоритетов (классов):
-<code>
-dns cs0
-ICMP cs0
-http cs0
-https cs0
-QUIC cs1
-default cs2
-bittorrent cs7
-</code>
-где
-  * cs0 соответствует приоритету 0, class0 соответственно
-  * cs1 - приоритету 1, class1
-  * cs7 - приоритету 7, низший класс
-<note important>Выделенные таким образом классы можно использовать в описании тарифных планов, вводя для них отдельные ограничения,
-кроме того в соотвтетвии с ними будет производится приоритезация протоколов в полосе.</note>
-. Конвертируем его в формат dscp, который понимает fastDPI
-<code>
-cat protocols.txt|lst2dscp /etc/dpi/protocols.dscp
-</code>
-. Применяем настройки
-<code>
-service fastdpi reload
-</code>
-===== Создание тарифного плана =====
-Для организации абонентской полосы согласно тарифному плану используем опцию [[dpi:dpi_options:opt_bandwidth_mgmt:start|Распределение канала доступа между абонентами]].\\
-\\
-. Для каждого тарифного плана абонента в биллинге создаем файл конфигурации, с описанием его настроек для DPI.
-<note important>Удобное соглашение: имена файлов конфигурации, с описанием настройки тарифного плана на DPI, сделать совпадающим с именем тарифного плана в биллинге.</note>
-Пример описания для тарифа 10mbit, название в биллинге "rate_10M"
-Создаем файл rate_10M.cfg
-<code>
-htb_inbound_root=rate 10mbit
-htb_inbound_class0=rate 4mbit ceil 10mbit
-htb_inbound_class1=rate 3mbit ceil 10mbit
-htb_inbound_class2=rate 8bit ceil 10mbit
-htb_inbound_class3=rate 8bit ceil 10mbit
-htb_inbound_class4=rate 8bit ceil 10mbit
-htb_inbound_class5=rate 8bit ceil 10mbit
-htb_inbound_class6=rate 8bit ceil 10mbit
-htb_inbound_class7=rate 8bit ceil 10mbit
-htb_root=rate 10mbit
-htb_class0=rate 4mbit ceil 10mbit
-htb_class1=rate 3mbit ceil 10mbit
-htb_class2=rate 8bit ceil 10mbit
-htb_class3=rate 8bit ceil 10mbit
-htb_class4=rate 8bit ceil 10mbit
-htb_class5=rate 8bit ceil 10mbit
-htb_class6=rate 8bit ceil 10mbit
-htb_class7=rate 8bit ceil 10mbit
-</code>
-Примечания:
-   * htb_class0-1 - имеют гарантированную скорость в 4Мбит/с и 3Мбит/с соответсвенно
-   * htb_class7 - минимальную полосу 8bit, что означает, что может зажиматься в 0 Мбит/с (0 - указывать нельзя зарезервировано)
-. Создаем тарифный план с именем **rate_10M**
-<code>
-fdpi_ctrl load profile --policing /path/to/rate_10M.cfg --profile.name rate_10M
-</code>
-. Чтобы наши настройки для абонентов, которые мы сделаем в дальнейшем, не пропали при перезагрузке DPI подключаем [[dpi:dpi_components:platform:dpi_admin:admin_db:start#Активация встроенной БД|БД UDR]]
-<code>
-udr=1
-</code>
-. Применяем настройки через перезапуск fastDPI
-<code>
-service fastdpi restart
-</code>
-===== Подготовка Captive Portal с доступом к платежным системам и Социально-значимым ресурсам (СЗР) =====
-<note important>Услуга 5 (Белые списки и Captive Portal) регулирует доступ только TCP-based протоколам.
-Для того, чтобы ограничить доступ к остальным ресурсам с использованием различных протоколов, необходимо использовать соответствующий профиль тарифного плана, который пропускает трафик только определенных классов.</note>
-.Создаем описание тарифного плана для абонентов в блокировке blocked.cfg.
-Разрешаем только трафик [[dpi:dpi_options:use_cases:qs_rateplans:start#распределение_трафика_по_классам_для_тарифного_плана|cs0, с протоколами согласно списка в п.1.]]
-<code>
-htb_inbound_root=rate 10mbit
-htb_inbound_class0=rate 1mbit ceil 10mbit
-htb_inbound_class1=rate 8bit ceil 8bit
-htb_inbound_class2=rate 8bit ceil 8bit
-htb_inbound_class3=rate 8bit ceil 8bit
-htb_inbound_class4=rate 8bit ceil 8bit
-htb_inbound_class5=rate 8bit ceil 8bit
-htb_inbound_class6=rate 8bit ceil 8bit
-htb_inbound_class7=rate 8bit ceil 8bit
-htb_root=rate 10mbit
-htb_class0=rate 1mbit ceil 10mbit
-htb_class1=rate 8bit ceil 8bit
-htb_class2=rate 8bit ceil 8bit
-htb_class3=rate 8bit ceil 8bit
-htb_class4=rate 8bit ceil 8bit
-htb_class5=rate 8bit ceil 8bit
-htb_class6=rate 8bit ceil 8bit
-htb_class7=rate 8bit ceil 8bit
-</code>
-. Создаем тарифный план с именем **blocked** для заблокированного абонента
-<code>
-fdpi_ctrl load profile --policing /path/to/blocked.cfg --profile.name blocked
-</code>
-. Создаем список сайтов, доступных в режиме Captive Portal. Подробнее в описании опции [[dpi:dpi_options:opt_capture:capt_make:start|Белый список]].
-Создаем файл **my_white_url_list.txt** с url сайтов платежных систем.
-Каждая строка файла содержит один url (без префикса <nowiki>http://</nowiki>), рекомендуется включать также и субдомены, например:
-<code>
-online.sberbank.ru
-*.online.sberbank.ru
-</code>
-Для добавления **Социально-значимых ресурсов** необходимо [[https://cloud.vasexperts.ru/api/vase/free_internet|скачать архив с VAS Cloud]] распаковать и добавить содержимое файлов из архива к вашим спискам **до** конвертации.
-Содержание архива:
-<code>
-url_list.txt - URL для HTTP запросов
-cn_list.txt - Common Name для HTTPS запросов
-sni_list.txt - Server Name Indication для HTTPS запросов
-ip_list.txt - IP адреса
-</code>
-<note tip>
-Для формирования белого списка рекомендуем использовать готовый список.
-**1. [[https://github.com/cloudipsp/all_banks_ips|Перечень платежных систем на github]]\\
-. [[https://api.lightbilling.cloud/static/library/skat/white.txt|Список банков подготовленный нашими партнерами]]\\
-. [[https://cloud.vasexperts.ru/api/vase/free_internet|Список социально-значимых ресурсов на VAS Cloud]]
-**
-</note>
-. Конвертирование во внутренний формат:
-<code>
-cat my_white_url_list.txt|url2dic my_url_list.bin
-cat my_white_cn_list.txt|url2dic my_cn_list.bin
-cat my_white_sni_list.txt|url2dic my_sni_list.bin
-cat my_white_ip_list.txt|ip2bin my_ip_list.bin
-</code>
-Любой из списков может отсутствовать. Подробнее в описании опции [[dpi:dpi_options:opt_capture:capt_make:start|Белый список]].
-<note tip> Чтобы исключить блокировку для HTTPS сайтов
-нужно подготовить белый список для CN и SNI **с символом ***,
-сигнализирующего что CN и SNI может быть любой.</note>
-. Создаем **именованный профиль** для белого списка
-<code>
-fdpi_ctrl load profile --service 5  --profile.name my_white_list --profile.json '{ "url_list" : "/path/to/my_url_list.bin" , "sni_list" : "/path/to/my_sni_list.bin", "cn_list" : "/path/to/my_cn_list.bin", "ip_list" : "/path/to/my_ip_list.bin", "redirect" : "mysite.ru/block" }'
-</code>
-где
-  * redirect - страница переадресации((Внимание если указываете https сайт, то обязательно требуется данный домен внести в список SNI иначе домен будет заблокирован))((доп. праметры можно дописать (по правилам http) только после ? или &, их надо обязательно указывать в url  для белого списка и тут надо подумать за dpi,иначе dpi припишет /? ))\\
-  * url_list: белый список URL
-  * sni_list: белый список SNI
-  * cn_list: белый список Common Name((проверка по ip:port или cname осуществляется если в запросе отсутствуют url или sni))
-  * ip_list: белый список IP адресов **включающий СЗР**
-===== Интеграция с биллингом без Radius =====
-<note important>Если у в сети все же используется Radius, но вы не предполагаете настраивать взаимодействие СКАТ с биллингом через него и имеете динамические IP адреса, необхоходимо использовать [[dpi:dpi_components:radius:start|Radius-монитор]], который добавит связку IP-Login в UDR.</note>
-. Проводим интеграцию с биллингом
-Вариант интеграции зависит от того, обладает ли биллинг возможностью управления оборудованием по событиям или нет.
-**1а. Биллинг умеет управлять оборудованием по событиям: создание абонента, смена тарифного плана, блокировка**
-В этом случае выбираем тип оборудования с управлением по SSH/RSH((При необходимости можно доустановить на dpi дополнительное ПО, совместимое с OS Linux, для расширения возможностей удаленного управления, например, telnet сервер.)) или с помощью выполнения локальных скриптов и заносим в настройки соответствующих команд (или скриптов) команды подключения (смены) тарифного плана:
-<code>
-fdpi_ctrl load --policing ${rateplan}.cfg --ip ${ip_address}
-или
-fdpi_ctrl load --policing ${rateplan}.cfg --login ${login}
-</code>
-где
-  * ${rateplan}   - переменная куда биллинг полдставит имя тарифного плана абонента rate_10M
-  * ${ip_address} - сюда биллинг подставит ip адрес 192.168.0.1 абонента (для абонентов с фиксированным ip)
-  * ${login}      - сюда биллинг подставит login абонента dom1kv2 (для абонентов с динамическим ip, несколькими ip, или просто мы хотим управлять по login)
-**1б. Биллинг не умеет управлять оборудованием по событиям**
-Настроим выгрузку данных из биллинга по расписанию в crontab. В файлы с именами имя_тарифного_плана.lst выгружаем из биллинга список абонентов с соответвующими тарифными планамм (список может содежать ip или login) и запускаем загрузку этих данных в dpi
-<code>
-fdpi_ctrl load --policing rate_10M.cfg --file rate_10M.lst
-fdpi_ctrl load --policing rate_20M.cfg --file rate_20M.lst
-...
-или (для всех сразу)
-for rateplan in *.cfg; do fdpi_ctrl load --policing "$rateplan" --file "${rateplan%%.*}".lst; done
-</code>
-. Помещаем абонента в Captive Portal((Если событийное управление не поддерживается, то делаем через выгрузку блокированных и разблокированных абонентов в файл blocked.lst и unblocked.lst))
-<code>
-fdpi_ctrl load --policing blocked.cfg --ip ${ip_address}
-fdpi_ctrl load --service 5 --ip ${ip_address}
-</code>
-. После оплаты отключаем абоненту Captive Portal и восстанавливаем его тарифный план
-<code>
-fdpi_ctrl load --policing ${rateplan}.cfg --ip ${ip_address}
-fdpi_ctrl del --service 5 --ip ${ip_address}
-</code>

Аккаунт

Настройки

Различия