Registo de auditoria: prova de integridade
GET /audit-log/proof
Gera um pacote ZIP que prova que o registo de auditoria da organização não foi alterado nem apagado e que cada entrada já existia à hora de um carimbo de tempo RFC 3161 externo. O pacote verifica-se fora do EterShield.
Autenticação: apenas sessão de browser. Não aceita chave de API. Papéis permitidos: ADMIN e AUDITOR.
Rate limit: 5 pedidos por minuto por organização.
Query params (opcionais):
| Parâmetro | Tipo | Descrição |
|---|---|---|
fromSeq |
inteiro positivo | Número de sequência da primeira entrada (por omissão, 1) |
toSeq |
inteiro positivo | Limite superior; o intervalo termina na última entrada ancorada que não o ultrapasse (por omissão, a última ancorada) |
Um pacote tem no máximo 50 000 entradas; acima disso, indique um intervalo mais curto.
Respostas:
| Código | Significado |
|---|---|
200 |
application/zip, com Content-Disposition: attachment; filename="etershield-prova-auditoria-<AAAA-MM-DD>-<fromSeq>-<toSeq>.zip" e Cache-Control: no-store |
400 |
fromSeq/toSeq inválidos (não são inteiros positivos, ou fromSeq > toSeq) |
403 |
Sem sessão ou papel não permitido |
409 |
Ainda não há âncora carimbada para a organização; não há nenhuma entrada ancorada no intervalo pedido; ou o intervalo tem mais de 50 000 entradas |
429 |
Limite de 5 pedidos/min excedido |
Conteúdo do ZIP:
| Ficheiro | Conteúdo |
|---|---|
entries.jsonl |
Uma entrada por linha (seq, userId, action, entity, entityId, changes, createdAt, prevHash, selfHash, ...) |
anchors.json |
Âncoras que cobrem o intervalo: raiz, digest, a folha da organização e o caminho Merkle (só hashes; nunca dados de outras organizações) |
anchors/<id>.tsr |
Resposta RFC 3161 de cada âncora |
manifest.json |
Formato etershield-audit-proof/1, organização, intervalo, algoritmos de hash e SHA-256 de cada ficheiro |
README.txt |
Instruções de verificação (PT/EN) |
As âncoras são criadas de hora a hora, por isso o intervalo termina na última entrada já ancorada; as entradas mais recentes ficam para a prova seguinte. Cada geração fica registada no audit log.
Verificação: o verificador público é um único ficheiro Node.js (18+), sem dependências, servido sem sessão em <URL da plataforma>/trust/verify-audit-proof.mjs:
node verify-audit-proof.mjs prova.zip [--ca cacert.pem] [--untrusted tsa.crt] [--json]
Código de saída 0 = verificado, 1 = há problemas, 2 = erro de utilização. Com --ca (requer openssl) valida também as assinaturas da entidade de carimbo de tempo.