Ideco NGFW
Скачать PDF
v19
v19
  • Об Ideco NGFW
  • Общая информация
    • Лицензирование
    • Системные требования и источники данных Ideco NGFW
      • Выбор аппаратной платформы
    • Техническая поддержка
      • Информация о поддержке версий Ideco NGFW
  • Быстрый старт Ideco NGFW
    • Рекомендации при первоначальной настройке
    • Подготовка платформы к установке
      • Настройка гипервизора
      • Настройка программно-аппаратных комплексов Ideco NGFW
      • Создание загрузочного USB-накопителя
    • Установка
    • Первоначальная настройка
    • Регистрация сервера
    • Получение доступа в интернет
  • Настройка Ideco NGFW
    • Панель мониторинга
    • Пользователи
      • Учетные записи
        • Управление учетными записями и группами
        • Настройка пользователей
      • Авторизация пользователей
        • Веб-аутентификация
        • IP и MAC авторизация
          • Авторизация по IP-адресу
          • Авторизация по MAC-адресу
        • Авторизация по подсетям
        • Авторизация пользователей терминальных серверов
      • Двухфакторная аутентификация
      • VPN-подключение
        • Подключение по PPTP
        • Подключение по IKEv2/IPsec
        • Подключение по SSTP
        • Подключение по L2TP/IPsec
        • Особенности маршрутизации и организации доступа
        • Инструкция по запуску PowerShell скриптов
      • Ideco Client
        • Установка и настройка Ideco Client на Windows
        • Установка и настройка Ideco Client на MacOS
        • Установка и настройка Ideco Client на Linux
        • Настройка Device VPN
        • Создание сертификатов для Device VPN
        • Балансировка VPN-подключений
        • Кастомная настройка Ideco Client
      • Профили устройств
      • Active Directory/Samba DC
        • Импорт пользователей
        • Аутентификация пользователей AD/Samba DC
          • Настройка сервера Active Directory
          • Настройка клиентских машин
          • Скрипты автоматической разавторизации
      • RADIUS
      • ALD Pro
      • Обнаружение устройств
      • Wi-Fi-сети
    • Мониторинг
      • Сессии администраторов
      • Сессии пользователей
      • Сессии ЛК
      • Графики загруженности
      • Монитор трафика
      • Telegram-бот
      • SNMP
      • Zabbix-агент
      • Netflow
    • Правила трафика
      • Файрвол
        • Таблицы файрвола (FORWARD, DNAT, INPUT и SNAT)
        • Примеры создания правил файрвола
        • Логирование
        • Тестирование правил
        • Предварительная фильтрация
        • Аппаратная фильтрация
      • Контент-фильтр
        • Правила
        • Описание категорий контент-фильтра
        • Морфологические словари
        • Настройки
        • Настройка фильтрации HTTPS
      • Ограничение скорости
      • Антивирус
      • Предотвращение вторжений
        • Группы сигнатур
        • Пользовательские сигнатуры
        • Настройки
      • Исключения
      • Объекты
    • Профили безопасности
      • Web Application Firewall
      • Контроль приложений
        • Особенности создания профилей
        • Пример создания иерархической структуры
        • Настройка фильтрации трафика, для которого в таблице FORWARD нет правил
      • Предотвращение вторжений
    • Сервисы
      • Сетевые интерфейсы
        • Внешние и локальные интерфейсы
        • Агрегированные интерфейсы (LACP)
        • Туннельные интерфейсы (GRE)
        • VCE-интерфейсы
        • SPAN-интерфейсы
      • Балансировка и резервирование
      • Маршрутизация
      • BGP
      • OSPF
      • IGMP Proxy
      • Прокси
        • Исключения
        • Настройка прямого подключения к прокси
        • Настройка прокси с одним интерфейсом
      • Обратный прокси
      • ЛК/Портал SSL VPN
      • Защита и управление DNS
        • Внешние DNS-серверы
        • Master-зоны
        • Forward-зоны
        • DDNS
      • DHCP-сервер
      • NTP-сервер
      • IPsec
        • Подключение между двумя Ideco NGFW в туннельном режиме работы
        • Подключение между двумя Ideco NGFW в транспортном режиме работы
        • Подключение Ideco NGFW и Mikrotik по IPsec в туннельном режиме
        • Подключение Ideco NGFW и Mikrotik по IPsec в транспортном режиме
        • Подключение MikroTik и Ideco NGFW по L2TP/IPsec
        • Подключение Cisco IOS и Ideco NGFW по IPsec в туннельном режиме
        • Подключение Cisco IOS и Ideco NGFW по IPsec в транспортном режиме
        • Подключение Cisco IOS и Ideco NGFW по route-based IPsec
        • Подключение pfSense к Ideco NGFW по IPsec
        • Подключение Kerio Control и Ideco NGFW по IPsec
        • Подключение Keenetic по SSTP или IPsec
      • ГОСТ VPN
      • Сертификаты
        • Загрузка SSL-сертификата на сервер
        • Создание самоподписанного сертификата c помощью PowerShell
        • Создание сертификата c помощью openssl
      • USB-токены
    • Отчеты и журналы
      • Трафик
      • Системный журнал
      • Журнал веб-трафика
      • Журнал трафика
      • События безопасности
      • Действия администраторов
      • Журнал аутентификации
      • Журнал авторизации ЛК
      • Конструктор отчетов
      • Syslog
    • Управление сервером
      • Администраторы
      • Ideco Center
      • VCE
      • Кластеризация
        • Настройка кластера
        • Обновление кластера
      • Обновления
      • Бэкапы
      • Терминал
        • Примеры использования утилит
      • Лицензия
      • Дополнительно
    • Почтовый релей
      • Основные настройки
        • Web-почта
        • Настройка почтового релея
        • Настройка почтового сервера
      • Расширенные настройки
        • Настройка домена у регистратора/держателя зоны
      • Антиспам и антивирус
      • Правила
        • Переадресация почты
      • Почтовая очередь
      • Настройка почтовых клиентов
      • Схема фильтрации почтового трафика
    • Публикация ресурсов
      • Доступ из внешней сети без NAT
      • Публикация веб-приложений (обратный прокси-сервер)
      • Настройка публичного IP-адреса на компьютере в локальной сети
      • Портмаппинг (проброс портов, DNAT)
    • Интеграция NGFW и SkyDNS
    • Полный цикл обработки трафика в Ideco NGFW
  • Настройка MY.IDECO
    • О личном кабинете MY.IDECO
    • NGFW
    • Центральная консоль
    • Monitoring Bot и Security
    • Личные данные и Компании
  • Настройка Ideco Center
    • Об Ideco Center
    • Установка Ideco Center
    • Серверы
    • Мониторинг
    • Политики и объекты
    • Профили безопасности
    • Сервисы
    • Отчеты и журналы
    • Управление сервером
  • Популярные инструкции и диагностика проблем
    • FAQ
      • Инструкции по созданию VPN-подключений
        • Создание VPN-подключения в Alt Linux
        • Создание VPN-подключения в Ubuntu
        • Создание VPN-подключения в Fedora
        • Создание подключения в Astra Linux
        • Создание подключения в Windows
        • Создание VPN-подключения на мобильных устройствах
        • Создание подключения в Mac OS
        • Подключение по SSTP Wi-Fi роутеров Keenetic
      • Подлючение к серверу по COM-порту и настройка Ideco NGFW
      • Анализ трафика
      • Режим удаленного помощника
      • Настройка LACP на Hyper-V
      • Разрешить интернет всем: диагностика неполадок
      • Как разрешить доступ к ресурсам в ограниченной сети
      • Удаленный доступ к серверу
      • Тестирование оперативной памяти сервера
      • Как избавиться от асимметричной маршрутизации трафика
      • Что делать если ваш IP попал в черные списки DNSBL
      • Как восстановить доступ к Ideco NGFW
      • Как восстановиться на прошлую версию после обновления Ideco NGFW
      • Проверка настроек фильтрации с помощью security ideco
      • Поддержка устаревших алгоритмов шифрования
      • Настройка программы Proxifier для прямых подключений к прокси серверу
      • Блокировка популярных ресурсов
      • Настройка прозрачной авторизации на Astra Linux
      • Настройка автоматической веб-аутентификации на Ideco NGFW на Linux
      • Перенос данных и настроек на другой сервер
      • Порядок обработки веб-трафика в Ideco NGFW
      • Интеграция Ideco NGFW и брокера сетевых пакетов DS Integrity NG
      • Настройка совместной работы ViPNet Координатор с Ideco NGFW
      • Блокировка чат-ботов
      • Таблица портов Ideco NGFW, доступных из локальной и внешних сетей
      • Как Ideco Client осуществляет обработку запросов с редиректом на сервер Ideco NGFW
      • Как включить таймер при загрузке Ideco NGFW
    • Диагностика проблем
      • Ошибка при открытии сайта ERR_CONNECTION_TIMED_OUT или Не открывается сайт
      • Что делать если не работает интернет
      • Ошибка при авторизации "The browser is outdated"
      • Если соединение по IPsec не устанавливается
      • Ошибка 400 Bad Request Request Header Or Cookie Too Large при авторизации в браузерах
  • API
    • Описание основных хендлеров
    • Управление интеграцией с Active Directory
    • Управление интеграцией с ALD Pro
    • Управление администраторами
    • Управление пользователями
    • Управление Ideco Client
    • Мониторинг и журналы
    • Управление правилами трафика
      • Файрвол
      • Контроль приложений
      • Контент-фильтр
      • Предотвращение вторжений
      • Исключения
    • Управление профилями безопасности
    • Управление сетевыми интерфейсами
    • Управление VPN
    • Управление обратным прокси
    • DHCP-сервер
    • DNS-сервер
    • Настройка удаленной передачи системных логов
    • Управление Ideco Center
    • Бэкапы и возврат к предыдущей версии
    • Почтовый релей
      • Расширенные настройки
      • Антиспам и антивирус
      • Правила
      • Почтовая очередь
    • Примеры использования
      • Редактирование пользовательской категории контент-фильтра
      • Создание правила FORWARD
  • changelog
    • Ideco NGFW 19.X
    • ФСТЭК Ideco UTM 19.X
    • Ideco Center 19.Х
