TgWitness / Documentazione

Cosa è stato testato →

Alcune parti di questa pagina sono ancora in inglese: il testo originale in inglese è stato modificato dopo la traduzione.

Riferimento / Raccogli

Telegram · Guida ai pannelli

Tutte le schermate del pannello: chat, diario, fonti, esportazioni, Extra, modalità di protezione e controllo del codice.

TgWitness / Documentazione · Introduzione

Introduzione

Configurazione iniziale e impostazioni · Account · Esportare e verificare · Rapporti sui casi

Cosa fa ogni schermata, cosa scrive nel registro firmato e dove si trova la guida dettagliata. Il pannello mostra un’area di lavoro alla volta: un account Telegram con le proprie fonti, il registro e la chiave di firma. Il selettore dell’account nella barra superiore consente di passare da un’area di lavoro all’altra. L’indirizzo contiene l’area di lavoro (?ws=…); finché l’indirizzo, il selettore e l’account caricato non corrispondono, le azioni rimangono bloccate.

Utilizzare i metodi di raccolta Compare per scegliere tra osservazione in tempo reale, cronologia completa, esportazioni di account/chat recenti e trasferimento di registrazioni salvate. La pagina Esportazioni include lo stesso confronto sopra i controlli di download.

In questa pagina

Orientati#

La barra laterale raggruppa sei sezioni giornaliere: Home, Chat, Registro, Esportazioni, Account e Impostazioni. Le sezioni a cui il tuo accesso non è consentito vengono omesse. La sezione Altri strumenti contiene strumenti di indagine e amministrazione. Apri Aspetto nella parte inferiore della barra laterale per modificare la lingua, il tema, il fuso orario o il livello dell’interfaccia:

Livello Sezioni nella barra laterale
Semplice Le sezioni giornaliere
Standard Inoltre, Case Board, Sources, Access e Documentation nella sezione More tools
Esperto Inoltre: Mappa del sistema, Topologia di rete, Extra, Chiedi all’archivio, Parametri, Account, Registro di sistema e Integrazioni nella sezione Altri strumenti

I nomi delle sezioni rimangono gli stessi a ogni livello. Un livello nasconde solo le sezioni. Una funzionalità nascosta continua a funzionare e il server verifica ogni autorizzazione autonomamente. Livello, lingua, tema e fuso orario vengono salvati per operatore e area di lavoro; consultare le impostazioni.

Utilizza Vai a una sezione nella parte superiore della barra laterale (Ctrl+K, o ⌘K su Mac) per trovare una chat, un parametro o un record del registro tramite #number. I tasti freccia consentono di spostarsi, Invio apre, Esc chiude.

La barra superiore presenta:

  • Notifiche: problemi e modifiche alle chat ricavati dal diario. L’opzione «Segna tutto come letto» azzera il contatore, mentre «Regole di notifica» apre le impostazioni relative alle regole. L’invio a Telegram, Discord o via e-mail viene configurato in Extra → Notifiche.
  • Un menu di stato della raccolta con il controllo di avvio/pausa, le impostazioni di connessione e la diagnostica dello stato di Telegram, l’acquisizione degli eventi, le fonti e la coda degli allegati. Su uno schermo stretto, aprirlo tramite l’icona dell’attività.
  • Lock: chiude il pannello in questo browser. La raccolta continua a funzionare sul server.

La versione e la modalità di protezione si trovano nella sezione Aspetto; vedere le modalità di protezione. Un’installazione apre la schermata Home dopo l’accesso; un collegamento esplicito apre la schermata richiesta. Un revisore con ambito chat apre la schermata Chat. Gli indirizzi /home, /case-board, /pseudo-secret e /network-topology aprono anch’essi le schermate corrispondenti. Gli indirizzi di pagine sconosciute restituiscono un codice di stato HTTP 404 con suggerimenti di pagine correlate.

L’area di lavoro dimostrativa contiene messaggi fittizi e non si connette mai a Telegram. Le azioni che potrebbero modificare un’area di lavoro reale vengono lì bloccate.

La mappa di sistema mostra i percorsi degli account di questa installazione, lo stato del proxy, gli endpoint dei socket, i vault crittografati, i servizi di raccolta prove e le richieste di rete osservate. Selezionare un account per esaminarne il percorso. I servizi disponibili ma disabilitati rimangono visibili.

Inizia da qui#

La panoramica cancella il grafico e il riepilogo specifici dell'account quando si cambia account o si effettua nuovamente l'accesso. Il caricamento, le letture non riuscite e un periodo in cui non sono stati salvati record hanno stati distinti. L'opzione Riprova ripete la lettura non riuscita; se il server richiede un'attesa, viene visualizzata l'ora del prossimo tentativo. Un aggiornamento non riuscito mantiene gli ultimi dati corretti per lo stesso spazio di lavoro e li contrassegna con l'ora dell'ultimo aggiornamento.

Per ogni account collegato vengono visualizzati separatamente lo heartbeat del collector e l'ultimo evento ricevuto . Il primo indica l'attività del collector; il secondo è l'ultimo aggiornamento di Telegram ricevuto. Una fonte inattiva può mantenere invariato il secondo valore mentre il collector continua a funzionare. Apri il menu "collection-status" per la diagnostica relativa a connessione, acquisizione, fonte e allegati.

Choose a task. Export my account downloads what the account can read now. Follow an investigation records new messages, observed edits and deletion notices from the chats you choose. While observation is paused, Chats, Journal and Sources show the setup card: connect the account, choose sources, start observation. With the goal Evidence for a case, or in the Witnessed, Case preparation, GitHub-verified or Maximum protection mode, starting observation first reads Telegram's session list (not while Strict: read only the chosen chats is on). If other sessions are signed in, the panel names their number and offers Start anyway or Open Sessions of this account. Other goals and modes start without that question. The goal question stays on this page until you answer or skip it. A new workspace opens the first setup instead.

Chat#

