TgWitness / Documentazione

Cosa è stato testato →

Riferimento / Prove

Telegram · Archiviazione e ripristino

Backup, trasferimento dei file più vecchi sul cloud, copie protette da Object Lock e ripristino su un nuovo dispositivo.

TgWitness / Documentazione · Implementazione e ripristino

Implementazione e ripristino

Il pannello distingue tre attività:

Compito Cosa fa
Esegui un backup Copia il registro firmato, i checkpoint, i file conservati e le esportazioni in coda nella destinazione S3 configurata.
Spazio locale gratuito Copia gli allegati più vecchi selezionati su S3 o su un server remoto cloud rclone, rileggili per intero, verifica i byte crittografati, quindi elimina la copia locale verificata.
Conserva una copia come prova Configurare S3 Object Lock e verificare lo stato di conservazione restituito. Il servizio deve confermare la modalità e la data richieste.

La liberazione di spazio non elimina né sovrascrive mai il registro firmato. Ogni allegato conserva il proprio SHA-256 originale e una ricevuta di recupero. La compressione gzip opzionale avviene prima della crittografia autenticata. I nomi dei file nel cloud non contengono nomi Telegram, ID delle chat o nomi originali degli allegati. Un allegato può arrivare fino a 32 GiB.

Una risposta di caricamento da sola non costituisce autorizzazione alla cancellazione di un file. TgWitness scarica l’oggetto crittografato completo e ne verifica le dimensioni; SHA-256 salva la ricevuta, quindi ricontrolla immediatamente i byte locali prima della rimozione. Un errore di caricamento, una lettura diversa o un trasferimento annullato lasciano il file locale al suo posto. Se un backup delle prove abilitato non ha ancora copiato quel file, anche la rimozione attende che ciò avvenga.

In questa pagina

Quando il disco si sta riempiendo#

I download degli allegati vengono già messi in pausa sotto Altri strumenti → Parametri → Foto e file → Metti in pausa i download al di sotto di questo spazio libero su disco (1 GiB per impostazione predefinita), mantenendo la loro coda. Le osservazioni testuali continuano. Ciò non dipende dalle impostazioni delle notifiche. La disattivazione delle notifiche non disattiva la riserva di download né le misure di sicurezza relative all’archiviazione.

Per intervenire prima, abilita Esegui automaticamente, scegli Rimuovi il file locale per liberare spazio e abilita Avvia un trasferimento aggiuntivo quando lo spazio è scarso. La regola facoltativa parte sotto 5120 MiB liberi e procede per lotti fino a 10240 MiB, per impostazione predefinita. Entrambe le soglie sono configurabili. Destinazione, età minima dei file, limite del lotto, verifica tramite rilettura completa e requisiti di backup delle prove sono gli stessi dell’esecuzione manuale. La regola non abilita autonomamente una destinazione. I controlli avvengono ogni 30 secondi; errori o mancati progressi rimandano il tentativo successivo di cinque minuti. Stato e orario del tentativo sopravvivono al riavvio. Quando la regola è inattiva, le esecuzioni pianificate mantengono l’intervallo normale.

Il pannello mostra spazio libero, riserva di preparazione, stato della regola e file saltati per spazio temporaneo insufficiente. Preparazione e ripristino verificano il fabbisogno massimo di spazio temporaneo prima di iniziare e lo spazio disponibile durante la scrittura. Vale la riserva configurata per i download, con un minimo di 64 MiB per le operazioni di archiviazione. Non è una quota del filesystem: altri processi possono consumare spazio tra i controlli.

Gzip comprime senza perdita gli oggetti remoti; non riduce il registro attivo né crea archivi locali. JPEG, video e ZIP possono ridursi appena o aumentare leggermente. Con la compressione, la preparazione può richiedere temporaneamente circa il doppio della dimensione dell’allegato più la riserva. Scegli una soglia tempestiva per i file più grandi. Un file troppo grande viene conservato e segnalato; file più piccoli e copie remote già verificate possono ancora liberare spazio. Una copia verificata permette di rimuovere il file locale senza un altro file di preparazione. Anche il ripristino richiede spazio temporaneo e può essere rifiutato finché non è disponibile.

