evidence-protocol/1.1.0 · aggiornato il 9 lug 2026

Evidence verificabile

Come registrare un fatto con data e renderlo consultabile per audit e incidenti.

Ogni registrazione conserva cosa è successo, quando e in base a quale valutazione del rischio, proteggendo le informazioni sensibili e mantenendo uno storico riesaminabile.

Evidence collega la difesa applicata alla revisione istituzionale: è il riscontro necessario per spiegare perché una situazione ha richiesto particolare attenzione o perché un'azione automatica è stata autorizzata.

Sigillare una prova non è un passaggio decorativo. Serve a colmare il divario tra osservazione, decisione e responsabilità operativa.

Lista di controllo

• Sigillare evidence quando si blocca, limita o scala un incidente.
• Salvare un riepilogo comprensibile per le operazioni e la revisione legale.
• Collegare la registrazione al flusso o all'incidente corrispondente.

Avvio rapido

1. Sigilla evidence ogni volta che una misura modifica il comportamento del sistema.
2. Usa un riepilogo adatto agli operatori e alla revisione istituzionale.
3. Collega incident, task o risorsa interessata prima di chiudere il caso.

Flusso operativo

Acquisire

Registra il fatto e il contesto minimo necessario per renderlo comprensibile.

Non affidarsi alla memoria o a conversazioni informali.

Sigillare

Salva hash, orario e un riferimento sufficiente per verificare l'integrità.

Preservare tracciabilità e consultazione successiva.

Collegare

Associa evidence a incidenti, certificati, task o automations.

Evitare prove isolate senza una storia operativa.

flowchart LR
  S1["Acquisire"]
  S2["Sigillare"]
  S3["Collegare"]
  S1 --> S2
  S2 --> S3

Validatori e controlli

Eseguono una lettura contestuale di questa superficie e restituiscono passaggi suggeriti con un taglio operativo.

Validare il circuito evidence

Riepiloga i prossimi passi e gli articoli di base per registrare un riscontro verificabile.

Esempi

Payload per sigillare evidence

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

Link e riferimenti

Route correlate

Evidence nel workspace Evidence nell'amministrazione

APIs

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

Docs e route di supporto

docs/ADDA_EVIDENCE.md
docs/ADDA_API.md

Problemi frequenti

• Conservare una prova senza collegarla al flusso principale la rende difficile da recuperare.
• Bloccare senza evidence può lasciare l'organizzazione senza un riscontro spiegabile.

Azioni suggerite

• Collega evidence a certificati o pack se il caso ha un esito pubblico.
• Usa evidence anche per decisioni positive particolarmente sensibili.

Reason code utili

Dizionario degli score

severity

Priorità istituzionale del segnale sulla scala ADDA.

action

Prossimo passo operativo consigliato dal motore.

reasonCodes

Motivi spiegabili che giustificano la valutazione.

Note di protocollo

• Evidence è il ponte tra operazioni, audit e governance.

Cronologia dell'articolo

9 lug 2026

Aggiunti quickstart e payload operativo per la sigillatura.