Создание шаблона СЗИ

Для создания шаблона СЗИ необходимо нажать кнопку "Добавить".

Точные имена полей спецификации и перечень встроенных spec-переменных приведены в документе MP. Анализ файлов. Формат спек (шаблонов) для интеграции. Для доступа к документу требуется авторизация.

Важно: при работе с шаблонами:

  1. Не рекомендуется использовать в качестве имени шаблона СЗИ фразу "WRONG RECORD", т.к. она зарезервирована Системой.

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

  3. Шаблоны являются условно "защищенными", т.е. при любом перезапуске сервиса mp-core с API они будут возвращаться к исходному виду (а при удалении - тоже будут возвращаться).

  4. ip адреса и hostname во встроенных шаблонах проставлены по умолчанию как 127.0.0.1. Поэтому при использовании шаблонов для подключения реального СЗИ необходимо заменить их на реальные ip и hostname, а также проверить правильность указания портов.

Страница создания шаблона СЗИ состоит из 4х вкладок.

Вкладка "Общие настройки" предназначена для ввода имени шаблона, указания лимита подключений и хоста.

В секции general лимиту подключений соответствует параметр connection_limit (default: 5), а адресу СЗИ — host.

create template 0001 22

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

В спецификации глобальные заголовки записываются в request_headers_mapping, а преобразования переменных из этого маппинга — в request_headers_mapping_transformation (с версии 2.2).

Новая запись добавляется по пиктограмме "icon add 22", удаляется - по пиктограмме "icon minuce 22".

create template 0002 22

По пиктограмме "icon settings 22" Настройки - система открывает модальное окно для установки настроек преобразования спек-переменных в маппинге заголовоков.

В настройках содержится список отпарсенных спек-переменных из "Маппинг заголовков", (попадающие под такую регялуярное выражение (?P<name>\$[A-Z_][A-Z0-9_]*)). Для установки значения предназначен выпадающий список доступных "преобразователей" (только base64).

create template 0002 2 22

Вкладка "Маппинг отчетности"

В спецификации путь к переменной с вердиктом задаётся параметром verdict_mapping.path.

Все, что упоминается в блоках "Маппинг распаковки тела ответа", "Маппинг распаковки заголовков ответа", "Маппинг распаковки http кода ответа" и попадает под регулярку (?P<name>\$[A-Z_][A-Z0-9_]*) - попадает для выбора в списке "Путь к вердикту".

В поле "Дефолтный вердик" осуществляется ввод текст вердикта (см. раздел Вердикты), по умолчанию - "Unknown".

create template 0003 22

Вкладка "Воркфлоу"

Подробное описание сценария заполнения вкладки приведено в разделе "Создание СЗИ"

Каждый шаг воркфлоу содержит параметры name (имя шага), kind (sync или poll) и is_report_step (признак шага с отчетностью). Настройки запроса находятся в блоках sync и poll, а распаковка ответа — в блоке extraction.

Для шага sync в версии 2.2 преобразования spec-переменных задаются отдельными параметрами: sync.path_transformation — для пути HTTP, sync.icap_path_transformation — для пути ICAP, sync.headers_transformation — для заголовков HTTP, sync.icap_headers_transformation — для заголовков ICAP и sync.body.transformation — для шаблона тела запроса (sync.body.payload). Поддерживается преобразование base64.

create template 0004 22