Conversazioni salvate, di default in sola lettura.

Le righe della chat mostrano lo stato della raccolta, i download di file in sospeso e falliti, il caricamento iniziale della cronologia e le restrizioni riportate nei metadati delle finestre di dialogo di Telegram. Uno stato di accesso perso o non confermato non indica un blocco dei contenuti. Apri Filtri per selezionare questi stati o ordina in base alla coda dei file; la selezione rimane nell'URL quando la pagina viene ricaricata. Il filtro Riprova individua i caricamenti iniziali delle chat in attesa dopo un errore. Il relativo badge mostra il tipo di errore e, durante la raccolta, l’ora del prossimo tentativo. La pagina Home riassume quanti caricamenti necessitano di un altro tentativo. La raccolta in pausa mantiene i processi in attesa fino alla ripresa.

In Simple mode Home also shows Can be handed to a court: yes or no · missing: …. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs verify.py with --tsa-ca and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here.

Le voci di registro con allegati conservati mostrano il tipo, il nome e la dimensione in byte rilevati. Anche i nuovi risultati dei download conservano il tipo di file multimediale e la durata, quando Telegram li fornisce. I record firmati più vecchi rimangono invariati; i metadati mancanti non vengono ricostruiti.

  • Cerca nell'elenco per nome o ID. Vengono individuate corrispondenze con più parole in qualsiasi ordine, compresa la combinazione di un nome e una parte di un ID. Il pulsante + apre le opzioni Aggiungi una chat o un canale (aggiunge o rimuove le chat seguite), Apri link Telegram e Pseudo-segreto · Avvia chat. Apri link Telegram accetta un nome utente o un link di invito e salva un'anteprima nel diario; una ricerca di un @nomeutente o di un link t.me senza risultati offre la stessa funzione. Partecipa / apri e osserva ti fa entrare nella chat e la aggiunge alle tue fonti; l'apertura di un bot gli invia il comando /start.
  • Le chat pseudo-segrete compaiono nello stesso elenco, di colore verde con un lucchetto, e si aprono in modalità pseudo-segreta. Quando l’osservazione è disattivata, l’elenco mostra la voce Osservazione disattivata con il pulsante Avvia osservazione.
  • I filtri rapidi sono schede disposte su un’unica riga: Tutti, Pseudo-segreti, Priorità, Modifiche (modifiche salvate o avvisi di cancellazione) e Da controllare (accesso perso o non confermato, messaggi non trovati al ricontrollo, file multimediali non validi, tentativi di recupero della cronologia o restrizioni di Telegram). Le schede vuote vengono nascoste. I conteggi tengono conto del filtro di ricerca e di tipo; un filtro rapido sostituisce il filtro di stato. Queste impostazioni rimangono nell’URL in caso di ricaricamento e durante la navigazione con i pulsanti Indietro/Avanti. La scheda Necessita di attenzione non contrassegna un messaggio come eliminato. Tipo, stato e ordinamento personalizzato rimangono visibili come schede rimovibili quando la sezione Filtri è compressa.
  • Gli elenchi di grandi dimensioni mostrano 80 risultati alla volta; il pulsante Mostra altro aggiunge i successivi 80. La chat aperta e la riga selezionata rimangono disponibili quando corrispondono a un risultato, anche al di fuori di quel gruppo. Il contatore indica il numero di chat visualizzate rispetto al totale dei risultati. La ricerca copre l'intero elenco, comprese le chat che non sono state ancora visualizzate.
  • Dalla schermata di ricerca, il tasto ↓ porta al primo risultato, il tasto ↑ all'ultimo risultato visualizzato, mentre il tasto Invio apre il primo risultato corrispondente. All'interno dell'elenco, i tasti ↑/↓ e Home/Fine spostano il focus; il tasto Invio apre la chat selezionata. Il tasto Esc riporta alla schermata di ricerca, dove premendolo nuovamente si cancella la query. L'opzione Cancella filtri azzera l'elenco senza modificare la raccolta né la conversazione aperta.
  • L’intestazione della chat conta i messaggi eliminati, testo mantenuto, eliminati prima del salvataggio e non trovati al ricontrollo. Ogni conteggio è un pulsante che mostra solo quei messaggi; premetelo di nuovo per vederli tutti. Eliminato e Non trovato al secondo controllo su un messaggio aprono una nota con l’ora e ciò che è stato osservato. L’elenco delle chat e le notifiche usano le stesse definizioni. Un messaggio eliminato è rosso e conserva il testo salvato; un messaggio modificato conserva ogni versione salvata.
  • La ricerca dei messaggi salvati analizza l'intera cronologia conservata, comprese le precedenti versioni testuali. Anche i filtri relativi a messaggi eliminati, modificati, file multimediali e autori coprono l'intera cronologia conservata. Il messaggio Non trovato in caso di nuova ricerca è distinto dalle notifiche di eliminazione ricevute. La ricerca non richiede i messaggi a Telegram; utilizzare Carica cronologia per recuperarne altri. Una corrispondenza in una versione precedente apre le versioni salvate con i relativi link al diario. La versione visualizzata identifica il record utilizzato per il messaggio e il relativo segnalibro; una risposta della cronologia precedente non può sostituire una modifica in tempo reale più recente sullo schermo.
  • Tra i messaggi la chat mostra due tipi di indicatori di lacuna. Numeri dei messaggi non rilevati elenca i numeri di cui il registro non ha traccia, solo in canali e supergruppi: le altre chat condividono un’unica numerazione dell’account, quindi lì un salto non dice nulla della chat. Lacuna nella copertura segna un periodo tra un’interruzione registrata e la successiva ripresa registrata, con il motivo se il registro lo riporta. Gli indicatori compaiono con tutti i messaggi visibili e si nascondono mentre è attivo un filtro dei messaggi.
  • Il pulsante Crea report sopra i messaggi apre Report Studio con questa chat selezionata. Lo stesso pulsante nella scheda personale di un autore seleziona la chat e quell'autore. Entrambe le operazioni modificano solo la bozza; salvala prima di esportarla.
  • Cliccando sul nome di un autore si apre una scheda personale accanto ai messaggi: profilo salvato, biografia, foto del profilo, regali, link, numero di messaggi e la cronologia delle attività con i relativi post del diario, oltre a Aggiorna profilo e Rapporto di compilazione. Chiudi, Esc oppure un'altra chat chiude la scheda; la chat mantiene la propria posizione. Ritmo nella scheda sono riportati i dati relativi ai messaggi salvati dall'autore in questa chat in UTC: giorni di attività, inizio dopo 6 ore di silenzio, tempo mediano di risposta a un altro utente entro 24 ore, la sequenza più lunga di messaggi consecutivi, la percentuale di messaggi inviati tra le 00:00 e le 06:00 e una mappa di calore per giorno della settimana × ora.
  • Seleziona sopra i messaggi attiva la selezione: tocca i messaggi per contrassegnarli, con Maiusc per contrassegnare un intervallo, oppure usa Seleziona quelli visualizzati e poi Generare il rapporto. Il Report Studio si apre con Messaggi selezionati già compilato. Il report copre i record di quei messaggi (osservazioni, modifiche, avvisi di cancellazione) che superano gli altri filtri; un filtro per autore esclude gli avvisi di cancellazione, che non hanno mittente. Si possono selezionare fino a 1.000 messaggi; un chip nello studio rimuove un messaggio, e accanto si possono aggiungere chat intere. I numeri di messaggio mancanti sono indicati solo per le chat selezionate per intero.
  • La cronologia dei caricamenti riporta gli ultimi 100, 250 o 500 messaggi in questa schermata e nel registro. La trovi nelle azioni della chat, accanto alle impostazioni di registrazione, alla modalità di sola lettura e ai controlli di mascheramento dei segreti. Il menu si chiude con il tasto Esc o cliccando fuori da esso. Il caricamento dei messaggi precedenti mantiene la posizione di lettura corrente. Se la query o la pagina cambiano mentre Telegram risponde, il caricamento completato aggiorna il diario salvato senza sostituire la vista più recente. Se il caricamento automatico fallisce, viene offerta l’opzione Riprova. Per caricare tutte le fonti abilitate, utilizzare Fonti → Cronologia completa.
  • L’opzione “Esporta chat” scarica l’intera cronologia visibile sotto forma di file firmato chat.json e chat.html. Diversi account collegati possono condividere il lavoro: ciascuno scarica il proprio intervallo di numeri di messaggi e firma la propria parte, mentre l’account che avvia l’ esportazione firma l’archivio. Vedi esportare una chat.
  • La sezione "Persone" elenca tutti coloro che hanno messaggi salvati in questa chat. I profili delle persone sono disattivati per impostazione predefinita poiché contengono dati personali relativi a terzi. Quando sono attivati per una chat, un profilo mostra il nome e la cronologia dei nomi utente, i flag di Telegram, gli hash degli avatar, l’attività, chi risponde a chi, altre chat osservate e i portafogli, i telefoni, i nomi utente e i link menzionati. Ogni dato rimanda al proprio record. L’esportazione dei profili salva un file firmato, facoltativamente in un ZIP protetto da password; la disattivazione dei profili elimina il file del profilo. Vedi i profili delle persone.
  • La funzione “Raccogli tutti gli autori nella stessa scheda” richiede a Telegram il profilo, la biografia, le foto del profilo, i regali e i link della biografia di tutti coloro che hanno messaggi salvati nella chat. In un canale o in un supergruppo, altri account collegati possono condividere il lavoro. Ogni account selezionato viene destinato alla raccolta, include l’intero profilo e raggiunge un autore tramite uno dei messaggi salvati di quell’autore. Un account impegnato in un’altra attività non viene toccato e si unisce non appena è libero. Se non riesce a raggiungere un autore, torna all’account della chat stessa. Lo stato di avanzamento mostra la percentuale, il tempo rimanente e la quota di ciascun account; il pulsante Pausa libera gli account. Ogni record salvato indica l’account che lo ha letto, e il registro annota quando ciascun account si è unito e quando se n’è andato.
  • La funzione “Salva profilo” ora registra un’istantanea del profilo della chat o del bot: descrizione, membri, link di invito, comandi del bot.

