TgWitness / Documentazione

Cosa è stato testato →

Riferimento / Prove

Telegram · Marcatori temporali

Timestamp RFC 3161 per i checkpoint firmati: cosa viene inviato all’autorità e come viene verificata la risposta.

TgWitness / Documentazione · Prove e verifica

Prove e verifica

TgWitness prepara richieste RFC 3161 e verifica le risposte dell’autorità di marcatura temporale (TSA). Questa procedura manuale non seleziona una TSA né invia dati; la modalità «evidence» esegue entrambe le operazioni secondo una frequenza prestabilita (formato «evidence»). Una richiesta preparata non costituisce ancora una prova di marcatura temporale.

Ciò che le prove dimostrano#

Diagramma di flussoOsservazioni sull’account → Catena SHA-256 e firme Ed25519; Catena SHA-256 e firme Ed25519 → Punto di controllo firmato; Punto di controllo firmato → Hash a byte esatto e nonce casuale; Hash a byte esatto e nonce casuale → Richiesta RFC 3161; Richiesta RFC 3161 → TSA indipendente; TSA indipendente → Risposta firmata della TSA; Punto di controllo firmato → Verifica dei dati, del nonce e della fiducia esplicita nella CA; Risposta firmata della TSA → Verifica dei dati, del nonce e della fiducia esplicita nella CAOsservazionisull’accountCatena SHA-256 e firmeEd25519Punto di controllofirmatoHash a byte esatto enonce casualeRichiesta RFC 3161TSA indipendenteRisposta firmata dellaTSAVerifica dei dati, delnonce e della fiduciaesplicita nella CA
Diagramma sotto forma di testo
  1. Osservazioni sull’account → Catena SHA-256 e firme Ed25519
  2. Catena SHA-256 e firme Ed25519 → Punto di controllo firmato
  3. Punto di controllo firmato → Hash a byte esatto e nonce casuale
  4. Hash a byte esatto e nonce casuale → Richiesta RFC 3161
  5. Richiesta RFC 3161 → TSA indipendente
  6. TSA indipendente → Risposta firmata della TSA
  7. Punto di controllo firmato → Verifica dei dati, del nonce e della fiducia esplicita nella CA
  8. Risposta firmata della TSA → Verifica dei dati, del nonce e della fiducia esplicita nella CA

La firma del collettore associa i record alla propria chiave. Una risposta TSA attendibile può stabilire che un particolare checkpoint esistesse all’ora indicata dalla TSA. Il checkpoint può quindi associare il prefisso del giornale. Questo limite temporale superiore si applica a quel prefisso confermato; le singole azioni di Telegram mantengono i tempi degli eventi registrati.

Procedura#

Il verificatore del registro segnala i passi indietro e i valori observed_at non analizzabili in chronology, se presenti, e include un avviso nell’output del comando. Esso mantiene i timestamp firmati e ne verifica comunque le firme. Un passo indietro può derivare da una correzione dell’orologio, quindi è necessario verificarlo con i registri dell’orologio dell’host. Il tempo indipendente proviene da timestamp esterni verificati, dai post dei testimoni letti dalla loro pagina pubblica su t.me e dai round drand; l’opzione --strict regola il pinning dei firmatari e i formati supportati.

I valori drand registrati vengono sottoposti offline a controlli di autoconsistenza strutturale e di hash. --check-drand confronta i round registrati selezionati con le risposte dei relay HTTPS; il risultato indica quanti round sono stati confrontati e quali relay hanno risposto, mentre i round confrontati forniscono il limite temporale inferiore autenticato.

  1. Conservare l’impronta digitale della chiave del collettore tramite un canale affidabile separato; essa identifica il collettore indipendentemente dal file ZIP esaminato.
  2. In Esportazioni → Prepara richiesta di timestamp, scarichi il file ZIP della richiesta relativo all’area di lavoro selezionata. Estragga i file checkpoint.json, timestamp.tsq, SHA256SUMS e README.txt. Non modifichi i byte di checkpoint.
  3. Scegliete un TSA adeguato all’indagine. Inviate timestamp.tsq utilizzando il relativo metodo documentato, con application/timestamp-query per un servizio HTTP. Salvate la risposta binaria originale come timestamp.tsr, indicando l’endpoint, l’ora di recupero e l’esito della richiesta. La richiesta contiene un hash e un nonce anziché i messaggi; i metadati di rete rivelano comunque la richiesta.
  4. Si ottenga il certificato radice attendibile indipendentemente dalla risposta, oltre a eventuali certificati intermedi necessari. Un certificato presente nella risposta non diventa attendibile semplicemente per il fatto di esservi incluso.
  5. Da un’installazione affidabile di TgWitness, verificare:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

