Пользовательские протоколы [Документация VAS Experts]

Различия

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

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

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols [2024/10/14 12:01] – [Запустить или отключить протокол] elena.krasnobryzhdpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols [2025/09/08 14:07] (текущий) elena.krasnobryzh
Строка 1: Строка 1:
 +{{indexmenu_n>2}}
 ====== Пользовательские протоколы ====== ====== Пользовательские протоколы ======
-{{indexmenu_n>1}}+Протоколы / сигнатуры доступные пользователю делятся на следующие типы: 
 +  - **Встроенные протоколы** — обновляются вместе с версией ПО СКАТ. С установкой новой версии нужно перезагружать DPI, это ведет за собой разрыв трафика.\\ При необходимости могут дополняться актуальными атрибутами из облака (VAS Cloud). Такая необходимость возникает только у сложных протоколов, но возможность доступна для всех. 
 +  - **Облачные протоколы**, которые создаются VAS Experts — обновляются периодически из VAS Cloud. Таким образом осуществляется поддержка актуальности популярных приложений в условиях изменения поведения. 
 +  - **Кастомные (пользовательские) протоколы** — протоколы, создаваемые пользователями через GUI с использованием инструментов VAS Cloud. Их приоритет выше загружаемых из VAS Cloud, а внутри них IP:PORT имеет приоритет над IP и CIDR. Возможно добавление протокола на основе IP, SNI, AS.
  
-Для перехода в раздел нажмите пункт меню Сервисы VAS cloudзатем нажмите пункт меню Пользовательские протоколы.+Пользователю доступно добавление протокола на основе IPSNI, AS. Кастомные протоколы переопределяют Встроенные и Облачные протоколы. 
  
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_ww_2.png? 1200 }} +Добавление нового протокола осуществляется в разделе **Сервисы VAS Cloud** → **Пользовательские протоколы** в 3 шага:
  
