Порядок сбора и передачи данных
Клиентские запросы инициализируют отправление сообщений в DLP-систему. Сообщения формируются в сервисах FM, NM, CVM, DCM, PGS и по REST-протоколу передаются асинхронно в сервис DPS (data protection service). Все сервисы имеют единую точку обработки и отправки сообщений — исходя из данных клиентского запроса, заполняются содержимое.
Описание основных полей представлено в таблицах ниже.
Обязательные запросы
| Имя поля | Пример заполнения | Описание поля |
|---|---|---|
X-Co-File-Name | res.xlsm | Имя и формат файла |
X-Co-File-Type | application/vnd.ms-excel.sheet.macroenabled.12 | Медиатип файла |
X-Co-User-Name | admin@<domain_name> | Имя пользователя, выполняющего операцию |
X-Co-Request-Id | 41f3af16f0594854a8a854b39f4c102e | ID операции |
Необязательные запросы
| Имя поля | Описание поля |
|---|---|
X-Co-Client-Host-Name | Имя хоста пользователя |
X-Co-Client-Ip | IP-адрес хоста пользователя |
X-Co-Request-Method | HTTP-метод в запросе от пользователя (для внутреннего использования) |
X-Co-Request-Uri-Host | Uri-Host, запрашиваемый пользователем (для внутреннего использования) |
X-Co-Request-Uri-Path | Uri-Path, запрашиваемый пользователем (для внутреннего использования) |
Пример запроса
RESPMOD icap://172.17.0.1:1344/echo ICAP/1.0
Allow: 204 # режим нотификации при обработке запроса
Host: 29c14c5a57a3 # адрес клиентского узла (обязательный параметр)
X-Co-File-Name: res.xlsm
X-Co-File-Type: application/vnd.ms-excel.sheet.macroenabled.12
X-Co-User-Name: comar@srv.tacos.devoffice.ru
X-Co-Request-Id: 41f3af16f0594854a8a854b39f4c102e
Encapsulated: res-hdr=0, res-body=96 # список смещений в байтах (обязательный параметр)
HTTP/1.1 200 OK
Content-Length: 12893
Content-Disposition: attachment; filename="res.xlsm"
PK... [бинарные данные файла]
Пример ответа
ICAP/1.0 204 No modifications needed
Date: Tue, 21 Jan 2025 15:13:35 GMT
Encapsulated: null-body=0
ISTag: epoch-1737472415
Service: echo service
X-ICAP-Metadata: lp4buhitjwdf43hojlhr
X-ICAPeg-Shadow-Service: false