Riferimento / Raccogli
Telegram · Chat segrete: configurazione e registrazione
Installa l’estensione del protocollo delle chat segrete, attivala per ogni account e registra le chat che TgWitness crea o accetta.
L'applicazione pubblicata include il backend di Secret Chat, l'integrazione con il collector, i percorsi API e l'interfaccia Pseudo-secret. La libreria del protocollo è un modulo separato: apri Pseudo-secret, premi Installa e attiva la funzione. L'accettazione automatica dei messaggi in arrivo rimane disattivata finché non la attivi.
Modulo di protocollo#
| Modulo | kiaro-telethon-secret-chat 0.2.0 |
| Autore | KiaroSama |
| Licenza | GPL-3.0 o versioni successive; la sua LICENSE e NOTICE rimangano all’interno dell’archivio salvato |
| Fonte | KiaroSama/Telethon-Secret-Chat al commit d87bf037b90060383c7b704d8a06ebb98c621c6f |
| Verifica | SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c sull'elenco dei file dei pacchetti e dei relativi valori SHA-256 |
L'amministratore principale può eseguire l'installazione e l'attivazione. TgWitness scarica l'
archivio sorgente di quel commit da GitHub tramite il percorso dell'area di lavoro per le richieste
esterne a Telegram, confronta ogni file del pacchetto con il valore fissato nella
versione di TgWitness, salva l'archivio come modules/telethon-secret-chat-<commit>.zip nella
directory dei dati e carica il codice dalla memoria. Non è necessario alcun riavvio. Il controllo viene eseguito
nuovamente ad ogni avvio; un archivio che presenta differenze non viene caricato e la pagina lo segnala.
Un file del pacchetto modificato, mancante o aggiunto fa fallire il controllo.
Il modulo è un'opera a sé stante, soggetta a una propria licenza. TgWitness non lo include nella distribuzione: ogni installazione lo scarica dal repository dell'autore. I dettagli riportati nella pagina mostrano il modulo caricato, il suo autore, la licenza, il commit e lo SHA-256.
Un host che non ha accesso a GitHub può invece installare lo stesso commit nell'ambiente Python; il pannello utilizzerà quindi quella copia:
python -m pip install ".[secret-chats]"
TgWitness diventa un endpoint per le chat che crea o accetta. Registra messaggi, allegati disponibili, modifiche al timer e avvisi di cancellazione nel registro firmato. I contenuti salvati in precedenza rimangono disponibili anche dopo un successivo avviso di cancellazione.
Disponibilità del pacchetto#
L’8
novembre 2026
, il pacchetto di installazione pubblicato è stato verificato alla fonte
b35f8e18f3d1
,
versione b35f8e18f3d1-1ff85ec98bb2
, versione 0.9.1
in anteprima.
Il file wheel immutabile
e il relativo blocco delle dipendenze hanno superato la verifica della firma di rilascio SHA-256
e RSA.
Il backend e l’interfaccia inclusi nel pacchetto corrispondevano byte per byte a quella revisione del codice sorgente.
Il pacchetto contiene anche la registrazione dell’API e gli hook del collettore.
Quel pacchetto non conteneva la libreria del protocollo e non è presente nel
lock delle dipendenze. L’ secret-chats elemento extra in pyproject.toml fissa lo stesso
commit del pulsante del pannello.
Questa ispezione del pacchetto stabilisce quali file e dichiarazioni di dipendenza vengono distribuiti. Il record di convalida identifica i controlli di runtime separati. La precedente guida del 6 novembre descriveva uno snapshot di sviluppo; non descrive più il pacchetto sopra indicato.
Utilizzare l’interfaccia#
Apri Pseudo-secret, installa il modulo se la pagina lo propone, attivalo per l'account e collegalo. Le richieste in arrivo rimangono in attesa di accettazione a meno che non sia abilitata l'accettazione automatica. L'avvio, l'accettazione, l'invio e la chiusura utilizzano le autorizzazioni di interazione dell'account e la protezione in sola lettura.
| Azione | Risultato conservato |
|---|---|
| Avvia una chat tramite nome utente o ID utente | Richiesta in uscita; il peer la accetta sul proprio dispositivo. |
| Accetta una richiesta | TgWitness diventa l’endpoint di ricezione. |
| Inviare o ricevere un messaggio | secret_chat.message con la sua direzione, il contenuto e il timer fornito. |
| Ricevi un file | Byte decriptati memorizzati tramite SHA-256 e una ricevuta secret_chat.file; inclusi nell’esportazione delle prove. |
| Ricevi un avviso di scadenza o di cancellazione | Un registro delle azioni separato, insieme ai messaggi e ai file conservati. |
| Rivedere la chat | Conversazioni, conferme di ricezione dei file, avvisi e visualizzazione delle chiavi. |
Le chat segrete esistenti su un altro dispositivo mantengono le chiavi specifiche del dispositivo. Una sessione cloud importata non trasferisce tali chiavi. Il materiale delle chiavi delle chat segrete e i contatori utilizzano il vault dell’area di lavoro; i messaggi conservati e i file decriptati utilizzano le normali protezioni di archiviazione dell’area di lavoro.
Trova i messaggi salvati#
Utilizza la funzione Cerca messaggi all'interno di una chat aperta per trovare una frase esatta, senza distinguere tra maiuscole e minuscole. I tasti Precedente e Successivo, oppure "Invio" e "Shift+Invio" nel campo di ricerca, consentono di spostarsi tra i messaggi corrispondenti. Il contatore tiene il conto dei messaggi; la prima frase corrispondente in ciascun messaggio viene evidenziata. Il tasto Esc cancella la ricerca.
La funzione di ricerca mantiene visibili la conversazione circostante, i file salvati e gli avvisi di cancellazione. Effettua la ricerca tra i record già caricati nel pannello. Se sono presenti record precedenti, il pannello lo segnala; l’opzione Carica record precedenti estende la cronologia e aggiorna i risultati della ricerca, mantenendo al contempo il messaggio corrente al suo posto.
Ogni chat mantiene la propria ricerca anche quando si passa da una chat all'altra all'interno dello stesso spazio di lavoro. Il blocco del pannello o il cambio di spazio di lavoro cancella tali ricerche. I termini di ricerca rimangono nella memoria della pagina e non vengono memorizzati nella memoria del browser né inviati come query API. La ricerca non invia messaggi Telegram né notifiche di digitazione o lettura. Le impostazioni di visibilità esistenti continuano a regolare l'apertura di una chat e altre azioni.
Il report di compilazione mantiene l'ambito di selezione della chat selezionata; una ricerca nella visualizzazione non limita automaticamente i record esportati. Visualizza l'anteprima della selezione del report prima di scaricarlo.
Controlli di persistenza e interazione#
L’implementazione integrata utilizza la ricerca nel registro durevole per il rilevamento dei duplicati, mantiene in sospeso i processi di allegato dopo un download fallito e instrada la chiusura attraverso lo stesso filtro di interazione delle altre azioni remote. Questi sostituiscono i tre percorsi segnalati nella revisione storica dello snapshot di sviluppo del 6 novembre.
I messaggi decriptati per i quali la scrittura nel journal non va a buon fine vengono conservati nel vault in attesa di un nuovo tentativo. I controlli relativi alle dimensioni degli allegati e allo spazio libero su disco ritardano i download, pur mantenendo attivi i relativi processi. Il modulo riutilizza la connessione esistente dell'account. Le notifiche di lettura e digitazione vengono inviate solo secondo quanto selezionato nella sezione " Cosa vede l'altra parte"; le notifiche con screenshot non vengono mai inviate. Vedi secret_chats.py, i percorsi API e la politica di accesso.
L’audit storico conserva i risultati originali delle istantanee. La disponibilità e l’implementazione attuali devono essere ricavate dalla revisione del pacchetto sopra indicata e dalle funzionalità attuali.
Dimostrazione dell’interfaccia#
Lo scenario del sito web utilizza richieste, messaggi e file fittizi per illustrare il flusso di lavoro del pannello. Si tratta di un esempio di interfaccia; i controlli relativi al protocollo e all’acquisizione hanno i propri risultati datati nel registro di convalida.