TgWitness / Documentazione

Cosa è stato testato →

Riferimento / Configurazione

Telegram · Connessione, proxy e protezione dei dati

Autenticazione, pool di proxy automatici, modalità IP, politica di fallback, richieste esterne e archiviazione dei dati riservati.

TgWitness / Documentazione · Implementazione e ripristino

Implementazione e ripristino

Questo documento descrive il comportamento di TgWitness0.9.3 e i suoi limiti. L’autenticazione, l’accesso alle fonti, la connettività di rete e la completezza dell’acquisizione sono stati distinti. Per le procedure di accesso, i formati dei file e la gestione di più account, consultare la sezione Account e formati di sessione. Per le politiche relative agli eventi e il comportamento in caso di riavvio, consultare la sezione Come funziona la raccolta.

Configurazione guidata della connessione#

In Altri strumenti → Account → Percorso di connessione, l’amministratore può scegliere Questo account, Un gruppo di account o Tutti gli account, quindi selezionare un percorso. L’opzione Rivedi selezione elenca gli account interessati. L’opzione Prepara e verifica testa il percorso proposto senza modificare quello salvato. L’opzione Applica connessione verificata convalida l’anteprima, mette in pausa il monitoraggio se necessario, salva il percorso e riprende il monitoraggio già in corso. Non avvia mai la raccolta in un account precedentemente inattivo. I download della cronologia rimangono in pausa e possono essere ripresi separatamente. Metti in pausa le esportazioni attive prima di effettuare il cambio.

Le modifiche ai gruppi mantengono per impostazione predefinita gli account con il proprio percorso. Deselezionare tale opzione solo quando l’anteprima elenca le modifiche desiderate. L'applicazione riporta i risultati di ciascun account; non si tratta di un'operazione "tutto o niente" che coinvolge tutti i database. Un cambio non riuscito ripristina le impostazioni precedenti di quell'account. L'impossibilità di riprendere l'operazione viene indicata esplicitamente. Le anteprime scadono dopo dieci minuti e le modifiche alle impostazioni di connessione o all'appartenenza ai gruppi richiedono una nuova verifica.

La funzione "Apply" riutilizza un risultato di preflight riuscito per un massimo di 90 secondi, purché il percorso, la modalità e la politica rimangano invariati. Un tunnel gestito deve comunque avere lo stesso processo in esecuzione. I risultati più vecchi, i processi del tunnel modificati e i percorsi automatici del pool MTProxy vengono ricontrollati. Il record dell'applicazione firmato conserva l'ora originale del controllo e registra il riutilizzo e la sua età. Ogni preflight chiude il proprio client temporaneo non autenticato; il collettore si connette utilizzando la propria sessione autorizzata.

Percorso Cosa gestisce TgWitness
Diretto Connessioni dall’host; non viene rilevata né imposta alcuna VPN da un host esterno.
VPN Un profilo WireGuard a tunnel completo per ogni account, gestito da un processo SOCKS5 locale nello spazio utente. Non viene installata alcuna interfaccia host né alcun driver.
Il mio proxy Credenziali SOCKS5, HTTP CONNECT o MTProxy. Un URL può compilare i campi SOCKS5/HTTP. Selezionando più account, si condivide questo proxy inserito.
MTProto pubblico Il pool esistente assegna percorsi Telegram. Le richieste esterne sono disabilitate fino a quando non viene configurato un proxy esterno adeguato nelle impostazioni avanzate.
WARP Un tunnel locale separato per ogni account selezionato, con registrazione WARP e un profilo WireGuard conservato nel vault di quell’account.

Il controllo del percorso corrente utilizza un nuovo trasporto Telegram non autenticato, non la sessione dell’account. Apre una connessione di trasporto attraverso il percorso verso il data center dell’account ed effettua un round trip MTProto non autenticato (req_pq_multi); non crea alcuna chiave di autorizzazione e non utilizza alcun account. La latenza riportata è costituita dal tempo di connessione più quello del round trip, e il controllo registra entrambe le parti separatamente. Per i percorsi compatibili con HTTP, richiede anche la traccia HTTPS di Cloudflare attraverso quella rotta e visualizza l’IP di uscita segnalato, il paese, lo stato WARP e l’ora del controllo. La preparazione WARP fallisce a meno che la traccia non segnali WARP attivo. Questi controlli preliminari segnalano la connettività della rotta e l’ uscita osservata. Esamina i record acquisiti attraverso i risultati di acquisizione e verifica dell’archivio. Un processo locale in esecuzione da solo non costituisce un controllo di uscita riuscito.

