Alcune parti di questa pagina sono ancora in inglese: il testo originale in inglese è stato modificato dopo la traduzione.
Riferimento / Prove
Telegram · Formato delle prove
Contenuto del file ZIP firmato, tipi di registrazioni, ricevute di elaborazione, profili degli utenti, copie esterne e verifica offline.
TgWitness conserva le osservazioni di Telegram visibili all’account in un registro firmato. I destinatari possono verificare i record salvati, gli allegati e i rapporti confrontandoli con una chiave di raccolta attendibile, controllare l’ora esterna fornita da una terza parte per l’ultimo record e confrontare il registro con un checkpoint che hanno conservato in precedenza. Questa pagina descrive i formati, i controlli e il materiale da conservare per il passaggio di consegne.
I destinatari possono iniziare con VERIFY.cmd su Windows: il programma richiede il file ZIP originale e l’impronta digitale della chiave ottenuta in modo indipendente, visualizza un risultato corredato di spiegazioni e salva una trascrizione separata della verifica. Consultare i lanciatori di verifica e il runtime portatile per la configurazione e i limiti di affidabilità.
In questa pagina
- Cosa viene firmato
- Confronto tra esportazioni di chat
- Passaggio di consegne dell’indagine
- Estratto del passaggio di consegne
- Rapporti di facile lettura
- Canonizzazione degli eventi
- Semantica degli attori
- Copertura: continuità, lacune e ID non osservati
- Produttore
- Profili delle persone
- Testimone indipendente
- Manifest e checkpoint
- Ambito di verifica
- Allegati
- Raccolta e elaborazione durevoli delle ricevute (0.2)
- Preparazione RFC 3161 e verifica della risposta (0.2)
- Record opzionali in modalità prove: drand e dispositivi Telegram
Che cosa viene firmato#
| Materiale | Protezione | Cosa conservare |
|---|---|---|
| Ogni osservazione del registro, compresi gli eventi operativi | Catena SHA-256 e una firma Ed25519 per ogni evento | events.jsonl originale, l’impronta digitale della chiave attendibile e un punto di controllo conservato |
| Contenuto del file ZIP delle prove | manifest.sig firma il manifesto canonico, che elenca gli hash dei file di contenuto |
Il file ZIP completo, comprensivo di manifesto e firma |
| Allegati conservati | SHA-256 e conteggio dei byte in un evento media.saved firmato; hash del file nel manifesto ZIP firmato |
I byte originali contenuti nel file ZIP verificato |
| Checkpoint | Firma Ed25519 relativa alla lunghezza del registro, all’hash dell’intestazione, alla chiave pubblica e alla data di creazione | Una copia indipendente conservata prima di una modifica contestata |
| Ricevuta di esecuzione | Registro firmato della versione del collector, degli hash dei file sorgente e delle impostazioni iniziali, incluso anche in process.started |
La ricevuta, il registro associato e le prove ambientali relative alla modalità di verifica selezionata |
Rapporti leggibili: report.html e le sue parti, report.json, report.pdf, chat.pdf |
Un sigillo Ed25519 per ogni file sul suo contenuto; anche l’PDF reca una firma standard PDF (vedi . Rapporti leggibili ) | Il file così come ricevuto e l’impronta digitale della chiave attendibile; l’archivio ZIP a cui si riferisce |
| CSV autonomo | Non è presente una firma crittografica autonoma; gli hash degli eventi da soli non sono sufficienti | Si prega di utilizzare il testo esatto contenuto nel file ZIP verificato per il controllo dell’integrità |
| Screenshot, stampe o file PDF generati da un browser | Nessuna firma di TgWitness sul derivato | Conservare il pacchetto originale verificato e documentare le modalità di creazione del derivato |
Il Collector verifica le firme del registro prima di generare ogni formato di esportazione. I report HTML e PDF leggibili recano i propri sigilli; il file CSV autonomo viene verificato come parte di un archivio ZIP firmato. Mantenere l’archivio ZIP per conservare i byte degli allegati e il manifesto, e un punto di controllo separato per verificare il registro rispetto a un limite precedente.
Formati e percorsi di verifica#
La modalità di acquisizione e il formato di output rispondono a domande diverse. La modalità fornisce prove relative alla raccolta e all’ambiente; ciascun formato conserva o presenta una parte di tale registrazione con i controlli indicati di seguito.
| Output | Verifica e utilizzo |
|---|---|
| Prove ZIP | Eventi canonici, manifesto firmato, copertura, voci di custodia, allegati e ricevute esterne disponibili; verificare l’archivio e la modalità di acquisizione selezionata. |
| Contenitore ASiC-E | Il file ZIP contenente le prove come contenitore ETSI ASiC-E (EN 319 162-1) con una voce mimetype e il file META-INF/ASiCManifest.xml, firmato con CAdES utilizzando il certificato proprio dell'area di lavoro a livello B-B, oppure B-T se è attivata la marcatura temporale. I validatori come EU DSS verificano il formato e l’integrità e, poiché il certificato è autoemesso, segnalano l’assenza di un’ancora di fiducia. EU DSS 6.3 con le impostazioni predefinite rifiuta un contenitore con più di 1000 file (“Rilevati troppi file”). verify.py verifica il manifesto Ed25519 e ogni file elencato, i valori SHA-256 presenti in META-INF/ASiCManifest.xml e in un file aggiuntivo ASiCManifestNNN.xml o ASiCEvidenceRecordManifest.xml, e restituisce un errore se è presente una voce in META-INF/ non coperta da nessuno di essi. Non verifica le firme CAdES e lo segnala. |
| Report in formato HTML e JSON | Viste sigillate individualmente con riferimenti alle fonti, elencate anche nel manifesto ZIP. I loro conteggi registrati riassumono i tipi di eventi del registro. |
| Rapporti in formato PDF | Sigillo Ed25519 più una firma PDF di base PAdES sull'intervallo di byte: B-B, oppure B-T con un timestamp della firma quando la funzione di timestamp è attiva. Il verificatore TgWitness utilizza la chiave Ed25519 attendibile; la visualizzazione dell'attendibilità del certificato da parte del visualizzatore costituisce un controllo separato. |
| CSV | Una vista in foglio di calcolo inclusa nel manifesto ZIP. L’escape delle formule protegge l’utilizzo del foglio di calcolo; il testo originale firmato rimane nel registro. |
| JSONL | Record di eventi firmati, inclusi i riferimenti agli allegati. Il file ZIP contenente le prove include inoltre i byte degli allegati conservati. |
| Esportazione delle chat e visualizzazioni compatibili con il desktop | Acquisizione della cronologia e dei record disponibili del registro di amministrazione, con il rendering richiesto e l’archivio firmato. Le versioni salvate del monitoraggio in tempo reale costituiscono un percorso di acquisizione separato. |
| Record multimediali e record contenenti solo hash | I byte salvati vengono confrontati con il loro SHA-256 e il riferimento del messaggio. L’acquisizione solo hash conserva i metadati hash disponibili per un successivo confronto con i byte del file. |
| STIX/MISP e profili delle persone | Osservazioni estratte collegate alla fonte, ID account e corrispondenze analitiche. Le firme dei profili e gli hash dei record possono essere verificati rispetto alle prove originali; la provenienza della cache degli avatar è etichettata separatamente. |
| Estratto del passaggio di consegne | Regole di divulgazione firmate, record invariati e record contrassegnati come ridotti al minimo che conservano hash/firme originali. Utilizzare l’originale conservato per un confronto che richieda campi omessi. |
| Testimone e ricevute temporali | Confini precedenti del registro, continuità e singole affermazioni temporali verificate. Accompagnano i controlli di acquisizione e archiviazione. |
| Consegna protetta da password | Protegge il pacchetto allegato durante il trasferimento. .tgwpw utilizza la crittografia autenticata AES-GCM, compreso un record finale autenticato; il registro allegato conserva le proprie firme e le ricevute di acquisizione. |
Una stampa o una cattura dello schermo costituisce una rappresentazione del materiale firmato. Il relativo ID del rapporto, l’impronta digitale della chiave e il riferimento QR consentono di individuare il file originale ai fini della verifica. Le dichiarazioni di custodia registrano le informazioni relative all’esaminatore incaricato e al trasferimento; i risultati del verificatore e le ricevute di acquisizione vengono conservati come prove separate.
Firme esterne#
Una firma può anche provenire da una chiave che TgWitness non detiene mai, come ad esempio la
firma elettronica qualificata di un investigatore o il sigillo di un’organizzazione. Per quanto riguarda le esportazioni, la
firma esterna su un’esportazione preparata senza password fornisce i byte da firmare: un nuovo
META-INF/ASiCManifestNNN.xml elenco di tutti i file con il relativo SHA-256 per un contenitore ASiC-E
, oppure il nome manifest.json per un ZIP. Il firmatario restituisce un CMS (CAdES)
.p7s, separato o con il contenuto incorporato.
TgWitness controlla che la firma copra esattamente quei byte e la verifica con il certificato del firmatario (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). La catena viene verificata solo rispetto ai certificati radice forniti dall’operatore; la revoca, gli elenchi di fiducia e lo stato qualificato non vengono controllati. Il pannello mostra uno stato per ogni firma: in attesa di firma, allegata e non verificata, verificata, algoritmo non supportato, firma non valida, byte firmati non corrispondenti o certificato non collegato a una radice fornita. La modifica dell’esportazione dopo che i byte sono stati distribuiti imposta tutte le sue firme su «byte firmati non corrispondenti».
Il download con le firme aggiunge le firme e i relativi manifest in META-INF
in un contenitore ASiC-E. Nel caso di un file ZIP, inserisce il file ZIP invariato, i .p7s file e
SIGNATURES.txt all'interno di un ZIP esterno. Le firme non valide e quelle sovrapposte ad altri byte
vengono escluse. Viene inclusa una firma con un algoritmo che TgWitness non è in grado di verificare; il
pannello ne mostra lo stato, così come SIGNATURES.txt nel caso di un file ZIP.
Immagini della chat firmate#
Scaricando il file ZIP contrassegnato nell'anteprima dell'immagine si salvano le pagine in formato PNG, pages.sig.json e
README.txt. Ogni pagina termina con i numeri di registro visualizzati, la chat, il
tempo di rendering, l’impronta digitale della chiave dell’area di lavoro e il comando che la verifica. Il pannello
invia solo lo SHA-256 e i numeri di registro di ciascuna pagina; il server conferma che i registri
appartengano alla chat, firma la dichiarazione (tgwitness-image-attestation-v1) con la
chiave dell’area di lavoro e registra la firma nel registro come export.image_attested.
python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip
Il verificatore controlla la firma, associa ogni file PNG a una pagina firmata e riporta l’
impronta digitale della chiave. --fingerprint Confronta il firmatario con un'impronta digitale ottenuta dal
mittente in modo indipendente. --evidence Legge un file ZIP contenente le prove firmate dello stesso spazio di lavoro e
richiede che ogni registrazione delle immagini sia presente con lo stesso hash. Un pixel modificato,
una dichiarazione modificata o un'altra chiave comportano il fallimento del controllo. Le immagini mostrano le registrazioni salvate nel
layout proprio di TgWitness; non mostrano ciò che Telegram ha visualizzato a chiunque.
Confronto tra esportazioni di chat#
Verificare e confrontare due file ZIP di esportazione delle chat firmati con le impronte digitali dei firmatari conservate in modo indipendente:
python -m tgwitness.verify first.zip --compare second.zip \
--fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
--require e --require-tier non sono ammessi insieme a --compare; verificare il
profilo richiesto per ciascun archivio tramite la relativa verifica.
Quando entrambi gli archivi registrano gli stessi ID numerici di account e chat, i record vengono abbinati
in base all’ID del messaggio. Invariato indica l’uguaglianza del record JSON salvato completo:
testo completo, autore, date, destinatario della risposta, metadati annidati e campi sconosciuti sono tutti
inclusi. L’ordine delle chiavi dell’oggetto JSON non ha importanza; i campi assenti, i valori nulli, i tipi di valore
e l’ordine degli array sì. L’anteprima di 300 caratteri è solo a scopo di visualizzazione. Le voci modificate
indicano il changed_fields di primo livello diverso, comprese le modifiche non visibili in tale anteprima.
Gli ID dei messaggi duplicati vengono scartati anziché sovrascriversi a vicenda durante l’abbinamento.
Una differenza può essere un nome visualizzato modificato, un conteggio delle visualizzazioni, un’annotazione della raccolta o altri metadati di osservazione. Le modifiche su Telegram appaiono come eventi di modifica a sé stanti e la verifica di ciascun archivio indica se tale archivio è intatto. I record non analizzati rimangono nel confronto e vengono confrontati in base alla loro rappresentazione salvata.
In caso di identità di account/chat diverse o mancanti, lo strumento individua le
corrispondenze candidate utilizzando il mittente, il testo completo, l’hash del file, il tipo di file multimediale e una tolleranza temporale di cinque secondi,
e le segnala come Corrispondenti anziché Invariate. I record non analizzati
rimangono senza corrispondenza. Le differenze nei record accoppiati sono elencate in changed,
anche in modalità contenuto. Con --json, matched conta le coppie candidate e
unchanged conta le coppie i cui record completi salvati sono uguali. L’
output esistente changed_fields e quello intero unchanged rimangono compatibili con i
risultati di confronto precedenti. Il formato di archivio e la verifica della firma rimangono invariati.
Passaggio di consegne nell’ambito delle indagini#
- Registrare il riferimento del caso, l’operatore, l’ID numerico dell’account Telegram, le fonti selezionate, la politica di raccolta e il periodo di raccolta nelle note del caso. TgWitness conserva le osservazioni e supporta note e raccolte collegate alle fonti in Case Board. Conservare i registri di trasferimento e custodia insieme al materiale del caso . Verificate la configurazione di raccolta prevista con la procedura di accettazione in tempo reale.
- Conservare in modo indipendente l'impronta digitale della chiave pubblica dell'area di lavoro prima di fare affidamento sulle sue esportazioni. Mantenere attiva la modalità "evidence" (impostazione predefinita) in modo che i checkpoint ricevano le ricevute RFC 3161 e OpenTimestamps. Salvare i checkpoint firmati al di fuori del collettore durante la raccolta. Registrare le interruzioni e i limiti di visibilità dell'account.
- Esportare un file ZIP firmato e conservare la ricevuta di esecuzione firmata. Utilizzare un punto di controllo in corrispondenza o prima del limite del registro esportato. Un punto di controllo successivo può correttamente rifiutare un’esportazione precedente in quanto troppo breve. Le esportazioni includono il registro completo dell’area di lavoro, indipendentemente dai filtri del pannello; si raccomanda di esaminare il materiale prima di condividerlo.
-
Chiedere al destinatario di verificare il file ZIP utilizzando una copia attendibile del verificatore, l’ impronta digitale fornita in modo indipendente e il certificato radice dell’autorità di marcatura temporale ottenuto separatamente. Da un checkout attendibile con il proprio ambiente Python attivo:
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidenceL’impronta digitale e un timestamp verificato dell’ultimo record soddisfano i requisiti minimi per costituire una prova; in caso contrario,
--require evidencetermina con codice 2. Il checkpoint è un controllo di supporto, poiché è firmato con la chiave del collettore. Un output corretto riportakey_pinned: trueecheckpoint_checked: truequando entrambi gli input sono forniti e accettati. Mantenere il risultato della verifica.For a handover requiring the final exported record to be witnessed, use `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`. This refuses an export with an unwitnessed tail. Add `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the witness posts as external time. See the [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).- Registrare lo SHA-256 dell’archivio, il limite di esportazione, la data di trasferimento, il mittente e il
destinatario nel proprio registro di custodia. Mantenere intatto il pacchetto originale e lavorare
sulle copie. Condividere i file di prova anziché la directory dei dati privati dell’applicazione,
che contiene anche sessioni dell’account e segreti di firma.
Per il trasferimento, scegliere un file ZIP AES-256 protetto da password o il contenitore più sicuro
.tgwpw. Il formato ZIP utilizza la derivazione della password a basso costo di WinZip; utilizzare una passphrase lunga e casuale . Il formato.tgwpwutilizza scrypt e AES-256-GCM e si apre con il comandounseal-passworddel verificatore autonomo. La password non viene memorizzata e protegge solo la riservatezza; il destinatario decrittografa l’archivio e verifica l’esportazione firmata al suo interno, che risulta inalterata. - Per applicare un timestamp a un checkpoint al di fuori della modalità di raccolta delle prove, seguire la procedura RFC 3161 e conservare la richiesta, il checkpoint, le informazioni relative alla CA fidata e la risposta verificata dell’autorità. La semplice preparazione di una richiesta non garantisce l’ottenimento di un timestamp.
- Registrare lo SHA-256 dell’archivio, il limite di esportazione, la data di trasferimento, il mittente e il
destinatario nel proprio registro di custodia. Mantenere intatto il pacchetto originale e lavorare
sulle copie. Condividere i file di prova anziché la directory dei dati privati dell’applicazione,
che contiene anche sessioni dell’account e segreti di firma.
Per il trasferimento, scegliere un file ZIP AES-256 protetto da password o il contenitore più sicuro
Per .tgwpw, utilizzare un verificatore ottenuto in modo indipendente e scegliere un nuovo file di output
con l’estensione originale: python verify.py unseal-password export.tgwpw --out evidence.zip.
Il comando richiede la password; --password-stdin legge una riga per l’automazione.
Non sovrascrive mai un file esistente e pubblica il testo in chiaro solo dopo che tutti i record
sono stati autenticati. Eseguire successivamente la normale verifica della firma sul file decrittografato.
Il contenitore utilizza scrypt (N=131072, r=8, p=1, salt da 16 byte; circa 128 MiB di RAM)
e AES-256-GCM con record da 1 MiB e un record finale autenticato. Un record di metadati crittografato
memorizza il nome del file interno, in modo che i contenitori scaricati possano essere rinominati.
Una verifica riuscita attesta l’integrità rispetto alla chiave del collector affidabile e ai confini definiti. Consultare l’ambito di verifica per le ipotesi di affidabilità e i risultati di convalida relativi ai controlli effettuati.
Estratto del passaggio di consegne#
Un file ZIP firmato contiene l’intero registro dell’area di lavoro. Quando un tribunale, un avvocato o un ufficio preposto alla segnalazione di abusi necessita
solo di alcune chat, di un determinato periodo o di determinate persone, la funzione Esportazioni → Estratto di consegna prepara una copia ridotta
(tgwitness-handover-v1) in base alle regole di divulgazione selezionate.
L’operatore specifica lo scopo e sceglie le chat, un periodo facoltativo (UTC), le persone a cui
si riferisce l’estratto, cosa succede a tutti gli altri (visualizzati, sostituiti da pseudonimi P01, P02… oppure omessi
), quali testi dei messaggi vengono mantenuti, quali allegati e foto del profilo vengono inclusi e se
i numeri di telefono e gli indirizzi e-mail presenti nei testi vengono mascherati. Lo scopo e queste regole sono riportati nel
manifesto firmato e nel rapporto; il registro registra «handover.exported» con l’accesso che
lo ha preparato e lo SHA-256 del file, non il contenuto.
verify.py verifica un estratto in due modi. Un record indicato come invariato viene verificato integralmente: il suo
contenuto viene confrontato con il relativo hash, la firma Ed25519 e il collegamento a un predecessore incluso. Un
record ridotto al minimo conserva l’hash e la firma originali, quindi la firma risulta ancora valida, ma i
campi omessi non possono essere ricalcolati a partire da essa; il record indica cosa è stato omesso e il rapporto
lo contrassegna. I record di servizio a livello di account (avvii e arresti, lacune di copertura, avvisi relativi a connessione, rete e archiviazione,
modifiche all’ambito e alle impostazioni) conservano solo i campi elencati per la loro tipologia: gli elenchi di chat al loro interno vengono ridotti alle
e i relativi totali vengono ricalcolati; una lacuna di sondaggio in tempo reale in una chat al di fuori della selezione comporta la perdita di quella chat, del numero dei suoi messaggi
e dell’account testimone; in una chat di sondaggio selezionata, l’account testimone viene sostituito dal proprio pseudonimo a meno che
non vengano mostrati tutti i partecipanti o si tratti di una delle persone selezionate. Il manifesto indica la lunghezza del registro e l’intestazione con la firma del raccoglitore su tale
intestazione, e conta i record esclusi; il file `coverage.json` descrive le chat selezionate. I nuovi estratti contengono anche
il file `proofs.jsonl`: per ogni record incluso e per l’intestazione del registro, il percorso Merkle dall’
hash originale del record alla radice del registro indicata nel manifesto firmato. verify.py verifica ogni
percorso, in modo che ogni record risulti appartenere allo stesso giornale di quella lunghezza e con quell’intestazione, senza il
giornale completo; un estratto di 100 messaggi viene verificato in circa un secondo, indipendentemente dalle dimensioni del giornale.
--range=CHAT:FROM-TO conferma inoltre che i messaggi da FROM a TO di una chat siano presenti nell’estratto
e riporta quanti record sono stati verificati per essi. I nomi all’interno dei
nomi dei file non vengono rilevati. Controllare i file finali prima di condividerli: il testo libero, i nomi dei file e gli
allegati selezionati possono comunque identificare le persone. Conservare il file ZIP completo e firmato: l’estratto è una divulgazione, non un sostituto.
Rapporti di facile lettura#
Le prove firmate, i trasferimenti e gli archivi ZIP delle chat contengono report leggibili in formato HTML e JSON, oltre a
file PDF quando i font richiesti sono disponibili, nella lingua selezionata per il report. Ogni
report è sigillato con la chiave Ed25519 dell’area di lavoro e può essere verificato separatamente: `
python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`.
report.html/chat.html: l’istruzione di sigillatura (tgwitness-report-seal-v1) chiude il file e firma il SHA-256 di ogni byte che lo precede. I registri e le chat di grandi dimensioni vengono suddivisi in parti di dimensione configurabile (Impostazioni report, da 500 a 100.000 record; 5.000 per impostazione predefinita):records/records-0001.htmlomessages/messages-0001.html, ciascuno sigillato con il proprio numero, l’intervallo e il totale, ed elencato con il proprio SHA-256 nel manifesto firmato. Le serie di heartbeat del collettore vengono visualizzate su un’unica riga, a meno che le impostazioni del report non prevedano che vengano elencate una per una.report.json(tgwitness-report-json-v1, chiaviformat,report,seal): il sigillo firma il SHA-256 del JSON canonico direport, in modo che i dati possano essere letti dai sistemi e dagli script dei tribunali e che sia possibile effettuare una selezione ai fini della protezione dei dati, mantenendo intatto il file firmato.report.pdf/chat.pdf: un documento formale destinato alla stampa e all’archiviazione, firmato due volte sugli stessi byte, l’intero file ad eccezione del valore della firma (/ByteRange). La firma PDF standard è PAdES baseline (ETSI EN 319 142-1,/SubFilter /ETSI.CAdES.detached: CMS con SHA-256 ed ECDSA P-256, certificato di firma v2, senza ora di firma CMS; l’ora dichiarata è/M) a livello B-B, oppure B-T con un timestamp di firma RFC 3161 nel CMS quando la marcatura temporale è attiva e un’ autorità di marcatura temporale risponde lungo il percorso per le richieste al di fuori di Telegram. Utilizza un certificato di firma del documento autoemesso conservato nel vault dell’area di lavoro; il suo numero di serie del soggetto è l’impronta digitale della chiave Ed25519. Il sigillo Ed25519 viaggia all’interno del CMS come attributo non firmato2.25.240684792623320047764573196045913242332e indica lo SHA-256 del certificato con"content": "pdf-byte-range", in modo che la chiave Ed25519 garantisca l’autenticità del certificato. Il certificato non è qualificato: un lettore PDF mostra la firma come valida e il firmatario come sconosciuto o non attendibile finché il certificato non viene considerato attendibile; confrontare invece l’impronta digitale Ed25519 . I PDF in cinese, giapponese e coreano richiedono un font sul server (o inTGWITNESS_FONT_DIR); in assenza di tale font, il file ZIP contiene solo i report HTML e JSON .report.en.html,report.en.pdf/chat.en.html,chat.en.pdf: l’originale inglese dello stesso report quando la lingua del report non è l’inglese, sigillato e firmato allo stesso modo e indicato nel manifesto firmato sottoreport.original. Il report nella lingua scelta si apre con la raccomandazione di depositare l’originale inglese con una traduzione certificata o giurata; vedere Tradurre i report per il tribunale.
In un canale o in un supergruppo, Telegram
numera i messaggi 1, 2, 3… in ordine. Un’esportazione della chat elenca il
primo e l’ultimo numero, quanti ne sono presenti e ogni serie di numeri mancanti in
message-ids.json
, il manifesto e l’intestazione chat.json
, e contrassegna ogni lacuna nel punto in cui si trova nella
trascrizione. verify.py
li ricompila a partire da chat.json
. Un numero mancante indica un messaggio che Telegram
non ha restituito (cancellato prima dell’esportazione o non visibile all’account); nelle chat private e nei
gruppi di base i numeri sono condivisi da tutte le chat dell’account e le lacune non vengono conteggiate.
Dopo aver letto la cronologia, l’esportazione richiede nuovamente a Telegram tutti i numeri mancanti, in base al numero (channels.getMessages, fino a 10.000 numeri, compresi i 1.000 che seguono il primo messaggio, distribuiti uniformemente su tutte le lacune qualora ve ne fossero di più). Il risultato è contenuto message-ids.json e nel rapporto. Una risposta vuota indica che il numero non è disponibile per questo account al momento della nuova verifica; non specifica la causa. Un messaggio restituito durante la nuova verifica viene aggiunto all’esportazione e contrassegnato found_on_recheck.
Quando l’area di lavoro di osservazione ha rilevato messaggi della chat cancellati, mancanti al ricontrollo o modificati, l’esportazione della chat aggiunge journal-changes.jsonl: tali record del registro, ogni versione salvata e la notifica, ciascuno con l’hash e la firma Ed25519 ricevuti nel registro. verify.py Ricalcola l’hash di ogni record, verifica la sua firma rispetto alla chiave di esportazione e confronta il conteggio con il manifesto firmato; l’esportazione delle prove contiene la catena completa di hash. Il rapporto elenca questi messaggi nelle sezioni «Cancellazioni» e «Versioni precedenti».
Ogni rapporto inizia con In breve: un paragrafo, seguito da ciò che il materiale mostra e da ciò che contiene il registro. Il sigillo della pagina stessa diventa ambra quando il browser ha verificato la firma del sigillo, non quella della pagina: un browser non assegna a una pagina i propri byte. Diventa verde solo quando il lettore trascina il file nell’area di verifica alla fine della pagina e ogni byte corrisponde, e solo se la pagina visualizzata è proprio quel file; altrimenti diventa rosso.
Ogni report indica il programma in modo esatto: il commit Git in cui il collector viene eseguito da un checkout o
l’installatore imposta TGWITNESS_COMMIT, e il SHA-256 dei suoi file sorgente (source_tree_sha256,
il JSON canonico del percorso → SHA-256 di ogni file .py, .js, .css, .html e .svg nel
pacchetto), che un checkout di quel commit riproduce a meno che i file non siano stati modificati. Il client Telegram
è denominato in base alla sua libreria, al livello API e al data center. All’inizio dell’osservazione e all’inizio e alla fine di un’esportazione
della chat, il collettore richiede a Telegram l’ora (updates.getState, secondi interi
) e registra l’ora di Telegram meno l’orologio del collettore, con l’incertezza derivante dal
tempo di andata e ritorno; i rapporti riportano queste misurazioni nella sezione «Catena di custodia». Un’esportazione della chat registra inoltre
il momento in cui ha letto la cronologia, oltre alle date dei messaggi.
Visualizzatore di report offline e guida all’archiviazione#
Estrarre l’intero file ZIP prima di aprire chat.html o report.html. Il visualizzatore offre funzioni di ricerca,
filtri, partecipanti, indicatori, dettagli dei record e selezioni di JSON/CSV senza bisogno di un server. Tenere
viewer/ e media/ accanto al report. Le selezioni sono derivati: utilizzare verify.py SELECTION.json
--evidence ARCHIVE.zip per confrontarle con l’archivio firmato.
Il verificatore controlla l’ID del report, la chiave di firma, i limiti dell’archivio e ogni voce selezionata; le voci modificate,
mancanti o duplicate vengono scartate. Le note di selezione e l’ora di creazione rimangono metadati non firmati.
Le lacune nei numeri dei messaggi vengono mostrate solo per un flusso di chat completo, non filtrato e in ordine crescente. Nascondere una categoria o non riuscire a caricare un blocco di dati non deve trasformare una riga omessa in prova della mancanza di un messaggio. L'evidenziazione dei risultati di ricerca opera sul testo in chiaro prima dell'escape «HTML», preservando il markup letterale.
Il browser verifica le firme del manifesto, l’ID del report e la chiave, nonché tutti gli hash dei file elencati. Rifiuta strutture ZIP ambigue o non valide, nomi duplicati e percorsi non sicuri, e limita i file a 256 MiB e il contenuto totale dichiarato a 4 GiB. Per archivi più grandi, utilizzare il verificatore autonomo. Questo controllo del browser integra le verifiche del verificatore relative alle catene di journal e alla semantica dei dati.
README.txt contiene una guida introduttiva, un inventario dei file allineato, istruzioni di verifica e note sul formato dei dati
nella lingua del report, seguite da una guida completa in inglese. SHA256SUMS copre i
file elencati al suo interno, esclusi se stesso, manifest.json e manifest.sig; il manifesto firmato
copre anche SHA256SUMS. Mantenere inalterato il file ZIP originale e salvare i file di lavoro al di fuori della
cartella estratta. I rapporti PDF includono segnalibri di sezione e l’identificazione del caso/rapporto nelle pagine successive.
La chat al momento dell’esportazione#
Un’esportazione della chat registra ciò che Telegram ha indicato riguardo alla chat all’inizio dell’esportazione: le etichette di Telegram
(scam, fake, restricted con le relative motivazioni, verified), i nomi utente, la descrizione, il numero
di membri e amministratori, la discussione collegata, la protezione dei contenuti, se i nuovi membri vedono i messaggi precedenti
e a partire da quale messaggio questo account visualizza la cronologia (available_min_id), la data
del messaggio 1 quando corrisponde alla creazione della chat e il SHA-256 della foto della chat (salvata in media/).
Registra la posizione dell’account esportante nella chat: ruolo, data di iscrizione, chi lo ha invitato e, per un
amministratore, i suoi diritti. Viene invece indicata una richiesta rifiutata da Telegram.
Quando l’account che effettua l’esportazione è un amministratore, l’esportazione legge il log amministrativo della chat (Telegram lo conserva per circa
48 ore) in admin-log.json: cancellazioni e modifiche con il contenuto fornito,
l’account che ha effettuato l’operazione e la data dell’azione di origine. Queste voci integrano le versioni acquisite del diario in tempo reale
e i registri di ricezione delle cancellazioni.
Indicatori#
L’elenco dei rapporti e l’archivio riportano i codici indicators.csv
, indicators.stix.json
(STIX 2.1
)
e indicators.misp.json
(evento MISP
), su cui un ufficio dedicato agli abusi può intervenire nei messaggi registrati:
link e domini (anche nascosti dietro il testo, nei pulsanti e nelle anteprime dei link), indirizzi di criptovalute,
nomi utente e link di invito Telegram
, numeri di telefono, indirizzi e-mail e immagini salvate.
Gli indirizzi Bitcoin, Litecoin, Dogecoin e TRON vengono elencati solo se il loro checksum base58 è valido,
gli indirizzi SegWit se il loro checksum bech32 o bech32m è valido e gli indirizzi TON se il loro CRC
è valido; gli indirizzi EVM e Solana sono contrassegnati come non verificati. Le immagini contengono SHA-256
e un hash percettivo
(dHash, 64 bit) che le copie ricompresse o ridimensionate mantengono pressoché invariato. I report scrivono
indicatori in modo che non si aprano accidentalmente (hxxps[://]example[.]com
); i file mantengono i
valori così come erano. Ogni indicatore è contrassegnato come sconosciuto e non destinato al rilevamento automatico (STIX
,
indicator_types: unknown
, MISP
, to_ids: false
, distribuzione alla propria organizzazione): la sua
presenza nell’elenco indica che un messaggio lo conteneva, non che sia dannoso. Un link il cui testo mostra un
indirizzo diverso da quello a cui rimanda viene segnalato nel rapporto.
I rapporti PDF terminano con una dichiarazione dell’esaminatore da firmare a mano, una checklist per un notaio o un perito giudiziario e un codice QR (presente anche sulla prima pagina) contenente l’ID del rapporto, l’impronta digitale della chiave e il codice SHA-256 dei dati autorevoli, in modo che una stampa possa ricondurre all’archivio di provenienza.
Canonizzazione degli eventi#
L’input dell’hash è costituito esattamente dai seguenti campi:
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
Serializzare utilizzando JSON compatibile con Python in formato UTF-8, con chiavi degli oggetti ordinate, senza escape ASCII, senza spazi bianchi insignificanti e senza valori NaN/infinito:
json.dumps(value, ensure_ascii=False, sort_keys=True,
separators=(",", ":"), allow_nan=False).encode("utf-8")
L’SHA-256 di tali byte costituisce l’hash dell’evento. La firma è generata con Ed25519 sui 32 byte grezzi dell’hash, quindi codificata in base64. Il primo previous_hash è composto da 64 zeri. I numeri di sequenza partono da 1 e aumentano di 1. Tutti gli eventi, compresi quelli operativi, condividono un’unica catena. Non vi è alcuna soppressione delle consegne duplicate: le osservazioni ripetute costituiscono ricevute distinte, non una rivendicazione di azioni distinte su Telegram.
I dati grezzi di Telegram sono stringhe ISO; i campi binari diventano oggetti contenenti
bytes_base64. Il testo del messaggio, le entità, i descrittori multimediali, i metadati di risposta, le reazioni
e le azioni di servizio vengono conservati nei metadati del messaggio grezzo, se presenti. Un messaggio in tempo reale
conserva inoltre l’aggiornamento di Telegram che lo ha consegnato transport_update; quando
tale aggiornamento trasporta lo stesso messaggio raw, il suo message campo è
{"same_as": "raw"} anziché una seconda copia.
observed_at è l'ora UTC in cui il collettore ha scritto il record; source_at è la data
fornita da quell’evento Telegram. Ai record scritti durante la gestione di un aggiornamento in tempo reale si aggiunge
payload.received_atl'ora UTC in cui l'aggiornamento ha raggiunto il collettore, e
payload.processing_delay_ms. Le modifiche in tempo reale mantengono la data di modifica fornita, le
istantanee della cronologia mantengono la data del messaggio con un’ora di osservazione corrente, mentre una normale
notifica di cancellazione registra l’ora di ricezione con una data di origine nulla. Le voci del registro di amministrazione
mantengono separatamente la data dell’azione fornita. L’ordine di ricezione e l’ordine degli eventi di origine
sono linee temporali distinte, con osservazioni dell’orologio e ricevute esterne
disponibili per il confronto.
Semantica degli attori#
L’attribuzione segue la fonte dell’evento. message.new.actor_id e
message.edited.payload.sender_id conservano il mittente del messaggio. Le normali
notifiche message.deleted riportano gli ID dei messaggi e presentano un campo actor nullo;
le voci disponibili nel registro di amministrazione riportano l’azione, l’attore e la data forniti.
I messaggi del servizio di appartenenza conservano il mittente e il tipo di azione, gli aggiornamenti grezzi dei partecipanti
conservano l’actor_id fornito, mentre le istantanee delle reazioni conservano i
conteggi e le identità visibili forniti. Leggere questi record insieme alle versioni acquisite
e alle ricevute di interazione del pannello.
Le notifiche di cancellazione per le chat private e i gruppi ordinari contengono solo gli ID dei messaggi.
Tali chat condividono un’unica sequenza di ID a livello di account, quindi un ID identifica un singolo messaggio di
questo account. Quando un messaggio con quell’ID è stato salvato in precedenza in questo registro, la
cancellazione viene registrata in quella chat come `message.deleted` con `payload.chat_resolution`
che indica il metodo. Gli ID che non sono mai stati salvati vengono conservati come deletion.unscoped: una
notifica di cancellazione effettiva la cui chat non è stata correlata. Ciò è distinto
da message.missing_on_recheck, che registra un risultato di query non disponibile, e
da una lacuna negli ID dei messaggi salvati. I canali e i supergruppi numerano i messaggi per chat e non vengono
mai abbinati in questo modo. Quando il messaggio eliminato è stato inviato dall’account osservato,
payload.deleted_message_was_outgoing è vero; l’autore dell’eliminazione non è ancora specificato.
Un avviso senza ambito mantiene la propria etichetta poiché la chat corrispondente potrebbe trovarsi al di fuori dell’ambito dell’osservazione corrente o non avere una corrispondenza univoca. L’assenza di ricontrollo rimane un’ osservazione separata dalla notifica di cancellazione nei conteggi dei report, nei filtri e nelle etichette. Un successivo recupero cancella lo stato di mancanza corrente, preservando al contempo il precedente controllo non andato a buon fine nella cronologia firmata; le notifiche di cancellazione rimangono un tipo di evento separato.
Gli ID multipli che rimandano alla stessa chat da un’unica notifica vengono raggruppati come
deletion.batch, indipendentemente dal loro numero, con gli ID dei messaggi esattamente come Telegram
li ha inviati e in base a quanti di essi questo account ne aveva inviati. La notifica di Telegram
elenca i messaggi; il registro di amministrazione della chat indica il nome dell’amministratore in carica, dove l’account
può leggerlo. Il collegamento (message.deletion_attributed) viene creato in base a quale dei due eventi si verifica per primo:
un'interrogazione che ha rilevato la voce nel registro dell'amministratore prima della notifica di cancellazione viene abbinata quando la notifica
viene registrata.
Ambito di copertura: continuità, lacune e ID non rilevati#
Ogni file ZIP firmato contiene coverage.json; il report HTML si apre con lo stesso riepilogo, mentre
verify.py lo ricalcola a partire da events.jsonl anziché fare affidamento sul file:
- Osservato continuamente da X a Y. Un periodo inizia con
observation.startede termina con una pausa, un arresto, una connessione Telegram persa, un logout, un avvio del processo senza un arresto ordinato, oppure dopo più di tre minuti senza alcuna registrazione durante l’osservazione (gli heartbeat vengono scritti ogni minuto, quindi il silenzio indica che il processo si è arrestato, si è bloccato o che il computer è entrato in modalità di sospensione). Quando l’intervallo dell’heartbeat viene modificato in Altri strumenti → Parametri, ogni heartbeat lo registra e il silenzio consentito diventa pari a tre intervalli, mai inferiore a tre minuti. - Le lacune indicano l’intervallo di tempo tra i periodi, con la relativa motivazione. Una lacuna ancora aperta all’ultimo
record è contrassegnata con il codice
not_resumed_by_last_record. - ID dei messaggi non rilevati. Per i canali e i supergruppi, che numerano i messaggi per chat, gli ID mancanti tra quelli rilevati sono elencati come intervalli. Vengono segnalati come non rilevati — cancellati, mai consegnati o al di fuori della cronologia salvata — mai come cancellati. Le chat private e i gruppi ordinari condividono una sequenza a livello di account, quindi le lacune all’interno di una di queste chat non hanno alcun significato e non vengono elencate in tale sezione.
- Le segnalazioni di interruzioni a livello di chat (ad esempio quando Telegram richiede il ripristino delle differenze in un canale) vengono conteggiate come note; esse non interrompono la copertura globale.
- Registrazioni delle sessioni. Vengono elencate separatamente le finestre temporali in cui il contatore degli aggiornamenti di Telegram è aumentato senza che alcun aggiornamento
raggiungesse questa sessione (
updates_diverted), in cui questa sessione è stata rimossa dall’elenco delle sessioni di Telegram mentre la sua connessione continuava a funzionare (session_revoked_externally), oppure in cui la risposta a una richiesta di verifica è arrivata solo dalla cronologia (probe_ack_missed_live). Il verificatore riporta inoltre la provenienza della chiave di sessione di Telegram, le altre sessioni attive all’ avvio dell’osservazione, le sessioni aggiunte durante l’osservazione, le notifiche di sicurezza di Telegram (777000), le altre sessioni terminate dall’area di lavoro, i periodi di “solo sessione”, il conteggio delle sonde di verifica e gli aggiornamenti relativi alle chiamate telefoniche. Vedi account. Quando è attiva l’opzione Chat selezionate in modo rigoroso (scope.strictinobservation.started), l’ elenco delle sessioni (tranne quando questa è l’unica sessione o quando la funzione Dispositivi Telegram è attiva), gli avvisi di sicurezza e gli aggiornamenti sulle chiamate telefoniche non vengono raccolti, quindi la loro assenza non significa nulla, e una cancellazione viene associata a una sessione solo se ne è stata eseguita una nei 10 minuti precedenti.
Sequenza di aggiornamento (pts)#
Telegram numera gli aggiornamenti relativi ai messaggi con pts: una sequenza per l’account
(chat private e gruppi di base insieme) e una per ogni canale o supergruppo. Il
collettore registra ogni sequenza ricevuta senza interruzioni come un coverage.sequence
record: il primo e l’ultimo pts, il numero di aggiornamenti di ciascun tipo e se sono
stati inviati in tempo reale o restituiti da getDifference o getChannelDifference. Un’interruzione è un
coverage.gap record, e coverage.gap_closed indica il pts da cui la sequenza
è di nuovo completa.
Una sequenza ininterrotta dimostra che ogni aggiornamento di Telegram numerato in quella sequenza, compreso tra
il primo e l’ultimo, pts , è giunto al client Telegram di questo collezionista. Non dice nulla riguardo ai
contenuti che Telegram non ha mai inviato a questo account, al periodo precedente al primo
pts, né riguardo agli intervalli che il collezionista non ha annotato. Un pts avanzamento che nessun
intervallo registrato o differenza copre viene visualizzato come un'interruzione.
GET /api/continuity risposte relative a un intervallo (since, until, chat_id) se ciascuna
sequenza è ininterrotta ed elenca le interruzioni con le relative motivazioni. verify.py stampa le stesse informazioni
tratte dai record di un archivio alla voce «Continuità della sequenza».
Numeri dei messaggi mancanti (gap_summary)#
For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.
Anteprima. coverage.json → gap_summary Misura i numeri assegnati da Telegram che questo
collettore non ha mai rilevato. Telegram numera i messaggi una volta per canale o supergruppo e una volta per
account tra chat private, bot e gruppi ordinari. Un numero compreso tra due messaggi osservati
è o stato osservato o è mancante; un intervallo contiguo costituisce un'affermazione positiva secondo cui
ogni messaggio in esso numerato è stato osservato. Un'interruzione non indica alcun attore né alcuna ragione.
| Settore | Significato |
|---|---|
status |
on o off quando disattivato in Altri strumenti → Parametri → Analisi delle lacune |
parameters |
I parametri che hanno prodotto il risultato, in modo che possa essere ripetuto |
chats[] |
Una voce per ogni canale o supergruppo, ciascuna numerata separatamente |
account |
La sequenza a livello di account delle chat private, dei bot e dei gruppi normali |
status (per sequenza) |
applicable, oppure not_applicable con reason |
observed_from, observed_to, span |
Primo e ultimo numero osservato e dimensione dell'intervallo |
observed, observed_without_content |
Numeri osservati; quelli noti solo da un record di cancellazione o di ricontrollo |
missing, density, gap_ranges, largest_gap |
Numeri mai osservati, la loro percentuale rispetto all’intervallo, il numero di cicli, il ciclo più lungo |
clusters[] |
Lacune elencate: low, high, missing, e i numeri osservati adiacenti after / before con i relativi orari di osservazione |
service_estimate |
Solo se abilitato: quanti numeri mancanti sarebbero messaggi di servizio in base alla loro percentuale osservata. Mai sottratto da missing |
La validità è ricavata dal registro, non viene mai data per scontata:
- I canali e i supergruppi vengono conteggiati per ogni chat, anche nell’esportazione delle chat selezionate.
Le registrazioni selezionate in base al mittente determinano il conteggio
not_applicable. - La sequenza a livello di account viene misurata solo dal primo all’ultimo messaggio
pervenuto mentre era attiva la raccolta completa dell’account e include chat private, bot,
gruppi ordinari e i messaggi dell’account stesso, senza escludere alcuna chat di questo tipo (
scope.changed). I numeri indicati dadeletion.unscopedvengono considerati osservati senza contenuto. Un’esportazione o un trasferimento di chat selezionate non può misurarla. Se la raccolta dell’intero account è stata disattivata e riattivata, una nota indica che i numeri utilizzati nel frattempo appaiono come lacune. - I messaggi di servizio sono voci del registro con numeri propri, quindi colmano da soli le lacune; la stima facoltativa serve solo a fornire contesto.
verify.py ricalcola gap_summary a partire da events.jsonl con i parametri presenti nel
coverage.json (impostazioni predefinite per gli archivi più vecchi) e
stampa la riga relativa all’intero account nel riepilogo della copertura. Il get_capture_status(MCP e riga di comando) restituisce la stessa misurazione per le chat che un accesso può leggere;
la sequenza a livello di account solo per gli accessi che coprono l’intero spazio di lavoro.
Le osservazioni ripetute di un messaggio di servizio vengono conteggiate una sola volta, e la stima del servizio dell’account utilizza solo i numeri all’interno dell’intervallo misurato. Un ambito applicato deve preservare esplicitamente i messaggi propri dell’account prima che venga abilitata la misurazione a livello di account; la misurazione inizia dai record che contengono tali informazioni. L’intervallo misurato copre l’osservazione in corso e ne viene annotata la ripresa. La query sull’archivio in tempo reale ha un limite di tempo , compresa la scansione del database, e contrassegna una misurazione incompleta come parziale.
Telegram documenta le sequenze separate di ID dei messaggi. Questi numeri descrivono le osservazioni; gli avvisi di cancellazione, i ricontrolli e il registro amministrativo spiegano perché un numero è assente laddove Telegram lo riporta.
Quando Telegram smette di accettare l’account, il record coverage.gap che conclude il monitoraggio
contiene cause (account_banned, account_frozen, account_deleted, session_duplicated,
session_revoked, session_expired, session_ended o not_authorized) e l’Telegram
errore; verify.py indica la causa per cui il periodo termina.
La copertura combina i periodi di osservazione registrati, le interruzioni e gli esiti dei messaggi. Valutarla insieme alle chat selezionate, al periodo e alla politica sugli allegati; ricontrollare i risultati e le lacune registrate per verificare quanto completamente siano stati osservati gli aggiornamenti dell’account.
Produttore#
Il manifesto firmato dei file ZIP contenenti le prove, delle esportazioni delle chat, dei registri dei testimoni e della dichiarazione dei
file di profilo utente contiene producer: software, versione, progetto (PhishDestroy),
pagina iniziale e repository di origine. Il report HTML e il verificatore mostrano questo
record del produttore firmato. Gli hash dei file sorgente identificano l’albero sorgente registrato per il confronto
con un checkout attendibile. La provenienza dell’esecuzione viene verificata separatamente tramite
l’attestato di acquisizione di GitHub o
le misurazioni Intel TDX, ove abilitate. Gli archivi creati prima che
il campo produttore esistesse continuano a essere supportati e vengono identificati come record legacy.
Ogni record observation.started indica anche il client Telegram che ha effettuato il monitoraggio: il suo api_id
(mai l’hash), indipendentemente dal fatto che si tratti di una coppia pubblica integrata o dell’applicazione dell’operatore stesso,
la descrizione del client inviata nella richiesta di connessione di Telegram e il tipo di percorso di connessione
con la modalità IP (senza indirizzo proxy o segreto). Il rapporto e il record custody.json elencano ogni
client e percorso distinti con la data di registrazione, nonché i momenti in cui nessun proxy elencato ha risposto
e il record Telegram ha rilevato l’indirizzo del server. I registri precedenti lo confermano.
Profili delle persone#
Su richiesta, viene generato un file di profilo (tgwitness-dossier-v1, JSON) a partire dai dati già presenti
nel registro relativi a una singola chat; non viene prelevato nulla da Telegram e i contenuti del profilo non vengono mai
scritti nel registro (l’attivazione e la disattivazione dei profili vengono registrate come dossier.changed).
Per ogni persona con un messaggio salvato, vengono elencati il nome e la cronologia dei nomi utente, i contrassegni di Telegram
(bot, truffa, falso, premium, verificato, con restrizioni, eliminato) così come visibili al momento del salvataggio, le
foto identificative, l’hash SHA-256 e l’hash percettivo (pHash, compatibile con imagehash.phash) dell’
avatar dalla cache locale degli avatar con avatar simili, l’attività (primo e ultimo messaggio,
conteggi, condivisioni modificate ed eliminate, messaggi per ora UTC), chi risponde a chi, altre chat
in questo diario in cui la persona ha scritto e i portafogli menzionati (BTC, EVM, TRON, TON, LTC,
DOGE, XMR, SOL; gli indirizzi Base58Check sono convalidati tramite checksum), numeri di telefono, nomi utente e
link, compresi quelli nascosti dietro il testo.
Ogni fatto riporta i record del registro (seq) da cui proviene, mentre record_hashes contiene l’
hash di ciascun record a cui si fa riferimento. La dichiarazione è firmata con la chiave dell’area di lavoro:
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
Verifica la firma, controlla l’esportazione delle prove stessa (firma, catena di hash e file) e che ogni record a cui si fa riferimento esista inalterato in tale esportazione dello stesso spazio di lavoro. Gli hash degli avatar sono contrassegnati come provenienti dalla cache locale (non dai record del registro). Le menzioni sono corrispondenze di pattern e indizi da verificare. I profili vengono attivati per ogni singola chat, possono essere esportati come file ZIP crittografato con AES-256 e protetto da password, e vengono eliminati quando vengono disattivati o quando la chat viene rimossa dalle fonti.
Testimone indipendente#
Un diario del testimone (tgwitness-witness-v1) e i relativi post del canale vengono verificati rispetto a un’
esportazione delle prove con verify.py --witness … --channel …; si veda testimone indipendente.
Con un indirizzo pubblico https://t.me/s/… o https://telegram.me/s/…, il verificatore legge
la data di ciascun post da Telegram, e la prima di tali date di un post all’inizio dell’esportazione
costituisce il tempo esterno per l’ultimo record. Le date provenienti da qualsiasi altra fonte sono metadati forniti.
Manifesto e punti di controllo#
Il file `manifest.json` include il formato, l’ora di esportazione, la chiave pubblica, l’impronta digitale, la lunghezza del registro,
l’hash di testa, l’ambito, il produttore, le limitazioni e l’SHA-256 di ogni elemento di contenuto diverso
dagli stessi manifest.json e manifest.sig.
`manifest.sig` è la firma Ed25519 in base64 sul manifest JSON canonico.
Il verificatore rifiuta elementi inattesi o mancanti, nomi duplicati, file danneggiati,
sequenze o catene interrotte, firme non valide e discrepanze con un checkpoint fornito.
Non estrae mai i percorsi dell’archivio. Limita la dimensione totale dichiarata non compressa a 4 GiB;
--max-gib N consente archivi più grandi creati con un limite aumentato in Altri strumenti → Parametri.
Un archivio di grandi dimensioni viene verificato contemporaneamente da diversi processi: i membri vengono sottoposti a hash in parallelo,
e dopo i primi 5.000 record l’hash del contenuto e la firma di ciascun record vengono verificati
dai processi di lavoro, mentre il processo principale segue la catena, la copertura e i collegamenti
in ordine. --jobs N imposta il numero di processi; l’impostazione predefinita auto utilizza uno per CPU, per un
massimo di 16, mentre --jobs 1 mantiene tutto in un unico processo. Il risultato è lo stesso in entrambi i casi,
e una modifica viene rifiutata con lo stesso messaggio. Gli hash nelle posizioni indicate dai
checkpoint conservati e dagli anchor di timestamp vengono mantenuti durante quel singolo passaggio, quindi ogni anchor viene
confrontato senza leggere nuovamente il journal. Su un computer a 32 thread, un archivio da 10,8 GB con
400.000 record ha richiesto 58,9 s in un unico processo, 15,2 s con 4 processi e 8,4 s con 16; un unico passaggio sui
record in ordine definisce quindi il limite.
Eseguire la verifica dalla versione TgWitness installata o da un checkout revisionato. La copia inclusa nell’archivio supporta l’uso portatile; confrontare tale copia con la propria installazione attendibile prima di eseguirla.
Un checkpoint firma una dichiarazione contenente la chiave pubblica, la lunghezza del registro, l’hash di testa
e l’ora di creazione. Trasporta inoltre l’ultimo round drand che l’area di lavoro ha
recuperato (drand_anchor
): il collettore interroga un relay drand attraverso la
rotta esterna dell’area di lavoro prima di ogni checkpoint periodico, pertanto si applicano Hide IP, proxy e una
rotta esterna disattivata, e il checkpoint stesso non si connette mai all’esterno. Il verificatore può controllare
che un archivio successivo contenga lo stesso prefisso. Con --checkpoint
e --check-drand
conferma quel round con i relay drand e segnala che il checkpoint è stato firmato
non prima dell’ora del round; il round non modifica il livello di garanzia. Conservare
il checkpoint al di fuori del collettore, in modo che la verifica successiva confronti l’archivio con un
riferimento conservato separatamente da esso. La chiave del collettore lo firma, quindi
collega i record ad esso solo se il destinatario lo ha ottenuto prima dell’archivio, attraverso
un altro canale; da solo non soddisfa i requisiti minimi di prova.
Lettura di un risultato di verifica#
Il verificatore riporta separatamente i controlli relativi all’integrità dell’archivio, al “pinning” del firmatario e alla garanzia di autenticità.
Una firma valida dimostra che i byte non sono stati modificati da quando sono stati
firmati. L’operatore fornisce l’impronta digitale della chiave al destinatario tramite un canale
separato. Senza --fingerprint, un archivio integro supera i controlli relativi alla firma e al formato
con signer_pinned: false, e la riga finale inizia con
EVIDENCE: minimum not met · missing: confirmed signer key.
Per una politica di archiviazione locale automatizzata che richiede un firmatario fisso e il minimo necessario per le prove:
python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence
Utilizzare un'impronta digitale conservata tramite il canale fidato del destinatario. Un
testimone fidato può anche fissare il collettore tramite un registro testimoniato coerente; fornire
--witness, --witness-fingerprint e --require-witness. --strict termina con lo
stato 2 per un firmatario non fissato; anche un --require-tier o --require evidence non soddisfatto
termina con lo stato 2. --require evidence richiede --fingerprint e un tempo esterno da una
terza parte che copra l’ultimo record.
Leggere signer_pinned, requirements_met e i risultati di garanzia, non solo il codice di uscita
. L’acquisizione sigillata utilizza invece il proprio
verificatore di attestazione e la politica approvata per autenticare il digest dell’acquisizione.
Ambito di verifica#
La verifica controlla l’archivio e la modalità di raccolta utilizzata per produrlo. Scegliere la modalità il cui limite di affidabilità corrisponda al caso specifico, quindi mantenere i relativi input di verifica.
| Modalità di raccolta | Cosa verifica il verificatore | Dati di verifica e confine di fiducia |
|---|---|---|
| Area di lavoro locale | Registrare le firme, la catena di hash, il manifesto e i byte degli allegati | Impronta digitale del collettore conservata dal destinatario e ora esterna fornita da una terza parte: ricevute verificate secondo RFC 3161 o OpenTimestamps, oppure post dei testimoni letti da t.me. I checkpoint e i record dei testimoni conservati fungono da controlli di supporto |
| Area di lavoro locale con un testimone indipendente | Verifica dell’archivio e corrispondenza con un prefisso di registro precedente conservato dal testimone | Impronta e record del witness; il registro di controllo della chiave del custode indica chi detiene la chiave del witness. Con --channel https://t.me/s/…, le date che Telegram ha assegnato ai post forniscono un tempo esterno |
| Acquisizione di GitHub Actions | Attestazione su GitHub del digest dell’archivio, del flusso di lavoro approvato e dei commit del collettore, del runner ospitato, dell’origine della sessione/chiave recente e dell’integrità interna dell’archivio | Politica dei verificatori fidati, repository dei chiamanti e pacchetto di attestazioni GitHub; la raccolta viene eseguita nell’ambito del flusso di lavoro fissato |
| Implementazione su cloud | Registri relativi al ciclo di vita e all’accesso del provider, stato del firewall e di Cloudflare, oltre al registro di esecuzione firmato dal collettore | Richieste in sola lettura al provider e a Cloudflare; la disponibilità dei singoli controlli dipende dal provider |
| Macchina virtuale riservata Intel TDX | Citare la firma e lo stato della piattaforma, collegandoli alla dichiarazione del collettore, alla composizione e alle misurazioni del sistema operativo | Catena di fiducia Intel e metriche di implementazione previste; conservare i risultati di ogni controllo TDX richiesto |
Nell’acquisizione sigillata, il raccoglitore autorizzato riceve i dati tramite una connessione Telegram autenticata all’interno dell’ambiente verificato. L’attestazione vincola l’archivio a quell’esecuzione, pertanto la verifica copre sia l’acquisizione che la successiva integrità del file. Ciò si basa sul codice approvato e sulla catena di fiducia della piattaforma sopra elencata. La verifica dell’acquisizione su GitHub richiede una sessione creata all’interno dell’esecuzione e rifiuta le acquisizioni da sessioni importate.
La ricevuta di esecuzione registra la versione del collector, gli hash dei file e le impostazioni di avvio. La provenienza da GitHub e le misurazioni TDX forniscono i controlli sull’ambiente; il record di convalida identifica le configurazioni testate.
Da dove provengono i messaggi#
Telegram invia i messaggi a ogni client, comprese le app ufficiali, all’interno di una sessione MTProto. La chiave di autorizzazione della sessione viene negoziata rispetto alla chiave server fissa di Telegram, e ogni aggiornamento arriva crittografato e sottoposto a verifica di integrità tramite tale chiave. Il collettore riceve i messaggi attraverso la sessione autenticata dell’account e registra ogni osservazione nel registro man mano che arriva, indicando la chat, gli identificatori del messaggio e del mittente e la data impostata da Telegram su ciascun messaggio. In GitHub Actions e nelle distribuzioni Intel TDX, l’attestazione associa inoltre quella sessione e la chiave di firma all’esecuzione approvata del collettore.
Il registro registra la provenienza della chiave di autorizzazione. L’accesso tramite telefono o QR,
o un accesso indipendente da un file di sessione, scrive account.authorized con
key_origin: "created"; la raccolta su una chiave .session importata, TData o JSON scrive
imported. Una chiave importata esiste anche indipendentemente dalla sua provenienza. Le distribuzioni certificate
rifiutano le chiavi importate.
L'origine Telegram di un record si basa sulla connessione autenticata dell'account, sui
record di connessione e di acquisizione presenti nel journal, sui frame MTProto acquisiti abbinati alle voci del journal
(tgwitness/forensics/), sulla data Telegram di ciascun
messaggio e, in caso di acquisizione attestata, sull'ambiente di esecuzione verificato. Le firme di archivio
conservano tale registrazione per verifiche successive. I checkpoint conservati fissano i confini precedenti del registro,
i record di copertura mostrano i risultati della raccolta e i timestamp esterni verificati
collocano temporalmente i byte confermati.
Per un’area di lavoro locale, il destinatario fornisce input affidabili relativi al collettore o al testimone. Per l’acquisizione sigillata, la politica di fiducia e l’attestazione legano il digest dell’archivio all’ esecuzione approvata del collettore. Si tratta di percorsi di verifica diversi; segnalare i controlli completati per il percorso selezionato.
Allegati#
I file sono identificati tramite SHA-256 nella cartella media/. Un evento media.saved associa un hash e la lunghezza in byte a un evento di messaggio specifico. I nomi dei file grezzi costituiscono metadati, mai percorsi locali. I byte multimediali vengono scaricati in modo asincrono, pertanto un’eliminazione immediata potrebbe impedire la cattura. La raccolta disabilitata, i file di dimensioni eccessive o sconosciute, gli errori di download e i download interrotti sono visibili come risultati. Un arresto anomalo del processo può lasciare file parziali senza riferimenti; essi non vengono inclusi nelle esportazioni.
L’esportatore ZIP verifica i file multimediali archiviati in base ai loro nomi. Le esportazioni in formato JSONL, CSV e HTML verificano le firme degli eventi ma non includono i byte dei file multimediali. I report derivati sono strumenti di comodità; il file events.jsonl costituisce la rappresentazione ufficiale degli eventi.
Un’esportazione completa della chat salva gli allegati, in base alle impostazioni degli allegati dell’area di lavoro, nella cartella
media/, con nomi del tipo SHA-256. Ogni record di messaggio in chat.json indica il nome del proprio file (file,
file_sha256) o il motivo della sua assenza (file_status), insieme a ciò che il lettore ha visto
intorno al testo: link presenti nel testo, origine dell’inoltro, pulsanti dei bot, firma, visualizzazioni e
il timer di cancellazione automatica. verify.py verifica che ogni file indicato sia presente nel manifesto firmato
sotto quell’hash.
Raccolta duratura e ricevute di elaborazione (0.2)#
Un’operazione relativa a un file multimediale e il relativo evento di invio del messaggio vengono eseguiti in un’unica transazione. Il processo memorizza il descrittore originale del messaggio TL; l’osservazione firmata associa il proprio SHA-256, l’account e la politica relativa alle dimensioni. Il recupero verifica tale associazione prima del download. Non recupera mai il messaggio corrente e sostituisce silenziosamente l’allegato con uno più recente. I processi interrotti vengono riprovati, mentre il fallimento permanente rimane un esito esplicito.
Ogni area di lavoro dispone di un proprio registro e di una propria identità di firma. Un evento process.started include un ID di esecuzione, gli orologi locali, le versioni delle dipendenze, gli hash dei file sorgente, l’account/ambito iniziale, e le impostazioni di acquisizione. Gli heartbeat includono l’ID di esecuzione, il tempo monotono e lo stato della coda. La ricevuta di esecuzione può anche essere scaricata come dichiarazione firmata separatamente. Per la verifica dell’ambiente di esecuzione, abbinarla all’attestazione GitHub o ai controlli TDX descritti in Ambito di verifica.
I checkpoint automatici vengono conservati localmente all’avvio, ogni cinque minuti durante l’ osservazione (Altri strumenti → Parametri → Checkpoint firmato ogni) e all’arresto ordinato. La verifica all’avvio e l’esportazione confrontano il giornale con l’ultimo checkpoint locale conservato. Ciò consente di rilevare un rollback del database quando il checkpoint rimane intatto. La conservazione indipendente mantiene tale riferimento disponibile al di fuori dell’area di lavoro; un timestamp esterno verificato lo fissa ulteriormente nel tempo.
Dopo un riavvio, viene ripristinata la posizione di aggiornamento di Telegram salvata (catch_up_from in observation.started) e vengono richiesti gli aggiornamenti mancati. La posizione salvata copre solo gli aggiornamenti la cui elaborazione è stata completata, pertanto gli aggiornamenti ancora in sospeso al momento della chiusura della connessione o dell’arresto del processo vengono richiesti nuovamente. Una verifica periodica registra message.recovered i messaggi mancanti e message.missing_on_recheck quando Telegram non restituisce più un messaggio salvato; quest’ultimo caso non costituisce un avviso di cancellazione e non indica né chi ha effettuato la cancellazione né l’ora.
Copia e ripristino fuori sede (S3)#
La copia off-site (Impostazioni → Notifiche e copia off-site → Copia off-site, oppure
Altri strumenti → Extra → Prove e backup; disattivata per impostazione predefinita) carica segmenti del registro, file conservati, checkpoint
con i relativi timestamp ed esportazioni di chat completate su un archivio compatibile con S3, crittografati con
AES-256-GCM prima del caricamento utilizzando una chiave conservata nel vault dell’area di lavoro; la conservazione con Object Lock si applica
quando il bucket la supporta. Senza la chiave scaricata, la copia non può essere letta. Ripristina e verifica
con python -m tgwitness.replica restore --key-file KEY.json --out DIR.
Il ripristino richiede una directory ordinaria vuota. I file scaricati e gli oggetti decriptati rimangono in un’area di archiviazione temporanea privata fino a quando l’intero registro e ogni checkpoint conservato non vengono verificati. I percorsi degli oggetti non sicuri, gli intervalli di segmenti incoerenti e i registri più brevi di un checkpoint vengono rifiutati; in caso di verifica fallita, non viene pubblicato alcun file ripristinato. I controlli di conservazione confrontano la modalità Object Lock e la data restituite con la scadenza inviata al momento del caricamento (con una tolleranza di arrotondamento di un secondo). Una scadenza scaduta, non valida o abbreviata non viene considerata verificata. Lo stato riporta l’oggetto campionato di cui è stata riletta la conservazione per quel ciclo di caricamento.
I file multimediali locali mancanti o danneggiati vengono segnalati come errore del ciclo e il cursore multimediale rimane posizionato prima di essi, in modo che il file venga riprovato nel ciclo successivo; i file, i checkpoint e le esportazioni successivi vengono comunque copiati. Il ripristino verifica tutti i riferimenti ai file multimediali conservati confrontandoli con gli hash decrittografati e le dimensioni registrate. I segmenti identici e sovrapposti del registro derivanti da caricamenti interrotti vengono deduplicati; le sovrapposizioni in conflitto vengono respinte. I punti di controllo creati durante un caricamento vengono differiti fino a quando i relativi record del registro non siano stati copiati, in modo che un ciclo completato non pubblichi un punto di controllo prima del relativo registro.
Esportazione in streaming di istantanee#
Le esportazioni in streaming utilizzano uno snapshot di lettura stabile di SQLite. La sua parte iniziale potrebbe risultare più vecchia rispetto al registro attivo corrente al momento del completamento del download. Un checkpoint creato successivamente a tale snapshot può correttamente indicare che l’archivio è più breve; si raccomanda di effettuare il confronto con un checkpoint situato in corrispondenza o prima del prefisso esportato, non con un checkpoint successivo arbitrario.
Preparazione della RFC 3161 e verifica delle risposte (0.2)#
La modalità Evidence invia solo l'hash SHA-256 di ciascun checkpoint firmato alle autorità elencate nella RFC 3161
e ai calendari OpenTimestamps, tramite il percorso dell'area di lavoro e mai tramite MTProxy.
I timestamp sono attivi per impostazione predefinita in ogni obiettivo di configurazione; la modalità Evidence per un caso registra anche il drand.
Le risposte vengono conservate in checkpoints/anchors/, esportate come .tsr e .ots file in anchors/,
e verificati da verify.py (--tsa-ca verifica la firma TSA; conferma le prove OpenTimestamps
con ots upgrade e ots verify).
Un’autorità RFC 3161 che fallisce due volte di seguito attende prima del tentativo successivo: un intervallo, poi
due, quattro e così via fino a sei ore, oppure per il tempo richiesto dal suo Retry-After, fino a un giorno. Un passaggio che
trova solo autorità in attesa non scrive alcun record; altrimenti anchor.completed le elenca sotto
deferred con retry_at. Finché non rispondono nuovamente, il pannello mostra i timestamp come Degraded.
Il pannello prepara un archivio di richieste contenente i byte canonici di checkpoint.json, un’impronta del messaggio SHA-256 e un nonce casuale nel file timestamp.tsq, i checksum e le istruzioni. Non viene effettuata alcuna richiesta di rete; il token restituito dall’autorità per questa richiesta è il timestamp.
python -m tgwitness.anchor verify confronta la risposta con i byte del checkpoint e con la richiesta originale, senza OpenSSL. Il file della CA attendibile va indicato esplicitamente; i certificati inclusi non sono considerati attendibili automaticamente. Nella CLI il controllo della richiesta è facoltativo, quindi conservate la richiesta e passate --request per verificare il nonce. Il risultato indica se è stato controllato. La firma del checkpoint del collector e il registro vanno comunque verificati a parte con l’impronta attendibile del collector.
La verifica controlla la firma della risposta, i byte del checkpoint e, se forniti,
la richiesta originale nell’ambito della fiducia CA specificata. Per i timestamp ottenuti in modalità prove, verify.py controlla anche le prove OCSP o
CRL (revoca del certificato di firma) memorizzate.
Consultare la procedura e i risultati della convalida.
Record opzionali in modalità prove: dispositivi drand e Telegram#
Altri due registri possono essere eseguiti negli stessi passaggi dei timestamp. Entrambi hanno effetto solo quando
la modalità "evidenza" è attiva. La presenza di prove relative a un caso attiva drand; in caso contrario, entrambi partono da zero. È possibile commutarli
da "Altri strumenti" → "Extra" → "Prove e backup" → Altri testimoni · opzionale,
oppure "drand": true e "devices": true in POST /api/evidence. Un errore non blocca l’
altro né i timestamp; il pannello mostra l’ultimo risultato di ciascuno sotto il modulo.
drand
(beacon.drand
). Ogni passaggio scrive l’ultimo round di drand quicknet, la
casualità pubblica della League of Entropy (un round ogni 3 secondi), nel registro: chain
,
round
, randomness
, signature
, round_time
e il relay
che ha risposto. Un round verificato
e imprevedibile fornisce un riferimento temporale inferiore per il materiale successivo collegato tramite hash.
Un timestamp verificato su un checkpoint successivo fornisce un riferimento temporale superiore. Questi controlli
delimitano il materiale collegato. Il collettore interroga prima drand.cloudflare.com
, poi i relay di Protocol Labs, attraverso il percorso dell’area di lavoro, con una richiesta per ogni passaggio.
verify.py
verifica che ogni valore casuale corrisponda a SHA-256
della relativa firma e che il tempo del round
sia corretto, quindi riporta i round, l’intervallo più lungo senza round e di quanto
l’orologio del collettore fosse in ritardo rispetto a drand. --check-drand
confronta i round con un relay Cloudflare e un relay Protocol Labs, tutti quanti o un campione casuale
di 100 in un registro esteso; un round che differisce non supera la verifica.
Dispositivi , Telegram, (account.devices). Ogni ciclo legge le sessioni dell’account con
account.getAuthorizations; l’elenco Telegram visualizzato in Impostazioni → Dispositivi viene registrato:
per intero se è cambiato rispetto al passaggio precedente, con gli hash delle sessioni added e removed,
altrimenti solo il numero e SHA-256. Vengono conservati il modello del dispositivo, la piattaforma, l’app e la versione,
la data di creazione e l’ultima attività, il paese e la regione; gli indirizzi IP no, perché
le esportazioni delle prove esulano dal tuo controllo. La sessione del collettore stesso è sempre attiva, quindi
solo l’attività delle altre sessioni viene considerata come una modifica. verify.py riporta la frequenza con cui l’elenco
è stato registrato e ogni sessione nuova e terminata. Legge l’elenco solo mentre l’osservazione è in corso.
Cosa mostrano: drand ordina i record in base al tempo pubblico, e l’elenco dei dispositivi è la dichiarazione di Telegram tramite il collettore, firmata dal collettore come ogni altro record.
Log di Cloudflare Gateway (cloudflare.gateway_dns). Per un server che effettua la risoluzione tramite
Cloudflare Gateway ( Gateway DNS ), ogni
passaggio copia ciò che il Gateway ha registrato dall’ultima copia: un record per finestra di al massimo tre
ore con from, until, location_id, l’address del server quando è impostato, e il
queries come [at, name, type, rcode, decision, colo], anche quando non ce n’erano. Impostarlo sotto
Log del gateway Cloudflare : account, posizione, indirizzo facoltativo e un token di sola lettura (Account
Analytics Read; Zero Trust PII Read per mantenere un indirizzo di una posizione condivisa). Il pannello li verifica
con una richiesta prima del salvataggio; il token rimane crittografato e non viene mai registrato nel log.
verify.py elenca le finestre, i nomi più ricercati e gli intervalli di tempo non coperti da alcuna copia; un record
il cui conteggio non corrisponde alle sue query viene scartato. Una finestra che contiene più di una pagina di
query in un singolo secondo conserva quella pagina e segnala che il resto è mancante. La copia è
la risposta di Cloudflare tramite il collettore, firmata dal collettore; entro 24 ore chiunque disponga di
un token di sola lettura può confrontarla con quella di Cloudflare.