Powered by GitBook
On this page
  • Предотвращение вторжений
  • Профили Web Application Control (WAF)
  • Контроль приложений

Was this helpful?

  1. API

Управление профилями безопасности

Предотвращение вторжений

Путь в веб-интерфейсе NGFW: Профили безопасности -> Предотвращение вторжений

Получение списка профилей
GET /ips/profiles

Ответ на успешный запрос:

[
  {
    "id": "string",
    "name": "string",
    "comment": "string"
  },
  ...
]
  • id - идентификатор профиля или фиксированная строка __DEFAULT_IPS_PROFILE_ID__ (шаблонный профиль);

  • name - название профиля, максимальная длина - 42 символа;

  • comment - комментарий, максимальная длина - 255 символов.

Шаблонный профиль отображается в режиме Только для чтения. Идентификатор шаблонного профиля не может быть использован в запросах на изменение/удаление профиля и на создание/изменение/перемещение/удаление правил профиля.

Создание профиля
POST /ips/profiles

Json-тело запроса::

{
    "name": "string",
    "comment": "string"
}
  • name - название профиля, максимальная длина - 42 символа;

  • comment - комментарий, максимальная длина - 255 символов.

Ответ на успешный запрос:

{
  "id": "string"
}
  • id - идентификатор профиля.