Senza file idonei da spostare o una destinazione configurata, TgWitness non può recuperare spazio automaticamente. La gestione dell’archiviazione non tronca né riscrive mai il registro firmato. Occorre comunque spazio per nuove osservazioni testuali.

Gli spazi di lavoro su un unico server condividono gli stessi allegati. A un file salvato viene assegnato un nome basato sul suo SHA-256; quando un altro spazio di lavoro dello stesso server contiene già lo stesso file nella cas/ della directory dei dati, la nuova copia viene sostituita da un collegamento fisico a quella esistente dopo che entrambi i file sono stati sottoposti nuovamente all’hash; in questo modo, tre spazi di lavoro che salvano lo stesso canale utilizzano lo spazio su disco di una sola copia. Ogni spazio di lavoro dispone comunque del proprio file in media/ e lo legge, esporta e scarica come prima. Un file che non può essere collegato, ad esempio su un filesystem senza collegamenti fisici, rimane una copia separata. Ad ogni avvio TgWitness rimuove da cas/ solo i file a cui nessun’area di lavoro è più collegata; un file dell’area di lavoro non viene mai rimosso da questa fase.

Collega una destinazione#

In Altri strumenti → Extra → Archiviazione e spazio su disco → Gestisci archiviazione, scegli l’attività e la destinazione, salva, quindi seleziona Prova di caricamento e download. Il test carica una piccola sonda casuale e la rilegge. Non utilizza contenuti di Telegram.

Per S3, utilizzare l’endpoint, la regione e il bucket effettivi del provider. Wasabi, Backblaze, Cloudflare R2 e altri servizi compatibili utilizzano le stesse impostazioni S3. Una API compatibile di per sé non implica il supporto per Object Lock. La modalità Governance può consentire a un amministratore autorizzato di bypassare la conservazione; la modalità Compliance presenta diversi vincoli. Leggere lo stato di Object Lock restituito prima di fare affidamento sulla conservazione.

Per una destinazione rclone, creare un remoto utilizzando la configurazione del provider di rclone e incollare la sezione [name] nel pannello. L’helper installato supporta MEGA, Google Drive, OneDrive, Dropbox, Box, pCloud e gli altri provider mostrati nel selettore. Le credenziali vengono salvate nel vault crittografato di questo spazio di lavoro. Gli aggiornamenti OAuth vengono salvati nuovamente nel vault. Le credenziali non vengono aggiunte agli eventi del registro né incluse nei download di ripristino.

L’helper viene installato all’interno dello spazio di lavoro, con una versione fissata e SHA-256. Non viene aggiunto al PATH di sistema. I file di configurazione e i file di lavoro sono file temporanei all’interno di quell’area di lavoro. I remote basati su comandi e su file locali vengono rifiutati. rclone richiede attualmente un percorso Direct selezionato esplicitamente per le richieste esterne. Utilizzare l’archiviazione S3 nativa per un percorso SOCKS5 o HTTP dell’area di lavoro; rclone non aggira silenziosamente un percorso non disponibile.

Conserva il file di ripristino#

Scegli l’opzione “Salva file di ripristino dopo aver copiato i file” e conservalo in un luogo separato dall’installazione. Contiene la chiave di decrittografia e le ricevute degli oggetti firmate, quindi trattalo come un backup della chiave privata. Conserva separatamente anche la configurazione remota originale e le credenziali di destinazione. Un file di ripristino creato prima di una copia successiva non contiene la ricevuta di quel file successivo.

Registrare in modo indipendente l’impronta digitale della chiave di firma: il confronto della firma con tale impronta digitale identifica a chi appartiene il file di ripristino.