Solo lettura, invio e segreti#

Due interruttori situati sopra i messaggi proteggono l’account e il lettore:

  • La modalità "Sola lettura" è attiva all’apertura di una chat. Disattivala per inviare messaggi o premere i pulsanti del bot . Ogni azione chiede “Invia come @account?” o “Premi questo pulsante del bot come @account?”, indicandoti che i membri della chat lo vedranno e che verrà inserito nel registro firmato. L’opzione “Non chiedere più per 10 minuti in questa chat” salta la domanda per un po’. L’invio è disattivato per l’obiettivo “Prove per un caso”, nel pannello e nell’API.
  • La funzione «Mask secrets» nasconde ciò che sembra una password, un codice di accesso, una chiave API o un hash, un token di bot, una stringa di sessione, una chiave privata, un JWT o un numero di carta di pagamento (i numeri delle carte vengono verificati con la somma di Luhn). La funzione «Show» rivela un valore; la rivelazione viene registrata nel registro. Anche la disattivazione della mascheratura per questo browser viene registrata. Cambia solo la visualizzazione: i record originali e ogni esportazione mantengono il testo completo.

Salva i messaggi selezionati come immagini#

In una chat su cloud, seleziona Seleziona, evidenzia i messaggi, quindi scegli “Salva come immagine”. Per salvare l’intera chat, seleziona Salva chat come immagini dal menu degli strumenti della chat; questa funzione carica fino a 2.000 messaggi salvati più recenti e indica quando quelli più vecchi vengono esclusi. L’anteprima offre gli stili Chiaro, Scuro e Classico; usa “Precedente” e “Successivo” per salvataggi più lunghi. Il download del file ZIP firmato salva ogni pagina in formato PNG insieme a pages.sig.json e README.txt (immagini della chat firmate). È possibile selezionare fino a 50 messaggi, che devono essere tutti presenti nella finestra della chat caricata. Il pannello richiede di ridurre una selezione troppo ampia invece di eliminare silenziosamente i messaggi.