Изменение профиля
PATCH /ips/profiles/<id профиля>

Json-тело запроса:

{
    "name": "string",
    "comment": "string"
}
  • name - название профиля, максимальная длина - 42 символа;

  • comment - комментарий, максимальная длина - 255 символов.

Ответ на успешный запрос: 200 ОК

Удаление профиля
DELETE /ips/profiles/<id профиля>

Ответ на успешный запрос: 200 ОК

Получение списка правил профиля
GET /ips/profiles/<profile_id>/rules
  • profile_id - идентификатор профиля, список правил которого запрашивается (без скобок и кавычек).

Ответ на успешный запрос:

[
  {
    "id": "integer",
    "filters": [
      {
        "key": "sid" | "mitre_tactic_id" | "protocol" | "signature_severity" | "flow" | "classtype",
        "operator": "equals",
        "values": [ "string" | "integer" ],
     },
    ...
    ]
    "action": "default" | "alert" | "drop" | "pass",
    "comment": "string"
  },
  ...
]
  • id - номер правила выбора сигнатур;

  • filters - список фильтров правила (список не может быть пустым):

    • key - поле фильтра (sid - идентификатор, mitre_tactic_id - тактика MITRE, protocol - протокол, signature_severity - уровень серьезности, flow - направление, classtype - класс);

    • operator - оператор, только equals;

    • values - список значений, которые должны принимать поля key (если key - sid, то values - число).

  • action - строка с действием при срабатывании правила;

  • comment - комментарий, максимальная длина 255 символов.

