TgWitness / Documentazione

Cosa è stato testato →

Riferimento / Prove

Telegram · Come funziona la raccolta delle prove

Spiegazione di catena di hash, firme, punti di controllo e testimoni con le formule esatte utilizzate dal verificatore.

TgWitness / Documentazione · Prove e verifica

Prove e verifica

TgWitness conserva ciò che un account di raccolta ha osservato, collega tali osservazioni in un registro firmato e consente a un’altra persona di verificare un’esportazione rispetto a una chiave affidabile, a un tempo esterno fornito da una terza parte e a un checkpoint precedente conservato.

Il sito web della documentazione locale aggiunge esempi interattivi alla pagina /docs/concepts/, un esploratore delle decisioni sui checkpoint alla pagina /docs/witness/ e guide dettagliate per Case Board, la progettazione dei report e gli estratti relativi al passaggio di consegne. Tutti i messaggi di esempio, i conteggi e i ritardi sono fittizi. Gli hash nella sandbox della catena vengono calcolati con SHA-256 nel browser. Nulla viene inviato a Telegram.

In questa pagina

Un messaggio cambia; le osservazioni si accumulano#

Diagramma di sequenzaTelegram → Collector: Nuovo messaggio: Ci vediamo alle 10:00; Collector → Registro firmato: Aggiungi messaggio.new; Telegram → Collector: Modifica: Appuntamento alle 11:00; Collector → Registro firmato: Aggiungere "message.edited"; Telegram → Collector: Avviso di cancellazione; Collector → Registro firmato: Aggiungere il messaggio.cancellato; Nota su Registro firmato: Vengono conservate le osservazioni relative all’originale, alle modifiche e alle cancellazioniTelegramCollectorRegistro firmatoNuovo messaggio: Ci vediamo alle 10:00Aggiungi messaggio.newModifica: Appuntamento alle 11:00Aggiungere "message.edited"Avviso di cancellazioneAggiungere il messaggio.cancellatoVengono conservate le osservazioni relativeall’originale, alle modifiche e alle cancellazioni
Diagramma sotto forma di testo
  1. Telegram → Collector: Nuovo messaggio: Ci vediamo alle 10:00
  2. Collector → Registro firmato: Aggiungi messaggio.new
  3. Telegram → Collector: Modifica: Appuntamento alle 11:00
  4. Collector → Registro firmato: Aggiungere "message.edited"
  5. Telegram → Collector: Avviso di cancellazione
  6. Collector → Registro firmato: Aggiungere il messaggio.cancellato
  7. Nota su Registro firmato: Vengono conservate le osservazioni relative all’originale, alle modifiche e alle cancellazioni

Questa sequenza semplificata presuppone che Telegram abbia consegnato ogni aggiornamento e che l’account selezionato potesse visualizzarlo. Anche gli eventi operativi vengono registrati nel registro. Una notifica di cancellazione non indica chi ha effettuato la cancellazione né l’ora esatta della stessa. Le consegne ripetute costituiscono osservazioni separate; non vi è alcuna eliminazione dei duplicati a livello di registro.

Cosa comprende un hash#

Osservare, codificare, generare l’hash e firmare: ogni nuovo evento include l’hash precedente.

Legga la formula dall’interno verso l’esterno: C trasforma i nove campi in byte esatti; SHA-256 ne produce il digest; «hex» indica il formato esadecimale in cui tale digest viene memorizzato. L’hash precedente è già contenuto nell’evento. «unhex» riconverte l’hash memorizzato nei 32 byte che Ed25519 firma.

Diagramma statico della catena

Sia C(ei) il JSON canonico in formato UTF-8 dei nove campi di evento. Il primo previous_hash è composto da 64 caratteri zero. Ogni record successivo include l’hash esadecimale del record precedente:

hi = hex(SHA256(C(ei)))
σi = Ed25519.Sign(sk,unhex(hi))

La firma copre i 32 byte grezzi del digest. L’input dell’hash contiene esattamente seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload e previous_hash. Le chiavi degli oggetti sono ordinate; gli spazi bianchi e gli escape ASCII sono omessi; i valori NaN e infinito vengono scartati. Si veda la codifica esatta.

