Фильтр ICAP (deprecated)#

Примечание

Данный механизм не рекомендован к использованию в SOWA. В качестве альтернативы рекомендуется использовать действие IcapFileChecker.

Фильтр ICAP позволяет отправить исходящий и входящий трафик в любую систему по протоколу ICAP. Такими системами могут быть АВПО или системы предупреждения утечек (DLP).

filter_icap - параметры#

Название

Обязательность

Описание

Возможные значения

Значение по умолчанию

request

Опциональный

Параметры фильтрации запроса

Параметры, описанные в разделе «filter_icap - request/response»

—

response

Опциональный

Параметры фильтрации ответа

Параметры, описанные в разделе «filter_icap - request/response»

—

filter_icap - request/response#

Параметры для request и response идентичны.

Название

Обязательность

Описание

Возможные значения

Значение по умолчанию

icap_url

Обязательный

URL внешнего антивируса. Возможность использования регулярного выражения. Для использования символов `\ ^ $ .

? * + ( ) [ ] { } -` в явном виде необходимо их экранирование

Строковое значение

icap_mode

Обязательный

Метод, использующийся при взаимодействии по протоколу ICAP

REQMOD, RESPMOD

—

icap_extensions

Обязательный

Расширения файлов, которые необходимо направить антивирусу для проверки

* — проверять все; перечисление расширений, начинающихся с «.»

—

icap_custom_headers

Обязательный

Секция заголовков для АВПО

Последовательность строковых значений

—

icap_custom_http_headers

Обязательный

Секция заголовков непосредственно запроса/ответа

Последовательность строковых значений

—

icap_silent

Опциональный

Флаг, в результате действия которого будет пропущен весь контент, независимо от результата проверки на вирусы

on, off

off

icap_body_temp_path

Опциональный

Путь к временным файлам

Строковое значение

/sowarun/<profile_name>/body

icap_temp_buffer_size

Опциональный

Размер буфера временного файла

Текстовое значение с суффиксом: число (байты), k/K (килобайты), m/M (мегабайты)

32768

icap_max_none_buffered_size

Опциональный

Максимальный размер небуферизуемого контента

Текстовое значение с суффиксом: число (байты), k/K (килобайты), m/M (мегабайты)

32768

icap_connect_timeout

Опциональный

Таймаут для установки соединения с антивирусом

Текстовое значение с суффиксом: ms (миллисекунды), m/M (минуты), s/S (секунды)

10s

icap_read_timeout

Опциональный

Таймаут чтения контента

Текстовое значение с суффиксом: ms (миллисекунды), m/M (минуты), s/S (секунды)

10s

icap_write_timeout

Опциональный

Таймаут записи контента

Текстовое значение с суффиксом: ms (миллисекунды), m/M (минуты), s/S (секунды)

10s

icap_internal_error_code

Опциональный

HTTP статус код, который генерируется при ошибке соединения с ICAP сервисом

Целочисленное значение

500

icap_check_error_code

Опциональный

HTTP статус код, который генерируется при блокировке сообщения антивирусом

Целочисленное значение

403

icap_internal_error_message

Опциональный

Сообщение об ошибке, отправляемое клиенту при ошибке соединения с антивирусом. Используется, если icap_internal_error_message_file не задан

Строковое значение

""

icap_internal_error_message_file

Опциональный

Файл, который содержит сообщение об ошибке, отправляемое клиенту в случае ошибки соединения с антивирусом. Используется, если icap_internal_error_message не задан

Строковое значение

""

icap_check_error_message_file

Опциональный

Файл, который содержит сообщение об ошибке, отправляемое клиенту при блокировке сообщения антивирусом. Используется, если icap_check_error_message не задан

Строковое значение

""

icap_internal_error_content_type

Опциональный

Контент-тип заголовка для сообщения об ошибке, отправляемого клиенту в случае ошибки подключения к антивирусу

Строковое значение

""

icap_check_error_content_type

Опциональный

Контент-тип заголовка для сообщения об ошибке, отправляемого клиенту при блокировке сообщения антивирусом

Строковое значение

""

Пример установки заголовков запросов/ответов:

avpo_custom_headers:
  - 'X-Dozor-Mapping-Schema': 'NewSystemSchema'
  - 'Host': '10.x.x.x'
  - 'X-Server-IP': '10.x.x.x'
  - 'X-Client-IP': '10.x.x.x'
avpo_custom_http_headers:
  - 'Host': 'localhost'
  - 'X-NewSystem-Sender-User-Login': '=?UTF-8?B?VEVTVERPTUFJTlx0ZXN0bG9naW4=?='
  - 'X-NewSystem-Recipient-User-Login': '=?UTF-8?B?VEVTVERPTUFJTlx0ZXN0bG9naW4sIFRFU1RET01BSU5cdGVzdGxvZ2luMiwgVEVTVERPTUFJTlx0ZXN0bG9naW4z?='
  - 'X-NewSystem-Application': 'NewSystem'
  - 'X-NewSystem-Message-ID': 'a3b88fe0-0547-11ea-eda0-adbbff4496fc'
  - 'X-NewSystem-Message-Date': '2020-10-19T14:07:34+03:00'
  - 'X-Custom-Header': '$http_content_type'