Создание правила в профиле
POST /ips/profiles/<profile_id>/rules?anchor_item_id=<integer>&insert_after=<true|false>
  • profile_id - идентификатор профиля, в котором создается правило (без скобок и кавычек);

  • anchor_item_id - идентификатор правила, ниже или выше которого нужно создать новое;

  • insert_after - вставка до или после. Если true или отсутствует, то вставить правило сразу после указанного в anchor_item_id. Если false, то на месте указанного в anchor_item_id.

Json-тело запроса:

{
    "filters": [
       {
        "key": "sid" | "mitre_tactic_id" | "protocol" | "signature_severity" | "flow" | "classtype",
        "operator": "equals",
        "values": [ "string" | "integer" ]
      },
      ...
    ],
    "action": "default" | "alert" | "drop" | "pass",
    "comment": "string"
}
  • filters - список фильтров правила (список не может быть пустым):

    • key - поле фильтра (sid - идентификатор, mitre_tactic_id - тактика MITRE, protocol - протокол, signature_severity - уровень серьезности, flow - направление, classtype - класс);

    • operator - оператор, только equals;

    • values - список значений, которые должны принимать поля key (если key - sid, то values - число).

  • action - строка с действием при срабатывании правила;

  • comment - комментарий, максимальная длина - 255 символов.

Ответ на успешный запрос:

{
  "id": "integer"
}
  • id - номер правила выбора сигнатур.

Изменение правила в профиле
PATCH /ips/profiles/<profile_id>/rules/<rule_id>
  • profile_id - идентификатор профиля, в котором изменяется правило;

  • rule_id - идентификатор правила в профиле.

Json-тело запроса: (некоторые или все поля объекта)

{
    "filters": [
      {
        "key": "sid" | "mitre_tactic_id" | "protocol" | "signature_severity" | "flow" | "classtype",
        "operator": "equals",
        "values": [ "string" | "integer" ]
       },
      ...
    ],
    "action": "default" | "alert" | "drop" | "pass",
    "comment": "string"
}
  • filters - список фильтров правила (список не может быть пустым):

    • key - поле фильтра (sid - идентификатор, mitre_tactic_id - тактика MITRE, protocol - протокол, signature_severity - уровень серьезности, flow - направление, classtype - класс);

    • operator - оператор, только equals;

    • values - список значений, которые должны принимать поля key (если key - sid, то values - число).

  • action - строка с действием при срабатывании правила;

  • comment - комментарий, максимальная длина - 255 символов.

Ответ на успешный запрос: 200 ОК

Перемещение правила в профиле
PATCH /ips/profiles/rules/move

Json-тело запроса::

{
    "params": {
        "profile_id": "string",
        "rule_id": "integer",
        "anchor_item_id": "integer",
        "insert_after": "boolean"
    }
}
  • profile_id - идентификатор профиля, в котором перемещается правило;

  • rule_id - идентификатор правила в профиле;

  • anchor_item_id - идентификатор правила, выше или ниже которого нужно разместить rule_id;

  • insert_after - вставить до (false) или после (true) правила anchor_item_id.

Ответ на успешный запрос: 200 ОК

Удаление правила в профиле
DELETE /ips/profiles/<profile_id>/rules/<rule_id>
  • profile_id - идентификатор профиля, в котором удаляется правило;

  • rule_id - идентификатор правила в профиле.

Ответ на успешный запрос: 200 ОК

Создание профиля с правилами
POST /ips/profiles-create-with-rules

Json-тело запроса::

{
    "name": "string",
    "comment": "string",
    "rules": [
          {
          "filters": [
                {
                "key": "sid" | "mitre_tactic_id" | "protocol" | "signature_severity" | "flow" | "classtype",
                "operator": "equals",
                "values": [ "string" | "integer" ]
                  },
                  ...
                ],
          "action": "default" | "alert" | "drop" | "pass",
          "comment": "string"
          },
          ...
        ]
    }
  • name - название профиля, максимальная длина - 42 символа;

  • comment - комментарий, максимальная длина - 255 символов;

  • rules - список правил профиля:

    • filters - список фильтров правила (список не может быть пустым):

      • key - поле фильтра (sid - идентификатор, mitre_tactic_id - тактика MITRE, protocol - протокол, signature_severity - уровень серьезности, flow - направление, classtype - класс);

      • operator - оператор, только equals;

      • values - список значений, которые должны принимать поля key (если key - sid, то values - число).

    • action - строка с действием при срабатывании правила;

    • comment - комментарий, максимальная длина 255 символов.

