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

Общие настройки
В верхней части вкладки «Общие настройки» отображаются имя, шаблон и настройка декодирования транзитных заголовков. Для остальных параметров вкладки предусмотрен режим редактирования.
Имя — имя подключения.
Шаблон — доступен для средства защиты информации (см. раздел Шаблоны СЗИ). Если шаблон не выбран, поля содержат значения по умолчанию, а на вкладке «Воркфлоу» нет шагов: их можно добавить вручную. При выборе шаблона значения его параметров подставляются во все вкладки. Если поле заполнено и в шаблоне есть соответствующий параметр, введенное значение заменяется значением из шаблона. Поля, для которых в шаблоне нет параметров, сохраняют текущие значения.
Декодирование транзитных заголовков из Base64 — доступно только для СЗИ. По умолчанию выключено. Означает, что при передаче в СЗИ (см. раздел "приехавших транзитом") заголовков - к ним будет применять попытка декодинга из Base64.
Хост — адрес хоста. По умолчанию поле пустое.
Лимит подключений — максимальное число подключений. По умолчанию
5.Игнорировать проверку безопасного соединения — по умолчанию выключено. При его включении необходимо добавить в систему набор сертификатов от СЗИ, с которыми предстоит интеграция - см. раздел Система.
Глобальные настройки
На вкладке «Глобальные заголовки» устанавливается маппинг заголовков в виде пар «Имя — значение или переменная». Доступно добавление несколько пар.
Для переменных из маппинга заголовков можно задать преобразование по пиктограмме "
" Настройки .
Добавляется пара «Переменная — преобразователь»: переменная выбирается из указанных в маппинге заголовков, а преобразователем может быть base64.
Маппинг вердиктов
Маппинг вердиктов сопоставляет значения, полученные от средства защиты информации (СЗИ), с вердиктами Системы.
Настройки маппинга включают:
Путь к вердикту — выберите переменную, содержащую вердикт СЗИ. В списке доступны переменные из маппингов HTTP-кода, заголовков и тела ответа. Имя переменной начинается со знака
$и содержит прописные латинские буквы, цифры и знак подчеркивания.Вердикт по умолчанию — значение
Unknown. При необходимости укажите другое значение.Маппинг вердиктов — добавьте пары «Вердикт СЗИ — вердикт Системы». Для вердикта Системы используйте одно из значений:
Clean,Malicious,DangerилиUnknown. Несколько вердиктов СЗИ можно сопоставить одному вердикту Системы.
Воркфлоу
Рабочий процесс может состоять из нескольких шагов. Для каждого шага задаются общие параметры и настройки, зависящие от его типа.
| Тип шага | Когда использовать | Дополнительные настройки |
|---|---|---|
| Когда ответ обрабатывается без последующего опроса | ICAP, HTTP, тело запроса и параметры подключения |
| Когда результат получают путём повторного опроса | 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"
}Эта страница была полезна?
Спасибо за отзыв!
Спасибо, мы учтём это для улучшения документации.