Diagramma di flusso64 caratteri zero → Record 1 / hash h1; Record 1 / hash h1 → La registrazione 2 include h1 / hash h2; La registrazione 2 include h1 / hash h2 → Il record 3 include h2 / hash h3; Il record 3 include h2 / hash h3 → Punto di controllo firmato: conteggio 3, intestazione h3 (conservare altrove)64 caratteri zeroRecord 1 / hash h1La registrazione 2include h1 / hash h2Il record 3 include h2/ hash h3Punto di controllofirmato: conteggio 3,intestazione h3conservare altrove
Diagramma sotto forma di testo
  1. 64 caratteri zero → Record 1 / hash h1
  2. Record 1 / hash h1 → La registrazione 2 include h1 / hash h2
  3. La registrazione 2 include h1 / hash h2 → Il record 3 include h2 / hash h3
  4. Il record 3 include h2 / hash h3 → Punto di controllo firmato: conteggio 3, intestazione h3 (conservare altrove)
Modifica al registro fornito Cosa lo rileva
Modificare il record 2 mantenendo il suo hash salvato L’hash dell’evento ricalcolato risulta diverso; la sua firma non copre più l’evento modificato
Ricostruire il record modificato e ogni hash successivo Le firme originali risultano non valide; anche un checkpoint conservato al confine interessato presenta discrepanze
Rimuovere la parte finale, ma mantenere intatto il prefisso rimanente Un punto di controllo precedente, conservato oltre il prefisso fornito, rivela che l’esportazione è troppo breve
Rifirmare un registro sostitutivo con un’altra chiave Un’impronta digitale della chiave, verificata separatamente, respinge l’identità sostitutiva

La modifica di un campo salvato ne altera il digest; il calcolo di nuovi hash non ripristina le firme originali.

Si provi ad applicare la logica al record 2: si modifichi Meet at 11:00 in Meet at 12:00 nell’ evento salvato. Il suo hash ricalcolato non corrisponde più. Il ricalcolo della catena successiva può ripararne i collegamenti, ma non può far sì che le firme originali coprano i nuovi digest. Una modifica osservata su Telegram, al contrario, diventa un nuovo record del registro.

Diagramma delle modifiche statiche

I soli link hash non impediscono a qualcuno di ricalcolare una catena sostitutiva. L’affidabilità deriva dalla verifica delle firme con una chiave considerata affidabile in modo indipendente, dal tempo esterno fornito da una terza parte che fissa l’intestazione del registro e dai riferimenti conservati al di fuori del collettore.

Cosa aggiunge un punto di controllo precedente#

Mantenere il conteggio 3 e l’intestazione h3; un’esportazione successiva di 4 record viene verificata alla posizione 3.

Il riferimento rimane invariato mentre il registro cresce. Se il punto di controllo indica «3 record, intestazione h3», un’esportazione di quattro record può essere accettata in quanto corrisponde a h3 nella posizione 3. La sua intestazione più recente è h4, che dovrebbe risultare diversa. Un’esportazione di soli due record non viene accettata.

Diagramma statico dei punti di controllo

Dopo aver verificato la firma del checkpoint, richiedere:

Nexport ≥ Ncheckpoint   and   hexport[Ncheckpoint] = Hcheckpoint

Un’esportazione può estendersi oltre un checkpoint. Deve coincidere al confine conservato. La chiave del collettore firma il checkpoint, quindi il collettore potrebbe firmarne un altro. Essa vincola i record solo se il destinatario li ha ottenuti prima dell’archiviazione, tramite un altro canale; il requisito minimo per la prova richiede anche un riferimento temporale esterno da parte di una terza parte. Il verificatore effettivo controlla anche la sequenza di ogni evento, il collegamento precedente, l’hash e la firma. Confrontando solo l’intestazione finale archiviata si rischierebbe di trascurare un record interno alterato il cui hash salvato non è stato aggiornato.

Il posto giusto per un testimone#