Ответ на успешный запрос:

{
    "id": "string"
}
  • id - идентификатор созданного профиля с правилами.

Копирование профиля с правилами
POST /ips/profiles/<id профиля>/copy

В качестве id профиля может быть указана фиксированная строка __DEFAULT_IPS_PROFILE_ID__ для создания копии шаблонного профиля. Поле Комментарий будет заменено на пустую строку.

Ответ на успешный запрос:

{
    "id": "string"
}
  • id - идентификатор созданного профиля.

Получение списка сигнатур в определенном профиле
GET /ips/profiles/<id профиля>/signatures

В качестве id профиля может быть указана фиксированная строка __DEFAULT_IPS_PROFILE_ID__ для получения списка сигнатур шаблонного профиля.

Ответ на успешный запрос:

{
    "signatures": [
        {
            "action": "string",
            "protocol": "string",
            "flow": "string",
            "classtype": "string-admin",
            "sid": "integer",
            "signature_severity": "string",
            "mitre_tactic_id": "string",
            "signature_source": "string",
            "msg": "string",
            "source": "string",
            "source_ports": "string",
            "destination": "string",
            "destination_ports": "string",
            "updated_at": "string"
        },
        ...
    ]
}
  • action - действие для трафика, соответствующего сигнатуре:

    • pass - Пропускать;

    • alert - Предупреждать;

    • drop - Блокировать;

    • rejectsrc - Отправлять RST узлу источника;

    • rejectdst - Отправлять RST узлу назначения;

    • rejectboth - Отправлять RST обоим.

  • flow - направление трафика (client2server, server2client, -);

  • classtype - группа, к которой относится сигнатура;

  • sid - идентификатор сигнатуры;

  • signature_severity - уровень угрозы;

  • mitre_tactic_id - тактика согласно матрице MITRE ATT&CK;

  • signature_source - источник сигнатуры:

    • standard - стандартные правила;

    • advanced - правила IPS от Лаборатории Касперского;

    • custom - пользовательские правила.

  • msg - название сигнатуры;

  • source - источник подключения;

  • source_ports - порты источника;

  • destination - назначение;

  • destination_ports - порты назначения;

  • updated_at - дата в формате YYYY-MM-DD или строка со значением -.

Получение количества сигнатур профиля по действиям для всех профилей
GET /ips/profiles/actions-counts 

Ответ на успешный запрос:

{
    "profile_id": {
      "pass": "integer",
      "alert": "integer",
      "drop": "integer",
      "rejectsrc": "integer",
      "rejectdst": "integer",
      "rejectboth": "integer"
    },
    ...
}
  • profile_id - идентификатор профиля или фиксированная строка __DEFAULT_IPS_PROFILE_ID__ (шаблонный профиль):

    • pass - Пропускать;

    • alert - Предупреждать;

    • drop - Блокировать;

    • rejectsrc - Отправлять RST узлу источника;

    • rejectdst - Отправлять RST узлу назначения;

    • rejectboth - Отправлять RST обоим.

Получение количества сигнатур профиля по действиям для конкретного профиля
GET /ips/profiles/<id профиля>/actions-counts

Ответ на успешный запрос:

{
    "rule_id": {
      "pass": "integer",
      "alert": "integer",
      "drop": "integer",
      "rejectsrc": "integer",
      "rejectdst": "integer",
      "rejectboth": "integer"
    },
    ...
}
  • rule_id - идентификатор правила в профиле:

    • pass - Пропускать;

    • alert - Предупреждать;

    • drop - Блокировать;

    • rejectsrc - Отправлять RST узлу источника;

    • rejectdst - Отправлять RST узлу назначения;

    • rejectboth - Отправлять RST обоим.

Получение профилей Предотвращения вторжений, которые содержат определенную сигнатуру
GET /ips/signatures/<sid>/profiles
  • sid - идентификатор сигнатуры.

Ответ на успешный запрос:

{
    "id": "string",
    "name": "string"
}
  • id - идентификатор профиля;

  • name - название профиля.

