Различия

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

--- dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols [2025/01/16 07:06] – elena.krasnobryzh
+++ dpi: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.
-<note tip>Приоритет пользовательских протоколов выше, чем облачных (загружаемых из VAS Cloud).\\ Также в пользовательских протоколах приоритет IP:PORT выше, чем  IP и CIDR.</note>
+Пользователю доступно добавление протокола на основе IP, SNI, AS. Кастомные протоколы переопределяют Встроенные и Облачные протоколы.
-Для перехода в раздел нажмите пункт меню Сервисы VAS cloud, затем нажмите пункт меню Пользовательские протоколы.
+Добавление нового протокола осуществляется в разделе **Сервисы VAS Cloud** → **Пользовательские протоколы** в 3 шага:
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:prtcl_ww_2.png? 1200 }}
+=====Шаг 1. Добавление нового протокола=====
+{{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:protocols.png?nolink&700 |}}
+На панели **Протоколы** есть возможность:
+  - Добавить элемент списка. Необходимо заполнить следующие параметры:
+    * Название — обязательное поле. Должно содержать только латинские буквы, цифры или их комбинацию. В начале каждого названия по умолчанию приписывается префикс “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:custom_protocols#оборудование|Оборудование]]
+{{ :dpi:dpi_components:dpiui:user_guide:vas_cloud_services:resources.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#ресурсы|Ресурсы]]
+  - Добавить элемент списка.\\ Заполните следующие параметры:
+    * Тип — обязательное поле, заполняется путем выбора из предложенного списка (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:logs.png?nolink&1200 |}}
-{{ dpi:dpi_components:dpiui:user_guide:vas_cloud_services:custom_protocols:equipment:up.png? 400 }}
-==== Редактировать элемент списка ====
-Чтобы редактировать параметры оборудования, нажмите на кнопку "Изменить".
-{{ 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), нажмите на кнопку "Экспортировать".

Аккаунт

Настройки

Различия

Различия

Что вы хотели найти?