Политики запроса ICAP к СЗИ

Icap-Клиент Системы предварительно собирает политику запроса ICAP к СЗИ из спецификации (см. раздел Создание СЗИ), после чего при необходимости уточняет ее через запрос OPTIONS. Только после этого решает: отправлять весь файл сразу или использовать Preview. При любом формате отправки, в параллельном режиме происходит запись (отправка файла) и чтение (получение) ответа от сервера.

Настройки в спецификации	Что делает клиент	Как отправляется файл
icap_preview_mode` не задан	Используется `disabled`	Файл отправляется целиком, без `Preview`
`icap_preview_mode: disabled`	`Preview` отключен явно	Файл отправляется целиком
`icap_preview_mode: auto`, `icap_options_enabled: false`	Клиент не делает `OPTIONS`, поэтому `auto` превращается в `disabled`	Файл отправляется целиком
`icap_preview_mode: auto`, `icap_options_enabled: true`	Клиент делает `OPTIONS` и смотрит, прислал ли сервер `Preview`	Если сервер прислал `Preview`, используется это значение. Если не прислал или `OPTIONS` упал, файл отправляется целиком
``icap_preview_mode: fixed` + `icap_preview_bytes: 1024`	Отправка фиксированного размера тела в 1024 байт	Клиент отправляет только заголовки и `Preview: 1024`, из тела загружает 1024 байта, после чего ждет ответ
`icap_preview_bytes` задан, но режим не `fixed`	Значение игнорируется	Отправляется согласно ответу, полученному от сервера.

Настройки в спецификации

Что делает клиент

Как отправляется файл

icap_preview_mode` не задан

Используется `disabled`

Файл отправляется целиком, без `Preview`

`icap_preview_mode: disabled`

`Preview` отключен явно

Файл отправляется целиком

`icap_preview_mode: auto`, `icap_options_enabled: false`

Клиент не делает `OPTIONS`, поэтому `auto` превращается в `disabled`

Файл отправляется целиком

`icap_preview_mode: auto`, `icap_options_enabled: true`

Клиент делает `OPTIONS` и смотрит, прислал ли сервер `Preview`

Если сервер прислал `Preview`, используется это значение. Если не прислал или `OPTIONS` упал, файл отправляется целиком

``icap_preview_mode: fixed` + `icap_preview_bytes: 1024`

Отправка фиксированного размера тела в 1024 байт

Клиент отправляет только заголовки и `Preview: 1024`, из тела загружает 1024 байта, после чего ждет ответ

`icap_preview_bytes` задан, но режим не `fixed`

Значение игнорируется

Отправляется согласно ответу, полученному от сервера.

Режимы предварительного просмотра ICAP (Preview Mode):

disabled - Клиент не использует Preview. Он отправляет заголовки ICAP-запроса, затем тело файла.
auto - Клиент может использовать auto только если включен icap_options_enabled. В таком режиме клиент сначала делает OPTIONS к ICAP-серверу. Если сервер в ответе прислал заголовок Preview, клиент переводит запрос в фактический режим fixed и использует размер от сервера.
fixed - Клиент берет icap_preview_bytes из спецификации и отправляет Preview именно с этим значением. Предварительный запрос OPTIONS не отправляется. По факту - режим для переопределения.

Важно: Allow: 204 не управляется, клиент всегда отправляет этот параметр в значении true

Важно: Для версий до 2.1 (не обновленных), клиент будет отправлять файлы в режиме preview_mode - disabled. Запросы Options так же не будут осуществлены

Была ли эта страница полезной?

Спасибо за отзыв!

Спасибо, мы учтём это для улучшения документации.