# Telegram · Format der Beweismittel

Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/evidence/

Inhalt der signierten ZIP-Datei, Protokolltypen, Prozessbestätigungen, Benutzerprofile, externe Kopien und Offline-Überprüfung.

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

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

Translation coverage: this edition includes material from the English original.

Inhalt der signierten ZIP-Datei, Protokolltypen, Prozessbestätigungen, Benutzerprofile, externe Kopien und Offline-Überprüfung.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

TgWitness speichert für das Konto sichtbare Telegram-Beobachtungen in einem signierten Journal. Empfänger können die gespeicherten Datensätze, Anhänge und Berichte anhand eines vertrauenswürdigen Collector-Schlüssels verifizieren, die externe Zeit eines Drittanbieters für den letzten Datensatz überprüfen und das Journal mit einem zuvor gespeicherten Checkpoint vergleichen. Diese Seite beschreibt die Formate, die Prüfungen und das für die Übergabe aufzubewahrende Material.

Empfänger können unter Windows mit **VERIFY.cmd** beginnen: Das Programm fragt nach der Original- ZIP-Datei und dem unabhängig ermittelten Schlüssel-Fingerabdruck, zeigt ein kommentiertes Ergebnis an und speichert ein separates Verifizierungsprotokoll. Informationen zur Einrichtung und zu Vertrauensgrenzen finden Sie unter den [-Verifizierungs-Launchern und der portablen Laufzeitumgebung](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md).

**Auf dieser Seite**