Se serve, aggiungete --intermediates tsa-intermediates.pem. OpenSSL non è necessario: la firma, il riferimento al certificato di firma e la catena sono verificati in Python con la libreria cryptography, lo stesso codice usato da verify.py --tsa-ca. openssl ts -verify resta un secondo controllo indipendente per l’esperto che lo desidera.

  1. Esportare un file ZIP del registro firmato dopo il punto di controllo in modo che includa tale prefisso. Verificare utilizzando l’impronta digitale nota in modo indipendente:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

Ciò dimostra che l’esportazione contiene il prefisso con timestamp. verify.py legge le ricevute con timestamp solo dal file ZIP, dove la modalità prove le memorizza; la risposta manuale viene verificata nel passaggio 5 e copre i record fino a questo checkpoint.

  1. Conservare il file ZIP, il checkpoint, la richiesta, la risposta, la catena di certificati, i risultati della verifica e il registro di trasferimento al di fuori del collettore. Ripetere la verifica al momento della ricezione.

Per preparare una richiesta a partire da un punto di controllo salvato:

python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip

La procedura di preparazione canonizza il JSON e include il checkpoint corrispondente nell’archivio. Utilizzi i byte del checkpoint presenti in tale archivio per la verifica TSA, anche qualora il file di input presentasse spazi bianchi diversi.

Limiti della verifica#

Verifica Comportamento attuale
Dati Il valore SHA-256 dei byte esatti del checkpoint deve corrispondere alla risposta
Richiesta Con --request, la query originale e il nonce vengono verificati
Firma TSA La firma, il certificato di firma e la sua catena fino alla CA indicata sono verificati alla data della marca temporale
Firma del responsabile della raccolta Verificato separatamente dal verificatore del registro tramite una chiave fissata
Revoca La modalità evidence memorizza le prove OCSP/CRL che vengono controllate da verify.py
Invio programmato Modalità "Evidence", attivata per ogni obiettivo di configurazione

--request è tecnicamente facoltativo, ma senza di esso non si può verificare il nonce originale. Per questa procedura completa, request_checked deve essere true nel risultato. Ogni certificato della catena deve essere valido alla data della marca, e il certificato di firma deve servire solo alla marcatura temporale.

La risposta TSA associa i byte del checkpoint inviato al momento specificato. Verificare tale risultato con i record di acquisizione e la verifica dell’ambiente per la modalità selezionata. La modalità evidenza include il TSA qualificato del governo belga http://tsa.belgium.be/connect; le risposte RFC 3161 sono firmate, quindi l’HTTP semplice non le indebolisce). Con la radice di quel provider passata a --tsa-ca, verify.py riporta un timestamp eIDAS qualificato e la sua unità di timestamp; il Regolamento (UE) n. 910/2014, articolo 41, paragrafo 2, presume l’accuratezza del suo tempo e l’integrità dei dati associati.

Revoca del certificato di firma#

Subito dopo ogni risposta, la modalità prove recupera le prove di revoca per il certificato di firma TSA: una risposta OCSP dall’indirizzo OCSP AIA del certificato, altrimenti la CRL dal suo punto di distribuzione (al massimo 4 MiB). Viene memorizzata accanto alla risposta come checkpoint-N.<service>.ocsp o .crl ed esportata insieme ad essa. Un recupero fallito non ritarda mai il timestamp; il record anchor.completed lo elenca come unavailable con la motivazione.