Il pannello calcola una media mobile degli ultimi cinque controlli. Un percorso è lento quando la media supera i 5 secondi o quando tre controlli consecutivi superano tale valore, e diventa non disponibile dopo due controlli falliti consecutivi; network.slow_route e network.route_recovered registra le modifiche. Per una rotta WARP lenta, Re-roll WARP riavvia il tunnel dell’account verso altri endpoint WARP di Cloudflare, mantiene quello più veloce e registra network.warp_rerolled i tempi prima e dopo; New WARP identity registra un nuovo dispositivo WARP e lo mantiene solo se è più veloce. L’indirizzo del proxy locale, l’account Telegram e la relativa sessione rimangono gli stessi; le connessioni Telegram si riconnettono attraverso il tunnel riavviato. Un percorso WARP lento viene riavviato automaticamente al massimo una volta ogni 30 minuti; quando ciò non è sufficiente, ulteriori riavvii richiedono l’intervento dell’operatore.

WARP e WireGuard portatili#

Si tratta di un'integrazione WARP non ufficiale che utilizza wgcf 2.3.1 e wireproxy 1.1.3 . L'amministratore accetta esplicitamente la configurazione prima del primo download o della registrazione a WARP. Tali connessioni di configurazione puntano direttamente a GitHub e Cloudflare e rivelano l’IP del computer. Il traffico ordinario dell’account mantiene il percorso esistente fino all’ applicazione. Cloudflare sceglie l’indirizzo di uscita e il Paese; tunnel separati possono condividere un indirizzo di uscita. La selezione del Paese, la rotazione periodica degli IP e un kill switch VPN a livello di host non sono forniti da questa funzionalità.

Download degli helper supportati: Linux e macOS x86-64/ARM64, e Windows x86-64. Gli artefatti vengono verificati rispetto agli hash SHA-256 inclusi nel codice sorgente revisionato, e gli eseguibili memorizzati nella cache vengono ricontrollati prima dell’avvio. Nessun programma ausiliario viene aggiunto al PATH, installato come servizio di sistema o dotato di un listener pubblico. Tutti i file risiedono nella directory portable-routes/ dell’area di lavoro e nelle voci crittografate del vault. Il listener di loopback SOCKS5 richiede credenziali generate in modo indipendente.

I profili privati e le credenziali dell’account WARP sono crittografati con il deposito di sicurezza dello spazio di lavoro esistente. Durante l’esecuzione, l’helper necessita di una configurazione in chiaro accessibile solo al proprietario; questa viene rimossa al termine normale dell’esecuzione. Un crash dell’host può lasciare questo file nella cartella dei dati accessibile solo al proprietario. Ciò non crittografa il disco né protegge dal suo amministratore. Il supervisore chiude il tunnel se il pipe padre del pannello scompare. Un tunnel non riuscito non abilita mai un fallback diretto. Il riavvio del pannello ripristina un tunnel selezionato; gli avvii non riusciti vengono riprovati con un ritardo limitato. Stop tunnel mette in pausa anche il monitoraggio e mantiene lo stato di arresto. Start tunnel avvia il tunnel; riprendere il monitoraggio separatamente quando si è pronti.

I profili WireGuard caricati devono contenere un'interfaccia e un peer, percorsi IPv4 e IPv6 completi, e non devono contenere hook, include, sostituzioni ambientali o listener aggiuntivi. Gli indirizzi degli endpoint pubblici vengono risolti e fissati prima dell'avvio. Utilizzare una VPN esterna o un gateway SOCKS5 per OpenVPN/IPsec e endpoint privati.

Metodi di autenticazione#