Профили Web Application Control (WAF)

Получение списка профилей
GET /reverse_proxy_backend/waf/profiles

Ответ на успешный запрос:

[
  {
    "id": "string",
    "name": "string",
    "detection_only": "boolean",
    "disabled_categories": ["string"],
    "exceptions": [
      {
        "id": "string",
        "rule_id": "integer",
        "comment": "string",
        "enabled": "boolean"
      },
      ...
    ],
    "server_tokens": "boolean",
    "comment": "string",
    "from_central_console": "boolean"
  },
  ...
]
  • id - идентификатор профиля;

  • name - название профиля, максимальная длина - 42 символа;

  • detection_only - режим работы: true - только обнаружение, false - обнаружение и блокировка;

  • disabled_categories - список идентификаторов категорий для исключения, максимальная длина - 128 символов;

  • exceptions - исключенные правила:

    • id - идентификатор исключенного правила;

    • rule_id - идентификатор исключенного правила в профиле;

    • comment - комментарий, максимальная длина - 255 символов;

    • enabled - статус: true - включено, false - выключено.

  • server_tokens - статус HTTP-заголовка Server: true - показывать, false - скрывать;

  • comment - комментарий, может быть пустым, максимальная длина - 255 символов;

  • from_central_console - true, если профиль создан в Ideco Center, только для чтения.

Создание профиля
POST /reverse_proxy_backend/waf/profiles

Json-тело запроса:

{
    "name": "string",
    "detection_only": "boolean",
    "disabled_categories": ["string"],
    "server_tokens": "boolean",
    "comment": "string",
    "from_central_console": "boolean"
}
  • name - название профиля, максимальная длина - 42 символа;

  • detection_only - режим работы: true - только обнаружение, false - обнаружение и блокировка;

  • disabled_categories - список идентификаторов категорий для исключения, максимальная длина - 128 символов, при создании профиля может быть пустым;

  • server_tokens - статус HTTP-заголовка Server: true - показывать, false - скрывать;

  • comment - комментарий, может быть пустым, максимальная длина - 255 символов;

  • from_central_console - true, если профиль создан в Ideco Center, только для чтения.

Ответ на успешный запрос:

{
    "id": "string"
}
Изменение профиля
PATCH /reverse_proxy_backend/waf/profiles/<id профиля>

Json-тело запроса:

{
    "name": "string",
    "detection_only": "boolean",
    "disabled_categories": ["string"],
    "server_tokens": "boolean",
    "comment": "string",
    "from_central_console": "boolean"
}
  • name - название профиля, максимальная длина - 42 символа;

  • detection_only - режим работы: true - только обнаружение, false - обнаружение и блокировка;

  • disabled_categories - список идентификаторов категорий правил, которые были отключены, максимальная длина - 128 символов;

  • server_tokens - статус HTTP-заголовка Server: true - показывать, false - скрывать;

  • comment - комментарий, может быть пустым, максимальная длина - 255 символов;

  • from_central_console - true, если профиль создан в Ideco Center, только для чтения.

Ответ на успешный запрос: 200 ОК

Удаление профиля
DELETE /reverse_proxy_backend/waf/profiles/<id профиля>

Ответ на успешный запрос: 200 ОК

Получение списка категорий правил
GET /reverse_proxy_backend/waf/categories

Ответ на успешный запрос:

[
  {
    "id": "string",
    "title": "string",
    "required": "boolean",
    "description": "string"
  },
  ...
]
  • id - идентификатор категории, максимальная длина - 42 символа;

  • title - название категории, максимальная длина - 42 символа;

  • required - является ли категория необходимой, т.е. еe нельзя будет выключать;

  • description - описание категории, максимальная длина - 255 символов.

Получение списка категорий правил в профиле
GET /reverse_proxy_backend/waf/profiles/<id профиля>/categories

Ответ на успешный запрос:

  • Список категорий правил, которые включены в профиле.

[
  {
    "id": "string",
    "title": "string",
    "required": "boolean",
    "description": "string"
  },
  ...
]
  • id - идентификатор категории, максимальная длина - 42 символа;

  • title - название категории, максимальная длина - 42 символа;

  • required - является ли категория необходимой, т.е. еe нельзя будет выключать;

  • description - описание категории, максимальная длина - 255 символов.

Добавление или удаление категории правил в профиле
PATCH /reverse_proxy_backend/waf/profiles/<id профиля>/categories/<id категории>