Diagramma di flussoCollector / sessione dell’account / chiave A → Endpoint di checkpoint in sola lettura; Witness / chiave di raccolta fissata / chiave propria B → Registro delle testimonianze separato e firmato; Witness / chiave di raccolta fissata / chiave propria B → Endpoint di checkpoint in sola lettura (Richiedere una verifica); Endpoint di checkpoint in sola lettura → Witness / chiave di raccolta fissata / chiave propria B (Risposta firmata); Witness / chiave di raccolta fissata / chiave propria B → Canale con post TGW1 firmati (API del bot / token proprio)Host AHost BCollector / sessionedell’account / chiave AEndpoint di checkpoint insola letturaWitness / chiave diraccolta fissata / chiavepropria BRegistro delletestimonianze separato efirmatoCanale con post TGW1firmatiRichiedere una verificaRisposta firmataAPI del bot / token proprio
Diagramma sotto forma di testo
  1. Collector / sessione dell’account / chiave A → Endpoint di checkpoint in sola lettura
  2. Witness / chiave di raccolta fissata / chiave propria B → Registro delle testimonianze separato e firmato
  3. Witness / chiave di raccolta fissata / chiave propria B → Endpoint di checkpoint in sola lettura (Richiedere una verifica)
  4. Endpoint di checkpoint in sola lettura → Witness / chiave di raccolta fissata / chiave propria B (Risposta firmata)
  5. Witness / chiave di raccolta fissata / chiave propria B → Canale con post TGW1 firmati (API del bot / token proprio)

Il witness registra rollback, una testa diversa allo stesso conteggio, chiavi cambiate, risposte non valide e risposte mancanti. Per confermare che ogni record precedente è invariato, confronta l’esportazione con i checkpoint conservati. Un witness su un altro host non condivide un’interruzione dell’host del collector; un operatore separato offre ulteriore indipendenza. Il verificatore controlla che la chiave del witness sia diversa dalla chiave del collector; il registro di controllo della chiave del custode indica chi la detiene. Telegram data ogni post in un canale pubblico, e verify.py --channel https://t.me/s/… legge queste date come tempo esterno.

Il “witness” attesta lo stato del registro segnalato dal “collector”. Utilizzare un test di consegna controllata per verificare quali azioni di Telegram abbiano raggiunto un account di raccolta. Vedere la configurazione del “witness”.

Verifica del funzionamento rispetto ad azioni note#

Si raccomanda di utilizzare un gruppo di controllo, account di raccolta distinti e un indicatore di novità. Si prega di inviare, modificare ed eliminare i messaggi in modo deliberato, verificando l’acquisizione dei dati tra una fase e l’altra. Si raccomanda di definire le azioni previste e un limite temporale prima di esaminare i risultati.

R = |observed∩expected| / |expected|      Δ t = treceipt - taction

Conta solo l’azione prevista; le ricevute duplicate non aumentano il numeratore. Il denominatore deve essere diverso da zero. Una ricevuta mancante non presenta alcun ritardo misurato. Documentare l’incertezza dell’orologio; utilizzare il proprio tempo di azione di cancellazione controllato, poiché Telegram non fornisce l’ora esatta della cancellazione. Un risultato come 5/6 (83,3%) descrive le azioni di test, non la completezza dell’intero traffico di Telegram.

Scegliete un flusso di lavoro#

La guida completa all’indagine segue lo svolgimento di un incidente attraverso un canale, un gruppo, un bot e una chat privata:

  1. Su un account dedicato alla raccolta, attivare la modalità Investigazione per l’intero account e effettuare l’inventario delle chat accessibili. Utilizzare le chat selezionate o una cartella per l’account principale.
  2. Acquisisca istantanee del registro, la cronologia completa per ogni chat e gli allegati conservati.
  3. Conservare le modifiche in tempo reale e qualsiasi interazione intenzionale con i pannelli, corredata delle relative ricevute.
  4. Tracciate gli ID numerici dei mittenti, le relazioni di risposta, le destinazioni ricorrenti e gli hash dei file attraverso i record citati e i profili delle persone.
  5. Aggiungere note e raccolte collegate alle fonti in Case Board. Ricostruire una cronologia incrociata delle chat con sia i timestamp che le lacune esplicite.
  6. Confrontare gli spazi di lavoro di altri account mantenendo separate le rispettive origini e chiavi.
  7. Compilare e verificare i registri firmati, i profili e le esportazioni della cronologia insieme alle note relative al caso.

La guida /docs/cases/ del sito web include una mappa interattiva dei casi e varianti per controversie relative ai bot, messaggi rimossi e partecipanti che cambiano nome. Case Board conserva note e raccolte all’interno di uno spazio di lavoro. Le esportazioni di gruppo raccolgono pacchetti separati di spazi di lavoro; la correlazione tra spazi di lavoro e la linea temporale combinata rimangono di competenza degli analisti.

Convalida completata e lavoro residuo · Esportare e verificare · Inizi con un solo account