O que é uma cadeia de custódia de evidências de teste?
Uma cadeia de custódia de evidências de teste é um registro que comprova que um resultado de teste e seus arquivos não foram alterados após a execução. O Nexus StudioQA, da Verdict System LLC, a mantém como um livro de registros opcional que permite apenas acréscimos: cada arquivo de uma pasta de evidências recebe um hash SHA-256 e é encadeado ao registro anterior, de modo que uma verificação identifica o primeiro registro alterado.
Última atualização:
Pela equipe do Nexus StudioQA, Verdict System LLC.
Por que uma equipe precisaria disso?
Um teste com falha se transforma em um relatório de defeito, uma decisão de lançamento ou um item de auditoria e, semanas depois, alguém pode perguntar se a captura de tela e o relatório são os mesmos que a execução produziu. Uma pasta em disco não comprova nada por si só: qualquer arquivo nela pode ser editado. Uma cadeia de custódia permite que qualquer pessoa execute um único comando e obtenha um sim ou um não, com a identificação do registro alterado.
Como funciona?
- Um registro é uma pasta de evidências que contém um arquivo metadata.json, como a pasta que uma execução BREACHED gera com seu relatório, captura de tela e registros.
- Cada arquivo da pasta recebe um hash SHA-256, e o hash do registro também inclui o hash do registro anterior. Alterar um byte de um arquivo invalida esse registro e todos os posteriores.
- Os registros ficam em um único livro de registros que permite apenas acréscimos,
evidence/chain-of-custody/ledger.jsonl, junto às evidências e sem nunca ser reduzido. Ele usa apenas o módulo crypto nativo do Node.js e é executado na sua máquina. - A selagem é opcional. Ela começa com a primeira classificação como Defeito real ou Alarme falso no Studio, que entra na cadeia com sua justificativa, ou com
nexus verify --seal. - Sem um livro de registros, a verificação informa UNVERIFIED e falha. Ela nunca informa um OK silencioso, porque a ausência de comprovação não é comprovação.
Como isso aparece em uma execução real?
Esta é a saída do próprio comando do mecanismo para duas pastas de evidências, uma execução BREACHED no Chromium e uma TIMEOUT no Firefox, registradas em 2026-11-06. Entre o terceiro e o quarto comando, uma linha do report.md do TC101 foi editada manualmente.
> nexus verify
🔗 Nexus StudioQA — Evidence Chain of Custody (SHA-256, on-prem)
⚠️ UNVERIFIED — no ledger — run `nexus verify --seal` first (UNVERIFIED, not OK)
> nexus verify --seal
✅ SEALED 2 record(s) → evidence\chain-of-custody\ledger.jsonl
tip: bcc9f551e102aa6b0593bbab23e794d2da62934d58dcd27464fa322962338571
> nexus verify
✅ VERIFIED — verified 2 record(s), all artifacts intact
(report.md of TC101 edited by hand)
> nexus verify
❌ TAMPER DETECTED — evidence altered after sealing at record 0: TC101_chromium_2026-11-06_10-15-02 [BREACHED]
record: TC101 / chromium [BREACHED] — TC101_chromium_2026-11-06_10-15-02 [BREACHED]
A verificação retornou o código de saída 2 enquanto não havia comprovação, 0 quando houve comprovação e 1 ao encontrar a edição, permitindo que uma tarefa de CI falhe em caso de adulteração.
Quais são os quatro estados?
| Estado | O que significa | O que fazer |
|---|---|---|
| UNVERIFIED | Ainda não há livro de registros, então nada pode ser comprovado | Sele ou faça a primeira classificação como Defeito real ou Alarme falso |
| VERIFIED | Todos os registros e arquivos selados correspondem aos seus hashes | Nada |
| TAMPER DETECTED | Um arquivo ou uma linha do livro de registros foi alterado após a selagem; o primeiro registro inválido é identificado | Compare essa pasta com uma cópia confiável |
| PURGED | Uma pasta selada foi removida de propósito, e o livro de registros informa quem a removeu e quando | Nada; o livro de registros ainda comprova qual era o hash |
O que acontece quando as evidências antigas são excluídas?
Antes que o limite de uso de disco, a retenção ou a opção Liberar disco remova uma pasta selada, o mecanismo acrescenta uma entrada PURGE ao livro de registros, identificando quem a removeu e quando. A verificação então informa o registro como PURGED, e não como adulterado. Se o livro de registros não conseguir registrar a entrada PURGE, a pasta é mantida. Armazenamento e manutenção automática explica o limite.
Quais são os limites?
- Isso comprova que os arquivos não foram alterados após a selagem. Não comprova que estavam corretos antes: um registro selado após uma edição sela a edição.
- Apenas registros selados são abrangidos. As evidências gravadas antes da primeira selagem permanecem UNVERIFIED até que você as sele.
- O livro de registros fica no mesmo disco que as evidências. Alguém com permissão de gravação em ambos poderia reconstruir toda a cadeia, então guarde o hash da ponta da cadeia exibido pela selagem em outro lugar, como um chamado ou uma nota de versão, e compare-o depois.
Onde posso ver isso?
A página de Evidências acompanha um teste com falha por todos os arquivos que ele gera, e o glossário define UNVERIFIED e a classificação como Defeito real ou Alarme falso. A avaliação gratuita executa o mesmo mecanismo nos seus próprios testes.