Arquivos Fonte

O serviço Relay inclui funcionalidade para publicar arquivos de origem usados durante a parte de extração de dados de uma votação. Por exemplo, uma votação para ios_messages.messages examinará o arquivo sms.db de um backup do iOS para recuperar os dados da mensagem – usando a publicação do arquivo de origem, o próprio arquivo sms.db será retornado junto com os dados extraídos e quaisquer arquivos anexos relevantes.

Ativando a publicação do arquivo de origem

A publicação do arquivo de origem pode ser habilitada por assinatura, por meio de seu atributo poll_payload ou por meio de uma configuração em nível de chave ou em toda a organização. Todos usam a mesma chave de configuração: publish_source_files

Criando uma assinatura com publicação de arquivo de origem habilitada

curl https://ricloud-api.reincubate.com/subscriptions \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "session": "<session ID>",
  "source": "<child source ID>",
  "poll_payload": {
    "data_types": ["ios_messages.messages"],
    "publish_source_files": true
  }
}'

Configurando a publicação do arquivo de origem no nível da organização

curl https://ricloud-api.reincubate.com/organisation \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "config": {
    "publish_source_files": true
  }
}'

O acima requer uma chave de administração da organização.

Configurando a publicação do arquivo de origem no nível da chave

curl https://ricloud-api.reincubate.com/key \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "config": {
    "publish_source_files": true
  }
}'

As configurações de toda a organização podem ser substituídas por configurações de nível de chave, o que pode ser útil quando os arquivos de origem são de interesse apenas para uso de produção. Da mesma forma, ambos podem ser substituídos pelo parâmetro poll payload – permitindo que você especifique se os arquivos de origem devem ser publicados caso a caso.

Observe que habilitar recursos por meio de organização ou configuração de chave aplicará retroativamente o comportamento alterado às assinaturas existentes.

Trabalhando com resultados de arquivo de origem

Quando a publicação do arquivo de origem está habilitada, a API rastreia todos os arquivos tocados como parte do processo de extração, os publica em seu depósito de armazenamento e cria um objeto de resultado associado à pesquisa atual.

Uma referência aos arquivos de origem relacionados a um determinado conjunto de dados é incluída no atributo de metadata do próprio resultado dos dados. Por exemplo:

{
  "data": [{
    "id": "a1b2c3d4",
    "data_type": "message",
    "conversation_id": "w6x7y8z9",
    "handle": "Pal",
    "type": "SMS",
    "text": "Hi, how’s it going?",
    "attachments": [{
          "type": "image",
          "file_id": "a492be9a8dadabdc774286116232420224f14976",
          "file_path": "Library/SMS/Attachments/de/14/33A09D66-287E-4B64-A874-1A1234BD7E61/IMG_0006.PNG",
          "filename": "IMG_0006.PNG"
    }],
    "group_handles": [
      "Pal",
      "renate@reincubate.com"
    ],
    "from_me": false,
    "deleted": false,
    "date": "2020-01-01T00:00:00.000000Z"
  }],
  "metadata": {
    "count": 1,
    "filters": null,
    "source_files": [{
      "file_id": "3d0d7e5fb2ce288813306e4d4636395e047a3d28",
      "domain": "HomeDomain",
      "file_path": "Library/SMS/sms.db",
      "filename": "sms.db",
      "size": 123456,
      "date_last_modified": "2020-01-02T00:00:00.000000Z"
    }]
  }
}

Assim como acontece com os resultados do arquivo anexo, o file_id de uma entrada do arquivo de origem corresponde ao atributo identifier do resultado ao qual está relacionado. Portanto, este também é o nome do arquivo gravado em seu depósito de armazenamento.