Per ripristinare le ricevute di archiviazione mancanti in uno spazio di lavoro esistente, aprire «Recupera file da un file di ripristino salvato» e selezionare il file. Il pannello verifica la firma e richiede la stessa chiave di firma dello spazio di lavoro. Non accetta la sostituzione con una chiave di archiviazione diversa. Quindi scegliere «Ripristina tutti i file». Il ripristino mette in pausa la regola di archiviazione automatica, in modo che il successivo ciclo pianificato non possa rimuovere immediatamente i file ripristinati. Riattivare la regola quando si è terminato con le copie locali.

Il processo di ripristino verifica il testo cifrato, autentica la decrittografia, decomprime se necessario e controlla lo SHA-256 del testo in chiaro originale prima di inserire un file nella cartella media/. Un oggetto remoto danneggiato non sostituisce mai un file locale. L’importazione di un file di ripristino considera presente un file locale solo quando la sua dimensione e lo SHA-256 corrispondono alla ricevuta, quindi l’opzione Ripristina tutti i file ripristina anche un file locale i cui byte differiscono. Tali byte non vengono sovrascritti: una volta pronta la copia verificata, vengono spostati senza modifiche in storage-conflicts/EXPECTED_SHA256.LOCAL_SHA256, il journal registra storage.local_conflict e il risultato del ripristino elenca ogni conflitto. Il pannello "Storage" mostra quanti file contiene la cartella storage-conflicts/ ed elenca i primi 20 con la loro dimensione; il comando recover visualizza ogni conflitto con entrambi gli hash e il relativo percorso. Finché un file di questo tipo non viene ripristinato, un'esportazione completa delle prove richiede di ripristinare prima tutti i file.

Ripristino dopo la perdita dell’installazione#

Installa TgWitness su un altro computer. Utilizza il file di ripristino privato, l’impronta digitale registrata separatamente e le credenziali di destinazione originali:

python -m tgwitness.storage recover \
  --recovery storage-recovery.json \
  --fingerprint TRUSTED_WORKSPACE_SHA256 \
  --credentials original-rclone.conf \
  --output recovered-attachments

Per S3, --credentials punta a un file JSON privato contenente access_key e secret_key; il file di ripristino firmato fornisce le impostazioni di destinazione. Il comando utilizza una connessione esterna diretta e scarica l’helper aggiunto ai preferiti quando un remoto rclone ne ha bisogno. Rifiuta una directory di output esistente a meno che tale directory non contenga un ripristino interrotto dallo stesso file di ripristino firmato; l’esecuzione del comando una seconda volta mantiene i file verificati e prosegue con il resto.

I byte originali recuperati vengono scritti in recovered-attachments/media/, denominati in base al loro SHA-256. recovery-log.jsonl è un registro non firmato delle operazioni di recupero. Il comando non ricrea un diario firmato perso né la relativa chiave di firma. Conservare un backup completo dell’area di lavoro per questi elementi. Un file di recupero dell’archivio non è un backup completo dell’area di lavoro .

Bot operatore e notifiche di completamento#

Il bot di Telegram appartiene all’operatore. Crealo tramite BotFather e imposta il suo token, la chat di destinazione e gli ID utente Telegram esplicitamente consentiti nel pannello di controllo. Sia il mittente che la chat devono corrispondere. I messaggi inoltrati e i comandi provenienti da altri bot vengono ignorati.

/status e /stats sono disponibili nella modalità predefinita "solo stato". La modalità di controllo opzionale aggiunge /pause, /resume e /copy. /copy richiede l’esecuzione dell’attività di archiviazione configurata; ciò non significa che il caricamento remoto sia già terminato. I comandi non possono fornire URL, file o programmi shell arbitrari.

Utilizza le impostazioni di notifica separate per gli avvisi e il completamento delle attività. Le notifiche di completamento distinguono un’esportazione dell’account con lacune da un’esportazione completa e mostrano la cronologia e il conteggio degli elementi archiviati. Gli estratti dei messaggi non sono inclusi a meno che non siano stati abilitati separatamente nelle impostazioni di notifica. Il selettore di servizi viene generato dal catalogo Apprise effettivamente installato anziché da un insieme fisso di esempi di provider.