verify.py verifica la firma della risposta OCSP (da parte dell’emittente o di un certificato di risposta che l’emittente ha fornito allo scopo della firma OCSP), l’ID del certificato e lo stato, e che la risposta sia stata emessa in data pari o successiva a genTime o fosse ancora valida in quel momento (nextUpdate). Per una CRL, verifica la firma dell’emittente, la stessa finestra temporale e che il numero di serie non sia presente nell’elenco. Segnala quindi signing certificate not revoked as of <time> (OCSP|CRL), il controllo fallito, oppure revocation not checked (no OCSP/CRL in the archive). Un certificato di firma revocato in data pari o anteriore a genTime non supera la verifica; una revoca successiva viene segnalata come avviso.

Registri delle prove e rinnovo (RFC 4998)#

Un timestamp RFC 3161 è valido solo fintanto che lo sono l’algoritmo hash, la chiave di firma e il certificato della TSA; un caso può tuttavia protrarsi oltre la loro validità. La modalità “Evidence” conserva inoltre un Evidence Record (ERS) RFC 4998 per ciascun checkpoint conservato e lo rinnova.

Ad ogni ciclo di verifica delle prove, i checkpoint privi di registrazione vengono inseriti in un albero hash e ai TSA configurati viene richiesto, in ordine, un timestamp relativo alla radice dell'albero. A ciascun checkpoint viene assegnato checkpoints/anchors/checkpoint-N.ers: un EvidenceRecord il cui ArchiveTimeStampSequence contiene un ArchiveTimeStampChain con un ArchiveTimeStamp che contiene l’albero hash ridotto per quel checkpoint e il token TSA. Un record può elencare gli hash dei checkpoint adiacenti; i validatori come l’EU DSS segnalano questo problema. Un’esportazione ASiC-E contiene inoltre META-INF/evidencerecord.ers con META-INF/ASiCEvidenceRecordManifest.xmlil record di prova relativo agli oggetti dati del contenitore (ETSI EN 319 162-1). Un'esportazione ZIP contiene i record dei checkpoint all'interno di anchors/.

Il rinnovo segue quanto previsto dalla sezione 5 della RFC 4998 e si limita ad aggiungere:

Rinnovo Quando Cosa è stampato
Rinnovo del timbro temporale Il certificato di firma del token più recente scade entro N mesi (valore predefinito: 6), il suo hash di firma è contrassegnato come debole oppure su richiesta Hash del token precedente, stesso algoritmo; il timbro viene aggiunto all'ultima catena
Aggiornamento dell'albero hash L'algoritmo di hash della catena è contrassegnato come debole, oppure su richiesta H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) con un algoritmo più potente (SHA-512 predefinito); viene aggiunta una nuova catena

Ogni rinnovo viene salvato in un nuovo file, checkpoint-N.renewal-K.ers; i file e le catene precedenti rimangono identici byte per byte. La prova risale al primo timestamp solo se ogni anello della catena risulta valido in ordine, quindi è necessario effettuare il rinnovo finché il token più recente è ancora valido: prima che il suo certificato di firma scada, le informazioni sulla revoca scompaiano o il suo algoritmo di hash o di firma venga violato. Un rinnovo successivo aggiunge un timestamp ma non estende la prova precedente.

Il ciclo di background in modalità "evidence" verifica la politica quotidianamente e su richiesta (evidence_record.demand_renewal). Ogni tentativo viene registrato nel giornale come evidence_record.created oppure evidence_record.renewed con il servizio, l’ora, l’algoritmo hash, la radice dell’albero, l’intervallo del checkpoint, ok ed eventuali errori; i record illeggibili vengono inviati a evidence_record.check_failed. Se un TSA fallisce, viene riprovato con il backoff di timbratura del checkpoint, conteggiato separatamente, mentre viene provato il TSA successivo nell’elenco. La politica (months_before_expiry, weak_algorithms, algorithm, stronger_algorithm) è l’ impostazione del profilo evidence_record_policy; il pannello non dispone ancora di alcun controllo su di essa.

