TgWitnessDocumentazione / 10
Garantite la sicurezza
Scoprite i percorsi di Telegram, gli elenchi di proxy pubblici e i servizi esterni opzionali. Scoprite cosa sblocca ciascuna opzione segreta, cosa coprono le protezioni e cosa spetta a voi gestire.
Dove si trova tutto
Il programma di raccolta, la relativa interfaccia e ogni registrazione salvata rimangono sul computer o sul server su cui lo si esegue. Telegram è l’unica destinazione predefinita; ogni altra destinazione è selezionabile tramite un’opzione separata.
- TelegramSempre · seguendo il percorso da Lei scelto
Connessione MTProto dell’account: diretta, SOCKS5, HTTP o MTProxy. La modalità «Nascondi IP» attende un proxy funzionante. Il fallback diretto richiede una modalità che lo consenta esplicitamente.
- Testo esterno al sitoOpzionale · disattivato per impostazione predefinita
Il registro, i file e i checkpoint vengono crittografati con AES-GCM prima del caricamento su un archivio compatibile con S3. La chiave rimane in vostro possesso; gli allegati vengono identificati tramite hash con chiave, non tramite l’hash del loro contenuto.
- NotificheOpzionale · disattivato per impostazione predefinita
Problemi e conteggio delle modifiche con i titoli delle chat. Gli estratti dei messaggi vengono inviati solo se si attiva questa opzione.
- Autorità di marcatura temporaleOpzionale · disattivato per impostazione predefinita
Solo l’SHA-256 di un checkpoint firmato e un nonce casuale. Nessun messaggio, nessun nome utente.
- WitnessOpzionale · disattivato per impostazione predefinita
Estrae i checkpoint firmati e i contatori di acquisizione tramite un token di sola lettura. Non è in grado di leggere le conversazioni né di modificare le impostazioni.
Impostazione predefinita: solo la connessione a Telegram esce da questo dispositivo.
Cosa svela ogni segreto
| Segreto | Dove viene conservato | Cosa offre | In caso di fuga di notizie |
|---|---|---|---|
| Token del pannello | panel-token.txt nella directory dei dati; il browser lo conserva solo per quella scheda | Tutte le funzionalità in ogni area di lavoro: lettura ed esportazione, modifica dell’ambito, accesso agli account | Interrompa TgWitness, elimini panel-token.txt, poi riavvii il programma: verrà creato un nuovo token |
| Sessione Telegram | Archivio crittografato (credentials.enc) | L’account Telegram stesso | Chiuda la sessione su Telegram da Impostazioni → Dispositivi |
| Chiave di firma | Archivio crittografato (signing.enc) | Registrazioni firmate verificabili tramite la Sua impronta digitale | I checkpoint conservati altrove, un testimone e i timestamp mostrano ciò che esisteva in precedenza |
| Chiave di archiviazione | vault.key accanto ai dati, oppure una chiave master esterna per una nuova directory di dati | Decifrare il caveau | Si considerino come trapelate anche la chiave di sessione e quella di firma |
| Token Witness | Sull’host di Witness | Sola lettura: checkpoint firmati e stato di integrità | Si prega di eliminarlo dalla pagina Witness e di crearne uno nuovo |
| Testo chiave per contenuti esterni | Vault: scaricatelo una sola volta per il ripristino | Decifrare la copia fuori sede | Chiunque sia in possesso degli oggetti archiviati può decriptarli: consideri tale copia come esposta |
Cosa coprono le misure di protezione
Trattato
- Un record modificato, rimosso o riorganizzato in un’esportazione: la catena di hash o una firma non risultano più valide.
- Un registro ridotto o ricostruito dopo che un punto di controllo è stato conservato altrove: il punto di controllo conservato non corrisponde più.
- Indovinare il token del pannello: 256 bit casuali, confrontati in tempo costante; dopo 15 tentativi falliti al minuto, l’indirizzo viene rifiutato.
- Contenuti ostili delle chat: il testo viene inserito come testo, mai come HTML; gli allegati vengono scaricati come file; il pannello non carica nulla da altri siti.
- Una directory di dati copiati con una chiave di archiviazione esterna: le sessioni e le chiavi di firma rimangono crittografate senza la chiave principale.
A voi la scelta
- Il titolare del token del pannello principale detiene il pieno controllo. Conceda ad altre persone un accesso limitato agli account, alle chat e alle azioni di cui hanno bisogno; mantenga riservata la chiave principale.
- Un amministratore del sistema può leggere tutto, nonché riscrivere e rifirmare il registro. Si raccomanda di conservare l’impronta digitale e i punti di controllo su un altro sistema.
- Il testo dei messaggi e i file multimediali non vengono crittografati da TgWitness. Si raccomanda di utilizzare la crittografia del disco e di impostare autorizzazioni rigorose.
- L’uso del protocollo HTTP standard al di fuori di localhost espone il token sulla rete. Si raccomanda di utilizzare HTTPS o un tunnel SSH.
- Le firme dimostrano che quanto registrato non è stato modificato, non che ogni evento su Telegram sia stato registrato.
Condivida l’accesso a un caso con autorizzazioni, scadenza e limiti di sessione. Il token di Testimone rimane una credenziale separata.
Rafforzare la sicurezza di un’installazione
- Utilizzi un account Telegram dedicato — mai quello principale. Il token del pannello e la sessione le garantiscono il pieno controllo dello stesso.
- Mantenete il pannello all’indirizzo 127.0.0.1. Accedetevi da remoto esclusivamente tramite HTTPS (la configurazione Caddy inclusa) o un tunnel SSH.
- Crittografare il disco che contiene la directory dei dati: il testo dei messaggi e i file multimediali vengono archiviati così come sono stati ricevuti.
- Limitare la directory dei dati all’account di servizio. Le nuove directory assumono la modalità 0700 su Unix; su Windows, impostare i permessi della cartella.
- Conservare la chiave principale dell’archivio su un altro server: impostare
TGWITNESS_VAULT_KEY_FILEprima di creare la directory dei dati. - Salvi l’impronta digitale della chiave di firma e i checkpoint su un altro sistema e aggiunga un testimone su un altro host.
- Non carichi mai le chiavi
data/, di sessione,panel-token.txto del vault su GitHub o in una chat. - Non registrare le intestazioni
Authorizationné i corpi delle richieste su un proxy inverso.
È possibile modificare il token del pannello senza perdere i dati?
Sì. Il token serve solo ad aprire il pannello. Arresti TgWitness, elimini panel-token.txt dalla directory dei dati e lo riavvii; il registro, le sessioni e le chiavi rimangono inalterati. Se TGWITNESS_TOKEN è impostato, viene utilizzato il valore dell’ambiente anziché il file.
Perché i messaggi non sono crittografati quando sono inattivi?
Il responsabile della raccolta deve leggerli per effettuare ricerche, confrontare le versioni ed esportarli. Crittografarli con una chiave sulla stessa macchina sarebbe di scarsa utilità contro chi è in grado di accedere a tale macchina. La crittografia del disco protegge un disco fuori uso o rubato; permessi rigorosi proteggono invece un disco in funzione.
Segnalare una vulnerabilità
Utilizzi la sezione Sicurezza → Segnala una vulnerabilità nel repository GitHub. Indichi la versione, l’impatto e una riproduzione sintetica minima. Non invii mai credenziali, directory degli account o archivi di prove reali. Qualora la segnalazione privata non fosse disponibile, apra un ticket richiedendo un canale privato senza fornire dettagli sull’exploit.