Documentazione / 14
Telegram · Garantite la sicurezza
Cosa lascia la Sua macchina, cosa apre ogni segreto e cosa coprono le protezioni rispetto a ciò che spetta a Lei.
Dove si trova tutto
Il collector, il pannello e ogni voce restano sulla Sua macchina. Di default si contatta solo Telegram; tutto il resto è un interruttore a parte.
- 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.
- TestimoneOpzionale · 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 cartella dati; il browser lo tiene per scheda | Tutto, in ogni spazio | Fermi TgWitness, elimini panel-token.txt, riavvii: ne riceve uno nuovo |
| 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) | Firmare voci con la Sua impronta | Punti di controllo conservati altrove, un testimone e le marche temporali mostrano comunque cosa esisteva prima |
| Chiave di archiviazione | vault.key accanto ai dati o una chiave master esterna | Il vault | Consideri trapelate anche la sessione e la chiave di firma |
| Token Witness | Sull’host di Witness | Sola lettura: punti di controllo e stato | Lo elimini nella pagina del testimone e ne crei uno nuovo |
| Testo chiave per contenuti esterni | Vault: scaricatelo una sola volta per il ripristino | La copia esterna | Chi ha anche il bucket può decifrarla: consideri la copia esposta |
Cosa coprono le misure di protezione
Trattato
- Una voce modificata, rimossa o riordinata: si rompe la catena di hash o una firma.
- Un diario accorciato o ricostruito dopo che ha conservato altrove un punto di controllo: il punto di controllo non corrisponde più.
- Indovinare il token: 256 bit casuali, confronto a tempo costante; 15 errori al minuto e l’indirizzo viene bloccato.
- Contenuti ostili nelle chat: il testo resta testo, mai HTML; gli allegati si scaricano come file; il pannello non carica nulla da altri siti.
- Una cartella dati rubata con chiave del vault esterna: sessioni e chiavi restano cifrate.
A voi la scelta
- Il token principale può fare tutto. Dia agli altri un accesso limitato e tenga per sé quello principale.
- Conservi impronta e punti di controllo altrove.
- Cifri il disco e restringa i permessi.
- L’HTTP semplice fuori da localhost espone il token. Usi HTTPS o un tunnel SSH.
- Controlli la copertura per individuare lacune e provi la consegna sui Suoi account e sulle Sue fonti.
Condivida l’accesso a un caso con permessi, scadenza e limiti di sessione.
Rafforzare la sicurezza di un’installazione
- Usi un account Telegram dedicato, mai quello principale.
- Tenga il pannello su 127.0.0.1. Accesso remoto solo via HTTPS (Caddy incluso) o tunnel SSH.
- Cifri il disco con la cartella dati.
- Limiti la cartella dati all’account di servizio (0700 su Unix, permessi della cartella su Windows).
- Tenga la chiave del vault altrove sui server: imposti
TGWITNESS_VAULT_KEY_FILEprima del primo avvio. - Salvi impronta e punti di controllo su un altro sistema ed esegua 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ì, apre solo il pannello. Fermi TgWitness, elimini panel-token.txt, riavvii. Diario, sessioni e chiavi restano. Se TGWITNESS_TOKEN è impostato, quel valore ha la precedenza sul file.
Segnalare una vulnerabilità
Security → Report a vulnerability su GitHub. Versione, impatto e una riproduzione minima con dati fittizi. Non invii mai credenziali, cartelle di account o prove reali. Se la segnalazione privata è disattivata, apra una issue chiedendo un canale privato, senza dettagli dell’exploit.