OzCapsula Data Container

Configurando Oz API

A principal mudança na interação com a API é que é necessário enviar dados com outro tipo de conteúdo, pois o contêiner de dados é um arquivo binário: Content-Type = application/octet-stream. Foi adicionada compatibilidade com esse tipo de conteúdo, juntamente com a funcionalidade de contêiner.

Além disso, Instant API agora requer as chaves privada e pública do cliente para funcionar. Os caminhos para essas chaves devem ser especificados em OZ_JWT_PRIVATE_KEY_PATH e OZ_JWT_PUBLIC_KEY_PATH no arquivo de configuração.

Para gerá-las, use os comandos listados abaixo.

# Gerar chave privada:
openssl ecparam -name secp384r1 -genkey -noout | openssl pkcs8 -topk8 -nocrypt -out ./jwt.key
# Gerar chave pública:
openssl ec -in ./jwt.key -pubout -out ./jwt.pub

Parâmetros de configuração

Esses parâmetros são obrigatórios para o funcionamento do OzCapsula. Adicione-os ao arquivo de configuração.

OZ_SESSION_TOKEN_LIFETIME=<your_ttl_for_session_token>
OZ_JWT_PRIVATE_KEY_PATH=<jwt_private_key_path>
OZ_JWT_PUBLIC_KEY_PATH=<jwt_public_key_path>
OZ_MALEWICZ_ANALYSIS_ENABLED=true

Exemplos

Observe: atualmente, o contêiner funciona com modo de solicitação única apenas.

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'