Json-тело запроса:

{
    "enabled": "boolean"
}

Ответ на успешный запрос:

  • Если профиль или категория не найдены по идентификатору, то код ответа - 542;

  • Если enabled - true, то категория, идентификатор которой указан в запросе, будет удалена из списка disabled_categories профиля. Ответ - 200 ОК;

  • Если enabled - false, то категория, идентификатор которой указан в запросе, будет добавлена в список disabled_categories профиля. Ответ - 200 ОК.

Получение белых и черных списков в профиле
GET /reverse_proxy_backend/waf/profiles/<id профиля>/rules

Ответ на успешный запрос:

[
  {
    "aliases": ["string"],
    "aliases_negate": "boolean",
    "action": "block" | "pass",
    "comment": "string",
    "enabled": "boolean",
    "id": "integer"
  },
  ...
]
  • aliases - список алиасов IP-адресов, подсетей, стран, списков стран и континентов;

  • aliases_negate - инверсия правила;

  • action - действие:

    • block - блокировать запросы;

    • pass - пропускать запросы.

  • comment - комментарий, максимальная длина - 255 символов;

  • enabled - статус: true - включено, false - выключено;

  • id - номер правила.

Создание белых и черных списков в профиле
POST /reverse_proxy_backend/waf/profiles/<id профиля>/rules?anchor_item_id=<integer>&insert_after=<true|false>
  • anchor_item_id - идентификатор правила, ниже или выше которого нужно создать новое;

  • insert_after - вставка до или после. Если true или отсутствует, то вставить правило сразу после указанного в anchor_item_id. Если false, то на месте указанного в anchor_item_id.

Json-тело запроса:

{
    "aliases": ["string"],
    "aliases_negate": "boolean",
    "action": "block" | "pass",
    "comment": "string",
    "enabled": "boolean"
}
  • aliases - список алиасов IP-адресов, подсетей, стран, списков стран и континентов;

  • aliases_negate - инверсия правила;

  • action - действие:

    • block - блокировать запросы;

    • pass - пропускать запросы.

  • comment - комментарий, максимальная длина - 255 символов;

  • enabled - статус: true - включено, false - выключено.

Ответ на успешный запрос:

{
    "id": "integer"
}
Изменение белых и черных списков в профиле
PATCH /reverse_proxy_backend/waf/profiles/<id профиля>/rules/<id правила в профиле>

Json-тело запроса:

{
    "aliases": ["string"],
    "aliases_negate": "boolean",
    "action": "block" | "pass",
    "comment": "string",
    "enabled": "boolean"
}
  • aliases - список алиасов IP-адресов, подсетей, стран, списков стран и континентов;

  • aliases_negate - инверсия правила;

  • action - действие:

    • block - блокировать запросы;

    • pass - пропускать запросы.

  • comment - комментарий, максимальная длина - 255 символов;

  • enabled - статус: true - включено, false - выключено.

Ответ на успешный запрос: 200 OK

Перемещение белых и черных списков в профиле
PATCH /reverse_proxy_backend/waf/profiles/rules/move

Json-тело запроса:

{
  "params": {
    "profile_id": "string",
    "rule_id": "integer",
    "anchor_item_id": "integer",
    "insert_after": "boolean",
  },
}
  • profile_id - идентификатор профиля, в котором перемещается правило;

  • rule_id - идентификатор перемещаемого правила;

  • anchor_item_id - идентификатор правила, относительно которого будет перемещено правило;

  • insert_after - вставить правило до или после anchor_item_id. Если true или отсутствует, то вставить правило сразу после указанного в anchor_item_id. Если false, то на месте указанного в anchor_item_id.

Ответ на успешный запрос: 200 OK

Удаление белых и черных списков в профиле
DELETE /reverse_proxy_backend/waf/profiles/<id профиля>/rules/<id правила>

Ответ на успешный запрос: 200 OK

Получение списка исключенных правил профиля
GET /reverse_proxy_backend/waf/profiles/<id профиля>/exceptions

Ответ на успешный запрос:

[
  {
    "id": "string",
    "rule_id": "integer",
    "comment": "string",
    "enabled": "boolean"
  },
  ...
]
  • id - идентификатор исключенного правила;

  • rule_id - идентификатор правила;

  • comment - комментарий, максимальная длина - 255 символов;

  • enabled - статус: true - включено, false - выключено.

