← BLOG
19 novembre 2026blockchainauditabilitaenterprise3 min di letturaITENHR

Un hash dimostra i byte, non il significato

La prova di un registro delle decisioni regge solo se, anni dopo, qualcuno riesce a ricostruire esattamente gli stessi byte. Serializzazione canonica, versione dello schema in ogni voce e una verifica indipendente dal vostro codice rendono l'hash riproducibile.

Tre regole in colonna: serializzazione canonica, versione dello schema, verifica indipendente, con un test in CI sotto.

In un registro delle decisioni si calcola l'hash di una voce, lo si ancora, e anni dopo qualcuno lo ricalcola per verificare che nulla sia cambiato. L'ancoraggio è la parte facile. La verifica regge solo se quella persona riesce a ricostruire esattamente gli stessi byte su cui è stato calcolato l'hash all'origine, ed è qui che molti registri si rompono senza che nessuno se ne accorga.

Stessa decisione, due hash

Una funzione di hash non sa che cosa significa una decisione. Vede byte. Serializzate due volte lo stesso oggetto e potete ottenere due sequenze diverse: chiavi in ordine diverso, uno spazio dopo i due punti, un numero scritto 1.0 invece di 1, un orario con o senza millisecondi, una lettera accentata in una forma Unicode diversa. Ogni differenza produce un hash completamente diverso.

Il più delle volte succede senza un bug nel vostro codice. Si aggiorna la libreria di serializzazione e cambiano i default. Si aggiunge un campo alla classe e l'output si sposta. Qualcuno ricalcola l'hash dalla riga del database invece che dal payload originale. Il dato è integro, nessuno l'ha manomesso, e la prova fallisce lo stesso. Peggio: fallisce davanti alla persona per cui il registro è stato costruito.

Tre regole per byte riproducibili

Serializzazione canonica. Si sceglie una codifica e la si documenta: ordine dei campi, scrittura dei numeri, di date e fusi orari, normalizzazione Unicode, codifica dei caratteri. Schemi esistenti come RFC 8785 per il JSON sono un buon punto di partenza. Poi si salvano i byte esatti su cui si è calcolato l'hash, e in verifica si calcola l'hash di quei byte. Mai di una nuova serializzazione di un oggetto caricato da altrove.

Una versione dello schema in ogni voce. I campi cambieranno negli anni. La voce deve dire con quali regole è nata, così chi la legge fra cinque anni sa come interpretarla e quale canonicalizzazione applicare. Le voci vecchie non si riscrivono nel nuovo schema: tengono la loro versione.

Una verifica che non dipenda dal vostro codice. Se solo la vostra applicazione sa riprodurre l'hash, la prova dipende dal fatto che l'applicazione esista ancora e si comporti allo stesso modo. Per una software house .NET significa non affidarsi al serializzatore di default del momento, ma a una specifica scritta abbastanza bene perché qualcuno la reimplementi in un altro linguaggio.

Collaudarla come ogni altro contratto

Tenete nel repository un piccolo insieme di voci di esempio fisse con i loro hash attesi. Fatele girare in CI a ogni build. Se un aggiornamento di libreria o un refactoring cambia anche un solo hash, la build fallisce prima che qualcosa arrivi in produzione. Costa pochi minuti ed è l'unico preavviso che avrete.

Cosa significa per una consegna

L'ancoraggio dimostra che i byte non sono cambiati. Renderli riproducibili è compito vostro, ed è parte della specifica del registro, non un dettaglio d'implementazione. Codifica, versioni dello schema e vettori di test vanno nel pacchetto di consegna.

Come farebbe qualcuno fuori dal vostro team a ricalcolare uno dei vostri hash?