TgWitness / Dokumentation

Was wurde getestet? →

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 / Dokumentation

Beweise & Verifizierung

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?#

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#

  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“. Bewahren Sie Übergabe- und Verwahrungsprotokolle zusammen mit Ihren Fallunterlagen auf. Überprüfen Sie die geplante Erfassungs Konfiguration im Rahmen des Live-Abnahmeverfahrens.
  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 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 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.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.

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.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. Solange 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 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 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. 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.