evidence-protocol/1.1.0 · atualizado em 9 de jul. de 2026

Evidence verificável

Como registrar um fato de forma datada e consultável para auditorias e incidentes.

Cada registro preserva o que aconteceu, quando e sob qual leitura de risco, protegendo informações sensíveis e mantendo um histórico revisável.

Evidence conecta a defesa aplicada à revisão institucional: é o respaldo para explicar por que uma situação exigiu cuidado especial ou por que uma ação automática foi autorizada.

Selar evidência não é um passo decorativo. Serve para fechar a lacuna entre observação, decisão e responsabilidade operacional.

Checklist

• Selar evidence ao bloquear, limitar ou escalar um incidente.
• Guardar um resumo compreensível para operações e revisão jurídica.
• Vincular o registro ao fluxo ou incidente correspondente.

Início rápido

1. Sele evidence sempre que uma medida alterar o comportamento do sistema.
2. Use um resumo adequado para operadores e revisão institucional.
3. Vincule incident, task ou recurso afetado antes de encerrar o caso.

Fluxo operacional

Capturar

Registre o fato e o contexto mínimo para torná-lo compreensível.

Não confiar em memória ou conversa informal.

Selar

Guarde hash, tempo e referência suficientes para verificar a integridade.

Preservar rastreabilidade e consulta posterior.

Conectar

Relacione a evidence a incidentes, certificados, tasks ou automations.

Evitar provas isoladas sem histórico operacional.

flowchart LR
  S1["Capturar"]
  S2["Selar"]
  S3["Conectar"]
  S1 --> S2
  S2 --> S3

Validadores e verificações

Executam uma leitura contextual desta superfície e devolvem passos sugeridos com foco operacional.

Validar fluxo de evidence

Resume próximos passos e artigos-base para registrar respaldo verificável.

Exemplos

Payload para selar evidence

{
  "summary": "Bloqueo temporal de ruta /api/login por presión coordinada.",
  "sourceModule": "login-shield",
  "riskLevel": "orange",
  "incidentId": "inc_demo_001"
}

Links e referências

Rotas relacionadas

Evidence no workspace Evidence na administração

APIs

/api/adda/v1/evidence/seal
/api/adda/v1/evidence/[id]
/api/adda/v1/incidents

Docs e rotas de apoio

docs/ADDA_EVIDENCE.md
docs/ADDA_API.md

Problemas frequentes

• Guardar evidência sem relação com o fluxo principal dificulta sua recuperação.
• Bloquear sem evidence pode deixar a organização sem respaldo explicável.

Ações sugeridas

• Conecte evidence a certificados ou packs se o caso tiver resultado público.
• Use evidence também para decisões positivas quando forem especialmente sensíveis.

Reason codes úteis

Dicionário de score

severity

Prioridade institucional do sinal na escala ADDA.

action

Próximo passo operacional recomendado pelo motor.

reasonCodes

Motivos explicáveis que justificam a leitura.

Notas do protocolo

• Evidence é a ponte entre operação, auditoria e governança.

Histórico do artigo

9 de jul. de 2026

Foram adicionados quickstart e payload operacional para selagem.