L’ID API e l’hash API identificano un’applicazione; non sostituiscono le credenziali di accesso all’account. In TgWitness sono facoltativi. Ordine di priorità: una coppia inserita nel modulo, poi una proveniente da un file JSON di un account importato, quindi la coppia salvata nell’area di lavoro, infine il pool integrato di 50 coppie pubbliche, provate in ordine casuale con rotazione automatica quando Telegram ne rifiuta una. Solo la coppia di Telegram Desktop (2040) viene inviata con una descrizione corrispondente del client Telegram Desktop. La propria coppia ottenuta dagli Strumenti di sviluppo API su my.telegram.org può essere utilizzata con tutti i propri account; ogni account mantiene comunque la propria autorizzazione.

Metodo Requisiti Assistenza TgWitness
Numero di telefono, codice, autenticazione a due fattori (2FA) facoltativa Accesso all’account; coppia API facoltativa Accesso al pannello di controllo
Chiave di autenticazione HEX + ID DC Chiave completa da 512 caratteri e DC 1–5 Scheda «Chiave di autenticazione diretta»; l’ID utente opzionale viene verificato prima che l’autorizzazione venga salvata
Telethon StringSession Una stringa di sessione valida Accesso al pannello di controllo
Telethon SQLite .session Testo completo e coerente Importazione diretta degli schemi tramite pannello 7/8; CLI offline opzionale
Pyrogram SQLite .session Sessione utente di produzione chiusa Importazione diretta degli schemi tramite pannello 2/3
Telegram Desktop TData ZIP Un unico account moderno; codice di accesso locale, se protetto Conversione in memoria con controlli di checksum e decrittografia
JSON dell'account Campi API/sessione/chiave supportati I metadati da soli non sono sufficienti per compilare le credenziali API; è comunque necessario un accesso tramite sessione/chiave o numero di telefono/codice QR
Accesso tramite codice QR Conferma da parte di un’app Telegram autorizzata Generazione locale di codici QR, scadenza/riprova, autenticazione a due fattori (2FA) opzionale
TDLib / Pyrogram StringSession Altri formati specifici per le librerie Non supportato
Token del bot Un bot dotato di un proprio modello di accesso e aggiornamento Non utilizzato da questo raccoglitore

Telegram sceglie la modalità di consegna del codice, compresa la scelta di inviare o meno un SMS. Un hash API non può ripristinare una sessione revocata né sostituire una password 2FA dimenticata. TgWitness non memorizza su disco i codici di accesso né la password 2FA di Telegram.

Per una fonte privata, l’account deve già disporre dell’accesso. Il nome utente di un gruppo non è necessario. Un proxy o un’importazione di sessione non conferisce né l’appartenenza al gruppo né i diritti di amministratore . Le impostazioni della chat determinano se i membri possono visualizzare la cronologia precedente alla loro adesione.

Importare un file di sessione di Telethon#

Telethon SQLite, Pyrogram SQLite e Telegram Desktop TData utilizzano formati diversi. Il pannello rileva e converte le strutture supportate; la ridenominazione di un file non costituisce una conversione. Seleziona una sessione e il relativo file JSON in corrispondenza della voce File, premi Verifica file, quindi Collega account. Sono accettati fino a quattro file corrispondenti per un totale di 8 MiB. Consultare i limiti di formato per i dettagli su TData/JSON. Non è previsto il recupero del codice di accesso. L'accesso tramite telefono/2FA o codice QR crea un'autorizzazione separata.

Il percorso opzionale della riga di comando, riservato esclusivamente a Telethon, rimane disponibile:

  1. Chiuda la sessione del client originale e crei una copia coerente. Il convertitore rifiuta i file con un WAL/registro incompleto. Chiuda il client originale in modo corretto, anziché eliminare tali file per aggirare il controllo.
  2. Dall’ambiente TgWitness, esegua:
python -m tgwitness.sessions account.session --out account.tgwitness-session
  1. In «Aggiungi account» → «File», carichi il risultato oppure incolli la stringa corrispondente e prosegua.
  2. Verifichi l’ID numerico dell’account visualizzato, selezioni le fonti e avvii il monitoraggio.