Ogni pagina termina con un blocco di autenticità: i numeri di registro del diario che riporta, la chat, il tempo di rendering, l'impronta digitale della chiave dell'area di lavoro, il verify.py comando relativo a quella pagina e un codice QR contenente la chat, la chiave e il tempo di rendering. La firma richiede l’autorizzazione all’esportazione e aggiunge una export.image_attested voce nel registro.

L'immagine include il testo salvato, l'autore, il numero del messaggio, l'ora UTC, il numero della risposta, le etichette degli allegati e lo stato di modifica/cancellazione salvato. Utilizza l'ultima versione salvata del testo con il numero di versioni conservate; i contenuti degli allegati, i pulsanti in linea, le reazioni e le versioni precedenti del testo non vengono visualizzati. Un messaggio lungo prosegue nella pagina successiva con il relativo numero di messaggio e il conteggio delle parti. Ogni pagina si identifica come generata dai messaggi salvati. Il file PNG è un estratto visivo; utilizzare l’archivio e il relativo verificatore al momento della consegna dei record firmati e degli allegati.

Il rendering avviene nel browser senza inviare alcuna richiesta a Telegram; per la firma, vengono inviati al pannello solo lo SHA-256 e i numeri di record di ciascuna pagina. L'attuale funzione di mascheramento dei dati sensibili protegge il testo, i nomi degli autori e le etichette degli allegati. L'anteprima mantiene un'istantanea fino alla chiusura e viene cancellata al blocco del pannello o al cambio di area di lavoro/chat. Il diario firmato e la selezione dei report rimangono invariati. Si vedano i casi clinici per l'esportazione completa dei report.

Inoltra messaggi#

Disattiva la modalità Sola lettura per la chat, quindi seleziona Inoltra sotto un messaggio, oppure seleziona e contrassegna fino a 100 messaggi e scegli Inoltra. Scegli la destinazione in base al nome: l'elenco contiene le chat salvate e le chat Telegram dell'account in cui è possibile pubblicare (gruppi, chat private, bot e canali di cui è amministratore). Il pannello richiede una conferma, quindi inoltra in modo nativo tramite Telegram con la frequenza di invio dei messaggi dell’account. La richiesta e il relativo risultato sono registrazioni firmate nel registro che indicano la chat di origine, i numeri dei messaggi e la destinazione. Le copie vengono salvate nella destinazione solo quando quella chat è monitorata. Una chat che vieta l’inoltro restituisce un rifiuto e non viene inviato nulla.

Inoltra una chat a un canale o a un gruppo#

L'amministratore principale può aprire una chat salvata nel cloud e selezionare Inoltra chat dal menu degli strumenti. Scegliere Nuovo canale, Nuovo gruppo oppure Canale o gruppo esistente. Le nuove destinazioni sono private. Per una destinazione esistente, l'opzione Scegli una chat elenca i gruppi dell'account e i canali che amministra; effettuare la ricerca per nome. La destinazione deve consentire a questo account di pubblicare contenuti. Le destinazioni relative ai forum non sono supportate.

Metti in pausa l'osservazione o un altro processo attivo relativo all'account e abilita le azioni Telegram prima di visualizzare l'anteprima. Gli account in sola lettura e l'obiettivo Prove per un caso bloccano i trasferimenti. L'anteprima legge i limiti della cronologia Telegram accessibile e verifica la destinazione. Non crea una destinazione né invia messaggi. Il pulsante Avvia avvia il trasferimento; l'anteprima scade dopo dieci minuti. È possibile avere un solo trasferimento attivo per ogni area di lavoro.

Il trasferimento legge la cronologia di Telegram dal più vecchio al più recente, fino all’ultimo messaggio visualizzato nell’anteprima. Non si limita ai messaggi già salvati in TgWitness. I messaggi che arrivano oltre tale limite vengono esclusi. L’inoltro nativo conserva le informazioni sull’autore e i contenuti multimediali disponibili su Telegram senza scaricare e caricare copie. Gli album compresi nel limite rimangono raggruppati. Le notifiche sono silenziose. Le risposte, la struttura degli argomenti, le reazioni, le modifiche e i messaggi eliminati o inaccessibili non vengono ricostruiti. Le chat segrete non rientrano in questo flusso di lavoro. La protezione dei contenuti di Telegram e le restrizioni di pubblicazione rimangono in vigore.

Il pannello mostra gli invii confermati, quelli saltati, lo stato e l'orario del prossimo tentativo consentito. I messaggi di servizio e quelli protetti individualmente vengono saltati con una motivazione registrata. La spaziatura dei messaggi dell'account e i limiti orari si applicano a ogni messaggio; un album attende fino alla scadenza degli slot riservati. Le pause di FloodWait e della modalità lenta aggiornano il backoff RPC condiviso dell'account. Le impostazioni predefinite di regolazione esistenti dell'account rimangono invariate.

L'opzione Pausa interrompe il processo tra una richiesta e l’altra; l’opzione Annulla interrompe il lavoro rimanente senza rimuovere i messaggi già inviati né cancellare una destinazione creata. Una richiesta in corso potrebbe concludersi prima che una delle due azioni abbia effetto. La chiusura della finestra di dialogo non annulla un lavoro. Dopo il riavvio del processo, i lavori non completati richiedono un comando Riprendi esplicito. Una risposta di invio persa o incompleta mette in pausa il lavoro per consentire la verifica: controllare la destinazione prima di riprendere. Un nuovo tentativo conserva gli ID casuali dei Telegram memorizzati e i conteggi confermati; ciò non garantisce una deduplicazione indefinita da parte di Telegram. Un risultato di creazione sconosciuto non può essere ripreso automaticamente: controllare Telegram e annullare il vecchio lavoro prima di avviare un nuovo trasferimento verso la destinazione che è stata creata, se presente.