- [Was ist signiert?](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#what-is-signed)
- [Vergleich von Chat-Exporten](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#comparing-chat-exports)
- [Übergabe der Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#investigation-handoff)
- [Auszug aus der Übergabe](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#handover-extract)
- [Lesbare Berichte](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#readable-reports)
- [Kanonisierung von Ereignissen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#event-canonicalization)
- [Akteur-Semantik](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#actor-semantics)
- [Abdeckung: Kontinuität, Lücken und nicht beobachtete IDs](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)
- [Ersteller](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#producer)
- [Personenprofile](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#people-profiles)
- [Unabhängiger Zeuge](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#independent-witness)
- [Manifest und Checkpoints](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#manifest-and-checkpoints)
- [Verifizierungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope)
- [Anhänge](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#attachments)
- [Dauerhafte Erfassung und Verarbeitung von Belegen (0.2)](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#durable-collection-and-process-receipts-02)
- [RFC 3161-Vorbereitung und Antwortüberprüfung (0.2)](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)
- [Optionale Datensätze im Beweismodus: drand und Telegram-Geräte](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)

## Was ist signiert?

| Material | Schutz | Was ist zu beachten? |
| --- | --- | --- |
| Jeder Eintrag im Protokoll, einschließlich operativer Ereignisse | SHA-256-Kette und eine Ed25519-Signatur pro Ereignis | Original-`events.jsonl`, der Fingerabdruck des vertrauenswürdigen Schlüssels, sowie ein gespeicherter Kontrollpunkt |
| Inhalt der ZIP-Datei mit den Beweismitteln | `manifest.sig` signiert das kanonische Manifest, in dem die Hash-Werte der Inhaltsdateien aufgeführt sind | Das vollständige ZIP-Archiv, einschließlich Manifest und Signatur |
| Erhaltene Anhänge | SHA-256 und Byteanzahl in einem signierten „`media.saved`“-Ereignis; Datei-Hash im signierten ZIP-Manifest | Die Originaldaten innerhalb der verifizierten ZIP-Datei |
| Checkpoint | Ed25519-Signatur über die Länge des Protokolls, den Kopf-Hash, den öffentlichen Schlüssel und den Erstellungszeitpunkt | Eine unabhängige Kopie, die vor einer umstrittenen Änderung gesichert wurde |
| Ausführungsbeleg | Signierte Aufzeichnung der Collector-Version, der Hashes der Quelldateien und der Starteinstellungen, ebenfalls in `process.started` enthalten | Der Beleg, der zugehörige Journal-Eintrag und die Umgebungsnachweise für den ausgewählten Verifizierungsmodus |
| Lesbare Berichte: „`report.html`“ und seine Teile „`report.json`“, „`report.pdf`“, „`chat.pdf`“ | Ein Ed25519-Siegel pro Datei über deren Inhalt; das PDF trägt zudem eine Standard-PDF-Signatur (siehe [Lesbare Berichte](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#readable-reports)) | Die empfangene Datei und der Fingerabdruck des vertrauenswürdigen Schlüssels; die darin beschriebene ZIP-Datei |
| Standalone-CSV | Keine eigenständige kryptografische Signatur; Ereignis-Hashes allein reichen nicht aus | Verwenden Sie den exakten Inhalt der verifizierten ZIP-Datei zur Integritätsprüfung. |
| Screenshots, Ausdrucke oder von einem Browser erstellte PDF-Dateien | Keine TgWitness-Signatur auf dem abgeleiteten Dokument | Bewahren Sie das ursprüngliche, verifizierte Paket auf und dokumentieren Sie, wie das Derivat erstellt wurde. |

Der Collector überprüft die Journal-Signaturen, bevor jedes Exportformat generiert wird. Lesbare HTML- und PDF-Berichte tragen ihre eigenen Siegel; eigenständige CSV-Dateien werden als Teil einer signierten ZIP-Datei überprüft. Behalten Sie die ZIP-Datei bei, um die Anhangsbytes und das Manifest zu erhalten, sowie einen separaten Checkpoint, um das Journal anhand einer früheren Grenze zu überprüfen.

## Formate und Verifizierungspfade

Der Erfassungsmodus und das Ausgabeformat beantworten unterschiedliche Fragen. Der Modus liefert Erfassungs- und Umgebungsnachweise; jedes Format bewahrt oder präsentiert einen Teil dieses Datensatzes unter Berücksichtigung der unten aufgeführten Prüfkriterien.

| Ausgabe | Verifizierung und Verwendung |
| --- | --- |
| Beweismaterial ZIP | Kanonische Ereignisse, signiertes Manifest, Abdeckung, Verwahrungseinträge, Anhänge und verfügbare externe Belege; überprüfen Sie das Archiv und dessen ausgewählten Erfassungsmodus. |
| ASiC-E-Container | Die ZIP-Datei mit den Nachweisen als ETSI-ASiC-E-Container (EN 319 162-1) mit einem `mimetype`-Eintrag und der Datei `META-INF/ASiCManifest.xml`, die mit dem arbeitsbereichseigenen Zertifikat auf Stufe B-B oder, bei aktivierter Zeitstempelung, auf Stufe B-T CAdES-signiert ist. Validatoren wie EU DSS prüfen Format und Integrität und melden, da das Zertifikat selbst ausgestellt wurde, keinen Vertrauensanker. EU DSS 6.3 lehnt mit den Standardeinstellungen einen Container mit mehr als 1000 Dateien ab („Zu viele Dateien erkannt“). `verify.py` überprüft das Ed25519-Manifest und jede aufgeführte Datei sowie die SHA-256-Werte in `META-INF/ASiCManifest.xml` und in einer hinzugefügten `ASiCManifestNNN.xml`- oder `ASiCEvidenceRecordManifest.xml`-Datei und schlägt fehl, wenn ein `META-INF/`-Eintrag vorhanden ist, der von keiner dieser Dateien abgedeckt wird. Es überprüft die CAdES-Signaturen nicht und gibt dies auch an. |
| HTML- und JSON-Berichte | Einzeln versiegelte Ansichten mit Quellenangaben, die ebenfalls im ZIP-Manifest aufgeführt sind. Ihre erfassten Zählwerte fassen die Arten der Journalereignisse zusammen. |
| PDF-Berichte | Ed25519-Siegel sowie eine PAdES-Baseline-PDF-Signatur über den Byte-Bereich: B-B oder B-T mit einem Signatur-Zeitstempel, sofern die Zeitstempelung aktiviert ist. Der TgWitness-Verifizierer verwendet den vertrauenswürdigen Ed25519-Schlüssel; die Anzeige der Zertifikatsvertrauenswürdigkeit durch den Betrachter ist eine separate Überprüfung. |
| CSV | Eine Tabellenkalkulationsansicht, die vom ZIP-Manifest abgedeckt wird. Die Formelauflösung schützt die Verwendung der Tabellenkalkulation; der ursprüngliche signierte Text verbleibt im Journal. |
| JSONL | Signierte Ereignisaufzeichnungen, einschließlich Verweisen auf Anhänge. Die ZIP-Datei mit den Nachweisen enthält zusätzlich die erhaltenen Anhangsdaten. |
| Chat-Export und Desktop-kompatible Ansichten | Erfassung des Verlaufs und der verfügbaren Admin-Log-Einträge mit der angeforderten Darstellung und dem signierten Archiv. Die gespeicherten Versionen der Live-Überwachung stellen einen separaten Erfassungspfad dar. |
| Medien und reine Hash-Einträge | Gespeicherte Bytes werden anhand ihres SHA256-Hashwerts und ihrer Nachrichtenreferenz überprüft. Bei der reinen Hash-Erfassung werden die verfügbaren Hash-Metadaten für einen späteren Vergleich mit den Dateibyte beibehalten. |
| STIX/MISP und Personenprofile | Quellverknüpfte extrahierte Beobachtungen, Konto-IDs und analytische Übereinstimmungen. Profilsignaturen und Datensatz-Hashes können mit den Originalnachweisen abgeglichen werden; die Herkunft des Avatar-Caches wird separat gekennzeichnet. |
| Auszug aus der Übergabe | Signierte Offenlegungsregeln, unveränderte Datensätze und markierte, minimierte Datensätze, die die ursprünglichen Hashes/Signaturen beibehalten. Verwenden Sie das beibehaltene Original für einen Vergleich, der zurückgehaltene Felder erfordert. |
| Zeugen und Zeitbelege | Frühere Journalgrenzen, Kontinuität und die einzelnen verifizierten Zeitangaben. Sie begleiten die Erfassungs- und Archivprüfungen. |
| Passwortgeschützte Bereitstellung | Schützt das enthaltene Paket während der Übertragung. `.tgwpw` verwendet eine authentifizierte AES-GCM-Verschlüsselung, einschließlich eines authentifizierten Abschlussdatensatzes; das enthaltene Journal behält seine Signaturen und Erfassungsbelege bei. |

Ein Ausdruck oder Screenshot ist eine Darstellung des signierten Materials. Seine Berichts- ID, der Schlüssel-Fingerabdruck und die QR-Referenz helfen dabei, die Originaldatei zur Überprüfung zu finden. Verwahrungserklärungen dokumentieren den bereitgestellten Prüfer und die Übertragungsinformationen; Prüferergebnisse und Erfassungsbelege werden als separate Beweismittel aufbewahrt.

### Externe Signaturen

Eine Signatur kann auch von einem Schlüssel stammen, den TgWitness niemals besitzt, wie beispielsweise die qualifizierte elektronische Signatur eines Ermittlers oder das Siegel einer Organisation. Bei **Exporten** gibt **die externe Signatur** auf einem vorbereiteten Export ohne Passwort die zu signierenden Bytes aus: eine neue `META-INF/ASiCManifestNNN.xml` Auflistung aller Dateien mit ihrem jeweiligen SHA-256-Hash für einen ASiC-E- Container oder die `manifest.json` für einen ZIP-Export. Der Unterzeichner gibt ein CMS (CAdES) zurück `.p7s`, entweder separat oder mit eingebettetem Inhalt.

TgWitness prüft, ob die Signatur genau diese Bytes abdeckt, und verifiziert sie anhand des Zertifikats des Unterzeichners (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Die Kette wird nur anhand der vom Betreiber bereitgestellten Stammzertifikate überprüft; Sperrstatus, vertrauenswürdige Listen und qualifizierter Status werden nicht geprüft. Das Fenster zeigt pro Signatur einen Status an: Warten auf eine Signatur, angehängt und nicht geprüft, verifiziert, Algorithmus wird nicht unterstützt, Signatur ungültig, signierte Bytes stimmen nicht überein oder Zertifikat ist nicht mit einem bereitgestellten Stammzertifikat verkettet. Wird der Export nach der Ausgabe der Bytes geändert, werden alle zugehörigen Signaturen auf „signierte Bytes stimmen nicht überein“ gesetzt.

**Beim Herunterladen mit Signaturen** werden die Signaturen und ihre Manifeste unter `META-INF` in einen ASiC-E-Container ein. Bei einer ZIP-Datei werden die unveränderte ZIP-Datei sowie die `.p7s` Dateien sowie `SIGNATURES.txt` in eine äußere ZIP-Datei. Ungültige Signaturen und Signaturen, die andere Bytes überlagern, werden weggelassen. Eine Signatur mit einem Algorithmus, den TgWitness nicht überprüfen kann, wird einbezogen; das Bedienfeld zeigt ihren Status an, ebenso wie `SIGNATURES.txt` bei einer ZIP-Datei.

### Signierte Chat-Bilder

**Durch das Herunterladen der signierten ZIP-Datei** in der Bildvorschau werden die Seiten als PNG-Dateien gespeichert, `pages.sig.json` und `README.txt`. Jede Seite endet mit den angezeigten Protokollnummern, dem Chat, der Renderzeit, dem Fingerabdruck des Arbeitsbereichsschlüssels und dem Befehl, der diesen überprüft. Das Fenster sendet nur den SHA-256-Hash und die Protokollnummern jeder Seite; der Server bestätigt, dass die Protokolle zu dem Chat gehören, signiert die Erklärung (`tgwitness-image-attestation-v1`) mit dem Arbeitsbereichsschlüssel und protokolliert die Signierung als `export.image_attested`.

```
python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip
```

Der Verifizierer überprüft die Signatur, ordnet jede PNG-Datei einer signierten Seite zu und gibt den Schlüssel-Fingerabdruck aus. `--fingerprint` Er vergleicht den Unterzeichner mit einem Fingerabdruck, der unabhängig vom Absender ermittelt wurde. `--evidence` Liest eine signierte ZIP-Datei mit Beweismaterial aus demselben Arbeitsbereich ein und verlangt, dass jeder Datensatz der Bilder mit demselben Hash vorhanden ist. Ein verändertes Pixel, eine geänderte Aussage oder ein anderer Schlüssel führt zum Fehlschlagen der Prüfung. Die Bilder zeigen gespeicherte Datensätze im TgWitness-eigenen Layout; sie zeigen nicht, was Telegram irgendjemandem angezeigt hat.

## Vergleich von Chat-Exporten

Überprüfen und vergleichen Sie zwei signierte ZIP-Dateien mit Chat-Exporten anhand unabhängig gespeicherter Fingerabdrücke der Unterzeichner:

```
python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
```

`--require` und `--require-tier` werden in Kombination mit `--compare` nicht akzeptiert; überprüfen Sie das erforderliche Profil jedes Archivs anhand der jeweiligen Verifizierung.

Wenn beide Archive dieselben numerischen Konto- und Chat-IDs aufzeichnen, werden die Datensätze anhand der Nachrichten-ID gepaart. **Unverändert** bedeutet Übereinstimmung des vollständigen gespeicherten JSON-Datensatzes: Volltext, Autor, Datumsangaben, Antwortziel, verschachtelte Metadaten und unbekannte Felder sind alle enthalten. Die Reihenfolge der Schlüssel im JSON-Objekt spielt keine Rolle; fehlende Felder, Nullwerte, Werttypen und die Reihenfolge der Arrays hingegen schon. Die 300-Zeichen-Vorschau dient nur zur Anzeige. Geänderte Einträge benennen die abweichenden `changed_fields`-Elemente der obersten Ebene, einschließlich Änderungen, die in dieser Vorschau nicht sichtbar sind. Doppelte Nachrichten-IDs werden beim Abgleich abgelehnt, anstatt sich gegenseitig zu überschreiben.

Eine Abweichung kann ein geänderter Anzeigename, eine geänderte Aufrufzahl, eine Sammlungsanmerkung oder andere Beobachtungsmetadaten sein. Telegram-Bearbeitungen erscheinen als eigene Bearbeitungsereignisse, und die Verifizierung jedes Archivs zeigt an, ob dieses Archiv intakt ist. Unparsierte Datensätze verbleiben im Vergleich und werden anhand ihrer gespeicherten Darstellung verglichen.

Bei abweichenden oder fehlenden Konto-/Chat-Identitäten ermittelt das Tool mögliche Übereinstimmungen anhand von Absender, vollständigem Text, Datei-Hash, Medientyp und einer Zeittoleranz von fünf Sekunden und meldet diese als **Matched** statt als **Unchanged**. Nicht geparste Datensätze bleiben unzugeordnet. Unterschiede in gepaarten Datensätzen werden unter `changed` aufgelistet, auch im Inhaltsmodus. Mit `--json` zählt `matched` die Kandidatenpaare und `unchanged` zählt Paare, deren vollständig gespeicherte Datensätze identisch sind. Die bestehenden Ausgaben `changed_fields` und `unchanged` (Ganzzahl) bleiben kompatibel mit früheren Vergleichsergebnissen. Das Archivformat und die Signaturüberprüfung bleiben unverändert.

## Übergabe von Ermittlungsergebnissen

1. Halten Sie die Fallreferenz, den Bearbeiter, die numerische Telegram-Konto-ID, die ausgewählten Quellen, die Erfassungsrichtlinie und den Erfassungszeitraum in Ihren Fallnotizen fest. TgWitness sichert Beobachtungen und unterstützt quellenverknüpfte Notizen und Erfassungen im [„Case Board](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/)“. Bewahren Sie Übergabe- und Verwahrungsprotokolle zusammen mit Ihren Fallunterlagen auf. Überprüfen Sie die geplante Erfassungs Konfiguration im Rahmen des [Live-Abnahmeverfahrens](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md).
2. Speichern Sie den Fingerabdruck des öffentlichen Schlüssels des Arbeitsbereichs separat, bevor Sie sich auf dessen Exporte verlassen. Lassen Sie den Nachweis-Modus aktiviert (Standardeinstellung), damit Checkpoints RFC 3161- und OpenTimestamps-Quittungen erhalten. Speichern Sie signierte Checkpoints während der Erfassung außerhalb des Collectors. Protokollieren Sie Unterbrechungen und die Grenzen der Sichtbarkeit des Kontos.
3. Exportieren Sie eine **signierte ZIP-Datei** und bewahren Sie die signierte Ausführungsbestätigung auf. Verwenden Sie einen Prüfpunkt an oder vor der Grenze des exportierten Protokolls. Ein späterer Prüfpunkt kann einen früheren Export zu Recht als zu kurz zurückweisen. Exporte umfassen das vollständige Arbeitsbereichsprotokoll, unabhängig von Panel-Filtern; überprüfen Sie das Material, bevor Sie es weitergeben.
4. Lassen Sie den Empfänger die ZIP-Datei mit einer vertrauenswürdigen Kopie des Verifizierers, dem unabhängig bereitgestellten Fingerabdruck und dem separat beschafften Stammzertifikat des Zeitstempeldienstes überprüfen. Ausgehend von einem vertrauenswürdigen Checkout mit aktiver Python- Umgebung:

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

   Der Fingerabdruck und ein geprüfter Zeitstempel des letzten Datensatzes erfüllen die Mindestanforderungen für Beweismittel; `--require evidence` beendet das Programm andernfalls mit dem Code 2. Der Checkpoint ist eine unterstützende Prüfung, da er mit dem Schlüssel des Collectors signiert ist. Bei erfolgreicher Ausgabe werden `key_pinned: true` und `checkpoint_checked: true` gemeldet, wenn beide Eingaben bereitgestellt und akzeptiert wurden. Behalten Sie das Verifizierungsergebnis bei.

   ```
   For a handover requiring the final exported record to be witnessed, use
   `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
   This refuses an export with an unwitnessed tail. Add
   `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
   witness posts as external time. See the
   [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
   ```

   1. Erfassen Sie den SHA-256-Hash des Archivs, die Exportgrenze, das Übertragungsdatum, den Absender und den Empfänger in Ihrem Aufbewahrungsprotokoll. Bewahren Sie das Originalpaket unverändert auf und arbeiten Sie mit Kopien. Geben Sie Beweisdateien weiter, nicht das private Datenverzeichnis der Anwendung, das auch Kontositzungen und Signaturgeheimnisse enthält. Wählen Sie für die Übertragung ein passwortgeschütztes AES-256-ZIP oder den sichereren `.tgwpw`- Container. ZIP verwendet die kostengünstige Passwortableitung von WinZip; verwenden Sie eine lange, zufällige Passphrase. `.tgwpw` verwendet scrypt und AES-256-GCM und lässt sich mit dem Befehl `unseal-password` des eigenständigen Verifizierers öffnen. Das Passwort wird nicht gespeichert und dient ausschließlich dem Schutz der Vertraulichkeit; der Empfänger entschlüsselt das Archiv und überprüft den darin enthaltenen signierten Export, der unverändert ist.
   2. Um einen Checkpoint außerhalb des Beweismodus mit einem Zeitstempel zu versehen, befolgen Sie das [Verfahren gemäß RFC 3161](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/) und bewahren Sie die Anfrage, den Checkpoint, die Informationen zur vertrauenswürdigen Zertifizierungsstelle sowie die verifizierte Antwort der Autorität auf. Das bloße Vorbereiten einer Anfrage führt nicht zum Erhalt eines Zeitstempels.

Verwenden Sie für `.tgwpw` einen unabhängig beschafften Verifizierer und wählen Sie eine neue Ausgabedatei mit der ursprünglichen Erweiterung: `python verify.py unseal-password export.tgwpw --out evidence.zip`. Der Befehl fordert zur Eingabe des Passworts auf; `--password-stdin` liest zur Automatisierung eine Zeile ein. Er überschreibt niemals eine vorhandene Datei und veröffentlicht Klartext erst, nachdem alle Datensätze authentifiziert wurden. Führen Sie anschließend eine normale Signaturprüfung an der entschlüsselten Datei durch. Der Container verwendet scrypt (`N=131072`, `r=8`, `p=1`, 16-Byte-Salt; ca. 128 MiB RAM) sowie AES-256-GCM mit 1 MiB großen Datensätzen und einem authentifizierten Abschlussdatensatz. Ein verschlüsselter Metadaten-Datensatz speichert den internen Dateinamen, sodass heruntergeladene Container umbenannt werden können.

Eine erfolgreiche Verifizierung stellt die Integrität in Bezug auf den vertrauenswürdigen Collector-Schlüssel und die beibehaltene Grenze sicher. Siehe [Verifizierungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) für die Vertrauensannahmen und [Validierungsergebnisse](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) der durchgeführten Prüfungen.

## Auszug aus der Übergabe

Eine signierte ZIP-Datei enthält das gesamte Arbeitsbereichsprotokoll. Wenn ein Gericht, ein Anwalt oder eine Meldestelle für Missbrauch nur bestimmte Chats, einen Zeitraum oder bestimmte Personen benötigt, erstellt **„Exporte → Übergabeauszug“** eine minimierte Kopie (`tgwitness-handover-v1`) gemäß den ausgewählten Offenlegungsregeln. Der Bediener gibt den Zweck an und wählt die Chats, einen optionalen Zeitraum (UTC) sowie die Personen aus, auf die sich der Auszug bezieht, und legt fest, was mit allen anderen geschieht (angezeigt, durch Pseudonyme P01, P02… oder weggelassen werden), welche Nachrichtentexte erhalten bleiben, welche Anhänge und Profilfotos enthalten sind und ob Telefonnummern und E-Mail-Adressen in Texten maskiert werden. Der Zweck und diese Regeln sind im signierten Manifest und im Bericht enthalten; das Journal protokolliert „`handover.exported`“ mit dem Zugriff, der es erstellt hat, sowie dem SHA-256-Hash der Datei, nicht den Inhalt.

`verify.py` überprüft einen Auszug auf zwei Arten. Ein als unverändert angezeigter Datensatz wird vollständig verifiziert: sein Inhalt wird mit seinem Hash, seiner Ed25519-Signatur und seinem Verweis auf einen enthaltenen Vorgänger abgeglichen. Ein minimierter Datensatz behält den ursprünglichen Hashwert und die Signatur bei, sodass die Signatur weiterhin gültig ist, die ausgeblendeten Felder jedoch nicht daraus neu berechnet werden können; der Datensatz gibt an, was ausgeblendet wurde, und der Bericht kennzeichnet dies. Kontoweite Dienstdatensätze (Start- und Stoppvorgänge, Abdeckungslücken, Verbindungs-, Netzwerk- und Speicherhinweise, Änderungen des Geltungsbereichs und der Einstellungen) behalten nur die für ihre Art aufgeführten Felder bei: Darin enthaltene Chat-Listen werden auf die ausgewählten Chats gekürzt und deren Gesamtzahlen neu gezählt; eine Lücke bei der Live-Abfrage in einem Chat außerhalb der Auswahl führt zum Verlust dieses Chats, seiner Nachrichtenanzahl und des Zeugen-Kontos; in einem ausgewählten Abfrage-Chat wird das Zeugen-Konto durch sein Pseudonym ersetzt, es sei denn, alle werden angezeigt oder es handelt sich um eine der ausgewählten Personen. Das Manifest gibt die Journal-Länge und den Kopf an, über dem die Signatur des Sammlers steht, und zählt die ausgelassenen Datensätze; `coverage.json` beschreibt die ausgewählten Chats. Neue Auszüge enthalten zudem `proofs.jsonl`: Für jeden enthaltenen Datensatz und für den Journal-Kopf wird der Merkle-Pfad vom ursprünglichen Hash des Datensatzes zur Journal-Wurzel angegeben, die im signierten Manifest genannt ist. `verify.py` überprüft jeden Pfad, sodass für jeden Datensatz nachgewiesen wird, dass er zu demselben Journal mit dieser Länge und diesem Kopf gehört, ohne dass das vollständige Journal vorliegt; ein Auszug mit 100 Nachrichten wird unabhängig von der Journalgröße in etwa einer Sekunde überprüft. `--range=CHAT:FROM-TO` bestätigt zusätzlich, dass Nachrichten von FROM bis TO eines Chats im Auszug enthalten sind, und gibt an, wie viele Datensätze dafür überprüft wurden. Namen innerhalb von Dateinamen werden nicht erkannt. Überprüfen Sie die endgültigen Dateien vor der Weitergabe: Freitext, Dateinamen und ausgewählte Anhänge können weiterhin Personen identifizieren. Bewahren Sie die vollständige signierte ZIP-Datei auf: Der Auszug ist eine Offenlegung, kein Ersatz.

## Lesbare Berichte

Signierte Beweismittel, Übergabe- und Chat-ZIP-Dateien enthalten lesbare HTML- und JSON-Berichte sowie PDF-Dateien, sofern die erforderlichen Schriftarten verfügbar sind, in der ausgewählten Berichts-Sprache. Jeder Bericht ist mit dem Ed25519-Schlüssel des Arbeitsbereichs versiegelt und kann separat überprüft werden: ` `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]``.

- `report.html` / `chat.html`: Die Seal-Anweisung (`tgwitness-report-seal-v1`) schließt die Datei und signiert das SHA-256 jedes davor liegenden Bytes. Lange Protokolle und Chats werden in Teile einer konfigurierbaren Größe aufgeteilt (Berichtseinstellungen, 500 bis 100.000 Datensätze; standardmäßig 5.000): `records/records-0001.html` oder `messages/messages-0001.html`, jeweils mit Nummer, Bereich und Gesamtsumme versiegelt und zusammen mit dem entsprechenden SHA-256 im signierten Manifest aufgeführt. Serien von Collector-Heartbeats werden als eine Zeile angezeigt, sofern sie in den Berichtseinstellungen nicht einzeln aufgeführt sind.
- `report.json` (`tgwitness-report-json-v1`, Schlüssel `format`, `report`, `seal`): Das Siegel signiert das SHA-256 des kanonischen JSON von `report`, sodass die Fakten von Fallbearbeitungssystemen und Skripten gelesen werden können und daraus eine Auswahl zum Datenschutz getroffen werden kann, während die signierte Datei intakt bleibt.
- `report.pdf` / `chat.pdf`: ein formelles Dokument zum Ausdrucken und Ablegen, das zweimal über dieselben Bytes signiert ist, wobei die gesamte Datei mit Ausnahme des Signaturwerts (`/ByteRange`). Die Standard-PDF-Signatur ist PAdES Baseline (ETSI EN 319 142-1, `/SubFilter /ETSI.CAdES.detached`: CMS mit SHA-256 und ECDSA P-256, Signaturzertifikat v2, keine CMS-Signaturzeit; die angegebene Zeit ist `/M`) auf Stufe B-B oder B-T mit einem RFC-3161-Signatur-Zeitstempel im CMS, wenn die Zeitstempelung aktiviert ist und eine Zeitstempelbehörde über die Route auf Anfragen außerhalb von Telegram antwortet. Es verwendet ein selbst ausgestelltes Dokumentensignaturzertifikat, das im Workspace-Tresor aufbewahrt wird; dessen Seriennummer entspricht dem Ed25519-Schlüssel-Fingerabdruck. Das Ed25519-Siegel wird innerhalb des CMS als das unsigned-Attribut `2.25.240684792623320047764573196045913242332` und benennt den SHA-256-Hash des Zertifikats mit `"content": "pdf-byte-range"`, sodass der Ed25519-Schlüssel für das Zertifikat bürgt. Das Zertifikat ist nicht qualifiziert: Ein PDF-Reader zeigt die Signatur als gültig und den Unterzeichner als unbekannt oder nicht vertrauenswürdig an, bis das Zertifikat als vertrauenswürdig eingestuft wird; vergleichen Sie stattdessen den Ed25519- Fingerabdruck. Chinesische, japanische und koreanische PDFs benötigen eine Schriftart auf dem Server (oder in `TGWITNESS_FONT_DIR`); ohne diese enthält die ZIP-Datei lediglich die HTML- und JSON-Berichte .
- `report.en.html`, `report.en.pdf` / `chat.en.html`, `chat.en.pdf`: das englische Original desselben Berichts, wenn die Berichtssprache nicht Englisch ist, auf dieselbe Weise versiegelt und signiert und im signierten Manifest unter `report.original` genannt. Der Bericht in der gewählten Sprache beginnt mit der Empfehlung, das englische Original mit einer beglaubigten oder vereidigten Übersetzung einzureichen; siehe [Berichte für Gerichte übersetzen](https://phishdestroy.io/tgwitness/de/docs/reference/translation/).

In einem Kanal oder einer Supergruppe nummeriert Telegram die Nachrichten der Reihe nach mit 1, 2, 3 … Ein Chat-Export listet die erste und letzte Nummer, die Gesamtanzahl sowie jede Folge fehlender Nummern in `message-ids.json` , das Manifest und den `chat.json` -Header auf und markiert jede Lücke an der Stelle, an der sie im Transkript auftritt. `verify.py` zählt sie ab `chat.json` neu. Eine fehlende Nummer ist eine Nachricht, die Telegram nicht zurückgegeben hat (vor dem Export gelöscht oder für das Konto nicht sichtbar); in privaten Chats und einfachen Gruppen werden die Nummern von allen Chats des Kontos gemeinsam genutzt, und Lücken werden nicht gezählt.

Nach dem Einlesen des Verlaufs fragt der Export bei Telegram erneut jede fehlende Nummer ab, und zwar nach Nummer (`channels.getMessages`, bis zu 10.000 Nummern einschließlich der 1.000 unterhalb der ersten Nachricht, gleichmäßig verteilt auf alle Lücken, sofern es mehr davon gibt). Das Ergebnis befindet sich in `message-ids.json` und im Bericht. Eine leere Antwort vermerkt, dass die Nummer zum Zeitpunkt der erneuten Überprüfung für dieses Konto nicht verfügbar ist; die Ursache bleibt dabei ungenannt. Eine bei der erneuten Überprüfung zurückgegebene Nachricht wird dem Export hinzugefügt und markiert `found_on_recheck`.

Wenn im Beobachtungsarbeitsbereich festgestellt wurde, dass Nachrichten des Chats gelöscht wurden, bei einer erneuten Überprüfung fehlten oder bearbeitet wurden, fügt der Chat-Export Folgendes hinzu `journal-changes.jsonl`: diese Protokoll-Einträge, jede gespeicherte Version sowie den Hinweis, jeweils mit dem Hash und der Ed25519-Signatur, die sie im Protokoll erhalten haben. `verify.py` berechnet den Hash jedes Datensatzes neu, gleicht dessen Signatur mit dem Exportschlüssel ab und vergleicht die Anzahl mit dem signierten Manifest; der Beweismittelexport enthält die vollständige Hash-Kette. Der Bericht listet diese Nachrichten unter **Löschungen und Frühere Versionen** auf.

Jeder Bericht beginnt mit **Kurz gesagt**: ein Absatz, dann was das Material zeigt und was die Aufzeichnung enthält. Der seiteninterne Siegelsstempel färbt sich bernsteinfarben, wenn der Browser die Signatur des Siegels überprüft hat, nicht die Seite selbst: Ein Browser weist einer Seite keine eigenen Bytes zu. Er wird erst grün, wenn der Leser die Datei in das Prüffeld am Ende der Seite zieht und jedes Byte übereinstimmt, und nur, wenn die angezeigte Seite genau diese Datei ist; andernfalls wird er rot.

Jeder Bericht nennt das Programm genau: den Git-Commit, bei dem der Collector aus einem Checkout ausgeführt wird oder der Installer `TGWITNESS_COMMIT` festlegt, sowie die SHA-256 der Quelldateien (`source_tree_sha256`, den kanonischen JSON des Pfads → SHA-256 jeder `.py`-, `.js`-, `.css`-, `.html`- und `.svg`-Datei im Paket), die ein Checkout dieses Commits reproduziert, sofern die Dateien nicht geändert wurden. Der Client „Telegram“ wird nach seiner Bibliothek, seiner API-Schicht und seinem Rechenzentrum benannt. Zu Beginn der Beobachtung sowie zu Beginn und Ende eines Chat-Exports fragt der Collector bei „Telegram“ nach dessen Zeit („`updates.getState`“, ganze Sekunden) und zeichnet die Zeit von „Telegram“ abzüglich der Uhrzeit des Collectors auf, unter Berücksichtigung der Ungenauigkeit durch die Übertragungszeit; die Berichte zeigen diese Messungen unter „Chain of Custody“ an. Ein Chat-Export protokolliert außerdem, wann er den Verlauf gelesen hat, zusätzlich zu den Datumsangaben der Nachrichten.

### Anleitung zum Offline-Berichtsbetrachter und zum Archiv

Entpacken Sie die ZIP-Datei vollständig, bevor Sie `chat.html` oder `report.html` öffnen. Der Viewer bietet Suchfunktionen, Filter, Teilnehmer, Indikatoren, Datensatzdetails sowie die Auswahl von JSON und CSV ohne Server. Bewahren Sie `viewer/` und `media/` neben dem Bericht auf. Auswahlen sind Ableitungen: Verwenden Sie `verify.py SELECTION.json
--evidence ARCHIVE.zip`, um sie mit dem signierten Archiv zu vergleichen. Der Verifizierer prüft die Berichts-ID, den Signaturschlüssel, die Archivgrenze und jeden ausgewählten Eintrag; bearbeitete, fehlende und doppelte Einträge führen zu einem Fehler. Auswahlhinweise und Erstellungszeitpunkt bleiben unsignierte Metadaten.

Lücken bei den Nachrichtennummern werden nur bei einem vollständigen, ungefilterten, aufsteigend sortierten Chat-Feed angezeigt. Das Ausblenden einer Kategorie oder das Nichtladen eines Datenblocks darf eine ausgelassene Zeile nicht als Hinweis auf eine fehlende Nachricht interpretieren. Suchmarkierungen werden auf Klartext vor der HTML-Escape-Verarbeitung angewendet, wobei literale Markups beibehalten werden.

Der Browser überprüft Manifest-Signaturen, die Berichts-ID und den Schlüssel sowie alle aufgeführten Datei-Hashes. Er lehnt mehrdeutige oder fehlerhafte ZIP-Strukturen, doppelte Namen und unsichere Pfade ab und begrenzt Dateien auf 256 MiB sowie die angegebene Gesamtgröße des Inhalts auf 4 GiB. Verwenden Sie für größere Archive den eigenständigen Verifizierer. Diese Browserprüfung ergänzt die Prüfungen des Verifiers hinsichtlich Journalketten und Datensemantik.

`README.txt` enthält eine Einführungsanleitung, ein abgeglichenes Dateiverzeichnis, Anweisungen zur Überprüfung sowie Hinweise zum Datenformat in der Berichts-Sprache, gefolgt von einer vollständigen englischen Anleitung. `SHA256SUMS` umfasst die darin aufgeführten Dateien, mit Ausnahme der Datei selbst, von `manifest.json` und `manifest.sig`; das signierte Manifest umfasst zudem `SHA256SUMS`. Behalten Sie die ursprüngliche ZIP-Datei unverändert bei und speichern Sie Arbeitsdateien außerhalb des entpackten Ordners. PDF-Berichte enthalten Abschnitts-Lesezeichen sowie Fall-/Berichts-Identifikationen auf den folgenden Seiten.

### Der Chat zum Zeitpunkt des Exports

Ein Chat-Export erfasst, was Telegram zu Beginn des Exports über den Chat angegeben hat: Telegrams eigene Bezeichnungen (`scam`, `fake`, `restricted` mit den jeweiligen Begründungen, `verified`), Benutzernamen, Beschreibung, Anzahl der Mitglieder und Administratoren, die verknüpfte Diskussion, den Inhaltsschutz, ob neue Mitglieder frühere Nachrichten sehen können und ab welcher Nachricht dieses Konto den Verlauf einsehen kann (`available_min_id`), das Datum der ersten Nachricht, sofern es sich um die Erstellung des Chats handelt, sowie die SHA-256-ID des Chat-Fotos (gespeichert in `media/`). Es erfasst die Position des exportierenden Kontos im Chat: Rolle, Beitrittsdatum, wer es eingeladen hat und, im Falle eines Administrators, dessen Rechte. Eine von Telegram abgelehnte Anfrage wird stattdessen benannt.

Wenn das exportierende Konto ein Administrator ist, liest der Export das Administratorprotokoll des Chats (Telegram bewahrt dieses etwa 48 Stunden lang auf) in die Datei `admin-log.json` ein: Löschungen und Bearbeitungen mit dem bereitgestellten Inhalt, dem ausführenden Konto und dem Datum der Quellaktion. Diese Einträge ergänzen die erfassten Versionen des Live-Journals und die Aufzeichnungen über den Empfang von Löschungen.

### Indikatoren

Die Berichtsliste und das Archiv enthalten die Einträge `indicators.csv` , `indicators.stix.json` (STIX 2.1 ) sowie `indicators.misp.json` (Ereignis MISP ), auf deren Grundlage eine Missbrauchsstelle in den aufgezeichneten Nachrichten Maßnahmen ergreifen kann: Links und Domains (auch solche, die hinter Text, in Schaltflächen und in Link-Vorschauen verborgen sind), Kryptowährungs- Adressen, Telegram -Benutzernamen und Einladungslinks, Telefonnummern, E-Mail-Adressen und gespeicherte Bilder. Bitcoin-, Litecoin-, Dogecoin- und TRON-Adressen werden nur aufgeführt, wenn ihre Base58-Prüfsumme stimmt, SegWit-Adressen, wenn ihre Bech32- oder Bech32m-Prüfsumme stimmt, und TON-Adressen, wenn ihr CRC stimmt; EVM- und Solana-Adressen werden als nicht geprüft markiert. Bilder enthalten SHA-256 und einen perzeptuellen Hash (dHash, 64 Bit), der bei komprimierten oder in der Größe angepassten Kopien nahezu unverändert bleibt. Berichte schreiben Indikatoren so, dass sie nicht versehentlich geöffnet werden (`hxxps[://]example[.]com` ); die Dateien behalten die Werte unverändert bei. Jeder Indikator wird als unbekannt und nicht zur automatischen Erkennung gekennzeichnet (STIX , `indicator_types: unknown` , MISP , `to_ids: false` , Verteilung an die eigene Organisation): Die Auflistung bedeutet, dass eine Nachricht ihn enthielt, nicht, dass er bösartig ist. Ein Link, dessen Text eine andere Adresse anzeigt als die, die beim Öffnen angezeigt wird, wird im Bericht markiert.

Die „PDF“-Berichte enden mit einer vom Prüfer handschriftlich zu unterzeichnenden Erklärung, einer Checkliste für einen Notar oder Gerichtssachverständigen sowie einem QR-Code (ebenfalls auf der ersten Seite) mit der Berichts-ID, dem Schlüssel-Fingerabdruck und dem „SHA-256“ der maßgeblichen Daten, sodass ein Ausdruck zum entsprechenden Archiv zurückverfolgt werden kann.

## Kanonisierung von Ereignissen

Die Hash-Eingabe besteht genau aus folgenden Feldern:

```
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
```

Serialisierung unter Verwendung von Python-kompatiblem JSON mit UTF-8, sortierten Objektschlüsseln, ohne ASCII- Escaping, ohne unbedeutende Leerzeichen und ohne NaN/Unendlich:

```
json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")
```

Der SHA-256-Hash dieser Bytes wird zum Ereignis-Hash. Die Signatur erfolgt mit Ed25519 über die 32 Roh-Hash-Bytes und wird anschließend Base64-kodiert. Der erste „previous_hash“ besteht aus 64 Nullen. Die Sequenznummern beginnen bei 1 und erhöhen sich um 1. Alle Ereignisse, einschließlich operativer Ereignisse, teilen sich eine Kette. Es erfolgt keine Unterdrückung doppelter Zustellungen: Wiederholte Beobachtungen stellen separate Empfangsbestätigungen dar und sind kein Hinweis auf unterschiedliche Telegram-Aktionen.

Rohdaten von Telegram-Nachrichten sind ISO-Zeichenketten; binäre Felder werden zu Objekten, die bytes_base64 enthalten. Nachrichtentext, Entitäten, Mediendeskriptoren, Antwort-Metadaten, Reaktionen und Service-Aktionen werden in den Rohdaten der Nachricht beibehalten, sofern sie vorhanden sind. Eine Live- Nachricht behält außerdem das Telegram-Update bei, durch das sie übermittelt wurde `transport_update`; wenn dieses Update dieselbe Nachricht enthält wie `raw`, wird ihr `message` Feld ist `{"same_as": "raw"}` anstelle einer zweiten Kopie.

`observed_at` ist die UTC-Zeit, zu der der Collector den Datensatz geschrieben hat; `source_at` ist das Datum, das von diesem Telegram-Ereignis bereitgestellt wird. Bei Datensätzen, die während der Verarbeitung einer Live-Aktualisierung geschrieben werden, wird zusätzlich `payload.received_at`, die UTC-Zeit, zu der das Update den Collector erreichte, sowie `payload.processing_delay_ms`. Live-Bearbeitungen behalten das übermittelte Bearbeitungsdatum bei, Verlaufs-Snapshots behalten das Nachrichten-Datum mit einer aktuellen Beobachtungszeit bei, und eine gewöhnliche Löschbenachrichtigung zeichnet die Empfangszeit mit einem Null-Quelldatum auf. Admin-Log- Einträge behalten ihr übermitteltes Aktionsdatum separat bei. Die Empfangsreihenfolge und die Reihenfolge der Quellereignisse sind unterschiedliche Zeitachsen, wobei Uhrzeitbeobachtungen und externe Empfangsbestätigungen zum Vergleich zur Verfügung stehen.

## Semantik der Akteure

Die Zuordnung erfolgt anhand der Ereignisquelle. `message.new.actor_id` und `message.edited.payload.sender_id` enthalten den Absender der Nachricht. Gewöhnliche `message.deleted`-Benachrichtigungen enthalten Nachrichten-IDs und haben ein null-Feld für den Akteur; verfügbare Admin-Log-Einträge enthalten die angegebene Aktion, den Akteur und das Datum. Nachrichten des Mitgliedschaftsdienstes enthalten Absender und Aktionstyp, rohe Teilnehmer-Updates enthalten die angegebene `actor_id`, und Reaktions-Snapshots bewahren ihre angegebenen Zählwerte und sichtbaren Identitäten. Lesen Sie diese Datensätze zusammen mit den erfassten Versionen und [den Belegen für die Panel-Interaktion](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#own-actions).

Löschbenachrichtigungen für private Chats und normale Gruppen enthalten nur Nachrichten-IDs. Diese Chats teilen sich eine kontoweite ID-Sequenz, sodass eine ID eine einzelne Nachricht dieses Kontos identifiziert. Wenn eine Nachricht mit dieser ID zuvor in diesem Journal gespeichert wurde, wird die Löschung in diesem Chat als `message.deleted` mit der Nutzlast `chat_resolution` als Methodenname aufgezeichnet. IDs, die nie gespeichert wurden, werden als `deletion.unscoped` geführt: eine tatsächliche Löschbenachrichtigung, deren Chat noch nicht zugeordnet wurde. Dies unterscheidet sich von `message.missing_on_recheck`, das ein nicht verfügbares Abfrageergebnis protokolliert, sowie von einer Lücke in den gespeicherten Nachrichten-IDs. Kanäle und Supergruppen nummerieren Nachrichten pro Chat und werden auf diese Weise niemals zugeordnet. Wenn die gelöschte Nachricht vom beobachteten Konto gesendet wurde, ist `payload.deleted_message_was_outgoing` wahr; der Löschende wird weiterhin nicht angegeben.

Eine Benachrichtigung ohne Geltungsbereich behält ihre eigene Kennzeichnung bei, da sich der passende Chat möglicherweise außerhalb des aktuellen Beobachtungsbereichs befindet oder keine eindeutige Übereinstimmung aufweist. Die erneute Überprüfung auf Fehlen bleibt eine separate Beobachtung gegenüber einer Löschbenachrichtigung in Berichtszahlen, Filtern und Kennzeichnungen. Eine spätere Wiederherstellung hebt den aktuellen Fehlzustand auf, während die frühere erfolglose Überprüfung im signierten Verlauf erhalten bleibt; Löschbenachrichtigungen bleiben ein separater Ereignistyp.

Mehrere IDs, die aus einer Benachrichtigung heraus demselben Chat zugeordnet werden, werden als `deletion.batch` zusammengefasst, unabhängig von ihrer Anzahl, wobei die Nachrichten-IDs genau so angegeben werden, wie Telegram sie gesendet hat, und unabhängig davon, wie viele davon dieses Konto gesendet hat. In der Benachrichtigung von Telegram werden die Nachrichten aufgelistet; im Administratorprotokoll des Chats wird der zuständige Administrator genannt, wo das Konto dies nachlesen kann. Die Verknüpfung (`message.deletion_attributed`) wird hergestellt, je nachdem, was zuerst eintrifft: Eine Abfrage, die den Eintrag im Administratorprotokoll vor der Löschbenachrichtigung gesehen hat, wird abgeglichen, sobald die Benachrichtigung erfasst wird.

## Erfassungsumfang: Kontinuität, Lücken und nicht erfasste IDs

Jede signierte ZIP-Datei enthält „`coverage.json`“, der HTML-Bericht beginnt mit derselben Zusammenfassung, und „ `verify.py`“ berechnet diese anhand von „`events.jsonl`“ neu, anstatt der Datei zu vertrauen:

- **Kontinuierliche Beobachtung von X bis Y.** Ein Zeitraum beginnt mit `observation.started` und endet bei einer Pause, einem Stopp, einer unterbrochenen Telegram-Verbindung, einer Abmeldung, einem Prozessstart ohne ordnungsgemäßen Stopp oder nach mehr als drei Minuten ohne Aufzeichnung während der Beobachtung (Heartbeats werden jede Minute geschrieben, daher bedeutet Stille, dass der Prozess gestoppt wurde, eingefroren ist oder der Computer in den Ruhezustand gewechselt ist). Wenn das Heartbeat-Intervall unter **Weitere Tools → Parameter** geändert wird, wird dies bei jedem Heartbeat protokolliert, und die zulässige Stille beträgt drei Intervalle, jedoch niemals weniger als drei Minuten.
- **In der Lückenliste** wird der Zeitraum zwischen den einzelnen Zeitabschnitten mit dem jeweiligen Grund aufgeführt. Eine Lücke, die zum Zeitpunkt des letzten Eintrags noch offen war, wird mit „`not_resumed_by_last_record`“ gekennzeichnet.
- **Nachrichten-IDs wurden nicht erfasst.** Bei Kanälen und Supergruppen, die die Nachrichten pro Chat nummerieren, werden die zwischen den erfassten IDs fehlenden IDs als Bereiche aufgeführt. Sie werden als „*nicht erfasst“* gemeldet – gelöscht, nie zugestellt oder außerhalb des gespeicherten Verlaufs – niemals als „gelöscht“. Private Chats und normale Gruppen nutzen eine accountweite Sequenz, daher haben Lücken innerhalb eines solchen Chats keine Bedeutung und werden dort nicht aufgeführt.
- Meldungen über Lücken auf Chat-Ebene (beispielsweise wenn Telegram in einem Kanal zur Wiederherstellung von Datenunterschieden auffordert) werden als Notizen gezählt; sie unterbrechen die globale Abdeckung nicht.
- **Sitzungsprotokolle.** Sitzungen, in denen der Aktualisierungszähler von Telegram anstieg, obwohl keine Aktualisierung diese Sitzung erreichte (`updates_diverted`), diese Sitzung aus der Sitzungsliste von Telegram entfernt wurde, während die Verbindung weiterhin bestand (`session_revoked_externally`), oder die Antwort einer Witness-Abfrage nur aus dem Verlauf eintraf (`probe_ack_missed_live`), werden separat aufgeführt. Der Verifizierer meldet außerdem, woher der Telegram-Sitzungsschlüssel stammt, welche anderen Sitzungen bei Beginn der Beobachtung angemeldet waren, welche Sitzungen während der Beobachtung hinzugefügt wurden, Telegram-Sicherheitshinweise (777000), welche anderen Sitzungen aus dem Arbeitsbereich beendet wurden, Zeiträume, in denen nur diese eine Sitzung aktiv war, die Anzahl der Witness-Probes sowie Aktualisierungen zu Telefonanrufen. Siehe [Konten](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#witness-probe). Solange [Strict Chosen Chats](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#strict-chosen-chats) aktiviert ist (`scope.strict` in `observation.started`), werden die Sitzungsliste (außer wenn dies die einzige Sitzung ist oder wenn **Telegram-Geräte** aktiviert ist), Sicherheitshinweise und Anruf-Updates nicht erfasst; ihr Fehlen sagt daher nichts aus, und eine Löschung wird nur dann einer Sitzung nur dann einer Sitzungsprüfung zugeordnet, wenn innerhalb der letzten 10 Minuten zuvor eine Sitzung lief.

### Aktualisierungsreihenfolge (`pts`)

Telegram-Nummern: Aktualisierungen zu Nachrichten mit `pts`: eine Sequenz für das Konto (private Chats und einfache Gruppen zusammen) und eine für jeden Kanal oder jede Supergruppe. Der Kollektor zeichnet jeden lückenlos empfangenen Abschnitt als `coverage.sequence` Datensatz: die erste und letzte `pts`, die Anzahl der Aktualisierungen jedes Typs sowie die Angabe, ob sie live gesendet oder von `getDifference` oder `getChannelDifference`. Eine Unterbrechung ist ein `coverage.gap` Datensatz, und `coverage.gap_closed` bezeichnet den `pts` , ab dem die Sequenz wieder vollständig ist.

Eine lückenlose Reihe zeigt, dass jedes Telegram-Update, das in dieser Reihenfolge zwischen dem ersten und dem letzten `pts` den Telegram-Client dieses Collectors erreicht hat. Es sagt nichts über Inhalte aus, die Telegram nie an dieses Konto gesendet hat, über die Zeit vor dem ersten aufgezeichneten `pts`oder über Abschnitte, die der Collector nicht notiert hat. Ein `pts` Zeitraum, der von keinem erfassten Zeitraum oder keiner Differenz abgedeckt wird, wird als Lücke dargestellt.

`GET /api/continuity` Gibt für ein Intervall (`since`, `until`, `chat_id`), ob jede Folge ununterbrochen ist, und listet die Unterbrechungen mit ihren Gründen auf. `verify.py` gibt dasselbe aus den Datensätzen eines Archivs unter **Folgenkontinuität** aus.

### Fehlende Nachrichtennummern (`gap_summary`)

For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md).

**Vorschau.** `coverage.json` → `gap_summary` misst die von Telegram zugewiesenen Nummern, die dieser Kollektor nie gesehen hat. Telegram nummeriert Nachrichten einmal pro Kanal oder Supergruppe und einmal pro Konto über private Chats, Bots und normale Gruppen hinweg. Eine Nummer zwischen zwei beobachteten Nachrichten ist entweder beobachtet oder fehlt; ein zusammenhängender Bereich ist eine positive Aussage, dass jede darin nummerierte Nachricht beobachtet wurde. Eine Lücke nennt weder einen Akteur noch einen Grund.

| Fachgebiet | Bedeutung |
| --- | --- |
| `status` | `on` oder `off`, wenn unter **Weitere Tools → Parameter → Lückenanalyse** deaktiviert |
| `parameters` | Die Parameter, die zu dem Ergebnis geführt haben, damit es reproduziert werden kann |
| `chats[]` | Ein Eintrag pro Kanal oder Supergruppe, jeweils eigenständig nummeriert |
| `account` | Die kontoweite Abfolge von privaten Chats, Bots und normalen Gruppen |
| `status` (pro Sequenz) | `applicable`, oder `not_applicable` mit `reason` |
| `observed_from`, `observed_to`, `span` | Erste und letzte beobachtete Nummer sowie die Größe des Bereichs |
| `observed`, `observed_without_content` | Beobachtete Nummern; solche, die nur aus einem Lösch- oder Nachprüfungsdatensatz bekannt sind |
| `missing`, `density`, `gap_ranges`, `largest_gap` | Nie beobachtete Zahlen, ihr Anteil am Bereich, Anzahl der Durchläufe, der längste Durchlauf |
| `clusters[]` | Aufgeführte Lücken: `low`, `high`, `missing`, sowie die benachbarten beobachteten Zahlen `after` / `before` mit ihren Beobachtungszeitpunkten |
| `service_estimate` | Nur wenn aktiviert: Wie viele fehlende Nummern wären bei ihrem beobachteten Anteil Servicemeldungen? Wird niemals abgezogen von `missing` |

Die Gültigkeit wird aus dem Protokoll abgeleitet und niemals vorausgesetzt:

- **Kanäle und Supergruppen** werden pro Chat erfasst, auch beim Export ausgewählter Chats. Die vom Absender ausgewählten Einträge bilden die Grundlage für die Erfassung `not_applicable`.
- **Die kontoweite Sequenz** wird nur von der ersten bis zur letzten Nachricht gemessen, die eingegangen ist, während die Erfassung des gesamten Kontos aktiv war, und umfasst private Chats, Bots, normale Gruppen sowie die eigenen Nachrichten des Kontos, wobei kein solcher Chat ausgeschlossen wird (`scope.changed`). Zahlen, die mit `deletion.unscoped` als beobachtet, ohne dass deren Inhalt berücksichtigt wird. Ein Export oder eine Übergabe ausgewählter Chats kann diese nicht erfassen. Wurde die Erfassung des gesamten Kontos aus- und wieder eingeschaltet, weist ein Hinweis darauf hin, dass die in der Zwischenzeit verwendeten Zahlen als Lücken erscheinen.
- Servicemeldungen sind Protokolleinträge mit eigenen Nummern, sodass sie Lücken selbst schließen; die optionale Schätzung dient lediglich als Kontext.

`verify.py` berechnet neu `gap_summary` aus `events.jsonl` mit den Parametern im signierten `coverage.json` Element (Standardwerte für ältere Archive) und gibt die kontoweite Zeile in der Abdeckungszusammenfassung aus. Das `get_capture_status`(MCP und die Befehlszeile) gibt denselben Messwert für die Chats zurück, die ein Zugriff lesen darf; die kontoweite Sequenz gilt nur für Zugriffe, die den gesamten Arbeitsbereich abdecken.

Wiederholte Beobachtungen einer Dienstnachricht zählen nur einmal, und die Schätzung des Kontodienstes verwendet ausschließlich Zahlen innerhalb des gemessenen Bereichs. Ein angewendeter Geltungsbereich muss die eigenen Nachrichten des Kontos explizit beibehalten, bevor eine kontoweite Messung aktiviert wird; die Messung beginnt mit Datensätzen, die diese Informationen enthalten. Der gemessene Bereich umfasst die laufende Beobachtung, und deren Fortsetzung wird vermerkt. Die Abfrage des Live-Archivs verfügt über ein Zeitbudget, einschließlich des Datenbank-Scans, und kennzeichnet eine unvollendete Messung als unvollständig.

Telegram dokumentiert die [einzelnen Nachrichten-ID-Sequenzen](https://core.telegram.org/api/updates#message-id-sequences). Diese Nummern beschreiben Beobachtungen; Löschhinweise, erneute Überprüfungen und der Admin-Protokoll-Eintrag erklären, warum eine Nummer fehlt, wo Telegram sie meldet.

Wenn Telegram das Konto nicht mehr akzeptiert, enthält der Datensatz `coverage.gap`, der die Überwachung beendet, `cause` (`account_banned`, `account_frozen`, `account_deleted`, `session_duplicated`, `session_revoked`, `session_expired`, `session_ended` oder `not_authorized`) sowie den Fehler Telegram; `verify.py` benennt die Ursache, aus der der Zeitraum endet.

Die Abdeckung umfasst aufgezeichnete Beobachtungszeiträume, Unterbrechungen und Nachrichtenergebnisse. Bewerten Sie diese zusammen mit den ausgewählten Chats, dem Zeitraum und den Richtlinien für Anhänge; eine erneute Überprüfung der Ergebnisse und der aufgezeichneten Lücken zeigt, wie vollständig die Aktualisierungen des Kontos beobachtet wurden.

## Produzent

Das signierte Manifest der Beweis-ZIP-Dateien, Chat-Exporte, Zeugen-Journale und die Angaben in den Personenprofil-Dateien enthalten `producer`: Software, Version, Projekt (PhishDestroy), Homepage und Quell-Repository. Der HTML-Bericht und der Verifizierer zeigen diesen signierten Producer-Eintrag an. Hashwerte der Quelldateien identifizieren den aufgezeichneten Quellcode-Baum zum Vergleich mit einem vertrauenswürdigen Checkout. Die Herkunft der Ausführung wird separat durch [eine GitHub-Erfassungsbescheinigung](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) oder [Intel-TDX-Messungen](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/) überprüft, sofern diese aktiviert sind. Archive, die erstellt wurden, bevor das producer-Feld existierte, werden weiterhin unterstützt und als Legacy-Datensätze gekennzeichnet.

Jeder `observation.started`-Datensatz nennt außerdem den Telegram-Client, der die Beobachtung durchgeführt hat: dessen `api_id` (niemals den Hash), unabhängig davon, ob es sich um ein integriertes öffentliches Schlüsselpaar oder die eigene Anwendung des Betreibers handelt, die in der Verbindungsanfrage von Telegram gesendete Client-Beschreibung sowie die Art der Verbindungsroute mit dem IP-Modus (keine Proxy-Adresse oder Geheimnis). Der Bericht und `custody.json` listen jeden einzelnen Client und jede Route mit dem Zeitpunkt ihrer Aufzeichnung auf sowie die Zeitpunkte, zu denen kein gelisteter Proxy geantwortet hat und Telegram die Adresse des Servers erkannt hat. Dies geht aus zuvor aufgezeichneten Protokollen hervor.

## Personenprofile

Eine Profildatei (`tgwitness-dossier-v1`, JSON) wird auf Anfrage aus den bereits im Protokoll vorhandenen Einträgen für einen Chat erstellt; es werden keine Daten von Telegram abgerufen, und Profilinhalt werden niemals in das Protokoll geschrieben (das Aktivieren und Deaktivieren von Profilen wird als `dossier.changed` protokolliert). Für jede Person mit einer gespeicherten Nachricht werden Name und Benutzernamenverlauf sowie Telegram-Kennzeichnungen (Bot, Betrug, Fälschung, Premium, verifiziert, eingeschränkt, gelöscht) – wie zum Zeitpunkt der Speicherung sichtbar – sowie Profil- Foto-IDs, SHA-256- und Perceptual-Hash (pHash, kompatibel mit `imagehash.phash`) des Avatars aus dem lokalen Avatar-Cache mit ähnlichen Avataren, Aktivitäten (erste und letzte Nachricht, Anzahlen, bearbeitete und gelöschte Freigaben, Nachrichten nach UTC-Stunde), wer wem antwortet, andere Chats in diesem Journal, in denen die Person geschrieben hat, sowie erwähnte Wallets (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; Base58Check-Adressen werden anhand der Prüfsumme validiert), Telefonnummern, Benutzernamen und Links, einschließlich hinter Text versteckter Links.

Jeder Sachverhalt listet die Protokoll-Einträge (`seq`) auf, aus denen er stammt, und `record_hashes` enthält den Hashwert jedes referenzierten Eintrags. Die Aussage ist mit dem Workspace-Schlüssel signiert:

```
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
```

Überprüft die Signatur, verifiziert den Beweisexport selbst (Signatur, Hash-Kette und Dateien) sowie die Tatsache, dass jeder referenzierte Datensatz unverändert in diesem Export desselben Arbeitsbereichs vorhanden ist. Avatar-Hashes werden als aus dem lokalen Cache stammend gekennzeichnet (keine Protokoll-Datensätze). Erwähnungen sind Musterübereinstimmungen und Anhaltspunkte zur Überprüfung. Profile werden pro Chat aktiviert, können als passwortgeschützte AES-256-ZIP-Datei exportiert werden und werden gelöscht, wenn sie deaktiviert werden oder wenn der Chat aus den Quellen entfernt wird.

## Unabhängiger Zeuge

Ein Witness-Journal (`tgwitness-witness-v1`) und seine Kanalbeiträge werden anhand eines Beweisexports mit `verify.py --witness … --channel …` überprüft; siehe [unabhängiger Witness](https://phishdestroy.io/tgwitness/de/docs/reference/witness/). Anhand einer öffentlichen Adresse `https://t.me/s/…` oder `https://telegram.me/s/…` liest der Verifizierer das Datum jedes Beitrags aus Telegram aus, und das früheste solche Datum eines Beitrags am Anfang des Exports gilt als externe Zeitangabe für den letzten Datensatz. Daten aus anderen Quellen sind bereitgestellte Metadaten.

## Manifest und Kontrollpunkte

manifest.json enthält das Format, den Exportzeitpunkt, den öffentlichen Schlüssel, den Fingerabdruck, die Journal- Länge, den Kopf-Hash, den Geltungsbereich, den Ersteller, Einschränkungen sowie den SHA-256-Hash jedes Inhaltselements außer `manifest.json` und `manifest.sig` selbst. manifest.sig ist die Base64-Signatur nach Ed25519 über das kanonische Manifest-JSON. Der Verifizierer lehnt unerwartete/fehlende Elemente, doppelte Namen, beschädigte Dateien, unterbrochene Sequenzen/Ketten, ungültige Signaturen und Abweichungen von einem angegebenen Checkpoint ab. Er extrahiert niemals Archivpfade. Er begrenzt die insgesamt deklarierte unkomprimierte Größe auf 4 GiB; `--max-gib N` erlaubt größere Archive, die mit einem erhöhten Limit unter **Weitere Tools → Parameter** erstellt wurden.

Ein großes Archiv wird von mehreren Prozessen gleichzeitig überprüft: Die Elemente werden parallel gehasht, und nach den ersten 5.000 Datensätzen werden der Inhalts-Hash und die Signatur jedes Datensatzes von Worker-Prozessen überprüft, während der Hauptprozess der Kette, der Abdeckung und den Verknüpfungen der Reihe nach folgt. `--jobs N` legt die Anzahl der Prozesse fest; standardmäßig `auto` verwendet einen pro CPU, maximal 16, und `--jobs 1` wird alles in einem Prozess verarbeitet. Das Ergebnis ist in beiden Fällen dasselbe, und eine Änderung wird mit derselben Meldung abgelehnt. Hashwerte an den durch beibehaltene Checkpoints und Zeitstempel-Anker angegebenen Positionen werden während dieses einzelnen Durchlaufs beibehalten, sodass jeder Anker verglichen wird, ohne das Journal erneut lesen zu müssen. Auf einem Computer mit 32 Threads benötigte ein 10,8-GB-Archiv mit 400.000 Datensätzen 58,9 s in einem Prozess, 15,2 s bei 4 und 8,4 s bei 16; ein Durchlauf über die Datensätze in der richtigen Reihenfolge legt dann die Obergrenze fest.

Führen Sie die Verifizierung anhand Ihrer installierten TgWitness-Version oder eines geprüften Checkouts durch. Die im Archiv enthaltene Kopie ermöglicht eine portable Nutzung; vergleichen Sie diese Kopie mit Ihrer vertrauenswürdigen Installation, bevor Sie sie ausführen.

Ein Checkpoint signiert eine Erklärung, die den öffentlichen Schlüssel, die Journal-Länge, den Kopf- Hash und den Erstellungszeitpunkt enthält. Er enthält außerdem die neueste DRAND-Runde, die der Arbeitsbereich abgerufen hat (`drand_anchor` ): Der Collector fragt vor jedem periodischen Checkpoint ein DRAND-Relay über die externe Route des Arbeitsbereichs ab, sodass Hide IP, Proxys und eine deaktivierte externe Route zum Tragen kommen und der Checkpoint selbst niemals eine Verbindung nach außen herstellt. Der Prüfer kann überprüfen, ob ein späteres Archiv dasselbe Präfix enthält. Mit `--checkpoint` und `--check-drand` bestätigt er diese Runde bei den Drand-Relays und meldet, dass der Checkpoint nicht früher als zum Zeitpunkt der Runde signiert wurde; die Runde ändert die Sicherheitsstufe nicht. Bewahren Sie den Checkpoint außerhalb des Collectors auf, damit bei einer späteren Verifizierung das Archiv mit einer separat davon geführten Referenz verglichen wird. Der Collector-Schlüssel signiert es, sodass es die Datensätze nur dann an ihn bindet, wenn der Empfänger es vor dem Archiv über einen anderen Kanal erhalten hat; für sich allein erfüllt es nicht die Mindestanforderungen für einen Nachweis.

## Auslesen eines Verifizierungsergebnisses

Der Verifizierer meldet die Archivintegrität, die Signaturzuordnung und die Sicherheitsprüfungen getrennt voneinander. Eine gültige Signatur zeigt an, dass sich die Bytes seit dem Signieren nicht verändert haben. Der Betreiber übermittelt dem Empfänger den Schlüssel-Fingerabdruck über einen separaten Kanal. Ohne `--fingerprint`besteht ein intaktes Archiv die Signatur- und Formatprüfungen mit `signer_pinned: false`, und die letzte Zeile beginnt mit `EVIDENCE: minimum not met · missing: confirmed signer key`.

Für eine automatisierte Richtlinie zur lokalen Archivierung, die einen festgelegten Unterzeichner und das Minimum an Nachweisen erfordert:

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

Verwenden Sie einen Fingerabdruck, der über den vertrauenswürdigen Kanal des Empfängers aufbewahrt wird. Ein vertrauenswürdiger Zeuge kann den Kollektor auch über ein konsistentes, bezeugtes Journal festpinnen; geben Sie `--witness`, `--witness-fingerprint` und `--require-witness` an. `--strict` beendet die Ausführung mit dem Status 2 bei einem nicht festgepinnten Unterzeichner; eine nicht erfüllte Anforderung `--require-tier` oder `--require evidence` führt ebenfalls zur Beendigung mit Status 2. `--require evidence` erfordert `--fingerprint` und eine externe Zeitangabe eines Drittanbieters, die den letzten Datensatz abdeckt. Lesen Sie `signer_pinned`, `requirements_met` und die Sicherungsergebnisse, nicht nur den Beendigungscode. [Die versiegelte Erfassung](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) verwendet stattdessen ihren Beglaubigungsprüfer und die genehmigte Richtlinie, um den Erfassungs-Digest zu authentifizieren.

## Umfang der Überprüfung

Die Verifizierung überprüft das Archiv und den zu seiner Erstellung verwendeten Erfassungsmodus. Wählen Sie den Modus, dessen Vertrauensgrenze dem jeweiligen Fall entspricht, und behalten Sie dessen Verifizierungsdaten bei.

| Erfassungsmodus | Was der Verifizierer überprüft | Verifizierungsdaten und Vertrauensgrenze |
| --- | --- | --- |
| Lokaler Arbeitsbereich | Signaturen, Hash-Kette, Manifest und Anhang-Bytes aufzeichnen | Vom Empfänger gespeicherter Fingerabdruck des Collectors und externe Zeitangabe eines Dritten: verifizierte RFC-3161- oder OpenTimestamps-Belege oder von t.me gelesene Witness-Beiträge. Gespeicherte Checkpoints und Witness-Datensätze dienen der Überprüfung. |
| Lokaler Arbeitsbereich mit einem unabhängigen Witness | Die Archivprüfungen sowie die Übereinstimmung mit einem früheren Protokollpräfix, das vom Zeugen beibehalten wurde | Witness-Fingerabdruck und -Einträge; der Schlüsselkontrollnachweis des Verwahrers zeigt, wer den Witness-Schlüssel hält. Mit `--channel https://t.me/s/…` liefern die von Telegram gesetzten Beitragsdaten externe Zeit |
| [GitHub Actions-Aufzeichnung](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | GitHub-Bescheinigung des Archiv-Digests, der genehmigten Workflow- und Collector-Commits, des gehosteten Runners, der neuen Sitzungs-/Schlüsselherkunft und der internen Archivintegrität | Richtlinie für vertrauenswürdige Prüfer, Aufrufer-Repository und GitHub-Bescheinigungsbündel; die Datenerfassung läuft im festgesteckten Workflow ab |
| [Cloud-Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/) | Lebenszyklus- und Zugriffsprotokolle des Anbieters, Status von Firewall und Cloudflare sowie das signierte Ausführungsprotokoll des Collectors | Schreibgeschützte Abfragen an den Anbieter und Cloudflare; die Verfügbarkeit einzelner Prüfungen hängt vom Anbieter ab |
| [Vertrauliche Intel TDX-VM](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | Signatur und Plattformstatus angeben, Verknüpfung mit der Collector-Anweisung, Kompositions- und Betriebssystemmessungen | Intel-Vertrauenskette und erwartete Messwerte für die Bereitstellung; die Ergebnisse jeder erforderlichen TDX-Prüfung beibehalten |

Bei der versiegelten Erfassung erhält der zugelassene Erfasser Daten über eine authentifizierte Telegram-Verbindung innerhalb der verifizierten Umgebung. Die Bescheinigung bindet das Archiv an diese Ausführung, sodass die Verifizierung sowohl die Erfassung als auch die spätere Dateiintegrität abdeckt. Dies beruht auf dem zugelassenen Code und der oben aufgeführten Vertrauenskette der Plattform. Die Überprüfung der GitHub-Erfassung erfordert eine innerhalb der Ausführung erstellte Sitzung und lehnt Erfassungen aus importierten Sitzungen ab.

Der Ausführungsbeleg protokolliert die Collector-Version, Datei-Hashes und Starteinstellungen. GitHub-Provenienz und TDX-Messungen dienen der Umgebungsprüfung; der Validierungsdatensatz   identifiziert getestete Konfigurationen.

### Woher die Nachrichten stammen

Telegram übermittelt Nachrichten an jeden Client, einschließlich der offiziellen Apps, innerhalb einer MTProto-Sitzung. Der Autorisierungsschlüssel der Sitzung wird anhand des festgelegten Server-Schlüssels von Telegram ausgehandelt, und jede Aktualisierung wird verschlüsselt und auf Integrität geprüft unter Verwendung dieses Schlüssels übermittelt. Der Collector empfängt Nachrichten über die authentifizierte Sitzung des Kontos und trägt jede Beobachtung bei ihrem Eintreffen in das Journal ein, zusammen mit den Identifikatoren für den Chat, die Nachricht und den Absender sowie dem Datum, das Telegram jeder Nachricht zugewiesen hat. In GitHub Actions-Erfassung und bei Intel TDX-Bereitstellungen bindet die Bescheinigung zudem diese Sitzung und den Signaturschlüssel an die genehmigte Ausführung des Collectors.

Das Journal protokolliert, woher der Autorisierungsschlüssel stammt. Bei der Anmeldung per Telefon oder QR-Code oder bei einer unabhängigen Anmeldung aus einer Sitzungsdatei wird `account.authorized` mit `key_origin: "created"` geschrieben; bei der Erfassung anhand eines importierten `.session`-, TData- oder JSON-Schlüssels wird `imported` geschrieben. Ein importierter Schlüssel existiert ebenfalls, unabhängig davon, woher er stammt. Beglaubigte Bereitstellungen lehnen importierte Schlüssel ab.

Die Herkunft eines Datensatzes in Telegram beruht auf der authentifizierten Verbindung des Kontos, den Verbindungs- und Erfassungsdatensätzen im Journal, den erfassten MTProto-Frames, die den Journal-Einträgen zugeordnet sind ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics)), dem Telegram-Datum jeder Nachricht sowie – bei beglaubigter Erfassung – der verifizierten Ausführungsumgebung. Archivsignaturen bewahren diesen Datensatz für spätere Überprüfungen auf. Gespeicherte Checkpoints legen frühere Journalgrenzen fest, Erfassungsdatensätze zeigen die Ergebnisse der Erfassung an, und verifizierte externe Zeitstempel ordnen die festgeschriebenen Bytes zeitlich ein.

Für einen lokalen Arbeitsbereich stellt der Empfänger vertrauenswürdige Collector- oder Witness-Eingaben bereit. Bei der versiegelten Erfassung binden die vertrauenswürdige Richtlinie und die Bescheinigung den Archiv-Digest an die genehmigte Collector-Ausführung. Es handelt sich um unterschiedliche Verifizierungspfade; melden Sie die für den ausgewählten Pfad abgeschlossenen Prüfungen.

## Anhänge

Dateien werden unter „media/“ anhand ihres SHA-256-Hashs adressiert. Ein „media.saved“-Ereignis verknüpft einen Hash und die Byte-Länge mit einem bestimmten Nachrichtenereignis. Die ursprünglichen Dateinamen dienen als Metadaten, niemals lokale Pfade. Mediendaten werden asynchron heruntergeladen, sodass eine sofortige Löschung die Erfassung verhindern kann. Deaktivierte Erfassung, übergroße Dateien oder Dateien mit unbekannter Größe, Download-Fehler sowie unterbrochene Downloads werden als Ergebnisse angezeigt. Ein Prozessabsturz kann nicht referenzierte Teil-Dateien hinterlassen; diese werden nicht in die Exporte einbezogen.

Der ZIP-Exporter gleicht gespeicherte Medien anhand ihrer Namen ab. JSONL-, CSV- und HTML-Exporte überprüfen Ereignissignaturen, enthalten jedoch keine Medienbytes. Abgeleitete Berichte dienen der Benutzerfreundlichkeit; „events.jsonl“ ist die maßgebliche Darstellung der Ereignisse.

Bei einem vollständigen Chat-Export werden Anhänge gemäß den Anhangseinstellungen des Arbeitsbereichs im Ordner „media/“ gespeichert und mit dem Namen „SHA-256“ versehen. Jeder Nachrichteneintrag in chat.json benennt seine Datei (`file`, `file_sha256`) oder den Grund für deren Fehlen (`file_status`), zusammen mit dem, was der Leser um den Text herum gesehen hat: Links hinter dem Text, Weiterleitungsquelle, Bot-Schaltflächen, Signatur, Aufrufe und den Timer für die automatische Löschung. `verify.py` überprüft, ob sich jede benannte Datei im signierten Manifest unter diesem Hash befindet.

## Dauerhafte Erfassung und Verarbeitung von Belegen (0,2)

Ein Medienauftrag und die damit verbundene Nachrichtenereignis-Festschreibung erfolgen in einer Transaktion. Der Auftrag speichert den ursprünglichen TL-Nachrichtenbeschreiber; die signierte Beobachtung bindet deren SHA-256-Hash, das Konto sowie die Größenrichtlinie. Die Wiederherstellung überprüft diese Bindung vor dem Herunterladen. Es wird niemals die aktuelle Nachricht abgerufen, und ein neuerer Anhang wird stillschweigend ersetzt. Unterbrochene Aufträge werden erneut versucht, während ein dauerhafter Fehler ein explizites Ergebnis bleibt.

Jeder Arbeitsbereich verfügt über ein eigenes Protokoll und eine eigene Signaturidentität. Ein process.started-Ereignis enthält eine Lauf-ID, lokale Uhrzeiten, Versionen von Abhängigkeiten, Hashes der Quelldateien, das anfängliche Konto/den anfänglichen Geltungsbereich sowie die Erfassungseinstellungen. Heartbeats enthalten die Lauf-ID, die monotone Zeit und den Status der Warteschlange. Der Ausführungsbeleg kann auch als separat signierte Erklärung heruntergeladen werden. Zur Verifizierung der Ausführungsumgebung kombinieren Sie ihn mit der GitHub-Bescheinigung oder den TDX-Prüfungen, die in [Verification scope](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) beschrieben sind.

Automatische Checkpoints werden lokal beim Start, alle fünf Minuten während der Beobachtung (**Weitere Tools → Parameter → Signierter Checkpoint alle**) sowie beim ordnungsgemäßen Beenden gespeichert. Bei der Startüberprüfung und beim Export wird das Journal mit dem zuletzt gespeicherten lokalen Checkpoint verglichen. Dadurch kann ein Datenbank-Rollback erkannt werden, sofern der Checkpoint erhalten bleibt. Durch die unabhängige Speicherung bleibt diese Referenz außerhalb des Arbeitsbereichs verfügbar; ein verifizierter externer Zeitstempel verankert sie zusätzlich zeitlich.

Nach einem Neustart wird die gespeicherte Telegram-Aktualisierungsposition fortgesetzt (`catch_up_from` in `observation.started`) und versäumte Aktualisierungen werden angefordert. Die gespeicherte Position umfasst nur Aktualisierungen, deren Verarbeitung abgeschlossen ist; daher werden Aktualisierungen, die zum Zeitpunkt des Verbindungsabbruchs oder des Prozessabbruchs noch ausstehend waren, erneut angefordert. Eine regelmäßige Überprüfung erfasst `message.recovered` auf verpasste Nachrichten und `message.missing_on_recheck` wenn Telegram eine gespeicherte Nachricht nicht mehr zurückgibt; Letzteres ist keine Löschmitteilung und nennt weder einen Löschenden noch einen Zeitpunkt.

### Externe Sicherung und Wiederherstellung (S3)

Die externe Kopie (**Einstellungen → Benachrichtigungen und externe Kopie → Externe Kopie** oder **Weitere Tools → Extras → Nachweise & Backups**; standardmäßig deaktiviert) lädt Journalsegmente, gesicherte Dateien, Checkpoints mit ihren Zeitstempeln und abgeschlossene Chat-Exporte in einen S3-kompatiblen Speicher hoch, verschlüsselt mit AES-256-GCM vor dem Hochladen unter Verwendung eines im Workspace-Tresor gespeicherten Schlüssels; die Aufbewahrung mit Object Lock gilt, sofern der Bucket dies unterstützt. Ohne den heruntergeladenen Schlüssel kann die Kopie nicht gelesen werden. Wiederherstellung und Überprüfung mit `python -m tgwitness.replica restore --key-file KEY.json --out DIR`.

Die Wiederherstellung erfordert ein leeres Standardverzeichnis. Downloads und entschlüsselte Objekte verbleiben im privaten Zwischenspeicher, bis das gesamte Protokoll und jeder aufbewahrte Prüfpunkt verifiziert sind. Unsichere Objektpfade, inkonsistente Segmentbereiche und Protokolle, die kürzer als ein Prüfpunkt sind, werden abgelehnt; bei fehlgeschlagener Verifizierung werden keine wiederhergestellten Dateien veröffentlicht. Bei Aufbewahrungsprüfungen werden der zurückgegebene „Object Lock“-Modus und das Datum mit der beim Upload übermittelten Frist verglichen (mit einer Rundungstoleranz von einer Sekunde). Eine abgelaufene, ungültige oder verkürzte Frist gilt nicht als verifiziert. Der Status gibt das Stichprobenobjekt an, dessen Aufbewahrungsstatus für diesen Upload-Durchlauf zurückgelesen wurde.

Fehlende oder beschädigte lokale Medien werden als Fehler des Durchlaufs gemeldet, und der Mediencursor bleibt vor diesem stehen, sodass die Datei im nächsten Durchlauf erneut versucht wird; die darauf folgenden Dateien, Checkpoints und Exporte werden weiterhin kopiert. Die Wiederherstellungsprüfung vergleicht alle Verweise auf erhaltene Medien mit entschlüsselten Hashes und aufgezeichneten Größen. Identische, sich überschneidende Protokollsegmente aus unterbrochenen Uploads werden dedupliziert; widersprüchliche Überschneidungen werden verworfen. Während eines Uploads erstellte Kontrollpunkte werden zurückgestellt, bis die von ihnen abgedeckten Protokolleinträge kopiert wurden, sodass ein abgeschlossener Durchlauf keinen Kontrollpunkt vor seinem Protokoll veröffentlicht.

### Streaming-Export-Momentaufnahmen

Streaming-Exporte verwenden einen stabilen SQLite-Lese-Snapshot. Dessen Anfang kann älter sein als das aktuelle Live-Protokoll, wenn der Download abgeschlossen ist. Ein nach diesem Snapshot erstellter Checkpoint kann korrekt melden, dass das Archiv kürzer ist; vergleichen Sie dies mit einem Checkpoint am oder vor dem exportierten Präfix, nicht mit einem beliebigen späteren Checkpoint.

## Vorbereitung gemäß RFC 3161 und Überprüfung der Antworten (0.2)

Im „Evidence“-Modus wird lediglich der SHA-256-Hash jedes signierten Checkpoints an die aufgeführten RFC 3161- Zertifizierungsstellen und OpenTimestamps-Kalender gesendet – und zwar über die Workspace-Route und niemals über MTProxy. Zeitstempel sind standardmäßig in jedem Einrichtungsziel aktiviert; **die Nachweise für einen Fall** erfassen auch drand. Die Antworten werden gespeichert in `checkpoints/anchors/`, exportiert als `.tsr` und `.ots` Dateien unter `anchors/`, und von `verify.py` (`--tsa-ca` überprüft die TSA-Signatur; bestätigt OpenTimestamps-Nachweise mit `ots upgrade` und `ots verify`).

Eine RFC-3161-Autorität, die zweimal hintereinander fehlschlägt, wartet vor dem nächsten Versuch: ein Intervall, dann zwei, vier und so weiter bis zu sechs Stunden oder so lange, wie es ihr `Retry-After` vorschreibt, bis zu einem Tag. Ein Durchlauf, der nur wartende Autoritäten findet, schreibt keinen Datensatz; andernfalls listet `anchor.completed` sie unter `deferred` mit `retry_at` auf. Bis sie wieder antworten, zeigt das Panel Zeitstempel als **Degraded** an.

Das Panel erstellt ein Anforderungsarchiv, das kanonische checkpoint.json-Bytes, einen SHA-256-Nachrichtenabdruck und einen zufälligen Nonce in timestamp.tsq, Prüfsummen sowie Anweisungen enthält. Es wird keine Netzwerkanfrage gestellt; das Token, das die Instanz für diese Anfrage zurückgibt, ist der Zeitstempel.

`python -m tgwitness.anchor verify` prüft die Antwort ohne OpenSSL gegen die Checkpoint-Bytes und die ursprüngliche Anfrage. Eine vertrauenswürdige CA-Datei muss ausdrücklich angegeben werden; enthaltene Zertifikate gelten nicht automatisch als vertrauenswürdig. Die Prüfung der Anfrage ist in der CLI optional; bewahren Sie die Anfrage daher auf und übergeben Sie --request, um die Nonce zu prüfen. Das Ergebnis gibt an, ob sie geprüft wurde. Die Checkpoint-Signatur des Collectors und das Journal müssen weiterhin separat mit dem vertrauenswürdigen Collector-Fingerabdruck geprüft werden.

Die Verifizierung überprüft die Signatur der Antwort, die Checkpoint-Bytes und, sofern vorhanden, die ursprüngliche Anfrage unter der angegebenen CA-Vertrauensbasis. Für Zeitstempel, die im Evidenzmodus erfasst wurden, überprüft `verify.py` außerdem die gespeicherten OCSP- oder CRL-Evidenzdaten ([Sperrung von Signaturzertifikaten](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/#signing-certificate-revocation)). Siehe das [Verfahren](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/) und [die Validierungsergebnisse](https://phishdestroy.io/tgwitness/de/docs/reference/verification/).

## Optionale Datensätze im Beweismodus: „drand“- und „Telegram“-Geräte

Zwei weitere Aufzeichnungen können parallel zu den Zeitstempeln laufen. Beide sind nur wirksam, solange der Evidenzmodus aktiviert ist. **Beweismittel für einen Fall** Aktiviert „drand“; andernfalls starten beide. Tauschen Sie sie aus unter „Weitere Werkzeuge“ → „Extras“ → „Nachweise & Sicherungen“ → **Weitere Zeugen · optional**, oder `"drand": true` und `"devices": true` in `POST /api/evidence`. Ein Fehler verhindert weder den anderen noch die Zeitstempel; das Fenster zeigt unter dem Formular jeweils das aktuellste Ergebnis an.

**drand** (`beacon.drand` ). Bei jedem Durchlauf wird die neueste Runde von drand quicknet, die öffentliche Zufallszahl der League of Entropy (eine Runde alle 3 Sekunden), in das Journal geschrieben: `chain` , `round` , `randomness` , `signature` , `round_time` und das `relay` , das geantwortet hat. Eine verifizierte unvorhersehbare Runde liefert eine untere Zeitreferenz für das nachfolgende, per Hash verknüpfte Material. Ein verifizierter Zeitstempel an einem späteren Checkpoint liefert einen oberen Zeitbezug. Diese Prüfungen begrenzen das verknüpfte Material. Der Collector fragt zuerst `drand.cloudflare.com` ab, dann die Relays von Protocol Labs über die Workspace-Route, mit einer Anfrage pro Durchlauf.

`verify.py` prüft, ob jede Zufallszahl das SHA-256 ihrer Signatur ist und ob die Rundenzeit stimmt, und meldet die Runden, die längste Zeitspanne ohne eine Runde sowie den Rückstand der Uhr des Collectors gegenüber drand. `--check-drand` vergleicht die Runden mit einem Cloudflare-Relay und einem Protocol Labs-Relay, entweder mit allen oder mit einer zufälligen Stichprobe von 100 aus einem langen Protokoll; eine Runde, die abweicht, führt zum Fehlschlagen der Überprüfung.

**, Telegram,** (`account.devices`). Bei jedem Durchlauf werden die Sitzungen des Kontos mit `account.getAuthorizations` gelesen, die Liste Telegram wird unter „Einstellungen“ → „Geräte“ angezeigt und vollständig aufgezeichnet: vollständig, wenn sie sich seit dem letzten Durchlauf geändert hat, mit den Sitzungs-Hashes `added` und `removed`; ansonsten nur deren Anzahl und SHA-256. Gerätemodell, Plattform, App und Version, Erstellungsdatum und letzte Aktivität, Land und Region werden gespeichert; IP-Adressen hingegen nicht, da der Export von Beweismaterial außerhalb Ihrer Kontrolle liegt. Die eigene Sitzung des Collectors ist ständig aktiv, daher zählt nur die Aktivität anderer Sitzungen als Änderung. „`verify.py`“ meldet, wie oft die Liste aufgezeichnet wurde sowie jede neue und beendete Sitzung. Die Liste wird nur gelesen, solange die Beobachtung läuft.

Was sie zeigen: drand ordnet die Datensätze nach der öffentlichen Zeit an, und die Geräteliste ist Telegrams Erklärung über den Collector, die wie jeder andere Datensatz vom Collector signiert ist.

**Cloudflare Gateway-Protokoll** (`cloudflare.gateway_dns`). Für einen Server, der über das Cloudflare-Gateway ([Gateway-DNS](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)) auflöst, kopiert jeder Durchlauf die seit der letzten Kopie vom Gateway protokollierten Daten: ein Eintrag pro Zeitfenster von maximal drei Stunden mit `from`, `until`, `location_id`, dem `address` des Servers, sofern festgelegt, und dem `queries` als `[at, name, type, rcode, decision, colo]`, auch wenn keine vorhanden waren. Richten Sie dies unter „ **Cloudflare Gateway-Protokoll“ ein:**: Konto, Standort, optionale Adresse und ein schreibgeschütztes Token (Konto Analytics-Lesezugriff; Zero Trust PII-Lesezugriff, um eine Adresse eines gemeinsam genutzten Standorts zu speichern). Das Panel überprüft diese Angaben mit einer Anfrage vor dem Speichern; das Token bleibt verschlüsselt und gelangt niemals in das Protokoll. `verify.py` listet die Fenster, die am häufigsten aufgerufenen Namen und alle Zeiträume auf, für die keine Kopie vorliegt; ein Datensatz, dessen Anzahl nicht mit seinen Abfragen übereinstimmt, schlägt fehl. Ein Fenster, das mehr als eine Seite mit Abfragen in einer einzigen Sekunde enthält, behält diese Seite bei und gibt an, dass der Rest fehlt. Die Kopie ist die Antwort von Cloudflare über den Collector, signiert vom Collector; innerhalb von 24 Stunden kann jeder mit einem schreibgeschützten Token diese mit Cloudflare abgleichen.