Il file convertito costituisce una chiave di accesso all’account non crittografata. Conservatelo in un archivio protetto e non inseritelo mai nel codice né inviatelo a un servizio di conversione di terze parti. TgWitness salva la sessione autorizzata nel proprio archivio crittografato. La copia di una sessione non crea un’autorizzazione separata: non eseguite client simultanei con chiavi di autenticazione clonate e non date per scontata la consegna indipendente degli aggiornamenti.

La conversione trasferisce l’autorizzazione, non i messaggi originali, la cache dell’entità o un cursore di aggiornamento permanente. Non garantisce il recupero degli aggiornamenti in caso di riavvio del processo.

MTProto, Telethon e proxy#

MTProto è il protocollo di Telegram. Telethon è la libreria client Python utilizzata da TgWitness. MTProxy è un proxy di trasporto per Telegram; SOCKS5 e HTTP CONNECT forniscono tunnel generici. Nessuno di essi sostituisce l’autenticazione dell’account.

Salvare il percorso per ogni area di lavoro in Altri strumenti → Account → Impostazioni → Impostazioni di connessione → Modifica percorso di connessione prima di effettuare l’accesso. Le nuove aree di lavoro utilizzano per impostazione predefinita MTProxy automatico · elenchi pubblici con l’opzione Nascondi l’indirizzo. Le aree di lavoro esistenti che utilizzavano esplicitamente Direct mantengono una modalità che lo consente.

I file vengono letti tramite connessioni separate da quella utilizzata per la lettura dei messaggi, proprio come fanno le app ufficiali. Nel data center dell’account viene riutilizzata la chiave di autorizzazione dell’account con una nuova sessione MTProto; per un altro data center viene creata una chiave che viene autorizzata mentre l’ account è connesso e viene conservata solo in memoria. Ogni connessione per i file utilizza lo stesso percorso dell’account. Il loro numero per data center è limitato da Parametri → Prestazioni → Connessioni file per data center Telegram; 0 legge i file solo tramite la connessione principale dell'account. È possibile stabilire al massimo cinque connessioni Telegram contemporaneamente su tutti gli account di un'installazione.

Modalità IP#

È il percorso a determinare la connessione. La modalità IP, ovvero la protezione IP nella sezione Account del pannello, determina quando l’indirizzo del server può essere esposto. Questi controlli non installano una VPN né instradano tutto il traffico del dispositivo.

Modalità Telegram Richieste esterne
Nascondi l’indirizzo (hide) Utilizzi un proxy; attenda se nessuno funziona. Nessuna soluzione alternativa diretta. Richiede SOCKS5/HTTP; respinge le richieste prive di un proxy idoneo.
Direct come ultima risorsa (fallback) MTProxy automatico può utilizzare Direct dopo il ritardo configurato, per poi tornare a un proxy funzionante. Si preferisce l’utilizzo di un proxy esterno configurato o del percorso SOCKS5/HTTP dell’account; in alternativa, è consentito l’accesso diretto.
Server protetto da un tunnel o da una VPN (tunnel) Sono consentiti percorsi diretti e il ricorso immediato al pool automatico di riserva. L’accesso diretto è consentito qualora non sia configurato alcun proxy applicabile.

La modalità tunnel o VPN presuppone che tu gestisca quella rete separatamente. Senza un tunnel funzionante, i destinatari possono vedere l’indirizzo del server stesso. Seleziona la modalità in base alla tua rete effettiva, non al nome dell’opzione.

Scegliete un percorso#

Percorso Impostazioni Limiti
MTProxy automatico Elenchi integrati o un catalogo di operatori Mantiene un percorso Telegram funzionante; il fallback diretto dipende dalla modalità IP
Diretto Modalità Tunnel o VPN Telethon utilizza il percorso di rete del conduttore
SOCKS5 Host, porta, nome utente/password (facoltativi) python-socks, DNS di destinazione remota abilitato
HTTP CONNECT Host, porta, nome utente/password (facoltativi) CONNECT HTTP semplice; il protocollo TLS verso il proxy stesso non è implementato
MTProxy Host, porta, chiave segreta Trasporto sperimentale Telethon; 32 cifre esadecimali oppure dd + 32 cifre esadecimali

