Подраздел "Источники" on xFP

Синхронный режим для API источников

Mon, 01 Jan 0001 00:00:00 +0000

Начиная с версии 2.1 в Системе оявился также синхронный режим для API источников.

В синхронном режиме, после успешной передачи файла в обработку, сервер ожидает вердикта по полученному файлу.

В настоящий момент максимальное время ожидания ответа по умолчанию - 1 час.

После получения вердикта сервер отвечает клиенту (на данный момент - всегда кодом 200 OK).

После получения вердикта сервер отвечает клиенту: просто 200 OK

К ответу добавляются заголовки HTTP:

X-Response-Info - содержит вердикт ( Clean | Unknown | Dangerous | Malicious )
X-Response-Desc - содержит подробности, относящиеся к вердикту (на данный момент пустую строку)

Синхронный режим передачи по ICAP

Mon, 01 Jan 0001 00:00:00 +0000

Асинхронный режим передачи по ICAP, в при котором после успешного приема файла в обработку сервер сразу отвечает ICAP 204 No content, с версии 2.1. дополнен:

вариант ответа ICAP 200 OK – рекомендованный метод: снимается требование к клиенту об обязательной передаче ICAP-заголовка Allow: 204.
синхронный режим работы – после успешной передачи файла в обработку, сервер ожидает вердикта по полученному файлу. Максимальное время ожидания ответа по умолчанию - 1 час.

После получения вердикта сервер отвечает клиенту

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

Mon, 01 Jan 0001 00:00:00 +0000

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):

Копирование источника

Mon, 01 Jan 0001 00:00:00 +0000

Для создания нового источника на основе ранее созданного предназначена пиктограмма "" копировать.

Новая страница будет содержать полную копию клонируемого источника с указанием в конце имени "копия (N)", где N – порядковый номер копии.

Редактирование источника

Mon, 01 Jan 0001 00:00:00 +0000

Переход на страницу редактирования источника возможен по ссылке в имени источника или по пиктограмме "" редактировать.

Перегенерирование API-ключа

Mon, 01 Jan 0001 00:00:00 +0000

В списке источников только для API-источников доступна функция "Перегенерировать API-ключ".

При удачной перегенерации Система перезапрашивает данные об источнике для их отображения на странице "Редактирование" в поле "API-ключ".

Удаление источника

Mon, 01 Jan 0001 00:00:00 +0000

Для удаления источника предназначена пиктограмма "" удалить. Удаление источника, включенного в цепочку, приведет к тому, что данные из удаленного источника более не будут поступать и конфигурация цепочки может прийти в неконсистентное состояние.

Расшифровки файлов base64

Mon, 01 Jan 0001 00:00:00 +0000

Для ICAP-источников предусмотрена функция для расшифровки файлов, закодированных в base64.

Например, приходит POST запрос с типом multipart/form-data и строками:

--------1234567890abc — это boundary (разделитель частей multipart-сообщения)
Content-Type: image/jpeg - тип контента
Content-Disposition: attachment; filename="IMG++_++5383.jpeg" - название файла
Content-Transfer-Encoding: base64 - означает что файл закодирован в base64

И далее идет бинарный файл в base64. Этот запрос из источника попадает по ICAP в Систему:

REQMOD icap://icap.example.net/reqmod ICAP/1.0
Host: icap.example.net
User-Agent: ICAP-Client/1.0
Allow: 204
Preview: 0
ncapsulated: req-hdr=0, req-body=304
POST /upload HTTP/1.1
Host: example.com
User-Agent: curl/8.5.0
Accept: ++*++/++*++
Content-Type: multipart/form-data; boundary=----BOUNDARY
Connection: close
304
------BOUNDARY++\++r
Content-Disposition: form-data; name="file";++\++r
filename++*++="x-cp1251''0fDo4fLq8uLuLnBkZg=="++\++r
Content-Type: application/pdf++\++r
Content-Transfer-Encoding: base64++\++r
++\++r
JVBERi0xLjQKJcTl8uXrPg0KMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==++\++r
------BOUNDARY--++\++r
0

Работа с архивами

Mon, 01 Jan 0001 00:00:00 +0000

Поддержка распаковки поступающих архивов форматов RAR, 7z, ZIP управляется в настройках источника с помощью флага "Распаковывать архивы" (реализовано для всех типов источников).

При успешной распаковке архива, содержащиеся в нем файлы передаются в цепочки по одному, сам архив в цепочки не отправляется.

Ограничения по работе с архивами устанавливаются в настройках источника (при создании источника или его редактировании):

Глубина распаковки архивов (по умолчанию = 4);
Лимит файлов в архиве (по умолчанию = 1000);
Максимальное время подбора пароля, в сек. (по умолчанию = 120/сек.).