# Telegram · GitHub Actions-Aufzeichnung

Canonical page: https://phishdestroy.io/tgwitness/de/docs/capture/

Wähle Takeout, den Export über die reguläre API oder ein Chatjournal auf einem temporären GitHub-Runner.

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

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

Wähle Takeout, den Export über die reguläre API oder ein Chatjournal auf einem temporären GitHub-Runner.

Aktivieren Sie JavaScript, um einen Schlüssel zu generieren und Ihr Archiv zu entschlüsseln.

**Vollständige Quellenangabe**

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Unabhängige Erfassung](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)

![Unabhängige Erfassung](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b)

**Vorschau unter `main` verfügbar.** Ein Fork startet einen angehefteten, wiederverwendbaren Workflow von `phishdestroy/TgWitness`. Der Workflow exportiert ein Konto, ausgewählte Chats oder das Ereignisprotokoll eines Chats mithilfe einer neu erstellten Telegram-Sitzung, beglaubigt die ZIP-Datei oder das Multipart-Manifest und lädt ausschließlich empfänger-verschlüsselte Handoffs hoch. Das normale Administrationspanel wird nicht offengelegt.

Wählen Sie `client=official_web` , um den [official-client-Witness](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md) mit geschützten Telegram-Web-Steuerelementen und Video auszuführen. Dies erfordert einen eigenen Upstream-Proxy und überwacht einen gerenderten Chat. Die Standardeinstellung `client=api` behält die unten beschriebenen Exportmodi für das gesamte Konto bei.

Der Prüfer vergleicht das Archiv mit der GitHub-Bescheinigung, dem genehmigten Workflow und den Collector-Commits sowie den signierten Hashes des Journals und der Anhänge. Der Erfassungsprozess nutzt festgestellten Upstream-Code und neuen Speicherplatz. Ein Prüfer kann diesen Code einsehen und das gelieferte Archiv anhand des protokollierten Durchlaufs überprüfen.

**Auf dieser Seite**

