ICAPFileChecker#

Действие ICAPFileChecker предназначено для проверки объекта на содержание вирусов по ICAP протоколу.

Для включения режима ByPass необходимо указать таймаут на всю транзакцию (параметр icap_transaction_timeout), а также поведение при его достижении (блокировать/пропускать) (параметр icap_unavailable_action).

Важно!

Включение режима ByPass может привести к потенциальным уязвимостям и снижению уровня кибербезопасности системы и требует подтверждения со стороны эксперта кибербезопасности. В случае срабатывания режима рекомендуется реализовать антивирусную проверку на уровне системы-получателя файла.

Параметры:

Название	Обязательность	Допустимые значения	Описание
icap_url	+	http://host[:port]/path	Url ICAP сервиса, обязательный параметр
icap_mode	+	reqmod/respmod	Режим обращения к ICAP сервису, обязательный параметр. reqmod - request modification mode; respmod - response modification mode.
silent	-	true/false	Определяется режим обработки. При значении true ошибки и положительный результат поиска вирусов логируются, но сообщения не блокируются; при значении false сообщения блокируются. По умолчанию false
Параметры запроса к ICAP сервису
http_initial_line	Текстовое значение. Значение по умолчанию: http://example.sowa.com/$request_id	Параметр, содержащий initial строку инкапсулированного HTTP запроса/ответа для обращения на AVPO. Возможно использование nginx переменных
icap_custom_headers	Последовательность строковых значений	Определяется набор заголовков для запроса к ICAP сервису.
icap_custom_http_headers	Последовательность строковых значений	Определяется набор http заголовков для запроса к ICAP сервису.
Параметры обработки 200 ответа от ICAP сервиса
icap_status_header	Строковое значение	Определяется наименование icap заголовка ответа, в котором может быть передана причина блокировки содержимого
icap_bad_statuses	Последовательность строковых значений	Определяется массив с вариантами ответа в заголовке icap_reason_header, при получении одного из которых необходимо блокировать содержимое. Обязательно в случае: icap_reason_header != None
icap_required_response_headers	Последовательность строковых значений	Определяется массив значений, если необходимо с помощью заголовков ответа проверить корректность ответа AVPO
Параметры тайм-аутов
icap_connect_timeout	Числовое значение с суффиксом. Суффиксы: число без суффикса - байты; k / K - килобайты; m / M - мегабайты.	Максимальное время ожидания установки соединения с ICAP сервисом. По умолчанию - 10 с
icap_read_timeout	Числовое значение с суффиксом. Суффиксы: число без суффикса - байты; k / K - килобайты; m / M - мегабайты.	Максимальное время ожидания на операции чтения ответа от ICAP сервиса. По умолчанию - 10 с
icap_write_timeout	Числовое значение с суффиксом. Суффиксы: число без суффикса - байты; k / K - килобайты; m / M - мегабайты.	Максимальное время ожидания операции записи в канал установленный с ICAP сервисом. По умолчанию - 10 с
icap_transaction_timeout	Числовое значение с суффиксом. Суффиксы: число без суффикса - байты; k / K - килобайты; m / M - мегабайты.	Определяется таймаут транзакции для включения режима ByPass. По умолчанию - 10 с
icap_unavailable_action	Текстовое значение. Значение по умолчанию: block.	Определяет действие для запроса/ответа при возникновении ошибок соединения или достижения таймаутов. Возможные значения: pass/block
Параметры буферизации
body_temp_path	Строковое значение	Определяет путь к временным файлам.
temp_buffer_size	Строковое значение	Определяет размер буфера временного файла.
max_none_buffered_size	Строковое значение	Определяет максимальный размер небуферизуемого контента.

Заполняемые переменные

По результатам своего выполнения, действие IcapFileChecker может заполнять следующие переменные:

Название	Описание
clj_validation_error_code	Код ошибки. Возможные значения: 0 - проверка прошла успешно; 200 - Сообщение не прошло проверку (DENY); 201 - Icap сервис не доступен или произошла ошибка при взаимодействии с ним (ERROR); 6 - внутренняя ошибка работы экшена (ERROR).
clj_validation_error_description	Расшифровка кода ошибки.
clj_validation_error_description_ext	Подробное описание ошибки.
clj_validation_icap_status	Значение заголовка ответа, указанного в icap_status_header.
clj_validation_icap_response_headers	Заголовки ответа от ICAP сервиса.