Se il salvataggio di un'attività o della relativa voce di giornale non va a buon fine, il worker ripristina l'ultimo stato salvato e libera l'account. Un invio o una creazione che potrebbe essere già pervenuta a Telegram rimane contrassegnata per la revisione. Riprovare un avvio fallito o riprendere l'attività una volta che lo spazio di archiviazione è nuovamente disponibile; lo stato di avanzamento confermato procede solo con la relativa voce di giornale.

Firmato interaction.forward.* le voci di registro registrano il confine, la destinazione, gli ID dei messaggi di origine/destinazione confermati e i salti. Esse documentano il trasferimento; non sostituiscono le osservazioni e le esportazioni firmate originali.

Registro#

Tutti i record firmati dall’area di lavoro, in ordine cronologico dal più recente al più vecchio.

  • La panoramica riporta il numero di messaggi osservati, le modifiche registrate, le notifiche di cancellazione e le fonti selezionate.
  • Cronologia degli eventi filtra per tipo di evento (tutti, modifiche, eliminazioni, reazioni, appartenenza, copertura), per testo e per fonte. Carica gli eventi precedenti torna alla pagina precedente.
  • Apri un record per visualizzarne i dettagli, l’hash e il payload. Il link a questo record è un indirizzo che apre lo stesso record. Eventuali informazioni riservate vengono mascherate in questa anteprima; le esportazioni mantengono l’originale.
  • Il registro è di sola aggiunta: nessuna operazione nel pannello modifica o elimina un record. Verificalo tramite Esportazioni → Verifica registro oppure python -m tgwitness.verify; vedi esportazione e verifica.

Fonti#

Quali conversazioni vengono registrate in questo spazio di lavoro e quali dati vengono conservati. Le modifiche si applicano alle attività future; le registrazioni salvate rimangono invariate.

L'aggiornamento dell'elenco delle chat legge le chat e le cartelle dell'account. Non scarica i messaggi.

Ambito di applicazione#

  • Cosa registra questo account : Chat selezionate (solo le chat che aggiungi), Cartella Telegram (una delle cartelle dell’account, comprese le chat aggiunte successivamente) oppure Account completo (ogni chat, e ogni nuova chat, gruppo, chat privata o bot non appena appare). Modalità di indagine è per un account dedicato: registra tutto ciò che l’account vede, i propri messaggi e le pressioni dei pulsanti, e salva immediatamente il profilo di ogni nuova chat e i messaggi visibili in precedenza. L’ guida dedicata agli account spiega perché non bisogna mai utilizzare il proprio account principale.
  • Modalità rigorosa: leggi solo le chat selezionate (Solo chat selezionate, disattivata per impostazione predefinita) blocca la lettura delle notifiche di servizio di Telegram, dell'elenco delle sessioni e dei messaggi precedenti di una chat quando è attivata, lascia invariata l'impostazione relativa ai contenuti sensibili e ignora gli aggiornamenti relativi alle chiamate telefoniche . Vedi Modalità rigorosa: chat selezionate.
  • I tipi di origine limitano le modalità «cartella» e «intero account» a canali, gruppi, chat private e bot. «Azioni proprie» aggiunge i messaggi, le modifiche e le pressioni sulla tastiera di risposta dell’account stesso.
  • Quando compare una nuova chat o un nuovo bot: salva il suo profilo e fino al numero scelto dei suoi ultimi messaggi visibili.
  • Le chat selezionate vengono contrassegnate come consigliate. L'opzione Ignora modifiche riporta il modulo all' ambito salvato, finché non si preme Salva ambito.

Pseudo-secret è l'interfaccia "Secret Chat" integrata, abilitabile per ogni account dopo l'installazione del relativo modulo di protocollo con un solo clic. Il monitoraggio su cloud e la cronologia utilizzano le proprie impostazioni. Non viene registrato nulla mentre TgWitness non è in esecuzione; dopo un riavvio, il programma recupera solo ciò che Telegram restituisce ancora e il rapporto mostra il divario. Le chat che superano il limite dell’elenco delle chat (1.000 conversazioni, salvo modifiche nei Parametri) vengono aggiunte non appena diventano attive. I pulsanti del bot integrati premuti in un’altra app sono invisibili; la risposta del bot viene registrata.

Chat incluse#

Filtra per stato (Abilitato, In pausa, Prioritario, Escluso, Accesso non confermato , Ignorato) e tipo, quindi agisci sulla selezione: abilita, metti in pausa, contrassegna o rimuovi la priorità, escludi dall’ambito o elimina. Il badge di stato mostra solo lo stato; le azioni si trovano nel menu di ogni riga con una descrizione di ciò che fanno. La messa in pausa e l’esclusione richiedono una conferma, anche in blocco. La rimozione di una fonte richiede il suo nome ed elimina i profili delle persone ad essa associate; i record salvati rimangono nel diario.

Una fonte che non compare nell’elenco delle chat dell’account sta ricevendo aggiornamenti, pur non figurando nell’elenco delle chat mentre continuano ad arrivare registrazioni; in caso contrario, l’accesso non è confermato. L’opzione «Chat disponibili» aggiunge le chat selezionando «Aggiungi selezionati» o «Aggiungi tutti quelli corrispondenti».

Cronologia completa#

Carica la cronologia disponibile di ogni fonte abilitata nelle chat e nel diario. I progressi vengono mantenuti dopo un riavvio; gli allegati seguono le impostazioni multimediali dell’utente. Vedi la cronologia delle fonti.

