# Telegram · Caratteristiche e ambito

Canonical page: https://phishdestroy.io/tgwitness/it/docs/reference/features/

L’attuale modello di raccolta, i flussi di lavoro multi-account, le esportazioni e i limiti operativi di TgWitness.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/it/llms.txt)

L’attuale modello di raccolta, i flussi di lavoro multi-account, le esportazioni e i limiti operativi di TgWitness.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentazione](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Riferimento al progetto](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Riferimento al progetto](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561)

TgWitness conserva le conversazioni di Telegram accessibili agli account collegati, registra le modifiche osservate e prepara esportazioni verificabili. Il presente documento descrive il modello di raccolta, i flussi di lavoro attuali e i relativi limiti.

**In questa pagina**

- [Applicazione autonoma](https://phishdestroy.io/tgwitness/it/docs/reference/features/#standalone-application)
- [Indagini condivise](https://phishdestroy.io/tgwitness/it/docs/reference/features/#shared-investigations)
- [Strumenti di archiviazione](https://phishdestroy.io/tgwitness/it/docs/reference/features/#archive-tools)
- [Elementi aggiuntivi opzionali](https://phishdestroy.io/tgwitness/it/docs/reference/features/#optional-extras)
- [Protocollo e fonti private](https://phishdestroy.io/tgwitness/it/docs/reference/features/#protocol-and-private-sources)
- [Account multipli](https://phishdestroy.io/tgwitness/it/docs/reference/features/#multiple-accounts)
- [Acquisizione e attribuzione](https://phishdestroy.io/tgwitness/it/docs/reference/features/#capture-and-attribution)
- [Capacità e limiti di Telegram](https://phishdestroy.io/tgwitness/it/docs/reference/features/#capacity-and-telegram-limits)
- [Affidabilità e ripristino](https://phishdestroy.io/tgwitness/it/docs/reference/features/#reliability-and-recovery)
- [Modello di prova](https://phishdestroy.io/tgwitness/it/docs/reference/features/#evidence-model)
- [Esportazione, implementazione e trasferimento](https://phishdestroy.io/tgwitness/it/docs/reference/features/#export-deployment-and-handoff)
- [Criteri di rilascio della versione stabile](https://phishdestroy.io/tgwitness/it/docs/reference/features/#stable-release-criteria)

## Applicazione autonoma

TgWitness dispone di una propria procedura di installazione, di una directory dei dati e di un proprio ciclo di vita delle versioni. L’interfaccia web integrata gestisce la configurazione e la revisione; i record esportati possono essere utilizzati in modo indipendente.

L’operatore collega i propri account, sceglie le fonti visibili a ciascuno di essi e ottiene un registro delle osservazioni salvato. Il pannello mostra i contenuti, le modifiche salvate, la provenienza delle osservazioni e le lacune note. Un altro investigatore può verificare il materiale esportato.

Il pannello distingue tra autorizzazione dell’account, accesso a una fonte, attività del Collector e copertura registrata. Esaminare questi stati nel loro insieme quando si valuta un intervallo con pochi messaggi o un problema di connessione.

## Indagini condivise

Un amministratore può emettere [token di accesso](https://phishdestroy.io/tgwitness/it/docs/reference/access/) limitati agli spazi di lavoro e alle singole chat, con autorizzazioni per singola azione, restrizioni IP, scadenza, limiti di accesso e controllo delle sessioni. Un revisore in sola lettura può esaminare un caso senza ricevere l’autorizzazione Telegram o la chiave del pannello principale. L’accesso limitato alla chat rimane separato dalle impostazioni a livello di account e dalle esportazioni complete del diario.

MTProxy automatica mantiene attive le rotte Telegram da quattro fonti pubbliche o da un catalogo gestito dall’operatore. [Le modalità IP](https://phishdestroy.io/tgwitness/it/docs/reference/connection/#ip-modes) determinano se, in caso di errore, sia necessario attendere un altro proxy o se sia possibile utilizzare una rotta diretta esplicitamente autorizzata. Le richieste HTTP esterne dispongono di una rotta separata e di un interruttore di disattivazione.

## Strumenti di archiviazione

[L’acquisizione della cronologia](https://phishdestroy.io/tgwitness/it/docs/reference/history/), [la ricerca e l’analisi nell’archivio](https://phishdestroy.io/tgwitness/it/docs/reference/analysis/), [l’MCP in sola lettura](https://phishdestroy.io/tgwitness/it/docs/reference/mcp/), [l’OCR/trascrizione locale](https://phishdestroy.io/tgwitness/it/docs/reference/media-analysis/) e [i webhook in uscita](https://phishdestroy.io/tgwitness/it/docs/reference/webhooks/) sono stati inclusi a partire dalla versione 0.7.1. I report analitici e il testo riconosciuto rimangono separati dagli eventi acquisiti.

[Case Board](https://phishdestroy.io/tgwitness/it/docs/reference/case-board/) aggiunge segnalibri collegati alle fonti, citazioni, note e raccolte all’interno di un’area di lavoro. Il [generatore di report](https://phishdestroy.io/tgwitness/it/docs/reference/case-reports/) seleziona il materiale, le sezioni e uno degli otto modelli disponibili per l’esportazione in formato HTML/PDF supportata.

## Elementi aggiuntivi opzionali

La configurazione quotidiana è: account → fonti → osservazione. **Altri strumenti → Extra** è una sezione separata dedicata a acquisizione indipendente, archiviazione, obiettivi e livelli di protezione, notifiche, prove e backup, un server sempre attivo, un bot testimone su Telegram e un controllo del codice. Ciascuna opzione indica la propria disponibilità e i propri requisiti prima di mostrare le impostazioni. La selezione di una scheda apre le istruzioni; non comporta l’iscrizione né l’avvio di un servizio.

La configurazione del bot prevede tre passaggi: creare un accesso in sola lettura, scegliere le impostazioni di pubblicazione e avviare sul host del testimone. Le opzioni di rete e di pubblicazione, le connessioni esistenti e i comandi di verifica vengono resi disponibili su richiesta. La configurazione scaricata è distinta da un testimone in esecuzione. Il cambio di opzioni aggiuntive conserva la bozza; le modifiche all’account e il blocco cancellano il token temporaneo e il modulo. La guida integrata include le istruzioni di avvio. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md), aperto da Esportazioni, avvia un collettore aggiunto dal tuo fork, acquisisce una chat e produce un trasferimento crittografato con la provenienza del flusso di lavoro.

## Protocollo e fonti private

**MTProto è il protocollo di Telegram; Telethon è la libreria Python che TgWitness utilizza per comunicare tramite MTProto.** Non si tratta di metodi di connessione alternativi. La raccolta dati utilizza MTProto; il «witness» opzionale pubblica i controlli firmati tramite l’API del bot.

Ogni area di lavoro dispone di un proprio client autorizzato e di un flusso di aggiornamenti dell’account. TgWitness seleziona le osservazioni dalle fonti configurate ed effettua richieste esplicite separate per funzioni quali le istantanee della cronologia e il download di file multimediali.

Una fonte privata non necessita di un nome utente pubblico. Il tipo di peer Telegram e l’ID numerico costituiscono gli identificatori; i titoli e i nomi utente possono variare. L’accesso dipende dall’appartenenza e dalle autorizzazioni esistenti. TgWitness non si unisce automaticamente alle fonti né aggira l’approvazione di adesione. Un hash di accesso proveniente da un altro account non costituisce un token di accesso universale.

Il modello di raccolta deve tenere conto della cronologia nascosta precedente all’adesione, dei ruoli dei partecipanti e degli amministratori, della revoca delle sessioni, della rimozione o della modifica delle autorizzazioni, della migrazione da gruppo a supergruppo, degli argomenti e dei forum, delle discussioni collegate, delle identità dei canali e degli allegati non disponibili. Non tutte le combinazioni sono state verificate in tempo reale.

La visibilità della fonte viene verificata all’avvio del collettore. L’assenza di una fonte dal risultato del dialogo circoscritto indica **un accesso non confermato**, non una rimozione comprovata. Una fonte non disponibile non impedisce l’osservazione delle altre fonti accessibili. Non inserire mai link di invito o sessioni reali nei dati pubblici.

## Account multipli

Il pannello supporta un numero illimitato di **aree di lavoro**, ciascuna delle quali dispone di:

- Autorizzazione, archivio crittografato e percorso di connessione.
- Registro SQLite e identità di firma Ed25519.
- Fonti selezionate, coda dei media e impostazioni di acquisizione.
- Stato di monitoraggio, errori, punti di controllo ed esportazioni.

Il cambio dell’area di lavoro visualizzata non interrompe il funzionamento di un altro collettore. L’autorizzazione duplicata di un account tra diverse aree di lavoro viene rifiutata. Un registro già associato a un account Telegram non può essere riassegnato a un altro; è invece consentita la riconnessione dello stesso account. Ciò preserva l’identità dell’account e l’ambito relativo agli ID dei messaggi.

L’applicazione non imposta un numero fisso di spazi di lavoro. Ogni spazio di lavoro esegue le proprie attività di raccolta per il monitoraggio delle connessioni, il download di file multimediali, le verifiche incrociate e l’acquisizione di nuove chat all’interno di un processo Python condiviso e di un ciclo di eventi. La produttività dipende dal carico di lavoro. Per l’isolamento dei processi, utilizzare installazioni, porte e directory di dati separate.

Assegnare a ciascun account le fonti a cui può accedere. Account diversi possono osservare lo stesso gruppo, ma le loro osservazioni rimangono separate e conservano la propria origine. Due account su un unico dispositivo controllato da un operatore non costituiscono due testimoni indipendenti. **L’esportazione del gruppo** raggruppa i file ZIP degli spazi di lavoro firmati separatamente con un elenco di file firmato contenente i relativi ID degli spazi di lavoro, gli hash e le impronte digitali delle chiavi di firma. Ogni registro mantiene i propri confini. È possibile creare una cronologia combinata trasversale agli spazi di lavoro nelle note del caso o negli strumenti di analisi, mantenendo tali riferimenti alle fonti.

## Acquisizione e attribuzione

La sezione «Fonti» offre opzioni per singolo account relative a nuovi messaggi, modifiche, cancellazioni, reazioni e appartenenza ai gruppi. Le impostazioni predefinite conservano tutte le categorie oppure solo messaggi, modifiche e cancellazioni. La politica si applica ai gruppi selezionati dell’area di lavoro, rimane attiva anche dopo il riavvio ed è firmata con le modifiche prima e dopo. Le impostazioni predefinite conservano tutte le categorie. La disattivazione di una categoria non comporta la rimozione dei vecchi record; la sua riattivazione non ricostruisce gli eventi mancanti. I record operativi, gli altri eventi relativi ai servizi di gruppo e le istantanee esplicite della cronologia sono separati. Gli oggetti Telegram acquisiti possono conservare i metadati incorporati indipendentemente dalle opzioni di aggiornamento separato. Non sono ancora disponibili sostituzioni delle categorie a livello di gruppo.

| Materiale | Acquisito ora | Limiti |
| --- | --- | --- |
| Messaggio | Testo, ID dei partecipanti/messaggi, metadati del mittente, risposte e busta di aggiornamento originale | Conservato come osservazione visibile all’account e firmata dal responsabile della raccolta |
| Modifica | Nuova versione osservata, versioni acquisite in precedenza, ora di ricezione e data di modifica fornita | Gli aggiornamenti dei messaggi e le voci disponibili nel registro di amministrazione mantengono i rispettivi campi di attribuzione |
| Cancellazione | Notifica Telegram, ora di ricezione e contenuto precedentemente acquisito | L’attore e l’ora dell’azione di origine vengono conservati quando forniti da un record separato del registro di amministrazione |
| Avviso di cancellazione a livello di account | Avviso originale; i record risolti includono la chat salvata e il metodo di correlazione | È richiesta esattamente una corrispondenza tra una chat privata o un gruppo ordinario precedentemente salvati nell’ambito di applicazione; gli altri ID rimangono “`deletion.unscoped`”. Gli ID dei canali e dei supergruppi sono esclusi da questa correlazione |
| Reazione | Contatori forniti e identità recenti visibili | Per ottenere un elenco completo dei reattori disponibili sono necessarie ricerche separate; i canali potrebbero nascondere le identità |
| Iscrizione | Messaggi di servizio e aggiornamenti inviati ai partecipanti | La visibilità dipende dal ruolo e dal tipo di chat; l’appartenenza viene segnalata dagli eventi consegnati |
| Azioni dell’amministratore | Aggiornamenti rilevanti forniti e un’istantanea del registro di amministrazione nelle esportazioni delle chat di canali/supergruppi | L’esportazione legge il log quando è disponibile per l’account amministratore che esegue l’esportazione |
| Allegato | Descrizione della versione originale, byte scaricati/SHA-256 ed esiti dei tentativi | La versione originale resta; una versione successiva non la sostituisce mai |
| Cronologia | Istantanea esplicita dei messaggi attualmente visibili | La registrazione dal vivo conserva le versioni precedenti e gli avvisi di cancellazione |
| Processo di raccolta | Avvio/arresto, heartbeat, errori, impostazioni, ambito e ricevuta di esecuzione firmata | Inventario locale; GitHub e TDX aggiungono [controlli ambientali indipendenti](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/#verification-scope) |

L’interfaccia riporta l’account fornito nell’evento di origine e mantiene i nomi e gli username osservati. Quando l’evento omette l’autore, il rapporto lascia quel campo non specificato.

## Capacità e limiti di Telegram

La capacità viene dimensionata per ogni distribuzione. Dipende dal picco di eventi al secondo, dal volume e dalle dimensioni degli allegati, dagli RPC aggiuntivi, dagli account attivi, dalla latenza del disco e dallo spazio libero, dalle condizioni di rete, dai limiti di Telegram, dal ritardo accettabile e dalla profondità della coda.

Telegram distingue la consegna passiva dal polling breve attivo. La sua documentazione aggiornata descrive ulteriori chiamate a `updates.getChannelDifference` per canali aperti e supergruppi e raccomanda un massimo di **dieci fonti sottoposte a polling breve simultaneo**. Ciò si applica al polling breve; il numero di gruppi selezionati viene impostato separatamente.

| Modalità | Scopo | Stato |
| --- | --- | --- |
| Osservazione standard | Registrazione degli aggiornamenti ricevuti da fonti selezionate | Implementato |
| Ricontrolli prioritari | Le fonti contrassegnate con un asterisco utilizzano un intervallo configurabile autonomo e hanno la precedenza in ogni ciclo di ricontrollo delimitato | Implementato con query relative alla cronologia e ai messaggi |

L’asterisco di priorità controlla queste ricontrolli. Il polling breve aggiuntivo di ``updates.getChannelDifference` ` non è esposto come modalità utente separata.

Un polling arbitrario ad alta frequenza, che ignori FloodWait o ipotizzi una capacità lineare da account aggiuntivi, non costituisce un modello di dimensionamento valido. I limiti predefiniti sono i primi 1,000 dialoghi elencati, fino a 500 messaggi per istantanea della cronologia, 1–2,000 MiB per file raccolto per tipo e 4 GiB di contenuto ZIP firmato non compresso; ciascuno viene modificato per ogni area di lavoro, le dimensioni dei file in **Altri strumenti → Fonti → Registrazione** e le altre in **Altri strumenti → Parametri**. Le esportazioni non hanno un limite fisso per il numero di eventi. Il fallback del browser è limitato a 128 MiB per impostazione predefinita; la CLI di streaming ha un limite di trasferimento configurabile, 5 GiB per impostazione predefinita.

## Affidabilità e recupero

Le funzionalità implementate includono transazioni SQLite WAL/sincrone; scritture atomiche di messaggi e operazioni relative ai file multimediali; operazioni persistenti e ritardi di riprova; descrittori della versione originale; tentativi di riprova limitati; FloodWait persistente per i file multimediali; download di file multimediali al di fuori dell’ attesa di rete dell’evento di testo; esportazioni con prefisso stabile mentre proseguono le scritture successive; impostazioni atomiche e registrazioni di audit; mantenimento dell’autorizzazione operativa dopo un accesso di sostituzione non riuscito; isolamento di uno spazio di lavoro aggiuntivo danneggiato; tentativi espliciti di riconnnessione; segnalazione distinta della perdita di autorizzazione; e rilevamento delle modifiche in tempo reale tramite un orologio monotono.

I dati pts/qts/seq relativi agli account e ai canali vengono salvati e ripristinati dopo un riavvio, mentre le chat monitorate vengono ricontrollate periodicamente; si veda [il formato delle prove](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/#durable-collection-and-process-receipts-02). Il salvataggio periodico della posizione non costituisce una conferma atomica e senza perdite dell’accettazione del registro.

All’inizio di ogni processo vengono registrati il punto di inizio precedente e il limite offline. La cronologia attuale non viene considerata come una riparazione delle lacune. La conservazione delle differenze di Telegram è limitata; `differenceTooLong` non è in grado di ricostruire tutti i contenuti scomparsi. Le lacune irrecuperabili devono rimanere esplicite anche qualora una successiva istantanea della cronologia riesca a essere acquisita.

## Modello probatorio

Ogni evento registra una sequenza, l’ora di osservazione locale in UTC, l’ora di origine (se fornita), il tipo, la fonte, l’autore (se specificato), il payload originale, l’hash precedente e la firma. Le osservazioni dei messaggi conservano inoltre l’account del collettore e il contesto di esecuzione.

La ricevuta di processo firmata contiene un ID di esecuzione casuale; le versioni delle dipendenze di TgWitness/Python/OS; i valori SHA-256 dei file sorgente e l’impronta digitale aggregata; l’account iniziale, l’ambito e le impostazioni; le letture UTC/monotone; e l’intestazione del registro precedente. Le modifiche alle impostazioni, l’avvio/arresto e gli errori vengono registrati nello stesso registro. I punti di controllo vengono conservati all’avvio, ogni cinque minuti durante il monitoraggio (intervallo modificabile) e al termine ordinato dell’operazione. Un punto di controllo locale conservato è in grado di rilevare un rollback a un prefisso del registro precedente.

| Meccanismo | Cosa stabilisce |
| --- | --- |
| SHA-256 del file | I byte corrispondono a un digest noto |
| Catena di hash degli eventi | Registrazione dell’ordinamento/collegamento rispetto a un confine noto |
| Ed25519 | Firma con una chiave specifica |
| Punto di controllo gestito in modo indipendente | Il materiale successivo rispetta i limiti stabiliti |
| Analisi delle dimensioni del file di programma | Autodichiarazione del Collector relativa ai file misurati |
| Risposta valida e indipendente della TSA | Esistenza di determinati byte al momento TSA in base a presupposti di fiducia espliciti |

La preparazione delle richieste RFC 3161 e la verifica delle risposte sono implementate senza OpenSSL. La modalità prova invia anche gli hash dei checkpoint ai servizi di marcatura temporale configurati. Conservate e verificate la risposta dell’autorità per ottenere un ancoraggio temporale indipendente. Vedere [TIMESTAMP.md](https://phishdestroy.io/tgwitness/it/docs/reference/timestamp/).

Mantenere i checkpoint in modo indipendente, controllare l’accesso alle chiavi di firma, conservare i registri dei trasferimenti e verificare le esportazioni con software affidabile. L’[ambito](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/#verification-scope) [di verifica](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/#verification-scope) spiega in che modo tali controlli si integrano a vicenda e quali presupposti di affidabilità si applicano.

## Esportazione, implementazione e consegna

Un file ZIP firmato contiene i file originali in formato JSONL, CSV, HTML, gli allegati conservati, gli hash, un manifesto firmato e uno strumento di verifica di facile utilizzo. Copre un unico spazio di lavoro e un prefisso fisso per l’intero registro. I filtri di ricerca del pannello non eliminano silenziosamente i record. Sono esclusi le chiavi segrete, i token e le sessioni di Telegram; le osservazioni originali possono comunque contenere informazioni personali e metadati di Telegram.

Conservare separatamente il digest ZIP, l’impronta digitale attendibile, il checkpoint, la ricevuta di elaborazione e il registro di trasferimento. Utilizzare un verificatore proveniente da un’installazione attendibile, anziché fidarsi del codice eseguibile solo perché presente nel file ZIP esaminato.

L’interfaccia browser viene fornita localmente senza Node.js, CDN o font esterni. Un unico token operatore controlla l’installazione. L’accesso remoto richiede HTTPS o un tunnel SSH. Vengono fornite definizioni native in Python e per container, con esempi di servizio nella cartella [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md); i controlli di piattaforma eseguiti sono elencati separatamente.

L’area di lavoro predefinita utilizza la radice dei dati; le aree di lavoro aggiuntive utilizzano `profiles/<id>/`. Il backup richiede l’arresto del processo e il set completo di dati e chiavi. I file ZIP contenenti le prove non costituiscono backup dell’applicazione. Per le informazioni riservate è possibile utilizzare una chiave master esterna per una nuova directory di dati; la crittografia del registro e dei file multimediali è garantita dal disco o dal volume dell’operatore. Si vedano i file [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/it/docs/reference/connection/) e [OPERATIONS.md](https://phishdestroy.io/tgwitness/it/docs/reference/operations/).

## Criteri di rilascio della versione stabile

Prima del rilascio di una versione stabile, specificare:

1. Gruppi privati reali, supergruppi, forum e canali con ruoli di membri/amministratori e cronologia nascosta/visibile, inclusi accesso/autenticazione a due fattori (2FA), revoca e perdita di accesso.
2. Modifiche, cancellazioni, reazioni, appartenenza e contenuti multimediali controllati rispetto ad azioni note.
3. Arresti anomali del processo o del server, guasti al disco o disco pieno, riferimenti a file scaduti, FloodWait, perdita di connessione di rete, file danneggiati e rollback del database.
4. Utilizzo prolungato di più account con ritardi misurati, code, memoria e spazio su disco, comprese sia fonti silenziose che rumorose.
5. Interruzione tra l’avanzamento dello stato MTProto e l’accettazione del registro.
6. Installazione pulita sulla matrice di sistemi operativi/container prevista e ripristino del backup verificato.
7. Analisi indipendente in materia di sicurezza, firme e affermazioni relative all’attribuzione e alle prove.

L’accesso al pannello con ambito limitato è descritto nella sezione [Accesso e autorizzazioni](https://phishdestroy.io/tgwitness/it/docs/reference/access/). A partire dalla versione 0.6, TgWitness supporta l’importazione limitata di TData con account singolo e di file di account descritta in [ACCOUNTS.md](https://phishdestroy.io/tgwitness/it/docs/reference/accounts/). Consultare i termini dell’API di Telegram prima della pubblicazione. I riferimenti di ricerca e i risultati relativi alla piattaforma sono riportati in [RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md).
