Быстрый старт: Тарифный план и Captive Portal (доступ к СЗР) [Документация VAS Experts]

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
dpi:dpi_options:use_cases:qs_rateplans:start [2024/07/04 08:15] – [Введение] atereschenkodpi:dpi_options:use_cases:qs_rateplans:start [Дата неизвестна] (текущий) – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1
Строка 1: Строка 1:
-====== Быстрый старт: Тарифный план и Captive Portal (доступ к СЗР) ====== 
-{{indexmenu_n>3}} 
-====== Введение ====== 
-Для реализации [[dpi:bras_bng:general_setup:start|BRAS]] в данном разделе приведен пример создания двух тарифных планов (policing): 
-  * **rate_10M** - базовый тарифный план, который используется после авторизации абонента.  
-  * **blocked** - тарифный план, который используется для блокировки абонента и предоставления доступа только по определенным протоколам. 
- 
-Доступ к Белому списку ресурсов и переадресация HTTP-запросов пользователя на Captive Portal подключается через [[dpi:dpi_options:opt_capture:capt_description:start|5 или 16 услугу]], в примере рассмотрен пример для 5 услуги.  
-Варианты использования 5 услуги **my_white_list**: 
-  * 5 услуга подключается совместно с тарифным планом **blocked**, т.к. по умолчанию 5 услуга обрабатывает только TCP-соединения и для ограничений UDP соединений используется тарифный план с ограничением по классам трафика. 
-  * 5 услуга подключается без тарифного плана и в конфигурации необходимо добавить [[dpi:dpi_components:platform:subscriber_management:subsman_cmd:start#настройка_блокировки_протоколов_tcp_и_udp|параметр udp_block=3]]. 
-<note important>[[dpi:bras_bng:radius_integration:radius_auth_server_integration:radius_auth_response:start|Имена данных профилей полисинга и услуг необходимо передавать в соответствующих атрибутах сообщений Radius Access-Accept или Access-Reject.]] <code bash> 
-VasExperts-Policing-Profile = "blocked" 
-VasExperts-Service-Profile = "5:my_white_list" 
-</code> 
-</note> 
- 
- 
-===== Распределение трафика по классам для тарифного плана ===== 
-Для разметки приоритетов используем опцию [[dpi:dpi_options:opt_priority:priority_config:start|Назначение приоритетов в зависимости от протокола]].\\ 
- 
-1. Создаем файл **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>  
- 
-2. Конвертируем его в формат dscp, который понимает fastDPI 
-<code> 
-cat protocols.txt|lst2dscp /etc/dpi/protocols.dscp 
-</code> 
- 
-3. Применяем настройки 
-<code> 
-service fastdpi reload 
-</code> 
-===== Создание тарифного плана ===== 
-Для организации абонентской полосы согласно тарифному плану используем опцию [[dpi:dpi_options:opt_bandwidth_mgmt:start|Распределение канала доступа между абонентами]].\\ 
-\\ 
-1. Для каждого тарифного плана абонента в биллинге создаем файл конфигурации, с описанием его настроек для 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 - указывать нельзя зарезервировано) 
- 
-2. Создаем тарифный план с именем **rate_10M** 
-<code> 
-fdpi_ctrl load profile --policing /path/to/rate_10M.cfg --profile.name rate_10M 
-</code> 
- 
-3. Чтобы наши настройки для абонентов, которые мы сделаем в дальнейшем, не пропали при перезагрузке DPI подключаем [[dpi:dpi_components:platform:dpi_admin:admin_db:start#Активация встроенной БД|БД UDR]] 
-<code> 
-udr=1 
-</code> 
-4. Применяем настройки через перезапуск fastDPI 
-<code> 
-service fastdpi restart 
-</code> 
- 
-===== Подготовка Captive Portal с доступом к платежным системам и Социально-значимым ресурсам (СЗР) ===== 
-<note important>Услуга 5 (Белые списки и Captive Portal) регулирует доступ только TCP-based протоколам. 
-Для того, чтобы ограничить доступ к остальным ресурсам с использованием различных протоколов, необходимо использовать соответствующий профиль тарифного плана, который пропускает трафик только определенных классов.</note> 
- 
-1.Создаем описание тарифного плана для абонентов в блокировке 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> 
- 
-2. Создаем тарифный план с именем **blocked** для заблокированного абонента 
-<code> 
-fdpi_ctrl load profile --policing /path/to/blocked.cfg --profile.name blocked 
-</code> 
- 
-3. Создаем список сайтов, доступных в режиме 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]]\\ 
- 
-2. [[https://api.lightbilling.cloud/static/library/skat/white.txt|Список банков подготовленный нашими партнерами]]\\ 
- 
-3. [[https://cloud.vasexperts.ru/api/vase/free_internet|Список социально-значимых ресурсов на VAS Cloud]] 
-** 
-</note> 
- 
- 
-4. Конвертирование во внутренний формат:  
-<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> 
- 
-5. Создаем **именованный профиль** для белого списка 
-<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. Проводим интеграцию с биллингом 
- 
-Вариант интеграции зависит от того, обладает ли биллинг возможностью управления оборудованием по событиям или нет.  
- 
-**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> 
- 
-2. Помещаем абонента в 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> 
- 
-3. После оплаты отключаем абоненту Captive Portal и восстанавливаем его тарифный план 
- 
-<code> 
-fdpi_ctrl load --policing ${rateplan}.cfg --ip ${ip_address} 
-fdpi_ctrl del --service 5 --ip ${ip_address} 
-</code>