Registrazione#

  • Scegli quali modifiche conservare: nuovi messaggi, modifiche, notifiche di cancellazione, reazioni visibili, ingressi e uscite. Un'impostazione predefinita modifica il modulo; l'opzione «Salva impostazioni di registrazione» la applica. Riattivare una categoria non recupera gli eventi persi.
  • Conserva i file multimediali quando disponibili: scarica allegati fino a una determinata dimensione per file, imposta per tipo da 1 a 2.000 MiB e limita la durata dei video in secondi (0 indica nessun limite). Ogni tentativo di download viene registrato con il relativo esito.
  • Ricontrollo: le chat prioritarie vengono ricontrollate ogni pochi minuti, le altre raramente, in modo che l’account resti al di sotto dei limiti FloodWait di Telegram. Impostando il valore su 0 si disattiva un gruppo. Contrassegnare le chat prioritarie con la stellina nell’elenco; il numero di chat per ciclo e la pausa tra una chat e l’altra sono specificati in Parameters. Vedi la raccolta.
  • La barra di salvataggio indica se queste impostazioni corrispondono a quelle consigliate. Torna alle impostazioni consigliate inserisce i valori consigliati; Salva impostazioni di registrazione le applica e Ignora modifiche ripristina quelle salvate.

Esportazioni#

La sezione «Downloads» prepara i file; «Build report» consente di scegliere l’aspetto dei report.

Cosa Utilizzalo per Guida
Esportazione dell’account Un'istantanea aggiornata di ciò che l'account può leggere in questo momento Esportazione dell’account
Condivisione della copia Una versione ridotta di un'esportazione completa dell’account Informativa
Firmato ZIP Diario, report, allegati e strumenti di verifica all’interno di un confine fisso del diario Esporta e verifica
Report in formato HTML, PDF e JSON Un rapporto sigillato e leggibile Rapporti sui casi
JSONL, CSV Registrazioni originali con firme; un foglio di calcolo protetto dalle formule Esporta e verifica
Estratto del passaggio di consegne Solo le chat, il periodo e le persone di cui il destinatario ha bisogno Prove
Esportazione delle chat Una chat firmata chat.json e chat.html Esporta una chat
  • Crittografando i download sopra indicati con una password (di almeno 12 caratteri) si salva un file AES-256 ZIP che può essere aperto con 7-Zip o WinRAR. Il file firmato al suo interno rimane inalterato. La password non viene memorizzata.
  • Quando è stata importata la chiave di sessione di questo spazio di lavoro, le finestre di dialogo di esportazione dell’account e della chat lo indicano in una riga: copie di quella chiave possono esistere al di fuori dell’elenco delle sessioni di Telegram . La stessa riga offre l’opzione Crea un’autorizzazione indipendente, che apre la pagina di accesso con tale opzione selezionata. Vedi account.
  • Un’esportazione di chat che fallisce o viene annullata mantiene l’intervallo salvato. L’opzione Cattura o esporta una chat offre quindi le opzioni Riprendi esportazione e Ricomincia da capo; vedi Esporta una chat.
  • Mentre l'opzione "Esporta chat letta" crea un file ZIP contenente i messaggi letti fino a quel momento, le cui pagine vengono firmate man mano che vengono scritte; la riga sottostante indica il numero di messaggi firmati.
  • Le esportazioni preparate conservano fino a 20 file entro un limite di 2 GiB, più l’ultimo, per i download ripetuti, ciascuno con il proprio SHA-256 affinché il destinatario possa effettuare il confronto. Ogni scheda indica il contenuto del file: Archivio firmato (registro completo e numero di record), Rapporto, Record del registro o Estratto di passaggio di consegne , il titolo e l’ID del caso, nonché la selezione di elementi utilizzata per la creazione del rapporto (chat, messaggi selezionati, date). La funzione Mostra restringe l’elenco a un solo tipo quando ne contiene più di uno.
  • Quando il browser rifiuta la finestra di dialogo di salvataggio, il pannello ricorre a un normale download.
  • La tua identità di firma mostra l’impronta digitale della chiave. Le opzioni «Salva checkpoint» e «Scarica ricevuta di esecuzione firmata» ti consentono di conservare le registrazioni al di fuori del collector. L’opzione «Prepara richiesta di timestamp» genera una richiesta RFC 3161 senza contattare alcun servizio.

Impostazioni, account e connessione#

  • Impostazioni: obiettivo, connessione, cosa registrare e interfaccia. Vedi prima configurazione e impostazioni.
  • Account: ogni spazio di lavoro con il proprio stato, le fonti, gli eventi e la coda degli allegati. Filtra per “Richiede attenzione”, “In fase di raccolta”, “Offline” o “In pausa” oppure “Non connesso”, metti in pausa o riprendi una selezione, importa file di account in blocco e gestisci i gruppi. Vedi account.
  • Account: accesso e percorso di connessione di questo account. Diretto, un profilo WireGuard , il proprio proxy, il pool pubblico MTProto o WARP; preparare e verificare un percorso, quindi applicarlo a questo account, a un gruppo o a tutti gli account. Vedi connessione e proxy e proxy. Sicurezza dell’account → Sessioni di questo account elenca le sessioni di Telegram, ne termina una o tutte e — per una chiave creata in questo spazio di lavoro — offre l’opzione Rendi questa l’ unica sessione quando Telegram lo consente, che ripete tale azione dopo le 24 ore richieste da Telegram e mostra la password a due passaggi che imposta una sola volta. Vedi sicurezza dell’account. Sicurezza dell’account → Witness probe utilizza un secondo spazio di lavoro per verificare che questa sessione riceva gli aggiornamenti in tempo reale; vedi witness probe.

Le funzioni di pausa e ripresa in blocco mantengono la selezione confermata all’interno della sessione in cui è stata aperta. I controlli rimangono disabilitati finché la conferma o l’esecuzione sono in sospeso; il cambio di area di lavoro o il blocco del pannello annullano i comandi rimanenti. Dopo l’esecuzione, il pannello aggiorna gli stati degli account. Una richiesta non andata a buon fine viene segnalata come errore di richiesta, poiché il server potrebbe aver già applicato il comando. I comandi non vengono ripetuti automaticamente.