I segreti TLS falsi di tipo ee vengono rifiutati. La normalizzazione di Telethon 1.45 può rimuovere un prefisso e un dominio, ma ciò non implementa il Fake TLS. Incollate tg://proxy?server=…&port=…&secret=… o https://t.me/proxy?server=…&port=…&secret=… e selezionate «Compila campi dal link». In questo modo i campi vengono convalidati e compilati senza effettuare alcuna connessione né salvare i dati; si prega di verificare e salvare il percorso separatamente. I campi manuali rimangono disponibili. Si vedano i link proxy di Telegram.

Proxy pubblici forniti dalla vostra installazione#

L'elenco integrato riunisce sette fonti: SoliSpirit/mtproto, zakky8/mtproto-proxy-pro, kort0881/telegram-proxy-collector, 3yed-61/MTP-Collector, Therealwh/MTPproxyLIST, KhodeJav/telegram-proxy-collector e tgmtproxy/telegram-mtproto-proxy-list. Lo snapshot incluso contiene informazioni sugli endpoint, l'attribuzione delle fonti e le date di download. Le voci dell’elenco costituiscono i dati di input; i controlli di connettività riportati di seguito determinano quali proxy vengono utilizzati.

MTProxy verifica automaticamente la connettività di trasporto di Telegram, mantiene attivo un proxy funzionante e passa a un altro quando questo fallisce. Gli spazi di lavoro preferiscono proxy diversi quando sono disponibili sufficienti voci funzionanti; i proxy possono condividere un indirizzo di uscita. I proxy non funzionanti rimangono inattivi prima di un nuovo tentativo. Se nessuno funziona, la modalità IP determina se la raccolta deve attendere o può utilizzare una connessione diretta. Il cambio di proxy non modifica l’account né cancella il suo diario. Le scelte e le modifiche relative al percorso vengono registrate nel diario firmato.

Quando i percorsi automatici sono attivi, gli elenchi vengono aggiornati ogni ora e i controlli di trasmissione vengono eseguiti ogni dieci minuti per impostazione predefinita. Tali intervalli sono configurabili. L’aggiornamento degli elenchi pubblici richiede un refresh; la semplice visualizzazione dell’elenco non modifica un percorso manuale salvato.

Il traffico Telegram e le richieste HTTPS utilizzano percorsi diversi. I download degli elenchi utilizzano una connessione HTTPS separata e il percorso di richiesta esterna fornito. Il TGWITNESS_PROXY_FEED_PROXY sovrascrive esplicitamente tale percorso con un proxy HTTP/SOCKS5; entrambe le varianti del collector Compose lo inoltrano. Il pool in background segue l’area di lavoro principale. Nessuna sessione Telegram, nessuna credenziale API, nessun token del pannello né token del bot viene inviato ai fornitori di feed. I nomi dei fornitori, le date degli snapshot e il percorso di download compaiono nella sezione «Da dove proviene l’elenco».

Un MTProxy trasporta solo il traffico di Telegram. Le operazioni HTTP dell’area di lavoro, quali timestamp, notifiche, copie off-site e controlli delle fonti, utilizzano un proxy SOCKS5/HTTP separato quando configurato, oppure il percorso SOCKS5/HTTP dell’account. In assenza di entrambi, l’opzione «Nascondi l’indirizzo» rifiuta la richiesta; le altre modalità consentono il collegamento diretto. Le richieste esterne possono essere disabilitate. Un proxy per il download dei feed configurato esplicitamente rimane una deroga separata da parte dell’operatore. Il servizio di testimonianza indipendente mantiene il proprio percorso.

Per i servizi privati gestiti dall’operatore, l’impostazione esistente dell’ambiente server TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1 consente le destinazioni private e mantiene la risoluzione del nome host lato proxy. Non può essere abilitata dal pannello di controllo. La modalità “solo pubblico” rifiuta le destinazioni ..onion prima di interrogare il resolver pubblico; i servizi onion di Tor richiedono tale impostazione esplicita per le destinazioni private e un proxy adeguato. Questo comportamento DNS si applica alle operazioni HTTP esterne, non al trasporto di Telegram. Cloudflare documenta l’endpoint DNS JSON.