-Раздел «Пользовательские протоколы» состоит из трех подразделов:\\ +=====Шаг 1. Добавление нового протокола===== 
-  - [[dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols#оборудованиеборудование]] +{{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:protocols.png?nolink&700 |}} 
-  - [[dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols#протоколы|Протоколы]] +На панели **Протоколы** есть возможность: 
-  - [[dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols#ресурсыесурсы]]+  - Добавить элемент списка. Необходимо заполнить следующие параметры: 
 +    * Название — обязательное поле. Должно содержать только латинские буквы, цифры или их комбинацию. В начале каждого названия по умолчанию приписывается префикс “cp_” (CP расшифровывается как Custom Protocol — Пользовательский Протокол), который является обязательным; 
 +    * Пользовательский номер — обязательное уникальное поле, ограничивается диапазоном от 1 до 1024; 
 +    * Порт — заполняется автоматически; 
 +    * Описание — необязательное поле; 
 +    * Основной список — при игнорировании данного параметра тип списка по умолчанию является тестовым. Флаги “основной” и “тестовый” применяются для отладки протокола (“тестовый”) и последующего запуска его для полисинга абонентов (“основной”). Обычно тестовый протокол сначала заливается на тестовый стенд DPI, после завершения процедуры отладки - выставляется флаг “основной” и заливается на все остальные DPI.\\ {{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:add_protocol.png?nolink&550 |}} 
 +  - Запустить или отключить протокол.\\ Выполнение любых действий с отключенным протоколом (7 пункт) приводит к его активации автоматически. Данные изменения также отображаются в основном разделе «Пользовательского интерфейса» в виде кнопки включения, которая находится рядом со столбцом «Название» каждого протокола списка. 
 +  - Импортировать данные из файла.\\ Для удобства заполнения полей создания протокола предоставлен шаблон, который можно выгрузить в формате Excel, заполнить и загрузить в это же окно. Изменить данные после загрузки файла невозможно, можно лишь удалить протокол.\\ {{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:protocol_import.png?nolink&600 |}} 
 +  - Удалить элемент списка. 
 +  - Очистить список. 
 +  - Обновить список. 
 +  - Включить и отключить элементы списка. 
 +  - Изменить элемент списка. 
 +  - Экспортировать список. Доступные форматы: Excel, CSV, PDF, PNG.
  
-===== Оборудование =====+=====Шаг 2. Добавить ресурсы, определяющие протокол===== 
 +{{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:resources.png?nolink&700 |}} 
 +На панели **Список ресурсов** есть возможность: 
 +  - Добавить элемент списка.\\ Заполните следующие параметры: 
 +    * Тип — обязательное поле, заполняется путем выбора из предложенного списка (Auto, IP, SNI, ASN((можно задавать только внешние AS (например, facebook или yandex) )) ); 
 +    * Uri (Uniform Resource Identifier — единообразный идентификатор ресурса) — обязательное поле, способ заполнения которого зависит от выбранного типа ресурса (IP или SNI);\\ Пример:\\ Тип IP — 201.1.1.1.\\ Тип SNI — yandex.ru.\\ {{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:uri.png?nolink&500 |}} 
 +  - Запустить или отключить ресурс.\\ Выполнение любых действий с отключенным протоколом (7 пункт) приводит к его активации автоматически. Данные изменения также отображаются в основном разделе «Пользовательского интерфейса» в виде кнопки включения, которая находится рядом со столбцом «Название» каждого протокола списка.  
 +  - Импортировать данные из файла.\\ Для удобства заполнения полей создания протокола предоставлен шаблон, который можно выгрузить в формате Excel, заполнить и загрузить в это же окно. Изменить данные после загрузки файла невозможно, можно лишь удалить протокол.\\ {{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:resources_import.png?nolink&600 |}} 
 +  - Удалить элементы списка. 
 +  - Очистить список. 
 +  - Обновить список. 
 +  - Включить и отключить элементы списка. 
 +  - Изменить элемент списка. 
 +  - Экспортировать список. Доступные форматы: Excel, CSV, PDF, PNG.
  
-Оборудования в данном списке нельзя добавитьтак же как и удалить.+=====Шаг 3. После приготовления протокола его нужно залить на оборудование - устройства DPI из списка.===== 
 +<note important>Добавлять и удалять оборудование из данного списка **нельзя**.</note>
  
-В данном подразделе Вы можете: +{{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:dpi.png?nolink&700 |}}
-  - Обновить список +
-  - Редактировать элемент списка +
-  - Включать и отключать элементы списка +
-  - Удалить элемент списка +
-  - Экспортировать список+
  
-==== Обновить список ====+На панели **Оборудование** есть возможность: 
 +  - Обновить список
 +  - Включить и отключить элементы списка. 
 +  - Редактировать элемент списка. 
 +  - Экспортировать список. Доступные форматы: Excel, CSV, PDF, PNG.
  
-Чтобы обновить список, нажмите на кнопку "Обновить".+=====Логи===== 
 +В разделе **Сервисы VAS Cloud** → **Логи** можно посмотреть все совершенные действия с протоколами
 +Есть возможность удалить определенную запись, очистить список, обновить и экспортировать его в форматах Excel, CSV, PDF, PNG.
  
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:equipment:up.png? 400 }}+{{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:logs.png?nolink&1200 |}}
  
-==== Редактировать элемент списка ==== 
  
-Чтобы редактировать параметры оборудования, нажмите на кнопку "Изменить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:2.png? 150 }} 
- 
-==== Включить и отключить элемент списка ==== 
- 
-Чтобы актировать или отключить оборудование, нажмите на кнопку "Включить/Отключить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:1.png? 150 }} 
- 
-==== Удалить элемент списка ==== 
- 
-Чтобы удалить выбранный элемент списка, нажмите на кнопку "Удалить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:equipment:3.png? 200 }} 
- 
-==== Экспортировать список ==== 
- 
-Чтобы экспортировать список в выбранный формат (Excel, CSV, PDF, PNG), нажмите на кнопку "Экспортировать". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:e.png? 600 }} 
- 
-===== Протоколы ===== 
- 
-<note tip>Утилита для проверки вхождения в custom протокол - ''[[dpi:dpi_components:utilities:management_utilities|checkproto]]''.</note> 
- 
-В данном подразделе Вы можете: 
-  - Добавить элемент списка 
-  - Запустить или отключить протокол 
-  - Импортировать данные из файла 
-  - Удалить элемент списка 
-  - Очистить список 
-  - Обновить список 
-  - Изменить элемент списка 
-  - Экспортировать список 
- 
-==== Добавить элемент списка ==== 
-Чтобы добавить элемент списка, нажмите на кнопку "Добавление элемента списка". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_crt_3.png? 500 }} 
- 
-Заполните следующие параметры:\\ 
-**//1. название//** — является обязательным полем для заполнения, содержащее исключительно латинские буквы, цифры или их комбинацию. Вначале каждого названия по умолчанию приписывается префикс "cp_" (CP - расшифровывается как Custom Protocol = Пользовательский Протокол), который является обязательным;\\ 
-**//2. пользовательский номер//** — является обязательным полем для заполнения, а также уникальным и ограничивается диапазоном от 1 до 1024;\\ 
-**//3. порт//**— заполняется автоматически;\\ 
-**//4. описание//** — не является обязательным полем для заполнения;\\ 
-**//5. основной список//** — при игнорировании данного параметра, тип списка по умолчанию является тестовым.  
- 
-==== Запустить или отключить протокол ==== 
- 
-Чтобы актировать или отключить выбранный протокол, нажмите на кнопку "Включить/Отключить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_strt_4.png? 700 }} 
- 
-Выполнение любых действий с отключенным протоколом приводит к его активации автоматически. Данные изменения также отображаются в основном разделе «Пользовательского интерфейса» в виде кнопки включения, которая находится рядом со столбцом «Название» каждого протокола списка. 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_shtdwn_5.png? 800 }} 
- 
-<note important>Приоритет отдается более специфичным кастомным SNI сигнатурам.\\ 
-Пример: для хоста ''a.b.c.d'' при наличии сигнатур ''*.d'', ''*.c.d'' и ''*.b.c.d'' будет выбран протокол, определенный сигнатурой ''*.b.c.d'' работает только для сигнатур с ''*''.\\ 
-Подробный пример в разделе [[dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols#пример_приоритизации_кастомного_протокола_над_облачным|Пример приоритизации кастомного протокола над облачным]]</note> 
- 
-==== Импортировать данные из файла ==== 
- 
-Чтобы импортировать данные из файла, нажмите на кнопку "Импорт из файла". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_import_6.png? 600 }} 
- 
-Для удобства заполнения полей создания протокола, предоставлен шаблон, который можно выгрузить в формате excel, заполнить и загрузить обратно. Изменить данные после загрузки файла невозможно, можно лишь удалить протокол.  
- 
-<note>[GUI v.2.32.70+] Появилась возможность импортировать списки размером до 1Mб</note> 
-==== Удалить элемент списка ==== 
- 
-Чтобы удалить элемент списка, нажмите на кнопку "Удалить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_dlt_7.png? 800 }} 
- 
-==== Очистить список ==== 
- 
-Чтобы очистить список, нажмите на кнопку "Очистить список". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_clr_9.png? 800 }} 
- 
-==== Обновить список ==== 
- 
-Чтобы обновить список, нажмите на кнопку "Обновить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_up_11.png? 800 }} 
- 
-==== Экспортировать список ==== 
- 
-Чтобы экспортировать список в выбранный формат (Excel, CSV, PDF, PNG), нажмите на кнопку "Экспортировать". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:e.png? 800 }} 
- 
-==== Изменить элемент списка ==== 
- 
-Чтобы изменить параметры выбранного протокола, нажмите на кнопку "Изменить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_list_12.1.png? 800 }} 
- 
-====Пример приоритизации кастомного протокола над облачным==== 
-**1. Загрузим два протокола:** 
- 
-Облачный протокол: ''cloudflare'' 
-  * ''cloudflare.com'' 
-  * ''*.cloudflare.com'' 
- 
-Кастомный протокол: ''cp_test1234'' 
-  * ''cloudflare.com'' 
-  * ''*www.cloudflare.com'' (можно будет ввести ''www.cloudflare.com'', автоматически произойдет замена на ''*www.cloudflare.com'' и уведомление о замене и пересечении с определенным протоколом) 
- 
-**2. Результат загруженных списков в DPI:** 
- 
-''cloudflare'' содержит: 
-  * ''*.cloudflare.com'' 
- 
-''cp_test1234'' содержит: 
-  * ''cloudflare.com'' 
-  * ''*www.cloudflare.com'' 
- 
-**3. Правило ''cp_test1234 drop'' будет означать:** 
-  * На поддомены нет влияния, пример: ''my.cloudflare.com'' доступен, исключая  ''www.cloudflare.com'' 
-  * Ресурсы ''cloudflare.com'' и ''www.cloudflare.com'' заблокированы 
- 
-**4. Правило ''cp_test1234 session policing'' будет означать:** 
-  * На поддомены нет влияния, пример: ''my.cloudflare.com'' доступен, исключая  ''www.cloudflare.com'' 
-  * Влияние на ресурсы ''cloudflare.com'' и ''www.cloudflare.com'' 
- 
-**При этом в облаке** ''cloudflare.com'' исключается из облачного протокола и помещается в кастомный протокол, а **в DPI** запись ''*www.cloudflare.com'' означает приоритет кастомного протокола над записью ''*.cloudflare.com'' 
- 
-===== Ресурсы ===== 
- 
-В данном подразделе Вы можете: 
-  - Добавить элемент списка 
-  - Запустить или отключить ресурс 
-  - Импортировать данные из файла 
-  - Удалить элементы списка 
-  - Очистить список 
-  - Обновить список 
-  - Изменить элемент списка 
-  - Экспортировать список 
- 
-==== Добавить элемент списка==== 
- 
-Чтобы добавить элемент списка, нажмите на кнопку "Добавление элемента списка". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_crt_13.png? 400 }} 
- 
-Заполните следующие параметры:\\ 
-**//1. тип//** — является обязательным полем для заполнения, заполняется путем выбора из предложенного списка (ip или sni); \\ 
-**//2. uri (Uniform Resource Identifier — единообразный идентификатор ресурса)//** — является обязательным полем для заполнения, способ заполнения которого зависит от выбранного пользователем «типа» ресурса (ip или sni); 
- 
-''Пример:''\\ 
-''Тип ip - 201.1.1.1.''\\ 
-''Тип sni - yandex.ru.'' 
- 
-==== Запустить или отключить протокол ==== 
- 
-Чтобы актировать или отключить выбранный ресурс, нажмите на кнопку "Включить/Отключить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_strt_14.png? 800 }} 
- 
-Выполнение любых действий с отключенным ресурсом приводит к его активации автоматически. Данные изменения также отображаются в основном разделе пользовательского интерфейса в виде кнопки включения, расположенной перед столбцом «Название» каждого ресурса списка; 
- 
-==== Импортировать данные из файла ==== 
- 
-Чтобы импортировать данные из файла, нажмите на кнопку "Импорт из файла". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_import_16.png? 600 }} 
- 
-Для удобства заполнения полей создания ресурса, предоставлен шаблон, который можно выгрузить в формате excel, заполнить и загрузить обратно. Изменить данные после загрузки файла невозможно, можно лишь удалить ресурс.  
- 
-==== Удалить элемент списка ==== 
- 
-Чтобы удалить элемент списка, нажмите на кнопку "Удалить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_dlt_17.png? 900 }} 
- 
-==== Очистить список ==== 
- 
-Чтобы очистить список, нажмите на кнопку "Очистить список". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_clr_18.png? 900 }} 
- 
-==== Обновить список ==== 
- 
-Чтобы обновить список, нажмите на кнопку "Обновить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_up_19.png? 900 }} 
- 
-==== Изменить элемент списка ==== 
- 
-Чтобы изменить параметры выбранного ресурса, нажмите на кнопку "Изменить". 
- 
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_list_20.1.png? 600 }} 
- 
-==== Экспортировать список ==== 
- 
-Чтобы экспортировать список в выбранный формат (Excel, CSV, PDF, PNG), нажмите на кнопку "Экспортировать".