Создание СЗИ

Для создания СЗИ нажмите кнопку «Добавить» и последовательно заполните вкладки «Общие настройки», «Глобальные настройки», «Маппинг вердиктов» и «Воркфлоу».

create pool cybersec tool 0001 22

Общие настройки

В верхней части вкладки «Общие настройки» отображаются имя, шаблон и настройка декодирования транзитных заголовков. Для остальных параметров вкладки предусмотрен режим редактирования.

  • Имя — имя подключения.

  • Шаблон — доступен для средства защиты информации (см. раздел Шаблоны СЗИ). Если шаблон не выбран, поля содержат значения по умолчанию, а на вкладке «Воркфлоу» нет шагов: их можно добавить вручную. При выборе шаблона значения его параметров подставляются во все вкладки. Если поле заполнено и в шаблоне есть соответствующий параметр, введенное значение заменяется значением из шаблона. Поля, для которых в шаблоне нет параметров, сохраняют текущие значения.

  • Декодирование транзитных заголовков из Base64 — доступно только для СЗИ. По умолчанию выключено. Означает, что при передаче в СЗИ (см. раздел "приехавших транзитом") заголовков - к ним будет применять попытка декодинга из Base64.

  • Хост — адрес хоста. По умолчанию поле пустое.

  • Лимит подключений — максимальное число подключений. По умолчанию 5.

  • Игнорировать проверку безопасного соединения — по умолчанию выключено. При его включении необходимо добавить в систему набор сертификатов от СЗИ, с которыми предстоит интеграция - см. раздел Система.

Глобальные настройки

На вкладке «Глобальные заголовки» устанавливается маппинг заголовков в виде пар «Имя — значение или переменная». Доступно добавление несколько пар.

Для переменных из маппинга заголовков можно задать преобразование по пиктограмме "icon settings 22" Настройки . Добавляется пара «Переменная — преобразователь»: переменная выбирается из указанных в маппинге заголовков, а преобразователем может быть base64.

Маппинг вердиктов

Маппинг вердиктов сопоставляет значения, полученные от средства защиты информации (СЗИ), с вердиктами Системы.

Настройки маппинга включают:

  • Путь к вердикту — выберите переменную, содержащую вердикт СЗИ. В списке доступны переменные из маппингов HTTP-кода, заголовков и тела ответа. Имя переменной начинается со знака $ и содержит прописные латинские буквы, цифры и знак подчеркивания.

  • Вердикт по умолчанию — значение Unknown. При необходимости укажите другое значение.

  • Маппинг вердиктов — добавьте пары «Вердикт СЗИ — вердикт Системы». Для вердикта Системы используйте одно из значений: Clean, Malicious, Danger или Unknown. Несколько вердиктов СЗИ можно сопоставить одному вердикту Системы.

Воркфлоу

Рабочий процесс может состоять из нескольких шагов. Для каждого шага задаются общие параметры и настройки, зависящие от его типа.

Тип шагаКогда использоватьДополнительные настройки

sync

Когда ответ обрабатывается без последующего опроса

ICAP, HTTP, тело запроса и параметры подключения

poll

Когда результат получают путём повторного опроса

HTTP, тело запроса и параметры подключения, а также интервал, таймаут и условие завершения опроса

Общие параметры шага

  • Имя шага — отображается на вкладке шага. По умолчанию — step.

  • Тип шага — sync или poll. По умолчанию — sync. От выбора зависит набор доступных настроек.

  • Шаг с отчетностью — включает отчетность для шага. По умолчанию выключен.

При смене типа шага заполненные значения общих для sync и poll параметров сохраняются.

Шаг типа sync

Настройки ICAP

  • Протокол ICAP — нет, icap или icaps. По умолчанию — нет. Если выбран вариант нет, остальные настройки ICAP не отображаются.

  • Порт ICAP — по умолчанию 1344.

  • Метод ICAP — REQMOD или RESPMOD. По умолчанию — REQMOD.

  • Путь обращения ICAP — по умолчанию /reqmod.

  • Дополнительные заголовки ICAP — пары «Имя» и «Значение или переменная». Можно добавить несколько пар.

  • Запросы ICAP OPTIONS — по умолчанию выключены.

  • Режим ICAP Preview — auto, disabled или fixed. По умолчанию — auto.

  • Объем ICAP Preview в байтах — по умолчанию 0. Поле доступно для изменения только при режиме fixed; в остальных режимах отображается 0.