Parametri automatici del pool

In Altri strumenti → Parametri → MTProxy automatico, configurare la soglia di errore, il tempo di attesa, la rotazione pianificata, la condivisione del proxy e il ritardo di fallback consentito.

Controllo Impostazione predefinita
Si disconnette prima della sostituzione 3 entro 10 minuti
Proxy provati per ogni tentativo di connessione 3
Primo / massimo riposo dopo un errore 10 minuti / 6 ore
Rotazione prevista Disabilitato; attivare in caso di errore
Account per proxy 0: preferire voci separate, unire quando necessario. Impostare 1 in modo da attendere una voce esclusiva.
Ritardo prima del fallback diretto consentito 10 minuti; Nascondi l'indirizzo, ma continua a rifiutare Direct
Controlli di aggiornamento / trasporto dei feed Minuti 60 / 10; i valori dell’area di lavoro principale si applicano al pool condiviso

Proxy diversi possono condividere un indirizzo di uscita. I limiti di Telegram si applicano su ogni percorso.

Per sostituire l’elenco pubblico con il proprio catalogo di operatori, configurare l’override riportato di seguito. Ciò disabilita completamente gli abbonamenti esterni, anche quando l’array proxies è vuoto.

Copi il catalogo vuoto in proxy-config/proxies.json e aggiunga i Suoi endpoint pubblici distribuiti:

{"format": "tgwitness-proxy-catalog-v1", "proxies": [
  {"id": "project-eu", "label": "Project EU",
   "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}

I valori di esempio devono essere sostituiti. Sono accettate fino a 32 voci distinte. L’ elenco autenticato restituisce etichette/host/porte senza segreti condivisi; selezionandone uno si salvano le relative credenziali nel vault dell’area di lavoro. La disponibilità rimane non verificata fino a un test di trasporto esplicito. Un catalogo non valido consente la configurazione manuale.

Avvio nativo: impostare TGWITNESS_PROXY_CATALOG come percorso JSON locale. Docker:

docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build

L’overlay monta proxy-config in sola lettura; i file devono essere leggibili dall’UID 10001 del container. Tale directory è esclusa da Git, dal contesto di compilazione di Docker e dagli archivi sorgente. Questo catalogo configura gli account di raccolta; il bot witness utilizza il proprio percorso HTTP/SOCKS5, non MTProxy.

Il fallback diretto è regolato dalla modalità IP sopra descritta. Sospendere il monitoraggio prima di modificare un percorso. Il salvataggio disconnette i client precedenti e annulla gli accessi non completati; un nuovo client utilizza il percorso salvato. Il collegamento tra registro e sessione dell’account rimane inalterato. Le impostazioni sostituiscono il percorso precedente: reinserire le credenziali del proxy al momento della modifica.

Le credenziali sono crittografate con l’algoritmo network.enc. L’API non restituisce il nome utente, la password né la chiave segreta. I record firmati contengono il tipo di percorso e indicano se le credenziali sono presenti, escludendo l’endpoint e le chiavi segrete. L’operatore può visualizzare l’endpoint nel pannello di controllo. I campi relativi alle chiavi segrete vengono cancellati dopo il salvataggio, il blocco o il cambio di area di lavoro.

La funzione «Verifica connessione Telegram», disponibile anche prima dell’accesso, apre e chiude una connessione temporanea non autorizzata a Telegram tramite il percorso. Non si collega a un sito web di verifica degli IP. Il successo della verifica attesta la connettività di trasporto, non l’accesso ai gruppi, la consegna completa o l’anonimato.

Il proxy si applica alle connessioni del client Telegram, compresi i download di file multimediali dai server di distribuzione (DC) di Telegram. Il browser, pip, SSH e gli strumenti TSA avviati manualmente seguono percorsi separati. Il nome host del proxy può essere risolto localmente. rdns influisce sui nomi host di destinazione; Telegram fornisce spesso indirizzi IP numerici dei server di distribuzione (DC).

SOCKS5 e HTTP CONNECT in chiaro non crittografano di per sé le credenziali del proxy né il tunnel client-proxy. MTProto protegge separatamente il traffico di Telegram. Utilizzare un canale sicuro appropriato verso il proxy su una rete non attendibile. I gruppi privati sono chat cloud protette da MTProto durante il transito; le chat segrete end-to-end sono un tipo di chat distinto, registrato dal modulo Secret Chat.

Crittografia e firme#

Livello Implementato Responsabilità dell’operatore
Traffico Telegram Telethon MTProto Affidabilità, percorso e disponibilità della piattaforma
Pannello web Token al portatore, impostazione predefinita di loopback, limiti delle richieste HTTPS o tunnel SSH per l’accesso remoto
Segreti Fernet per le credenziali API, la sessione, le credenziali proxy e la chiave privata di firma Protegga la chiave di decrittografia e l’host su cui è in esecuzione
Chiave di archiviazione Chiave locale o chiave master esterna per una nuova installazione Archiviazione protetta separata e backup delle chiavi
Messaggi e allegati Archiviazione dei dati dell’applicazione in testo semplice Disco/volume crittografato
ZIP/JSONL/CSV/HTML Controlli di integrità, nessuna crittografia dei contenuti Proteggere le copie esportate e i trasferimenti
Provenienza e data Registro firmato, ricevuta di elaborazione, strumenti RFC 3161 Chiave affidabile, punti di controllo indipendenti/TSA e procedura di custodia

La protezione dell’archiviazione nell’Account mostra questi stati. Il token del pannello è un segreto di accesso, non una password di crittografia. Concede l’accesso amministrativo; i token emessi possono essere limitati ad account e chat. Gli spazi di lavoro condividono il processo host e non sono tenant isolati.

BitLocker, LUKS, FileVault o un volume crittografato gestito possono proteggere l’archivio nell’ambito dei rispettivi modelli di minaccia. Un amministratore di una macchina in esecuzione e sbloccata può comunque leggere i dati. Si prega di includere SQLite WAL/SHM, file multimediali, esportazioni temporanee, swap, backup e download dal browser nella pianificazione dello spazio di archiviazione. Un volume Docker non è crittografato semplicemente perché si tratta di un volume.

Chiave master esterna#

Per una nuova installazione, collochi la chiave principale al di fuori della directory dei dati. Ciò non comporta la migrazione automatica di un archivio di chiavi locale esistente. Prepari una directory delle chiavi accessibile esclusivamente all’identità del servizio, quindi esegua:

python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case

PowerShell, utilizzando l’ambiente di progetto installato:

python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case

In Docker, montare il file in sola lettura al di fuori di /data, ad esempio in /run/secrets/tgwitness-master.key, e impostare la variabile d’ambiente su tale percorso. L’UID del servizio deve essere in grado di leggerlo. Trasmettere il percorso, non i byte della chiave, tramite file di ambiente/configurazione.

Ogni spazio di lavoro riceve un salt pubblico casuale e una propria chiave Fernet derivata tramite HKDF-SHA256. vault.external.json memorizza i metadati di derivazione, non la chiave principale. Una chiave mancante o errata impedisce l’avvio senza sostituirla in modo silenzioso. Conservare sia i metadati del salt che la chiave principale a scopo di ripristino.

Tutti gli spazi di lavoro derivano dalla stessa chiave principale; la sua compromissione compromette l’intera installazione. Il processo in esecuzione è in grado di decriptare i dati riservati. Non si tratta di un HSM né di un KDF basato su password. Non sono accettate password arbitrarie inserite dall’utente in sostituzione di una chiave casuale.

Conservare la chiave esistente per le installazioni attuali fino a quando non venga implementata e verificata una migrazione pianificata. L’eliminazione di vault.key o la sostituzione di una chiave master può compromettere l’accesso alle sessioni o alle chiavi di firma. Conservare separatamente i backup crittografati e le chiavi e testare il ripristino in un’istanza isolata.