Различия

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

--- dpi:dpi_components:dpiui:dpiui2:интерфейс_управления_правилами_фильтрации [2020/05/22 12:59] – [Удаление правила белого списка] kparamonov
+++ dpi:dpi_components:dpiui:dpiui2:интерфейс_управления_правилами_фильтрации [2020/05/27 15:06] (текущий) – удалено arusnak
@@ Строка 1: / Строка 1: @@
-====== Интерфейс управления правилами фильтрации ======
-===== Введение =====
-Интерфейс управления правилами фильтрации предназначен для управления правилами фильтрации на некскольких DPI одновременно с помощью графического интерфейса.
-===== Установка =====
-Для подсистемы можно использовать оборудование или виртуальные машины со сл.характеристиками:
-  - Процессор (CPU) 2.5 ГГц, 1 шт
-  - Оперативная память (RAM) 512 Мб - 1 Гб
-  - Жесткий диск (HDD) 50 Гб - 250 Гб
-  - Операционная система Cent OS 7+ (не ставьте minimal, иначе большинство зависимостей придется руками ставить)
-  - Сетевая плата (NIC) от 10 Mб/сек
-<note>Рекомендуемая операционная система Cent OS  7+ (**не ставьте minimal, иначе большинство зависимостей придется руками ставить**).
-Если вам необходимо поставить на  Cent OS 6, убедитесь что установлен supervisor 3+. Если у вас нет нужного пакета обращайтесь в тех. поддержку.
-</note>
-<note tip>Интерфейс управления правилами фильтрации является отдельным разделом [[dpi:dpi_components:dpiui:dpiui2|Интерфейса управления CKAT DPI версия 2]]. Процесс установки идентичен скрипту инсталяции [[dpi:dpi_components:dpiui:dpiui2#инсталляция|Интерфейса управления CKAT DPI версия 2]]</note>
-===== Настройка =====
-==== Настройки .env ====
-Настройка подсистемы выполняется через файл .env \\ <code>/var/www/html/dpiui2/backend/.env</code>
-Содержимое файла следующее:
- \\ <code>
-#URL редиректа для услуги "Белый список"
-ULR_WHITE_LIST_REDIRECT_URL=https://google.com
-#Период очистки данных Ulr задач в днях
-ULR_QUEUE_DELETE_TASKS_DAYS_INTERVAL=1
-#ASN для правил IP-исключений.
-ULR_IP_EXCLUDE_ASN=64401
-#Хост для выгрузки списка блокируемых ресурсов. Для подключения к серверу блокируемых ресурсов.
-ULR_BLACK_LIST_DEPLOY_HOST=vasexperts.ru
-#Порт для выгрузки списка блокируемых ресурсов. Для подключения к серверу блокируемых ресурсов.
-ULR_BLACK_LIST_DEPLOY_PORT=22
-#Имя пользователя для выгрузки списка блокируемых ресурсов. Для подключения к серверу блокируемых ресурсов.
-ULR_BLACK_LIST_DEPLOY_USER=default
-#Пароль для выгрузки списка блокируемых ресурсов. Для подключения к серверу блокируемых ресурсов
-ULR_BLACK_LIST_DEPLOY_PASS=
-#Использовать sudo при выгрузке списка блокируемых ресурсов. (0 - не использовать, 1 - использовать)
-ULR_BLACK_LIST_DEPLOY_SUDO=1
-#Путь для сохранения черных списков.
-ULR_BLACK_LIST_DEPLOY_PATH=/var/tmp
-#Уровень детализации логов.(0 - инфо, 1 - отладка, 2 - трассировка)
-ULR_LOAD_LOG_LEVEL=0
-</code>
-<note important>Если были внесены изменения в .env, необходимо выполнить команду \\ <code>php /var/www/html/dpiui2/backend/artisan queue:restart</code></note>
-<note tip>Данные настройки можно внести в конфигурацию в разделе Администратор->Конфигурация сервера DPIUI2 (GUI) в интерфейсе управления CKAT DPI версия 2</note>
-==== Установка ключа ====
-Для того, чтобы получить возможность пользоваться Интерфейсом управления правилами фильтрации необходимо активировать лицензию Ulr-раздела в DPIUI2.
-Для этого необходимо выполнить команду:
-<code>dpiui2 ulr_lic --make=1</code>
-Далее:
-  - Ввести уровень лицензии standard;
-  - Ввести дату завершения лицензии в формате Y-m-d (например 2099-12-31);
-  - Ввести пароль от лицензии.
-В случае, если Вами были введены корректные данные, выведется сообщение об успешной активации лицензии для Ulr-раздела:
-<code>
-dpiui2 ulr_lic --make=1
- Enter level:
- > standard
- Enter expire date in Y-m-d format:
- > 2099-12-31
- Enter password:
- >
-stdClass Object
-(
-    [success] => 1
-)
-</code>
-==== Установка роли ====
-В интрефейсе DPIUI2 перейдите в раздел Администратор->Роли. Создайте новую роль и устновите в ней права на чтение и запись в разделе ulr_admin как на изображении ниже.
-{{ :dpi:dpi_components:dpiui:dpiui2:role.png?600 |}}
-Далее, перейдите в раздел Администратор->Пользователи. Создайте нового пользователя и установите ему роль, которую вы создали ранее.
-{{ :dpi:dpi_components:dpiui:dpiui2:user.png?300 |}}
-При авторизации от имени этого пользователя, он будет переключен в раздел управления правилами фильтрации.
-{{ :dpi:dpi_components:dpiui:dpiui2:ulr.png?600 |}}
-==== Настройка оборудования ====
-В разработке.
-==== Настройка справочников ====
-  * [[dpi:dpi_components:dpiui:dpiui2:интерфейс_управления_правилами_фильтрации#Справочник категорий|Справочник категорий]]
-  * [[dpi:dpi_components:dpiui:dpiui2:интерфейс_управления_правилами_фильтрации#Справочник регуляторов|Справочник регуляторов]]
-<note important>Данные справочники используются при создании/редактировании правил.</note>
-=== Справочник категорий ===
-В интерфейсе управления провилами фильтрации перейдите в раздел Справочники->Категории.
-{{ :dpi:dpi_components:dpiui:dpiui2:cat.png?600 |}}
-== Создание ==
-В форме введите название категории, ее описание и нажмите кнопку "Добавить запись".
-{{ :dpi:dpi_components:dpiui:dpiui2:add_cat.png?600 |}}
-== Редактирование ==
-В таблице с категориями нажмите на кнопку редактирования категории, чтобы открылась форма редактирования. В форме измените название и/или описание категории, после чего нажмите кнопку "Сохранить запись".
-{{ :dpi:dpi_components:dpiui:dpiui2:cat_edit.png?600 |}}
-== Удаление ==
-В таблице с категориями нажмите на кнопку удаления категории. В появившемся окне подтвердите или отмените действие.
-{{ :dpi:dpi_components:dpiui:dpiui2:cat_delete.png?600 |}}
-<note warning>**Внимание**: Перед удалением категории проверьте наличие правил, которые ссылаются на эту категорию!</note>
-=== Справочник регуляторов ===
-В интерфейсе управления провилами фильтрации перейдите в раздел Справочники->Регуляторы.
-{{ :dpi:dpi_components:dpiui:dpiui2:reg.png?600 |}}
-== Создание ==
-В форме введите название регулятора, его описание и нажмите кнопку "Добавить запись".
-{{ :dpi:dpi_components:dpiui:dpiui2:add_reg.png?600 |}}
-== Редактирование ==
-В таблице со списком регуляторов нажмите на кнопку редактирования регулятора, чтобы открылась форма редактирования. В форме измените название и/или описание регулятора, после чего нажмите кнопку "Сохранить запись".
-{{ :dpi:dpi_components:dpiui:dpiui2:reg_edit.png?600 |}}
-== Удаление ==
-В таблице со списком регуляторов нажмите на кнопку удаления записи. В появившемся окне подтвердите или отмените действие.
-{{ :dpi:dpi_components:dpiui:dpiui2:reg_delete.png?600 |}}
-<note warning>**Внимание**: Перед удалением записи проверьте наличие правил, которые ссылаются на эту запись!</note>
-==== Управления профилями IGW ====
-Перейдите в раздел "Профили ISP и IGW"->"Список IGW".
-{{ :dpi:dpi_components:dpiui:dpiui2:igw.png?600 |}}
-=== Создание ===
-Для добавления нового профиля IGW перейдите в раздел "Профили ISP и IGW"->"Добавить профиль IGW".
-В форме укажите:
-  * Имя профиля;
-  * Режим работы (Snadalone/Cluster)
-  * Узлы для профиля (Имя узла, DPI оборудование из списка доступных и количество мостов)
-{{ :dpi:dpi_components:dpiui:dpiui2:add_igw.png?600 |}}
-<note tip>Перед тем как создавать профиль IGW добавьте FastDPI сервер в основном интерфейсе DPIUI 2 [[dpi:dpi_components:dpiui:dpiui2#управление_оборудованием|в разделе "Администратор"->"Оборудование"]]</note>
-=== Редактирование ===
-В разделе "Профили ISP и IGW"->"Список IGW" нажмите кнопку "Редактировать профиль".
-{{ :dpi:dpi_components:dpiui:dpiui2:igw_edit.png?600 |}}
-Откроется форма создания/редактирования профиля IGW, внесите необходимые Вам изменения и нажмите "Сохранить изменения".
-=== Удаление ===
-В разделе "Профили ISP и IGW"->"Список IGW" нажмите кнопку "Удалить" и подтвердите/отмените действие.
-{{ :dpi:dpi_components:dpiui:dpiui2:igw_delete.png?600 |}}
-<note warning>**Внимание**: Перед удалением профиля проверьте наличие ISP профилей, которые ссылаются на этот профиль!</note>
-===== Настройка веб-сервера для глобальных списков =====
-В разработке.
-===== Правила DSCP =====
-Перейдите в раздел "Приложения и полисинги"->"Правила DSCP".
-{{ :dpi:dpi_components:dpiui:dpiui2:dscp_rules.png?600 |}}
-=== Создание ===
-В форме создания правила:
-  * Введите имя протокола приложения и выберите нужный из представленного списка;
-  * Выберите приоритет из представленного списка.
-Сохраните правило путем нажатия кнопки "Установить DSCP".
-=== Редактирование ===
-В списке правил DSCP нажмите на кнопку "Редактировать правило". В открывшейся форме редактирования правила DSCP задайте необходимый приоритет и сохраните изменения нажатием кнопки "Установить DSCP".
-{{ :dpi:dpi_components:dpiui:dpiui2:dscp_edit.png?600 |}}
-=== Удаление ===
-В списке правил DSCP нажмите на кнопку "Удалить правило" и, в появившемся окне, подтвердите либо отмените действие.
-{{ :dpi:dpi_components:dpiui:dpiui2:dscp_delete.png?600 |}}
-===== Фильтр номеров АС =====
-Перейдите в раздел "Фильтр номеров АС".
-{{ :dpi:dpi_components:dpiui:dpiui2:asn.png?600 |}}
-=== Создание ===
-В форме создания правила:
-  * Укажите номер АС;
-  * Выберите приоритет из представленного списка;
-  * Укажите название правила;
-  * Укажите описание правила;
-Сохраните правило путем нажатия кнопки "Установить DSCP".
-=== Редактирование ===
-В списке правил DSCP в направлении ASN нажмите на кнопку "Редактировать правило". В открывшейся форме редактирования правила DSCP в направлении ASN при необходимости:
-  * Выберите приоритет из представленного списка;
-  * Укажите название правила;
-  * Укажите описание правила;
-{{ :dpi:dpi_components:dpiui:dpiui2:asn_edit.png?600 |}}
-Сохраните изменения путем нажатия кнопки "Установить DSCP".
-=== Удаление ===
-В списке правил DSCP в направлении ASN нажмите на кнопку "Удалить правило" и, в появившемся окне, подтвердите либо отмените действие.
-{{ :dpi:dpi_components:dpiui:dpiui2:asn_delete.png?600 |}}
-===== Исключение IP & АС =====
-Перейдите в раздел "Исключение IP & АС".
-{{ :dpi:dpi_components:dpiui:dpiui2:ip_as_exclude.png?600 |}}
-==== Исключение IP ====
-Перейдите в раздел "Исключение IP & АС"->"Исключение IP".
-{{ :dpi:dpi_components:dpiui:dpiui2:ip_exclude.png?600 |}}
-=== Создание ====
-В форме создания правила:
-  * Укажите IP/CIDR;
-  * Укажите название правила;
-  * Укажите описание правила;
-Сохраните правило путем нажатия кнопки "Установить исключение".
-=== Редактирование ===
-Нажмите на кнопку "Редактировать исключение".
-В форме редактирования правила есть возможность изменить:
-  * название правила;
-  * описание правила.
-{{ :dpi:dpi_components:dpiui:dpiui2:ip_exclude_edit.png?300 |}}
-Сохраните изменения путем нажатия кнопки "Установить DSCP".
-=== Удаление ===
-В списке исключений нажмите на кнопку "Удалить исключение" и, в появившемся окне, подтвердите либо отмените удаление.
-{{ :dpi:dpi_components:dpiui:dpiui2:ip_exclude_delete.png?600 |}}
-==== Исключение номеров АС ====
-Перейдите в раздел "Исключение IP & АС"->"Исключение номеров АС".
-{{ :dpi:dpi_components:dpiui:dpiui2:as_exclude.png?600 |}}
-== Создание ===
-В форме создания правила:
-  * Укажите номер АС;
-  * Укажите название правила;
-  * Укажите описание правила;
-Сохраните правило путем нажатия кнопки "Установить исключение".
-=== Редактирование ===
-Нажмите на кнопку "Редактировать правило".
-В форме редактирования правила есть возможность изменить:
-  * название правила;
-  * описание правила.
-{{ :dpi:dpi_components:dpiui:dpiui2:as_exclude_edit.png?300 |}}
-Сохраните изменения путем нажатия кнопки "Установить DSCP".
-=== Удаление ===
-В списке исключений нажмите на кнопку "Удалить правило" и, в появившемся окне, подтвердите либо отмените удаление.
-{{ :dpi:dpi_components:dpiui:dpiui2:as_exclude_delete.png?600 |}}
-===== Настройка ISP =====
-Перейдите в раздел "Профили ISP и IGW"->"Список ISP".
-{{ :dpi:dpi_components:dpiui:dpiui2:isp_list.png?600 |}}
-==== Создание ISP профиля ====
-Для добавления нового профиля IGW перейдите в раздел "Профили ISP и IGW"->"Добавить профиль ISP".
-В форме укажите:
-  * Имя профиля ISP;
-  * Выберите бордер из представленного списка;
-  * Логин, который будет использоваться на узле DPI;
-  * Префикс для списков на узле DPI(будет использоваться как имя профиля услуг на узле);
-  * Выберите используемые мосты выбранного бордера;
-  * Выберите Обучение сети для получения адресов данного профиля;
-  * Укажите адрес/сети данного ISP (при необходимости).
-{{ :dpi:dpi_components:dpiui:dpiui2:isp_add.png?600 |}}
-Нажмите кнопку "Сохранить изменения" или "Сохранить и Отключить/Включить".
-<note important>По умолчанию профиль ISP при создании включен. На узлы DPI выгружаются только включенные профили.</note>
-==== Редактирование ISP профиля ====
-В разделе "Профили ISP и IGW"->"Список ISP" нажмите кнопку "Редактировать профиль".
-Откроется форма создания/редактирования профиля ISP, внесите ,необходимые Вам, изменения и нажмите кнопку "Сохранить изменения" или "Сохранить и Отключить/Включить".
-==== Удаление ISP профиля ====
-В разделе "Профили ISP и IGW"->"Список ISP" нажмите кнопку "Удалить" и подтвердите/отмените действие.
-{{ :dpi:dpi_components:dpiui:dpiui2:isp_delete.png?600 |}}
-<note warning>**Внимание**: Перед удалением профиля проверьте наличие правил, которые ссылаются на этот профиль!</note>
-==== Профиль полисинга ====
-Перейдите в раздел "Приложения и полисинги"->"Профили полисинга".
-{{ :dpi:dpi_components:dpiui:dpiui2:policing.png?600 |}}
-=== Редактирование профиля полисинга ===
-Нажмите на кнопку "Редактировать полисинг".
-{{ :dpi:dpi_components:dpiui:dpiui2:policing_edit.png?600 |}}
-В открывашейся форме редактирования полисинга:
-  * Введите описание профиля;
-  * Выберите тип полисинга TBF/HTB (в зависимости от выбранного типа форма со значениями по классам будет выглядеть по-разному)
-<note>
-Вы можете воспользоваться автозаполнением конфигурации:
-  * Для HTB типа: rate=8Бит/с, ceil=значение, которое было указано в форме автозаполнения;
-  * Для TBF типа: rate=значение, которое было указано в форме автозаполнения.
-</note>
-Для того, чтобы сохранить изменения профиля, нажмите кнопку "Сохранить профиль" либо "Сохранить и отключить/включить".
-<note warning>По умолчанию профиль полисинга отключен.</note>
-=== Удаление профиля полисинга ===
-Удалить профиль можно либо путем нажатия кнопки "Удалить профиль" в списке профилей полисингов либо на странице редактирования профиля нажатием кнопки "Удалить профиль".
-===== Фильтр WEB и IP =====
-==== Список правил блокировок ====
-Перейдите в раздел "Фильтр WEB и IP".
-{{ :dpi:dpi_components:dpiui:dpiui2:blocked_resources.png?600 |}}
-==== Создание/Редактирование правила блокировки ====
-  * Для создания нового правила блокировка ресурса перейдите в раздел "Фильтр WEB и IP"->"Добавить новое правило";
-  * Для внесения изменений в существующее правило перейдите в раздел "Фильтр WEB и IP" и нажмите на кнопку "Редактировать правило".
-В открывшейся форме:
-  * Выберите регулятор;
-  * Выберисте категорию;
-  * Введите публичное описание правила;
-  * Введите скрытое описание правила;
-{{ :dpi:dpi_components:dpiui:dpiui2:create_edit_web_rule.png?600 |}}
- В форме проверки/валидации ресурса введите ресурс и выберите его тип:
-  *   В случае, если нет необходимости в проверке/валидации ресурса нажмите "Добавить в список";
-  *   Нажмите кнопку "Проверить". Будет произведен вывод информации по ресурсу, которую можно будет добавить в список блокировок по этому правилу нажатием кнопки "Добавить в список".
-{{ :dpi:dpi_components:dpiui:dpiui2:create_edit_web_rule2.png?600 |}}
-В подразделе привязки правила к профилям ISP:
-  * В случае, если опция "Применит правило к ISP из списка" отключена, данное правило считается глобальным и ресурсы из данного правила включаются в глобальные списки заблокированных ресурсов.
-  * В случае, если опция "Применит правило к ISP из списка" включена, данное правило применяется только к ISP профилям, которые отмечены в данном правиле и ресурсы из данного правила включаются в списки блокировок по этим ISP профилям.
-==== Удаление правила блокировки ====
-Перейдите в раздел «Фильтр WEB и IP» и нажмите на кнопку «Редактировать правило».
-{{ :dpi:dpi_components:dpiui:dpiui2:delete_web_rule.png?600 |}}
-<note warning>**Внимание**: Перед удалением убедитесь, что данное правило не ссылается на ISP профили.</note>
-==== Проверка домена ====
-Перейдите в раздел "Фильтр WEB и IP"->"Проверить домен".
-{{ :dpi:dpi_components:dpiui:dpiui2:check_domain.png?600 |}}
-В поле ввода "Проверка ресурса" введите URL ресурса, информацию о котором Вы хотите проверить, и нажмите кнопку "Проверить". Под формой выведется информация о введенном Вами ресурсе:
-  * SSL/TLS, тип блокировки;
-  * Информация о сертификате;
-  * Список DNS;
-  * Рекомендации о значениях, которые нужно использовать для блокировки данного ресурса.
-{{ :dpi:dpi_components:dpiui:dpiui2:check_domain_result1.png?600 |}}
-{{ :dpi:dpi_components:dpiui:dpiui2:check_domain_result2.png?600 |}}
-==== Поиск по базе (среди правил блокировки) ====
-Перейдите в раздел "Фильтр WEB и IP"->"Поиск по базе".
-В поле "IP,CIDR,Домен, Комментарий" введите значение в соответствии с подсказками вверху страницы, выберите тип поиска: Полный текст, По ресурсами или По описанию.
-Нажмите на кнопку "Поиск".
-В результате поиска отобразятся все правила блокировок, которые соответствуют выбранным параметрам поиска.
-{{ :dpi:dpi_components:dpiui:dpiui2:web_rules_search.png?600 |}}
-===== Белый список =====
-==== Список правил белого списка ====
-Перейдите в раздел "Белый список".
-{{ :dpi:dpi_components:dpiui:dpiui2:white_lists.png?600 |}}
-==== Создание/Редактирование белого списка ====
-  * Для создания нового правила белого списка перейдите в раздел "Белый список"->"Добавить новое правило";
-  * Для внесения изменений в существующее правило перейдите в раздел "Белый список" и нажмите на кнопку "Редактировать правило".
-В открывшейся форме:
-  * Выберите регулятор;
-  * Выберисте категорию;
-  * Введите публичное описание правила;
-  * Введите скрытое описание правила;
-{{ :dpi:dpi_components:dpiui:dpiui2:white_list_edit1.png?600 |}}
- В форме проверки/валидации ресурса введите ресурс и выберите его тип:
-  *   В случае, если нет необходимости в проверке/валидации ресурса нажмите "Добавить в список";
-  *   Нажмите кнопку "Проверить". Будет произведен вывод информации по ресурсу, которую можно будет добавить в список блокировок по этому правилу нажатием кнопки "Добавить в список".
-{{ :dpi:dpi_components:dpiui:dpiui2:white_list_edit2.png?600 |}}
-В подразделе привязки правила к профилям ISP:
-  * В случае, если опция "Применит правило к ISP из списка" отключена, данное правило считается глобальным и ресурсы из данного правила применяются ко всем ISP, у которых включен белый список.
-  * В случае, если опция "Применит правило к ISP из списка" включена, данное правило применяется только к ISP профилям, которые отмечены в данном правиле.
-==== Удаление правила белого списка ====
-Перейдите в раздел «Белый список» и нажмите на кнопку «Редактировать правило».
-{{ :dpi:dpi_components:dpiui:dpiui2:white_list_delete.png?600 |}}
-<note warning>**Внимание**: Перед удалением убедитесь, что данное правило не ссылается на ISP профили.</note>
-===== Поиск по базе (глобальный) =====
-Перейдите в раздел "Поиск по базе".
-В поле "IP,CIDR,Домен, Комментарий" введите значение в соответствии с подсказками вверху страницы, выберите тип поиска: Полный текст, По ресурсами или По описанию.
-Нажмите на кнопку "Поиск".
-В результате поиска отобразятся все правила (с указанием типа правила), которые соответствуют выбранным параметрам поиска.
-{{ :dpi:dpi_components:dpiui:dpiui2:db_search.png?600 |}}
-===== Мониторинг задач =====
-Перейдите в раздел "Состояние системы".
-{{ :dpi:dpi_components:dpiui:dpiui2:ulr_queue.png?600 |}}
-В данном разделе отображается очередь выполнения задач, статус и время.
-Для того, чтобы увидеть детали выполнения задачи нажмите на "Детали задачи".
-===== Логи =====
-Логи по данному разделу хранятся в файлах: <code>/var/www/html/dpiui2/backend/storage/logs/ulr*.log</code>
-<note>Уровень детализации логов задается [[dpi:dpi_components:dpiui:dpiui2:интерфейс_управления_правилами_фильтрации#настройки_env|опцией ULR_LOAD_LOG_LEVEL в .env файле конфигурации]].</note>