TgWitness / Documentazione

Cosa è stato testato →

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.

127.0.0.1Indirizzo del pannello predefinito
256 bittoken casuale del pannello
0CDN, strumenti di analisi o font remoti
Ed25519firma su ogni registrazione

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.

06 / CIÒ CHE ESCE DALLA MACCHINALa vostra installazione
IL VOSTRO COMPUTER O SERVER
Pannello127.0.0.1:8787 · token bearer
Collectorun client Telegram per ogni area di lavoro
DIRECTORY DEI DATI
RegistroSQLite · concatenazione di hash · firmato
Multimediafile denominati in base all’SHA-256
VaultFernet · sessione, coppia API, chiave di firma, proxy
  • 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.

Le destinazioni opzionali vengono configurate per ogni area di lavoro.

Cosa svela ogni segreto

SegretoDove viene conservatoCosa offreIn caso di fuga di notizie
Token del pannellopanel-token.txt nella cartella dati; il browser lo tiene per schedaTutto, in ogni spazioFermi TgWitness, elimini panel-token.txt, riavvii: ne riceve uno nuovo
Sessione TelegramArchivio crittografato (credentials.enc)L’account Telegram stessoChiuda la sessione su Telegram da Impostazioni → Dispositivi
Chiave di firmaArchivio crittografato (signing.enc)Firmare voci con la Sua improntaPunti di controllo conservati altrove, un testimone e le marche temporali mostrano comunque cosa esisteva prima
Chiave di archiviazionevault.key accanto ai dati o una chiave master esternaIl vaultConsideri trapelate anche la sessione e la chiave di firma
Token WitnessSull’host di WitnessSola lettura: punti di controllo e statoLo elimini nella pagina del testimone e ne crei uno nuovo
Testo chiave per contenuti esterniVault: scaricatelo una sola volta per il ripristinoLa copia esternaChi 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

  1. Usi un account Telegram dedicato, mai quello principale.
  2. Tenga il pannello su 127.0.0.1. Accesso remoto solo via HTTPS (Caddy incluso) o tunnel SSH.
  3. Cifri il disco con la cartella dati.
  4. Limiti la cartella dati all’account di servizio (0700 su Unix, permessi della cartella su Windows).
  5. Tenga la chiave del vault altrove sui server: imposti TGWITNESS_VAULT_KEY_FILE prima del primo avvio.
  6. Salvi impronta e punti di controllo su un altro sistema ed esegua un testimone su un altro host.
  7. Non carichi mai le chiavi data/, di sessione, panel-token.txt o del vault su GitHub o in una chat.
  8. Non registrare le intestazioni Authorization né 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.