- [Benutzerablauf](https://phishdestroy.io/tgwitness/de/docs/capture/#user-flow)
- [Zeitrahmen für die Sitzung](https://phishdestroy.io/tgwitness/de/docs/capture/#session-time-budget)
- [Wählen Sie diesen Modus oder einen dauerhaften Arbeitsbereich aus](https://phishdestroy.io/tgwitness/de/docs/capture/#choose-this-mode-or-a-persistent-workspace)
- [Was ist öffentlich und was muss privat bleiben?](https://phishdestroy.io/tgwitness/de/docs/capture/#what-is-public-and-what-must-stay-private)
- [Fehlerbehebung](https://phishdestroy.io/tgwitness/de/docs/capture/#troubleshooting)
- [Lokale Entschlüsselung und Überprüfung](https://phishdestroy.io/tgwitness/de/docs/capture/#local-decryption-and-verification)
- [Wie die Verzweigung außerhalb des Erfassungsprozesses gehalten wird](https://phishdestroy.io/tgwitness/de/docs/capture/#how-the-fork-is-kept-outside-the-capture-process)
- [Kryptografische Übergabe](https://phishdestroy.io/tgwitness/de/docs/capture/#cryptographic-handoff)
- [Geltungsbereich und Validierung](https://phishdestroy.io/tgwitness/de/docs/capture/#scope-and-validation)
- [Veröffentlichungsablauf des Betreuers](https://phishdestroy.io/tgwitness/de/docs/capture/#maintainer-release-sequence)

## Benutzerablauf

Der Assistent erläutert die fünf Schritte und ermöglicht es Ihnen, die Nachrichten- oder Collector- Substitution anhand von Beispieldaten auszuprobieren. **Mit Erfassung starten** öffnen Sie den Assistenten.

1. Wählen Sie **GitHub Actions Capture (Vorschau)** auf der Projekt-Startseite, dem Anmeldebildschirm des Arbeitsbereichs oder unter **Exporte → Capture-Helper öffnen**. Sie können auch den [offiziellen Helper](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) oder `tgwitness/static/capture.html` aus einem vertrauenswürdigen Checkout in einem modernen Browser öffnen. Der Helfer führt keine Netzwerkanfragen zur Schlüssel- oder Dateiverarbeitung durch. Der Helfer unterstützt die Sprachen der Website; das temporäre Erfassungsfenster unterstützt Englisch und Russisch und öffnet sich in der Sprache des Browsers, sofern diese zu den unterstützten Sprachen gehört.
2. Schlüssel generieren und speichern **sealed-key.json**. Dies ist der einzige private Entschlüsselungsschlüssel. Kopieren Sie den separaten öffentlichen **Empfänger** Wert. Wenn Sie den privaten Schlüssel verlieren, verlieren Sie den Zugriff sowohl auf die Verbindung als auch auf das Archiv. Bestätigen Sie, dass Sie ihn gespeichert haben, um zum nächsten Schritt zu gelangen. Wenn Sie bereits über eine Übermittlungsdatei verfügen, laden Sie den gespeicherten Schlüssel und wählen Sie **Ich habe bereits ein Archiv**.
3. Erstellen Sie einen Fork von TgWitness, aktivieren Sie „Actions“ in diesem Fork und führen Sie **Sealed Chat Capture** aus. Fügen Sie den öffentlichen Empfänger ein und wählen Sie 30, 60 oder 120 Minuten aus. Geben Sie niemals eine Telefonnummer, einen Anmeldecode, ein Telegram-Passwort, einen privaten Schlüssel oder eine Sitzung in Workflow-Eingaben, Commits, Issues oder Logs ein.
4. Laden Sie während der Ausführung **sealed-connection** aus „Artifacts“ herunter und entpacken Sie die Datei. Laden Sie `connection.tgwsealed` im Helper unter Verwendung des gespeicherten privaten Schlüssels. Der resultierende Link enthält ein zufälliges Zugriffsgeheimnis im URL-Fragment. Behalten Sie diesen Link für sich. Das Panel entfernt das Fragment und speichert das Geheimnis im Sitzungsspeicher dieses Tabs; es wird nicht in den HTTP-Zugriffsprotokollen erfasst.
5. Öffnen Sie den Verbindungslink. Melden Sie sich mit einem QR-Code oder mit Ihrer Telefonnummer und dem Anmeldecode an. Geben Sie Ihr Passwort für die zweistufige Verifizierung ein, falls Telegram Sie dazu auffordert. Der integrierte API-Anmeldedatenpool wird standardmäßig verwendet, genau wie im normalen Arbeitsbereich. Sie können den optionalen Abschnitt für benutzerdefinierte Anmeldedaten erweitern und beide `api_id` und `api_hash` aus [my.telegram.org/apps](https://my.telegram.org/apps). Lassen Sie beide Felder leer, um den integrierten Pool zu verwenden; ein unvollständiges oder fehlerhaftes Paar wird abgelehnt. Der Import von Sitzungen ist nicht zulässig. Wählen Sie den Exportmodus und den Geltungsbereich aus. Der Verbindungslink enthält ein Zugriffsgeheimnis: Behalten Sie es für sich.
6. Wählen Sie **Telegram Takeout**, **Regular Telegram API** oder **Chat-Ereignisprotokoll**. Für den Kontoexport wählen Sie entweder alle zugänglichen Chats aus oder laden Sie einen oder mehrere Chats und wählen Sie diese aus; legen Sie anschließend Datumsbereiche, Chat-Typen, Kontokategorien und Regeln für Anhänge fest. Überprüfen Sie die Einstellungen und die Größe, speichern Sie optional die JSON-Einstellungen für einen unabhängigen Prüfer und klicken Sie dann auf **Erfassung starten**. Die Einstellungen sind nach dem Start fest vorgegeben. Die Wiederaufnahme funktioniert nur, solange dieser Runner existiert; bei vorzeitigem Abschluss werden die erfassten Daten beibehalten und Lücken protokolliert. Das Ablaufen der Frist nach dem Start führt zu einem explizit unvollständigen Archiv; das Ablaufen vor dem Start oder eine Abbruch führt zu keinem Archiv.
7. Warten Sie auf **die sealed-result-Datei**, laden Sie sie herunter, entpacken Sie sie und entschlüsseln Sie sie `delivery.tgwsealed` im Helper. Sie erhalten `delivery.zip`, das `evidence.zip`, `attestation.jsonl`sowie Anweisungen. Die Entschlüsselung im Browser ist auf 256 MiB begrenzt; für größere Pakete verwenden Sie den unten stehenden Befehl „streaming local“. Große Ergebnisse enthalten zudem `delivery-NNNNNN.tgwsealed` Teile; die Hauptdatei `delivery.tgwsealed` enthält dann `evidence.parts.json` und die Bescheinigung. Laden Sie jeden Teil herunter und setzen Sie ihn lokal wie unten beschrieben zusammen.
8. Beenden Sie die temporäre Sitzung unter „Telegram-Einstellungen“ → „Geräte“, falls der Widerruf nicht bestätigt wurde oder der Runner beendet wurde. Bei normalem Abschluss wird eine Abmeldung angefordert, und im Laufprotokoll wird vermerkt, ob der Widerruf bestätigt wurde.

Das Repository muss die veröffentlichten „pinned source“- und „reusable-workflow“-Commits enthalten. Ein lokaler Zweig allein kann nicht von einem anderen GitHub-Repository aufgerufen werden.

## Zeitbudget für die Sitzung

Vor der Abholung, **Zeit und Umfang berechnen** schätzt den ausgewählten Verlauf und die Dateien anhand der Nachrichtenanzahl und einer begrenzten Stichprobe. Die Anzeige umfasst die bereits für die Anmeldung aufgewendete Zeit, die geschätzte Erfassungszeit und eine Reserve für die Paketierung. Bei Dateien basiert die anfängliche Schätzung auf 1 MiB/s und einer doppelten Zeitreserve; im Verlauf wird diese Annahme durch die gemessene Rate ersetzt. Verwenden Sie **Nur Nachrichten** oder wählen Sie weniger Chats aus, wenn die geschätzte Dauer die verbleibende Zeit überschreitet.

Die von Telegram gemeldete „Takeout“-Wartezeit wird dem Budget hinzugefügt. Der Collector bricht die Erfassung ab, wenn die verbleibende Zeit für die Paketierung benötigt wird, behält die erfassten Daten bei und kennzeichnet ein Teilergebnis. Eine 120-minütige Sitzung nutzt daher ihr verbleibendes Erfassungsfenster, anstatt auf den Stichtag zu warten, bevor das Archiv vorbereitet wird. Die Anzeige kennzeichnet Auswahlen, deren vollständige Größe nicht erfasst werden konnte.

## Wählen Sie diesen Modus oder einen dauerhaften

| Aufnahmemodus | Konfigurierbarer Umfang | Unterschied |
| --- | --- | --- |
| Telegram Takeout, die Standardeinstellung | Alle verfügbaren Cloud-Chats oder ausgewählte Chats, Daten, Kontokategorien, Medienrichtlinien und JSON-/HTML-Ansichten | Nutzt den offiziellen Exportmechanismus von Telegram; möglicherweise ist eine Genehmigung oder eine Wartezeit erforderlich. Takeout kann verlassene Kanäle/Gruppen auflisten, sofern Telegram dies zulässt, und zusätzliche personenbezogene Daten anfordern. |
| Standard-Telegram-API | Der gleiche Kontenumfang und die gleichen Ausgabeoptionen, vorbehaltlich der über die reguläre API verfügbaren Methoden | „Takeout“ wird nicht initialisiert; es ist nicht möglich, die linken Kanäle/Supergruppen aufzulisten oder persönliche Daten abzurufen, die ausschließlich in „Takeout“ gespeichert sind. Die Kontakte umfassen Telegram-Nutzer und nicht die gesamte gespeicherte Telefonkontaktliste. Es gelten weiterhin Ratenbeschränkungen. |
| Chat-Ereignisprotokoll | Ein ausgewählter Chat, Richtlinien für Anhänge und optionale Avatare | Zeigt den Verlauf und die während dieses Durchlaufs beobachteten Änderungen an. Kontenkategorien, Datumsfilter und Desktop-kompatible Ansichten gelten hier nicht. |

Alle drei Modi verfügen über dieselbe GitHub-Bescheinigung und verschlüsselte Übertragung. Takeout wählt die Erfassungsmethode aus und wird niemals stillschweigend durch einen regulären API-Zugriff ersetzt. TgWitness generiert die JSON-/HTML-Ansichten aus den erfassten Datensätzen und behält die ausgewählte Erfassungsmethode beim Export bei. Siehe die [offizielle Takeout-API](https://core.telegram.org/api/takeout).

Standardmäßig werden „Takeout“ verwendet, alle zugänglichen Chat-Typen einschließlich archivierter Chats, alle Daten, das Kontoprofil und die Kontakte, kompatibles JSON und HTML sowie Dateidownloads. Das anfängliche Medienkontingent beträgt 4 GiB, mit sichtbaren Dateigrößenbeschränkungen pro Typ; bei größeren Dateien oder aufgebrauchten Download-Kontingenten werden, sofern verfügbar, Server-Hashes verwendet. Überprüfen Sie diese Beschränkungen vor der Erfassung. Hashes können keine Datei rekonstruieren. Optionale Fotos, Stories, Sitzungsmetadaten und zusätzliche personenbezogene Daten bleiben separate Auswahlmöglichkeiten.

Für den Export ist möglicherweise eine Genehmigung in einer bestehenden Telegram-Sitzung erforderlich. Telegram legt die Verzögerung fest; eine neue Anmeldung oder ein neuer Runner kann diese nicht umgehen. Das maximale Erfassungsfenster beträgt 120 Minuten einschließlich Anmeldung und Genehmigung, sodass ein großes Konto oder eine lange Wartezeit auf die Genehmigung möglicherweise nicht vollständig abgearbeitet werden kann. Ein persistenter lokaler Export kann dieselbe Sitzung fortsetzen, übernimmt jedoch nicht die GitHub-Bescheinigung.

### bestätigen und überprüfen#

Danach **Einstellungen und Größe prüfen**, verwende **Einstellungen zur Überprüfung speichern**. Einverstanden das daraus resultierende `sealed-export-settings.json` mit dem Prüfer vor der Erfassung. Änderungen machen die gespeicherte Bewertung ungültig. Der Erfasser signiert die gültigen Einstellungen und deren SHA-256, und die Belege zum Kontoexport verknüpfen dieselben Optionen. Der Prüfer meldet den tatsächlichen Modus, die Auswahl und die Vollständigkeit und lehnt eine Diskrepanz zwischen dem Journal und dem verschachtelten Kontoexport ab.

```
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
```

`--expected-selection` lehnt einen anderen Transport, Chat-Gültigkeitsbereich, Filter oder eine andere Richtlinie für Anhänge ab. `--require-complete` akzeptiert nur Kontoexporte und Chat-Protokolle, die als vollständig erfasst sind. Ohne diese Kennzeichen überprüft die Verifizierung weiterhin Herkunft und Integrität und meldet dabei die erfassten Einstellungen und Lücken. Legen Sie die erwartete Auswahl vor dem Durchlauf fest und bewahren Sie sie getrennt vom Archiv auf. Der Umfang und die Erfassungsintervalle bestimmen das während des Durchlaufs erfasste Material; verwenden Sie aufbewahrte frühere Beobachtungen beim Vergleich mit früheren Versionen.

| Anforderungen | Modus |
| --- | --- |
| Exportieren Sie während einer zeitlich begrenzten Sitzung zugängliche Kontodaten oder ausgewählte Chats und stellen Sie einem Prüfer ein extern beglaubigtes Archiv zur Verfügung | GitHub Actions-Aufzeichnung (Vorschau) |
| Mehrere Chats gleichzeitig verfolgen, Konten verwalten, ein ständig wachsendes Archiv durchsuchen und lesen | Lokaler Arbeitsbereich oder Docker-Arbeitsbereich |

Dadurch wird eine separate Erfassung mit einer neuen Anmeldung gestartet. Dabei wird weder Ihr bestehendes lokales Journal hochgeladen, noch wird der aktuell geöffnete Arbeitsbereich exportiert, noch wird die Telegram-Sitzung wiederverwendet. Eine unvollendete Cloud-Erfassung kann nicht fortgesetzt werden, nachdem ihr Runner beendet wurde; ein neuer Workflow startet eine neue Erfassung.

Über **Exporte → Capture-Helper öffnen** im Arbeitsbereich wird der vollständige Assistent innerhalb des Fensters geöffnet. Die eigenständige Seite verwendet denselben Assistenten, dieselben Steuerelemente und dieselben Designs. Bei beiden werden Schlüssel und Entschlüsselung in Ihrem Browser gespeichert. Der GitHub-Workflow-Start und das temporäre Telegram-Fenster werden in separaten Registerkarten geöffnet; der Assistent weist Sie darauf hin, wann Sie zurückkehren müssen. Durch das Sperren des Arbeitsbereichs wird der im Arbeitsspeicher des Assistenten gespeicherte Schlüssel gelöscht. Ihre gespeicherte Schlüsseldatei bleibt auf Ihrem Gerät erhalten.

## Was ist öffentlich und was muss privat bleiben?

Die Erfassung erfolgt über einen standardmäßigen, von GitHub gehosteten Runner. GitHub, der zugelassene Erfasser sowie die Abhängigkeiten, die Hilfeseite, der Browser und der HTTPS-Tunnel sind vertrauenswürdige Bestandteile dieser Konfiguration. Der temporäre Host verarbeitet die Telegram-Sitzung und die Klartextnachrichten; die übermittelten Artefakte werden für den Empfänger verschlüsselt.

Durch das Forken wird der Projektcode in Ihr Repository kopiert. Ihr Telegram-Konto wird dabei **nicht** exportiert. Die Eingabe für den Empfänger-Workflow ist ein öffentlicher Verschlüsselungsschlüssel. Halten Sie `sealed-key.json`Telegram-Anmeldedaten, Login-Codes, 2FA-Passwörter und die entschlüsselte Verbindungs-URL aus Commits, Workflow-Eingaben und öffentlichen Protokollen heraus.

Der Workflow veröffentlicht verschlüsselte Verbindungs- und Ergebnis-Artefakte für einen Tag. Laden Sie beide rechtzeitig herunter; es gelten die Verfügbarkeit von GitHub Actions, die Kontolimits und die Abrechnungsbedingungen. Ein öffentlicher Fork ist keine Garantie für unbegrenzte kostenlose Rechenleistung. Es werden weder Zahlungsdaten noch ein GitHub-Zugriffstoken in den Helper eingegeben.

Der private Entschlüsselungsschlüssel verbleibt in Ihrem Browser bzw. in Ihrer Datei. Das Material der Telegram-Sitzung sowie die Klartext-Beobachtungen befinden sich zwangsläufig im temporären Speicher. GitHub und der HTTPS-Tunnel bleiben vertrauenswürdige Infrastruktur. Durch die Beglaubigung können der Archiv-Digest und die Workflow-Identität veröffentlicht werden; der Inhalt des Archivs wird jedoch nicht in der Beglaubigung aufgeführt. Der Zeitstempel der Beglaubigung ist kein Zeitstempel der Nachricht.

##

| Symptom | Nächster Schritt |
| --- | --- |
| Nein **Workflow ausführen** Schaltfläche | Erstellen Sie Ihren eigenen Fork, aktivieren Sie „Actions“ und synchronisieren Sie ihn mit dem Upstream `main`. Bearbeite die genehmigten Upstream-Pins nicht, um einen Fehler zu umgehen. |
| Nein `sealed-connection` Artefakt | Überprüfen Sie, ob der Job gestartet wurde und den Start-/Upload-Schritt abgeschlossen hat. Fehler in der Warteschlange, beim Runner, beim Herunterladen des Images, beim Tunnel oder bei den Repository-Richtlinien können den Start verhindern. |
| Die Verbindung kann nicht hergestellt werden | Laden Sie den für diesen Durchlauf gespeicherten Schlüssel, entpacken Sie das heruntergeladene Artefakt und wählen Sie `connection.tgwsealed`. Der Runner muss noch aktiv sein. |
| Die Zeitleiste ist angehalten | Überprüfen Sie den Status des Panels und nutzen Sie die Funktion „Fortsetzen“, solange die Sitzung noch aktiv ist, oder schließen Sie die Sitzung mit den bereits erfassten Daten ab. Telegram-Beschränkungen und nicht zugängliche Inhalte können zu Lücken führen. |
| Nein `sealed-result` | Eine Stornierung oder ein Ablauf vor Beginn der Erfassung führt nicht zur Erstellung eines Archivs; der Lauf endet dann mit dem Hinweis **Kein Archiv**. Ein fehlgeschlagener Erfassungs-, Beglaubigungs- oder Verpackungsschritt verhindert ebenfalls die Auslieferung; der fehlgeschlagene Schritt nennt den Grund des Vorgesetzten ohne Angabe personenbezogener Daten. Überprüfen Sie dies, ohne Anmeldedaten einzugeben. |
| Der Browser kann ein großes Archiv nicht entschlüsseln | Verwenden Sie die unten stehende Streaming-CLI für Pakete, die größer als 256 MiB sind. Mit einem falschen oder verlorenen privaten Schlüssel lässt sich das Ergebnis nicht entschlüsseln. |
| Bei der Überprüfung wird der Unterzeichner abgelehnt | Verwenden Sie eine vertrauenswürdige, aktuelle TgWitness-Installation und genau denselben Aufrufer `OWNER/REPOSITORY`. Akzeptieren Sie keine mit dem Archiv mitgelieferte Ersatzrichtlinie. |
| Telegram zeigt die temporäre Sitzung weiterhin an | Beenden Sie den Vorgang unter „Einstellungen“ → „Geräte“. Die Abmeldung kann fehlschlagen, und bei einem zwangsweise beendeten Workflow wird die Bereinigung möglicherweise nicht ausgeführt. |

Bevor Sie sich auf diese Vorschau verlassen, probieren Sie einen kleinen Chat aus, den Sie selbst kontrollieren: Erstellen Sie eine Nachricht und einen Anhang, fügen Sie beide zusammen, entschlüsseln Sie das Ergebnis, führen Sie den Verifizierer aus, überprüfen Sie die Ergebnisse zu Abdeckung und Medien und bestätigen Sie die Aufhebung der Telegram-Sitzung. Bei automatisierten Prüfungen kommen ein synthetischer Telegram-Client sowie ein separater Test mit einem echten GitHub-Zertifikat zum Einsatz; es wurden keine Tests mit Live-Konten in der aktuellen Version durchgeführt.

## Lokale Entschlüsselung und

Verwenden Sie Tools aus einer unabhängig vertrauenswürdigen Installation und keine ausführbaren Dateien, die aus einem unbekannten Archiv stammen:

```
python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip
# Unzip delivery.zip using your archive manager, then:
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
```

Bei einer mehrteiligen Übertragung entschlüsseln Sie zunächst das Hauptpaket und legen Sie dessen extrahiertes Manifest neben jeden verschlüsselten Teil ab. Führen Sie anschließend folgenden Befehl aus:

```
python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip
python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
```

Das Manifest ist das beglaubigte Objekt und bindet alle Teile sowie die zusammengestellte ZIP-Datei. Verwenden Sie `--max-gib` , um eine angemessene Obergrenze für die Überprüfung des unkomprimierten Inhalts bei einem großen Archiv festzulegen; der Standardwert beträgt 4 GiB. Überprüfungen der erwarteten Auswahl und des vollständigen Umfangs funktionieren auch bei mehrteiliger Übertragung.

Python 3.11+, die Projektabhängigkeiten und eine aktuelle GitHub-CLI, die `--signer-digest` und `--deny-self-hosted-runners` erforderlich. Ein CLI-Schlüsselgenerator ist ebenfalls verfügbar: `python -m tgwitness.sealed_crypto keygen sealed-key.json`.

Der Verifizierer verwendet `tgwitness/sealed_policy.json` aus der vertrauenswürdigen Installation. Er überprüft das aufrufende Repository, den Workflow des Upstream-Signierers, den genehmigten Signier- Commit, die Anforderungen an den gehosteten Runner, den vollständigen ZIP-Digest, das interne Journal und die Integrität der Anhänge, die Aktualität des Account-Key-Origins sowie den erwarteten Collector-Commit. Er zeigt den Verlauf und die Medienergebnisse an, anstatt anzunehmen, dass alle Daten gespeichert wurden. Eine leere Liste der genehmigten Veröffentlichungen führt zu einem Fehler „geschlossen“. Die Aktualisierung der Richtlinie ist eine explizite Vertrauensentscheidung; akzeptieren Sie niemals automatisch die von einem Archiv selbst vorgeschlagene Richtlinie.

Für die Offline-Nutzung sollten Sie vertrauenswürdige Stammzertifikate vorab aus einer vertrauenswürdigen Umgebung beziehen:

```
gh attestation trusted-root > trusted_root.jsonl
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl
```

Der Zeitstempel der Bescheinigung bezieht sich auf die Verpflichtung des Archivs. Er dient nicht zur Authentifizierung von Zeitstempeln in Nachrichten oder der Systemuhr des Collectors. Siehe [die Verifizierungsoptionen von GitHub](https://cli.github.com/manual/gh_attestation_verify).

## Wie die Verzweigung außerhalb des Erfassungsprozesses gehalten wird

Der Aufrufer enthält einen Verweis auf Arbeitsebene auf den vorgelagerten wiederverwendbaren Workflow unter einer vollständigen Commit-SHA. Dieser Workflow checkt explizit aus **das Upstream-Repository an einem festen Collector-SHA**. Ein Standardwert `actions/checkout` In einem wiederverwendbaren Workflow würde der Aufrufer überprüft werden; diese Funktion wird jedoch bewusst nicht verwendet.

Der Workflow stellt keine Caches des Aufrufers wieder her, verbraucht keine Artefakte des Aufrufers, führt keine Dateien des Aufrufers aus und akzeptiert keine Quell- oder Image-URLs, Shell-Befehle, vorbereitete ZIP-Dateien oder Hashes zum Signieren. Er akzeptiert einen festgelegten öffentlichen Empfänger und eine festgelegte Sitzungsdauer. Aktionen, das Python-Basis-Image und „cloudflared“ werden durch unveränderliche Digests fixiert; Python-Abhängigkeiten verwenden die vorhandenen, hash-gesicherten Anforderungen. Das Image wird aus der vertrauenswürdigen Quelle ohne Cache erstellt.

Der Collector läuft als Nicht-Root-Benutzer mit einem schreibgeschützten Image, deaktivierten Linux- Capabilities, Ressourcenbeschränkungen und ohne Docker-Socket oder GitHub-Token-Umgebung. Die einzigen eingehängten Verzeichnisse sind das Verzeichnis für die aktuelle Konfiguration, das Arbeitsverzeichnis und das Ausgabeverzeichnis. Die eingeschränkte FastAPI-Anwendung stellt Funktionen für Anmeldung, Dialoge, konfigurierbare Konto- oder Chat-Erfassung, Status, Fortsetzen, Beenden und Abbrechen bereit. Es gibt keine Download-Route im Klartext, keine allgemeine Verwaltungsroute, keine Import-Route und keinen Signatur-Endpunkt.

Der Supervisor stoppt die netzwerkseitigen Container, bevor die Attest-Aktion die endgültige, korrigierte `evidence.zip` oder `evidence.parts.json`. Der Verpackungscontainer verfügt über keine Netzwerkverbindung. In den Upload-Schritten wird nur `connection.tgwsealed` und `delivery*.tgwsealed`; weder Klartext-Nachweise noch Telegram-Anmeldedaten werden als Artefakte hochgeladen. Bei der Bereinigung werden die privaten Verzeichnisse und Container entfernt, und GitHub löscht die gehostete Runner-VM nach Abschluss des Jobs. Die Aufbewahrungsdauer für Artefakte beträgt einen Tag; bitte vor Ablauf herunterladen.

Ein Fork-Besitzer kann den Aufrufer ersetzen oder eine andere signierte Datei erstellen. Der strenge Prüfer muss den daraus resultierenden **Workflow bzw. Digest mit einem anderen Unterzeichner** ablehnen. Diese Konstruktion hängt nach wie vor davon ab, dass der genehmigte Code keine ausnutzbaren Fehler enthält und dass die Integrität des GitHub-Runners sowie der Signaturinfrastruktur gewährleistet ist.

## Kryptografischer

Jeder Empfängerschlüssel ist ein RSA-3072-Schlüssel (RSA-4096-Importe werden ebenfalls akzeptiert) mit dem Exponenten 65537. Jeder Umschlag verfügt über einen neuen, zufällig generierten AES-256-Schlüssel und einen 96-Bit-Nonce. RSA-OAEP mit SHA-256/MGF1-SHA256 verschlüsselt den AES-Schlüssel. AES-GCM mit einem 128-Bit-Tag authentifiziert das gesamte Präfix und die Nutzdaten. Der öffentliche Empfängerschlüssel liegt im DER-SPKI-Format in Base64 vor; die private Schlüsseldatei enthält DER-PKCS8 im Base64-Format.

Die Envelope-Bytes sind `TGWSEAL1\n`: eine Big-Endian-uint32-Angabe für die Länge des JSON-Headers, der Header, der Chiffretext und ein 16-Byte-GCM-Tag. Der Header hat genau `algorithm`, `key`und `nonce`; der Algorithmus ist `RSA-OAEP-256+A256GCM`. Das gesamte Präfix bis einschließlich des Headers besteht aus zusätzlichen authentifizierten GCM-Daten. Die Header-Größe ist auf 8192 Bytes begrenzt. Die CLI überträgt Nutzdaten von bis zu 8 GiB und führt vor der Erstellung der angeforderten Ausgabe eine Authentifizierung durch; das Überschreiben eines bestehenden Ziels wird verweigert. Es handelt sich um eine projektspezifische Hülle um standardmäßige kryptografische Primitive: RSA-OAEP mit SHA-256 und AES-256-GCM, verfügbar in OpenSSL und allen gängigen Kryptografie-Bibliotheken.

Die ursprünglichen Evidenz-Bytes werden **vor** dem Einfügen der Evidenz und der Beglaubigung in das verschlüsselte Außenpaket beglaubigt. Dadurch wird eine zirkuläre Abhängigkeit zwischen dem Hash des Archivs und einem in diesem Archiv enthaltenen Zertifikat vermieden. Bei öffentlichen Repositories sind die Metadaten der Beglaubigung (Repository, Workflow, Commit, Artefaktname und Digest) öffentlich zugänglich. Geben Sie niemals Chat-Namen in öffentlichen Metadaten an.

## Geltungsbereich und Validierung

Dieser Modus nutzt die Engine für signierte Protokolle und den Kontoexport. Geheime Chats, gelöschte Verlaufsdaten aus der Zeit vor der Erfassung sowie Daten, auf die das Konto keinen Zugriff hat, werden ausgeschlossen. Private Cloud-Chats sind zulässig, sofern sie ausgewählt wurden. Die Chat-Auswahl ist auf 20.000 Dialoge begrenzt; der Kontoexport ermittelt den eigenen Bestand selbst. Fehlende Daten, fehlerhafte Dateien und unvollendete Aufgaben werden protokolliert. Die Beschränkungen für Anhänge sowie die Speicherplatz- und Zeitbeschränkungen des Runners gelten weiterhin. Bei umfangreichen Übermittlungen werden verschlüsselte Teile anstelle einer festen Übermittlungsgrenze von 4 GiB verwendet. „Abgeschlossen“ bedeutet, dass die eingefrorenen ausgewählten Aufgaben beendet sind, nicht, dass jeder historische Telegram-Datensatz im Archiv vorhanden ist. Das Chat-Journal kann auch Live- Aktualisierungen verfolgen; keiner der beiden Modi ist ein atomarer Momentaufnahme. Generierte Screenshots und Bildschirmaufzeichnungen sind nicht Teil dieses Modus.

Die Tests umfassen synthetische Erstanmeldungen, Bereichsisolierung, Medien, Stornierungen, teilweise Fristablauf, fehlgeschlagene Abmeldungen, unzulässige API-Pfade und -Felder, Ablehnung vorbelegter Arbeitsbereiche, Ablehnung aufgrund falscher Schlüssel und Manipulationen, erforderliche Verifizierungs- Flags sowie die Interoperabilität der Verschlüsselung zwischen Browser und Python. Der Browser-Akzeptanztest verwendet eine eindeutig gekennzeichnete Mock-Bescheinigung; es handelt sich nicht um einen echten Sigstore-Test. Echte „Hosted-Runner“-Tests, Docker-, GitHub-Attestierungen sowie die Live-Telegram-Akzeptanztests müssen getrennt von lokalen synthetischen Prüfungen gemeldet werden.

[Die Nutzungsbedingungen für GitHub Actions](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) beschränken die Nutzung gehosteter Runner auf den Lebenszyklus des Softwareprojekts. Ein Fork hebt diese Einschränkungen nicht auf; diese Vorschau darf nicht als uneingeschränktes kostenloses Produktions-Hosting vermarktet werden. [Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) sind ebenfalls für Test- und Entwicklungszwecke vorgesehen. Die Helper/Workflows eignen sich zur Evaluierung dieser Funktion; die Eignung für den Produktionsbetrieb bleibt eine separate Bereitstellungsanforderung.

## Veröffentlichungsreihenfolge des Betreuers

1. Den Collector, den Supervisor, die Container-Definition und die Tests einpflegen und überprüfen.
2. Füge diesen Collector-Commit in `sealed-collector.yml`und führen Sie anschließend einen Commit bzw. eine Überprüfung des wiederverwendbaren Workflows durch. Leiten Sie den Checkout niemals stillschweigend aus dem SHA des Aufrufers ab.
3. Füge den wiederverwendbaren Workflow-Commit in `sealed-witness.yml` und fügen Sie dessen Workflow-/Collector-SHA-Paar `sealed_policy.json` in einer vertrauenswürdigen Version hinzu.
4. Veröffentliche alle referenzierten Commits und den Helper und teste anschließend einen unabhängigen Fork sowie das echte GitHub-Zertifikat. Füge die von diesen Pins referenzierten Commits nicht zusammen, es sei denn, die Referenzen werden neu generiert und erneut veröffentlicht.

Informationen zur Unterscheidung zwischen dem Aufrufer-Repository und dem vorgelagerten Unterzeichner finden Sie in [den wiederverwendbaren Workflows und Bescheinigungen](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) .