Extra#

Opzionale: bastano un account e delle fonti per iniziare a raccogliere dati. Solo l’opzione che scegli aprirà le relative impostazioni; nulla viene collegato automaticamente. La scheda «Livello di protezione» nella parte superiore mostra la modalità di protezione.

Scheda Cosa offre in più Guida
Archiviazione e spazio su disco Backup, trasferimento dei file più vecchi sul cloud, una copia probatoria che non può essere cancellata Archiviazione
Obiettivo e livello di protezione Impostazioni consigliate per il tuo obiettivo e due scale di seguito
Notifiche Problemi, messaggi modificati e un riepilogo giornaliero; il tuo bot di controllo personale di seguito
Prove e backup Timestamp, ulteriori testimoni e una copia crittografata fuori sede di seguito
Server attivo 24 ore su 24, 7 giorni su 7 Un server cloud senza SSH, creato ed eliminato dal pannello di controllo Elevata affidabilità
Testimone indipendente Controlli firmati pubblicati sul tuo canale Telegram o su Discord Testimone
Controllo del codice Confronta il programma in esecuzione con un commit pubblico su GitHub di seguito

Obiettivo e livello di protezione#

Quattro domande:

  1. A cosa serve? Per una documentazione personale, un'indagine o come prova in un caso.
  2. Quanto intendi monitorare? Poche chat (fino a circa 50), molte chat (fino a circa 500) o interi account. Questo imposta il limite dell’elenco delle chat a 1.000, 3.000 o 20.000.
  3. Foto e file? Solo testo, foto e file multimediali di piccole dimensioni (foto fino a 20 MB, video fino a 100 MB), oppure tutto (video e documenti fino a 1 GB ciascuno). L’opzione “Tutto” con account completi mantiene inoltre 4 GiB di spazio libero su disco.
  4. Dove verrà eseguito? Su questo computer o su un server sempre attivo.

Il suggerimento elenca i timestamp indipendenti, il drand e l’elenco dei dispositivi di Telegram, ciascuno corredato da una riga che ne descrive la funzione. I timestamp vengono generati ogni 60, 30 o 10 minuti per una registrazione personale , un’indagine o una prova; il drand e l’elenco dei dispositivi richiedono i timestamp. Applicare le modifiche solo a questi elementi, alla politica sugli allegati e ai due parametri sopra indicati. Ogni modifica costituisce una registrazione nel registro, oltre a setup.applied. Notifiche, una copia fuori sede, un server, il DNS del gateway, il controllo del codice e un testimone vengono proposti come passaggi successivi con i rispettivi moduli.

Due scale vengono calcolate in base a quanto impostato, non all’obiettivo:

Scala Punti
Credibilità Diario firmato 1, timestamp 3, drand 1, elenco dispositivi 1, verifica del codice corrispondente 1, polling dei testimoni 1, server certificato 2, log DNS del gateway 1
Affidabilità Server sempre attivo 3, copia off-site 3, Object Lock 1, notifiche di problemi 1

L'80% o più corrisponde al livello massimo, il 50% a quello alto, il 25% a quello moderato, mentre al di sotto di tale soglia si considera il livello base. L'affidabilità attualmente tiene conto di un server sempre attivo in base alla risposta alla domanda 4, prima che venga verificato qualsiasi server.

Notifiche#

Le notifiche vengono inviate tramite Apprise a Telegram, Discord, Slack, ntfy, e-mail, Matrix e oltre 100 altri servizi. Scegli un servizio, compila uno o due campi e invia un test, oppure incolla direttamente gli indirizzi di Apprise.

  • Problemi: disco quasi pieno, account disconnesso, errori di raccolta, copia o timestamp; una nuova sessione connessa all’account con il dispositivo, l’applicazione e gli elenchi Telegram per paese; un codice di accesso o un nuovo accesso segnalato da Telegram durante l’osservazione; e un’altra sessione dopo aver impostato Rendi questa l’unica sessione. Su un server sigillato, anche una porta SSH aperta o un accesso costituiscono un problema.
  • Modifiche: messaggi eliminati, modificati e mancanti nelle chat monitorate, raggruppati in una singola notifica per ogni controllo (ogni minuto, salvo diversa impostazione nei Parametri).
  • Attività completate: cronologia, esportazioni e copie di archiviazione.
  • Risultati nella lista di controllo: corrispondenze provenienti da liste di controllo impostate per l’invio di un avviso.
  • Riepilogo giornaliero all’ora prescelta, secondo l’ora del server.

Le notifiche riportano i nomi delle chat e il numero di messaggi. Gli estratti dei messaggi sono disattivati per impostazione predefinita; se sono attivati, il testo dei messaggi esce da questo dispositivo.

Il tuo bot operatore è un bot personale creato tramite @BotFather che risponde /status e /stats, e, facoltativamente, /pause, /resume e /copy. Solo la chat indicata e gli ID utente di Telegram elencati possono utilizzarlo; il testo della conversazione rimane nell’area di lavoro. Utilizza un bot separato se un’altra applicazione riceve già i suoi comandi. Vedi notifiche e bot operatore.

