Работа с контейнером данных OzCapsula

Конфигурация Oz API

Основное изменение в работе с API – это новый content type для передачи данных. Контейнер представляет собой бинарный файл, поэтому установите Content-Type = application/octet-stream. Поддержка этого типа добавлена вместе с функциональностью контейнера.

Примеры

POST api/folders:

curl -X POST \
  '{{host}}/api/folders' \
  -H 'Content-Type: application/octet-stream' \
  -H 'X-Forensic-Access-Token: <YOUR_TOKEN>' \
  --data-binary '@/path/to/container.dat'

POST api/instant/folders:

curl -X POST \
  '{{host}}api/instant/folders' \
  -H 'Content-Type: application/octet-stream' \
  -H 'X-Forensic-Access-Token: <YOUR_TOKEN>' \
  --data-binary '@/path/to/container.dat'

Для Instant API также потребуются публичный и приватный ключи. Пути к этим ключам должны быть указаны в переменных OZ_JWT_PRIVATE_KEY_PATH и OZ_JWT_PUBLIC_KEY_PATH в файле конфигурации.

Генерация ключей:

# Generate private key:
openssl ecparam -name secp384r1 -genkey -noout | openssl pkcs8 -topk8 -nocrypt -out ./jwt.key
# Generate public key:
openssl ec -in ./jwt.key -pubout -out ./jwt.pub

Возможные ошибки

Код ошибки	Сообщение	Описание
13	No data container provided	API не получил контейнер
14	Data container unpacking failed Invalid Data Container Invalid signature Invalid SummingHash Invalid or empty Session Token	В контейнере обнаружены ошибки, распаковка невозможна

Получение Session Token

До начала работы с SDK получите session token:

1. (Опционально, только для stateful API) авторизуйтесь с любой ролью, кроме OPERATOR.

2. Вызовите метод GET {{host}}/api/authorize/session_token.

Пример запроса

curl -L 'https://{{host}}/api/authorize/session_token' \
-H 'X-Forensic-Access-Token: <token>' \
-H 'Content-Type: application/json'

Пример ответа

{
    "session_token": "<session_token>"
}