Для переменных, использованных в пути обращения и дополнительных заголовках ICAP, можно отдельно задать преобразование. Настройка представляет собой пары «Переменная — преобразователь». Доступное преобразование — base64. Переменные выбираются из соответствующего пути или заголовков.

Настройки HTTP

  • Протокол HTTP — http или https. По умолчанию — http.

  • Порт HTTP — по умолчанию 8080.

  • Метод HTTP — GET, POST или PUT. По умолчанию — POST.

  • Путь обращения HTTP — по умолчанию /.

  • Дополнительные заголовки HTTP — пары «Имя» и «Значение или переменная». Можно добавить несколько пар.

Для переменных в пути обращения и дополнительных заголовках HTTP можно задать преобразование base64. Каждое преобразование задается парой «Переменная — преобразователь»; переменные выбираются из соответствующего пути или заголовков.

Настройки тела запроса

  • Режим передачи данных — binary, multipart или json. По умолчанию — json.

  • Шаблон тела запроса — поле JSON. Не отображается в режиме binary; при заполнении проверяется корректность JSON.

В режиме multipart при необходимости можно задать имя поля, содержащего файл, в шаблоне тела запроса с помощью ключа field_name. Если имя не указано, используется file.

Для переменных из шаблона тела запроса можно задать пары «Переменная — преобразователь». Доступное преобразование — base64.

Дополнительные настройки

  • Коды успешности — список числовых кодов. Можно добавить несколько кодов.

  • Количество попыток подключения — по умолчанию 3.

  • Интервал между попытками подключения — число и единица времени: second, minute, hour или day. По умолчанию — 30 second.

  • Таймаут ожидания ответа — число и единица времени из того же списка. По умолчанию — 15 minute.

Шаг типа poll

Для шага poll настройки HTTP, тела запроса и дополнительные настройки задаются так же, как для шага sync (см. соответствующие подразделы выше).

Настройки опроса

  • Интервал между попытками опроса — число и единица времени: second, minute, hour или day. По умолчанию — 2 minute.

  • Общий таймаут опроса — число и единица времени из того же списка. По умолчанию — 15 minute.

  • Переменная для условия завершения опроса — укажите переменную, значение которой проверяется при опросе.

  • Оператор условия завершения опроса — eq, neq, gt, lt, exists, not_exists, empty, not_empty или in. По умолчанию — eq.

  • Значение условия завершения опроса — укажите значение для сравнения.

Распаковка ответа

Режим распаковки ответа определяет, какие данные ответа обрабатываются:

  • code — отображается маппинг HTTP-кода ответа;

  • headers — отображается маппинг заголовков ответа;

  • payload — отображаются маппинги заголовков и тела ответа;

  • file — отображается маппинг заголовков ответа. Файл из ответа размещается в хранилище как модифицированная версия исходного файла.

По умолчанию выбран режим headers.

Для маппинга HTTP-кода ответа укажите переменную в текстовом поле. Маппинги заголовков и тела ответа задаются парами «Путь — переменная»; можно добавить несколько пар.

Поиск в ответе

Поиск доступен в режимах распаковки headers и payload. Для каждого условия поиска укажите:

  • Переменную для поиска — из переменных, заданных в маппингах заголовков или тела ответа.

  • Путь к полю для сравнения.

  • Оператор сравнения — eq, neq, gt, lt, exists, not_exists, empty, not_empty или in. По умолчанию — eq.

  • Значение для сравнения.

  • Путь к полю результата.

  • Переменную для размещения результата.

Можно добавить несколько условий поиска. Например, следующее условие ищет запись, у которой поле status равно ready, и помещает значение поля verdict в переменную $SUMMARY_VERDICT:

{
  "search_var": "$SANDBOX_THREAT",
  "search_path": "status",
  "search_op": "eq",
  "search_val": "ready",
  "result_path": "verdict",
  "result_var": "$SUMMARY_VERDICT"
}