Prove e backup#

  • I timestamp indipendenti inviano solo l’SHA-256 di ciascun checkpoint firmato alle autorità RFC 3161 e ai calendari OpenTimestamps, ogni 5-1,440 minuti. Un destinatario necessita di tale tempistica di terze parti come requisito minimo per la prova. Anchor ora esegue un ciclo. Vedi timestamp.
  • Altri testimoni, ciascuno inattivo finché non viene selezionato: l’ultimo round di drand, l’elenco di Telegram dei dispositivi connessi senza indirizzi IP e il log di Cloudflare Gateway relativo alle query DNS del server. Vedi i registri opzionali.
  • Il backup crittografato copia il diario, i file, i checkpoint e le esportazioni delle chat su un archivio compatibile con S3 (Wasabi, Amazon S3, Backblaze B2, Cloudflare R2, MinIO). Tutto viene prima crittografato su questa macchina. Scarica la chiave di crittografia e conservala in un luogo separato: senza di essa la copia non può essere letta. Object Lock in modalità Governance o Compliance impedisce la cancellazione degli oggetti per un numero prestabilito di giorni. Vedi copia off-site.

Controllo del codice#

Verifica se il programma installato corrisponde a una versione pubblicata.

  1. Inserisci un repository GitHub (quello ufficiale è già precompilato) e un tag, un ramo o un commit.
  2. Check now interroga l’API di GitHub, tramite la route di questo spazio di lavoro per le richieste esterne, per ottenere l’elenco dei file di quel commit. Confronta l’ID blob git di ogni file di programma analizzato con il commit. Un checkout da Windows con terminazioni di riga convertite risulta comunque compatibile.
  3. Il risultato elenca i file modificati, aggiuntivi e mancanti (fino a 50 per ciascuna categoria) e viene salvato come un source.checked registro di diario.

Il risultato è considerato aggiornato solo finché i file del programma in esecuzione rimangono invariati: ricontrollare dopo un aggiornamento. Non è necessario alcun token e funzionano solo i repository pubblici; le chat e le credenziali non vengono caricate. Una corrispondenza identifica il codice presente sul disco. Non si tratta di un’attestazione hardware; per quella, consultare Phala Cloud.

Modalità di protezione#

Il selettore accanto al numero di versione mostra la modalità selezionata e quanti dei 18 livelli di protezione sono attivi, ad esempio 🟠 Witnessed 9/18. Per cambiare modalità, in «Extras» → «Livello di protezione» si apre il menu di selezione. Ogni modalità descrive un obiettivo e elenca ciò che manca ancora; la registrazione, la firma e le impostazioni salvate sono le stesse in ogni modalità.

Modalità Per Aggiunge
🟢 Facile Monitorare una chat e conservarne una copia Chat, il diario e le esportazioni delle chat; la firma avviene in background
🟡 Firmato Segnala a una piattaforma, a un host o a un servizio di segnalazione degli abusi Archivio firmato, verifica del registro, punti di controllo, estratto di passaggio di consegne
🟠 Testimoniato Casi in cui qualcuno potrebbe sostenere che il record sia stato modificato Un testimone indipendente che pubblica le intestazioni del registro firmate
🔴 Pronta per l’uso in tribunale Prove per un avvocato, la polizia o un tribunale Timestamp, una copia crittografata conservata in un luogo esterno, dettagli del caso nei report
🟣 Verificato da GitHub Registrazioni il cui software deve poter essere verificato da chiunque Controllo del codice e acquisizione di GitHub Actions
⚫ Massimo Casi di grande rilevanza contro un avversario ben finanziato Un server protetto attivo 24 ore su 24, 7 giorni su 7, un indirizzo IP nascosto, tutti i 18 livelli

I livelli: ogni registrazione firmata e concatenata; una ricevuta di esecuzione firmata; allegati salvati con SHA-256; checkpoint firmati; ricontrolli; avvisi di problemi; accesso di sola lettura per i testimoni; un testimone che effettua controlli a intervalli regolari; timestamp RFC 3161; prove OpenTimestamps; un timestamp più recente verificato; una copia crittografata fuori sede; dettagli del caso nei rapporti; un controllo di corrispondenza del codice ; Telegram non vede mai l’IP di questa macchina; richieste esterne tramite un proxy; Object Lock sulla copia; un server sigillato con i registri del provider. Un livello disattivato presenta l’opzione “Configura”, che apre il relativo modulo. La scelta di una modalità inferiore richiede conferma e non elimina nulla.

Altri strumenti#

Extra → Acquisizione indipendente: collegare un browser separato o un registratore AyuGram, associare la relativa chiave di firma, selezionare le opzioni di acquisizione, avviare/mettere in pausa, acquisire istantanee e scaricare archivi firmati e verificati. Ogni registratore dispone di un proprio accesso manuale, percorso, registro e chiave. Entrambe le connessioni sono inizialmente disabilitate. Vedi la versione in inglese Guida indipendente alla cattura.

  • Consulta l’archivio: cerca le osservazioni salvate, esamina le fonti, quindi decidi se inviarle a un modello di IA. Vedi l’analisi dell’archivio e l’OCR e la trascrizione locali.
  • Parametri: limiti e frequenza di raccolta, ricontrolli, download, profili, notifiche ed esportazioni. Ricerca per nome, mostra «Solo valori modificati» e prepara le impostazioni predefinite come bozza con «Ripristina impostazioni predefinite…». «Salva parametri» applica i valori dal loro prossimo utilizzo, e ogni modifica viene registrata nel registro.
  • Accesso: token distinti per revisori, analisti e operatori, limitati a determinati spazi di lavoro, chat e diritti. Vedi la sezione "Accesso".
  • Log di sistema : attività svolte da questo processo dal suo avvio (connessioni, modifiche al proxy, accessi, rifiuti, modifiche alle impostazioni) con gli indirizzi IP nascosti. L’opzione “Segui nuove righe” mantiene visibile la riga più recente. I messaggi rimangono solo nel registro.
  • Integrazioni: il provider di IA, connessioni MCP in sola lettura e webhook firmati.
  • Case Board: note private del team, segnalibri e estratti accanto alle prove. Vedi Case Board.
  • Documentazione: il pannello della modalità di indagine. Mentre una sessione documentata è in fase di registrazione, viene spostata nella barra laterale principale.
  • Acquisizioni di GitHub Actions in Esportazioni: una chat acquisita dal tuo fork. Vedi acquisizione sigillata.