Создание исключенного правила в профиле
POST /reverse_proxy_backend/waf/profiles/<id профиля>/exceptions

Json-тело запроса:

{
    "rule_id": "integer",
    "comment": "string",
    "enabled": "boolean"
}
  • comment - комментарий, максимальная длина - 255 символов;

  • enabled - статус: true - включено, false - выключено.

Ответ на успешный запрос:

{
    "id": "integer"
}
Изменение исключенного правила в профиле
PATCH /reverse_proxy_backend/waf/profiles/<id профиля>/exceptions/<id исключенного правила>

Json-тело запроса:

{
    "rule_id": "integer",
    "comment": "string",
    "enabled": "boolean"
}
  • comment - комментарий, максимальная длина - 255 символов;

  • enabled - статус: true - включено, false - выключено.

Ответ на успешный запрос: 200 OK

Удаление исключенного правила в профиле
DELETE /reverse_proxy_backend/waf/profiles/<id профиля>/exceptions/<id исключенного правила>

Ответ на успешный запрос: 200 OK

Контроль приложений

Получение списка профилей
GET /api/application_control/profiles

Ответ на успешный запрос:

[
  {
    "id": "string",
    "name": "string",
    "comment": "string",
    "protocols": [
      {
        "id": "string",
        "action": "deny" | "allow"
      },
      ...
    ],
  }
]
  • id - идентификатор профиля;

  • name - название профиля;

  • comment - комментарий к профилю;

  • protocols - список протоколов, выбранных для профиля:

    • id - строковый идентификатор алиаса протокола с префиксом id.l7. Например, id.l7.ftp_protocol;

    • action - действие, применяемое к протоколу (deny - запретить, allow - разрешить).

Создание профиля
POST /api/application_control/profiles

Json-тело запроса:


{
  "name": "string",
  "comment": "string",
  "protocols": [
    {
      "id": "string",
      "action": "deny" | "allow"
    },
    ...
    ],
}
  • name - название профиля;

  • comment - комментарий к профилю;

  • protocols - список протоколов, выбранных для профиля:

    • id - строковый идентификатор алиаса протокола с префиксом id.l7. Например, id.l7.ftp_protocol;

    • action - действие, применяемое к протоколу (deny - запретить, allow - разрешить).

Ответ на успешный запрос:

[
  {
    "id": "string",
    "name": "string",
    "comment": "string",
    "protocols": [
      {
        "id": "string",
        "action": "deny" | "allow"
      },
      ...
      ],
  }
]
  • id - идентификатор профиля;

  • name - название профиля;

  • comment - комментарий к профилю;

  • protocols - список протоколов, выбранных для профиля:

    • id - строковый идентификатор алиаса протокола с префиксом id.l7. Например, id.l7.ftp_protocol;

    • action - действие, применяемое к протоколу (deny - запретить, allow - разрешить).

Копирование профиля
POST /api/application_control/profiles/<id профиля>/copy

Ответ на успешный запрос:

{
  "id": "integer"
}
  • id - идентификатор копии профиля.

Редактирование профиля
PATCH /api/application_control/profiles/<id профиля>

Json-тело запроса:

[
  {
    "name": "string",
    "comment": "string",
    "protocols": [
      {
        "id": "string",
        "action": "deny" | "allow"
      },
      ...
      ],
  }
]
  • name - название профиля;

  • comment - комментарий к профилю;

  • protocols - список протоколов, выбранных для профиля:

    • id - строковый идентификатор алиаса протокола с префиксом id.l7. Например, id.l7.ftp_protocol;

    • action - действие, применяемое к протоколу (deny - запретить, allow - разрешить).

Ответ на успешный запрос: 200 OK

Удаление профиля
DELETE /api/application_control/profiles/<id профиля>

Ответ на успешный запрос: 200 OK

PreviousИсключенияNextУправление сетевыми интерфейсами

Last updated 27 days ago

Was this helpful?

protocol - протокол (tcp, udp, icmp, ip). Возможные значения представлены по ;

rule_id - идентификатор правила. Можно найти в журнале в разделе Отчеты и журналы -> События безопасности -> ;

rule_id - идентификатор правила. Можно найти в журнале в разделе Отчеты и журналы -> События безопасности -> ;

ссылке
Web Application Firewall
Web Application Firewall