Il collettore verifica ogni nuovo record confrontandolo con il relativo checkpoint e con la firma della TSA prima di scriverlo. Il verify.py verifica ogni record in un’esportazione: alberi di hash, token, ordine delle catene e dei rinnovi, e riporta l’ora comprovata più recente e lo stato del timbro più recente. EU DSS legge gli stessi record con il checkpoint come dati separati.

Il regolamento (UE) 2024/1183 (eIDAS 2.0) ha integrato l’archiviazione elettronica qualificata e i registri elettronici qualificati nel regolamento (UE) n. 910/2014. TgWitness registra i dati in formati standard, ma non è un servizio di fiducia; il suo archivio e il suo registro non hanno uno status qualificato. Un fornitore qualificato dovrebbe, tra le altre cose:

  • Archiviazione (articoli 45i e 45j): un prestatore di servizi di fiducia qualificato che conserva i dati per il periodo di conservazione previsto dalla legge o dal contratto, in forma durevole e leggibile oltre il periodo di validità tecnologica e protetta da perdita e alterazione, con un rapporto automatizzato sull’integrità destinato alle parti affidanti autorizzate, dall’inizio della conservazione fino al recupero. L’articolo 45i, paragrafo 2, presume l’integrità e l’origine di tale servizio.
  • Registri (articoli 45k e 45l): un registro creato e gestito da uno o più fornitori di servizi fiduciari qualificati che attesta l’origine dei dati, li ordina in modo univoco e cronologico e rende immediatamente rilevabili eventuali modifiche successive. Il giornale TgWitness è concatenato tramite hash e firmato con la chiave del collettore stesso, il che di per sé non lo rende un registro qualificato.
  • Entrambi: lo status di qualificato concesso da un organismo di vigilanza e l’iscrizione in un elenco di soggetti affidabili (articoli 21 e 22), gli obblighi di cui all’articolo 24, la valutazione della conformità almeno ogni 24 mesi (articolo 20) e le norme di riferimento degli atti di esecuzione di cui agli articoli 45j, paragrafo 2, e 45l, paragrafo 2.

I timbri temporali qualificati provenienti da un TSA qualificato (articoli 41 e 42) mantengono la propria presunzione per singolo token; il rinnovo non ne crea una per il documento nel suo complesso.

Registro dei passaggi di consegne#

Registrare l’identificativo del caso, il mittente e il destinatario, l’ora di trasferimento UTC e la relativa fonte, lo scopo, i nomi dei file/i valori SHA-256, l’impronta digitale del collettore, l’intervallo di sequenza, le lacune note, la versione del verificatore e l’esito della verifica. Firmare e conservare in modo indipendente tale registro secondo la procedura della propria organizzazione. In TgWitness non è implementato un sistema di registrazione della custodia multiutente.

Verifica del servizio in tempo reale, 9 novembre 2026#

È stata inviata una richiesta RFC 3161 a ciascun servizio predefinito. Entrambi l’hanno accolta.

Servizio Rispondi Unità di firma Risultato del verificatore
http://tsa.belgium.be/connect Concesso, politica 2.16.56.13.6.3.1.1000 Unità di data e ora 202301 Timbro temporale qualificato eIDAS
https://freetsa.org/tsr Concesso FreeTSA Timestamp RFC 3161

Il certificato di firma belga riporta la dichiarazione di conformità qcStatements e corrisponde all’unità registrata nel verificatore. I test locali utilizzano inoltre una CA/TSA sintetica per verificare il rifiuto di dati modificati, un nonce alterato e una CA errata.

Il 10 novembre 2026 il responder OCSP belga, un certificato di responder delegato, ha risposto "good" per l’unità di timestamp 202301. L’indirizzo OCSP di FreeTSA (porta 2560) non ha risposto entro 40 secondi dall’host di test; è stata invece utilizzata la sua CRL (PEM, 1 KB).