# Un unico registro. Quattro modalità di raccolta. Otto livelli di verifica.

Canonical page: https://phishdestroy.io/tgwitness/it/guides/modes

Ambiti di raccolta, confini degli eventi, otto meccanismi di verifica e sei scenari investigativi fittizi.

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

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

Modalità, scenari e livelli di evidenza

TgWitness Registra ciò che l’account connesso osserva. Una terza parte può verificare l’integrità della registrazione rispetto a una chiave attendibile indipendente.

[Modalità di raccolta](https://phishdestroy.io/tgwitness/it/guides/modes#scope)[Scenari](https://phishdestroy.io/tgwitness/it/guides/modes#scenarios)[Livelli di evidenza](https://phishdestroy.io/tgwitness/it/guides/modes#levels)

Panoramica di 3–5 minuti · esempi fittizi · implementazione attuale

1. **Telegram**

   Aggiornamenti visibili sull’account
2. **Collector**

   Record collegati, ciascuno firmato
3. **Verificatore**

   Chiave fidata + confine mantenuto

`h₁ → h₂ → h₃ · Ed25519`Esamina ogni osservazione insieme agli identificatori della fonte e al registro di acquisizione.

## Scegliere l’ambito di osservazione

Tre ambiti e un’impostazione predefinita per le indagini. Le esclusioni e i tipi di fonte abilitati rimangono validi.

Impostazione predefinita**Chat selezionate**

Registrazioni

Solo fonti selezionate manualmente.

Nuove chat

Non viene aggiunto automaticamente.

Scegliere per

Un insieme noto di canali o gruppi. Non è stata specificata alcuna capacità fissa delle chat.

Cartella degli account**Cartella Telegram**

Registrazioni

Inclusioni di cartelle e categorie, escluse le esclusioni e le chat archiviate, se configurate.

Nuove chat

Corrispondenza delle chat attive; modifiche alle cartelle entro un’ora.

Scegliere per

Un analista gestisce già una cartella dedicata al caso. Confermare la raccolta su un account dedicato.

Confermare l’ambito**Account completo**

Registrazioni

Chat visibili dall’account, comprese le conversazioni private e i bot, all’interno di tipi selezionati.

Nuove chat

Da aggiungere al momento del primo aggiornamento.

Scegliere per

Un account dedicato all’osservazione, compreso un account che partecipa a un caso.

Preimpostazione dell’intero account**Modalità di indagine**

Registrazioni

Tutti i tipi di fonte, le azioni proprie, i profili delle fonti e gli ultimi 200 messaggi visibili delle fonti appena individuate.

Nuove chat

A ogni nuova chat o bot vengono assegnati un profilo e un’istantanea della cronologia.

Scegliere per

Entrare a far parte di un team o interagire con un bot tramite il pannello. Verificare e salvare le impostazioni predefinite.

Queste schede rappresentano un confronto locale, non controlli in tempo reale del collettore. Non modificano alcun account.

[Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/collection/)

## Acquisizione con GitHub Actions (anteprima)

Un nuovo accesso a Telegram, una chat, un archivio cifrato e un’attestazione di provenienza GitHub.

[Apri l’assistente di acquisizione](https://phishdestroy.io/tgwitness/it/docs/capture/)

## Cosa viene registrato

Solo le osservazioni consegnate o esplicitamente richieste vengono inserite nel registro. Le attribuzioni sconosciute rimangono tali.

 Acquisizione degli switch · illustrazione localeNuovi messaggiModificheCancellazioniReazioniAdesione

Il pannello applica queste opzioni per ogni area di lavoro. Disattivandone una, i record esistenti vengono mantenuti; riattivandola, gli eventi persi non vengono ricostruiti.

**Matrice degli eventi: materiale salvato e incognite residue**

| Categoria | Salvato |
| --- | --- |
| Messaggio | Testo, ID, metadati del mittente, contesto della risposta e busta di aggiornamento originale. |
| Modifica | Ogni versione osservata, senza sovrascrivere quelle precedenti. |
| Cancellazione | Avviso più il testo salvato in precedenza, se disponibile. |
| Cancellazione senza ambito | Avviso a livello di account; il peer sconosciuto rimane esplicito. |
| Reazione | Contatori consegnati e identità recenti visibili. |
| Adesione | Messaggi di servizio consegnati e aggiornamenti dei partecipanti. |
| Allegato | Descrittore della versione originale, byte salvati, SHA-256 e risultati dei tentativi. |
| Istantanea della cronologia | Messaggi attualmente visibili, contrassegnati come osservazioni della cronologia. |
| Azioni proprie | In uscita messages/edits e i metadati corrispondenti della tastiera di risposta button_press . |
| Pulsanti del bot | I metadati relativi a callback, URL, applicazioni web e richieste vengono conservati insieme al messaggio. |

### Limiti predefiniti per gli allegati

Foto

20 MiB

Video

100 MiB

File

50 MiB

Animazioni

20 MiB

Note video

50 MiB

Voce

20 MiB

Audio

50 MiB

Adesivi

5 MiB

[Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/collection/)

## Utilizzi l’autorizzazione di cui dispone

Ogni account dispone di un proprio spazio di lavoro, registro, chiave di firma, percorso e coda.

### Telefono + codice

Inserire 2FA quando abilitato.

### QR codice

Eseguire la scansione da un dispositivo autorizzato; 2FA potrebbe comunque essere richiesto.

### Telethon .session

Importare il file di sessione dell’account.

### Pyrogram .session

Importare il formato di sessione supportato Pyrogram formato di sessione supportato.

### TData ZIP

È supportato un solo account Desktop; codice di accesso locale, se impostato.

### StringSession testo

Inserisca un Telethon StringSession.

### .session + .json

Selezionare la sessione e i metadati associati corrispondenti.

### Chiave di autenticazione HEX + DC ID

Importare l’autorizzazione dell’account con il relativo identificatore del data center.

**API coppia**

La propria API è facoltativa. In assenza di una coppia, TgWitness viene utilizzato un pool di coppie pubbliche, comprese quelle provenienti dal client ufficiale di Telegram Desktop.

`Direct · SOCKS5 · HTTP CONNECT · MTProxy`MTProxy è sperimentale; sono disponibili MTProxy . Un percorso proxy non riuscito non ricorre a una connessione diretta.

Due aree di lavoro su un unico computer non costituiscono due testimoni indipendenti.

[Formati degli account](https://phishdestroy.io/tgwitness/it/docs/reference/accounts/)

## Agire dal pannello

Inviare o rispondere, premere un pulsante del bot corrente, salvare l’anteprima di un link, quindi entrare esplicitamente in una chat o avviare un bot con il relativo parametro di avvio.

`interaction.preview``interaction.requested``interaction.result`

Le conferme di anteprima, di richiesta e di risultato sono firmate. Prima che venga premuto un pulsante, il server recupera nuovamente il messaggio e rifiuta eventuali modifiche apportate tramite tastiera. Il testo e gli URL restituiti dalla callback rimangono registrati nel contesto.

[Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/collection/)

## Ripristino e continuità

Le lacune vengono evidenziate, non nascoste.

### Riprendere la posizione salvata

Dopo il riavvio, a Telegram vengono richiesti gli aggiornamenti mancati. La conservazione limitata nel tempo e le differenze scadute possono lasciare delle lacune.

### Ricontrollare i messaggi visibili

Impostazioni predefinite: fonti prioritarie ogni 15 minuti, le altre ogni 6 ore. I risultati includono message.recovered e message.missing_on_recheck.

### Leggere coverage.json

I periodi di osservazione, le lacune con relative motivazioni e gli ID non osservati accompagnano l’esportazione firmata. Un record mancante al momento della verifica non costituisce un avviso di cancellazione.

[Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/)

## Sette livelli. Domande diverse.

Ogni meccanismo risponde a una domanda circoscritta. Configurare i servizi esterni separatamente e mantenere i loro punti di riferimento di fiducia al di fuori del collettore.

1. ### Registrazione

   SHA-256 catena + Ed25519 per evento; il primo previous_hash è costituito da 64 zeri.

   **Verifiche da parte di terzi** Ordinamento e firme sotto la chiave del collettore fissata.

   **Comando di verifica**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
   ```
2. ### Contenitore

   manifest.json elenca gli hash dei file; manifest.sig lo firma; media.saved associa i byte degli allegati a un evento.

   **Verifiche da parte di terzi** I file forniti sono conformi al manifesto firmato e alle ricevute multimediali.

   **Comando di verifica**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
   ```
3. ### Confine mantenuto

   Eseguire un checkpoint all’avvio, ogni 5 minuti per impostazione predefinita, e un arresto ordinato. Conservarne una copia altrove.

   **Verifiche da parte di terzi** L’esportazione successiva è coerente con una lunghezza e un’intestazione conservate in precedenza; è possibile rilevare un rollback.

   **Comando di verifica**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json
   ```
4. ### Tempo esterno

   La modalità «Evidence» invia un checkpoint SHA-256 alle RFC 3161 autorità (FreeTSA, DigiCert) e OpenTimestamps ai calendari.

   **Verifiche da parte di terzi** Una risposta TSA verificata data tali byte; un OpenTimestamps prova li ancorerà a Bitcoin.

   **Comando di verifica**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca trusted-ca.pem
   ots upgrade checkpoint.ots
   ots verify checkpoint.ots
   ```
5. ### Testimone indipendente

   Separare l’host, l’endpoint in sola lettura con ambito definito, la nuova sfida e il proprio key/journal e TGW1 i post del canale.

   **Verifiche da parte di terzi** Heads precedentemente accettati; stati: ok, key_changed, rollback, fork, invalid e no_response.

   **Comando di verifica**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL
   ```
6. ### Replica fuori sede

   S3- copia compatibile crittografata con AES-256-GCM; Object Lock qualora il bucket lo supporti.

   **Verifiche da parte di terzi** Restore pubblica i file solo dopo che la verifica del diario, del checkpoint e dei contenuti multimediali conservati è stata completata con esito positivo.

   **Comando di verifica**

   ```
   python -m tgwitness.replica restore --key-file KEY.json --out EMPTY_DIR
   ```
7. ### Eseguire la verifica della provenienza

   Ricevuta di esecuzione firmata: hash delle fonti, versioni delle dipendenze e contesto del processo. Autodichiarata.

   **Verifiche da parte di terzi** Quanto riportato dal collettore di firme in merito alla propria esecuzione.

   **Comando di verifica**

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256
   ```

### Fonte e registro di acquisizione

Esamina ogni osservazione insieme agli identificatori della fonte e al registro di acquisizione.

[Testimone indipendente](https://phishdestroy.io/tgwitness/it/docs/reference/witness/)

Esperimento SHA-256 esperimento

### Provi a modificare il record 2

Il record successivo conserva il link salvato in precedenza. La modifica del testo altera l’hash calcolato del record 2.

Testo del record 2

Record 1`h1`Inizia con 64 zeri

Record 2`h2`Include i dati salvati h1

Record 3`h3`Include i dati salvati h2

Esempio statico: h2 riferisce a «Appuntamento alle 11:00». Modificando quel testo si modifica h2; il record 3 fa ancora riferimento a quello salvato h2.

**Esaminare i digest completi**

Hash del record 2 salvato

`SHA-256(e₂)`

Hash del record 2 ricalcolato

`SHA-256(e₂)`

Questo esempio calcola gli hash, non le firme. Il vero verificatore controlla ogni firma e ogni link rispetto alla chiave fidata.

 [Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/how-it-works/)

## Scegliere un percorso attraverso le prove

Situazioni fittizie. Avviare la raccolta prima dell’evento in questione; conservare i confini e le lacune insieme al contenuto.

### Un canale modifica i dettagli di pagamento

Modalità → eventi

Chat selezionate → messaggi, modifiche, cancellazioni.

Output

Versioni dei post e allegati osservati tramite hash.

Verifica

Firmato ZIP + checkpoint conservato + risposta TSA verificata.

### I messaggi scompaiono dopo un incidente

Modalità → eventi

Cartella o intero account → tutte le categorie di eventi.

Output

Originali salvati, avvisi di cancellazione e copertura con lacune.

Verifica

Firmato ZIP + diario di testimonianza indipendente.

### Analizzare un bot di negozio

Modalità → eventi

Preimpostazione di indagine → pulsanti, anteprime dei link e avvio esplicito del bot.

Output

Ricevute di interazione firmate, callback restituiti e profili salvati.

Verifica

Firmato ZIP; verificare qualsiasi dossier rispetto al ZIP.

### Un partecipante cambia nome da una chat all’altra

Modalità → eventi

Qualsiasi ambito → metadati sender/profile metadati.

Output

Cronologia dei nomi/nomi utente in base all’ID numerico, collegamenti «anche in» e indizi estratti.

Verifica

Il dossier JSON confrontato con il documento firmato ZIP.

### Osservazione a lungo termine con una copia fuori sede

Modalità → eventi

Qualsiasi ambito → Modalità "Evidence" e una S3 replica con supporto Object Lock.

Output

Copia crittografata, checkpoint conservati e risposte con timestamp.

Verifica

Eseguire il ripristino con la chiave esportata, quindi verificare senza il server originale.

[Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/investigation/)

## Consegnare un pacchetto verificabile

Fornire l’originale firmato, un’impronta digitale della chiave conservata in modo indipendente, il checkpoint pertinente e il risultato della verifica.

- Firmato ZIP
- JSONL
- CSV
- HTML
- Punto di controllo
- Conferma di ricezione
- Esportazione delle chat: chat.json / chat.html
- Dossier JSON
- Protetto da password AES-256 ZIP
- Esportazioni separate per più account
- CLI di streaming: 5 GiB limite predefinito

```
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint checkpoint.json --require evidence
```

Si ottenga il verificatore da una copia attendibile, non dall’archivio oggetto di verifica.

[Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/)

## Confrontare l’artefatto fornito

Artefatti di base senza sistemi aggiuntivi di firma, marcatura temporale o testimonianza. Gli script e i logger variano a seconda dell’implementazione; «parziale» significa limitato al materiale acquisito o visibile.

| Approccio | Modifiche / cancellazioni | Registrazione della firma | Tempo esterno | Testimone indipendente | Copertura / lacune | Verifica senza autore |
| --- | --- | --- | --- | --- | --- | --- |
| Esportazione da Telegram Desktop | Parziale | No | No | No | No | No |
| Telethon script di snapshot | Parziale | No | No | No | No | No |
| Registratore delle cancellazioni: registro di testo | Parziale | No | No | No | No | No |
| Screenshot / acquisizione web | Parziale | No | No | No | No | No |
| TgWitness con extra configurati | Parziale | Sì | Sì | Sì | Parziale | Sì |

[Leggere i dettagli](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/)

[Guida alla configurazione](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=it)[Account dedicato](https://phishdestroy.io/tgwitness/it/docs/dedicated-account/)[EVIDENCE.md](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/)[INVESTIGATION.md](https://phishdestroy.io/tgwitness/it/docs/reference/investigation/)
