Teile dieser Seite sind noch auf Englisch: Das englische Original wurde nach der Übersetzung geändert.
Referenz / Beweismaterial
Telegram · Format der Beweismittel
Inhalt der signierten ZIP-Datei, Protokolltypen, Prozessbestätigungen, Benutzerprofile, externe Kopien und Offline-Überprüfung.
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 .
Auf dieser Seite
- Was ist signiert?
- Vergleich von Chat-Exporten
- Übergabe der Untersuchung
- Auszug aus der Übergabe
- Lesbare Berichte
- Kanonisierung von Ereignissen
- Akteur-Semantik
- Abdeckung: Kontinuität, Lücken und nicht beobachtete IDs
- Ersteller
- Personenprofile
- Unabhängiger Zeuge
- Manifest und Checkpoints
- Verifizierungsumfang
- Anhänge
- Dauerhafte Erfassung und Verarbeitung von Belegen (0.2)
- RFC 3161-Vorbereitung und Antwortüberprüfung (0.2)
- Optionale Datensätze im Beweismodus: drand und Telegram-Geräte
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 ) | 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#
- 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“. Bewahren Sie Übergabe- und Verwahrungsprotokolle zusammen mit Ihren Fallunterlagen auf. Überprüfen Sie die geplante Erfassungs Konfiguration im Rahmen des Live-Abnahmeverfahrens.
- 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.
- 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.
-
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 evidenceDer Fingerabdruck und ein geprüfter Zeitstempel des letzten Datensatzes erfüllen die Mindestanforderungen für Beweismittel;
--require evidencebeendet 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 werdenkey_pinned: trueundcheckpoint_checked: truegemeldet, 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).- 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..tgwpwverwendet scrypt und AES-256-GCM und lässt sich mit dem Befehlunseal-passworddes 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. - Um einen Checkpoint außerhalb des Beweismodus mit einem Zeitstempel zu versehen, befolgen Sie das Verfahren gemäß RFC 3161 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.
- 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
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 für die Vertrauensannahmen und Validierungsergebnisse 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.htmlodermessages/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üsselformat,report,seal): Das Siegel signiert das SHA-256 des kanonischen JSON vonreport, 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-Attribut2.25.240684792623320047764573196045913242332und 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 inTGWITNESS_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 unterreport.originalgenannt. 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.
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.
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.startedund 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. Solange Strict Chosen Chats aktiviert ist (scope.strictinobservation.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
ptsoder ü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.
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 mitdeletion.unscopedals 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. 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 oder
Intel-TDX-Messungen ü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.
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 --fingerprintbesteht 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 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 | 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 | 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 | 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/), 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 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).
Siehe das Verfahren und die Validierungsergebnisse.
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) 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.