# TgWitness · Deutsch > Documentation edition: Deutsch. Project version: `0.9.3`. Source branch: `main`. This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Sections without a translation appear in English. - [Project context, installation, measured scale and verification](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md) - [English project summary](https://phishdestroy.io/tgwitness/llms.txt) - [Complete handbook · Deutsch](https://phishdestroy.io/tgwitness/de/llms-full.txt) - [Complete handbook as Markdown · Deutsch](https://phishdestroy.github.io/TgWitness/de/llms-full.md) - [Source code and release history](https://github.com/phishdestroy/TgWitness) - [Collection modes and evidence levels](https://phishdestroy.io/tgwitness/de/guides/modes.md) - [Published checks and measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md) ## Complete documentation map ### Guides - [Das Archiv bearbeiten](https://phishdestroy.io/tgwitness/de/docs/archive/index.md): Laden Sie den Verlauf, durchsuchen Sie gespeicherte Datensätze, überprüfen Sie KI-Quellen und verbinden Sie Ihre Tools. - [GitHub Actions-Aufzeichnung](https://phishdestroy.io/tgwitness/de/docs/capture/index.md): Wähle Takeout, den Export über die reguläre API oder ein Chatjournal auf einem temporären GitHub-Runner. - [Spezielles Konto](https://phishdestroy.io/tgwitness/de/docs/dedicated-account/index.md): Richten Sie ein separates Telegram-Konto für die Datenerfassung ein. - [In wenigen Minuten loslegen](https://phishdestroy.io/tgwitness/de/docs/start/index.md): Installieren Sie mit einem Befehl, verbinden Sie ein Telegram-Konto und exportieren Sie ein überprüfbares Archiv unter Windows, Linux oder macOS. - [Ein Konto verbinden](https://phishdestroy.io/tgwitness/de/docs/accounts/index.md): Verbinden Sie Telegram über einen QR-Code, eine Telefonnummer oder einen Sitzungsimport. Wählen Sie die Quellen aus und überprüfen Sie, ob neue Nachrichten in Ihrem Protokoll erscheinen. - [Wählen Sie einen Proxy](https://phishdestroy.io/tgwitness/de/docs/proxies/index.md): Verwalten Sie automatische MTProxy-Routen oder verwenden Sie Ihren eigenen Proxy. Wählen Sie IP-Modi, Fallback-Regeln und die Route für externe Anfragen aus. - [Exportieren und verifizieren](https://phishdestroy.io/tgwitness/de/docs/exports/index.md): Exportieren Sie den erfassten Telegram-Verlauf, überprüfen Sie die Signaturen und vergleichen Sie das Protokoll mit einem von einem unabhängigen Zeugen aufbewahrten Kontrollpunkt. - [Erfahren Sie, wie die Beweissicherung funktioniert](https://phishdestroy.io/tgwitness/de/docs/concepts/index.md): Verfolgen Sie eine Nachricht von der Erfassung bis zum Prüfpunkt. Ändern Sie einen Beispieldatensatz, berechnen Sie dessen SHA-256-Kette neu und sehen Sie, was ein gespeicherter Prüfpunkt erkennt. - [Untersuchungen über alle Chats hinweg](https://phishdestroy.io/tgwitness/de/docs/cases/index.md): Führen Sie eine lückenlose Telegram-Untersuchung über Kanäle, Gruppen, private Chats und Bots hinweg durch: Erfassung des gesamten Kontos, Verlauf, Personen, Links, Dateien, Zeitachsen und verifizierte Beweise. - [Erstellen Sie ein Case Board](https://phishdestroy.io/tgwitness/de/docs/case-board/index.md): Sammeln Sie gespeicherte Beobachtungen, genaue Markierungen und Aktionsausschnitte auf einem privaten Board, besprechen Sie diese mit Ihrem Team und präsentieren Sie eine Zusammenstellung. - [Erstellen Sie einen Bericht](https://phishdestroy.io/tgwitness/de/docs/reports/index.md): Wählen Sie die Berichtsdaten, eines von acht Designs und den Inhalt aus, zeigen Sie dann eine Vorschau an und exportieren Sie HTML, ein signiertes PDF oder ein vollständiges Beweismittelpaket. - [Bereiten Sie eine Kopie zur Weitergabe vor](https://phishdestroy.io/tgwitness/de/docs/handover/index.md): Wählen Sie die Datensätze und Felder aus, die ein Empfänger erhalten darf, prüfen Sie die fertige Kopie und verifizieren Sie das signierte Manifest sowie die Grenzen des Quelljournals. - [Verwalten Sie eine Gruppe von Konten](https://phishdestroy.io/tgwitness/de/docs/groups/index.md): Vergleichen Sie Gruppen-Arbeitsbereiche, suchen Sie eine Quelle, überprüfen Sie Beobachtungszeiträume und wenden Sie gemeinsame Einstellungen mit Ausnahmen pro Konto an. - [Sorgen Sie für Sicherheit](https://phishdestroy.io/tgwitness/de/docs/security/index.md): Erfahren Sie, wo Sitzungen, Schlüssel und Beweismaterial gespeichert sind, welche Daten Ihren Rechner verlassen, welchen Schutz die Sicherheitsmaßnahmen bieten und wie Sie eine Installation absichern können. - [Einen Fall teilen](https://phishdestroy.io/tgwitness/de/docs/access/index.md): Gewähren Sie Prüfern und Analysten Zugriff auf ausgewählte Konten und Chats mit separaten Berechtigungen, Sitzungsbeschränkungen und widerrufbaren Tokens. - [Einen Witness-Bot einrichten](https://phishdestroy.io/tgwitness/de/docs/witness/index.md): Veröffentlichen Sie signierte Protokoll-Checkpoints in Ihrem Telegram-Kanal mit einem separaten Zeugen, einem eigenen Schlüssel und einem schreibgeschützten Zugriff für den Collector. - [Warum Zero Trust: Taylor Wessing, Dr. Zurheide, Dr. Schelinski](https://phishdestroy.io/tgwitness/de/docs/signed-export/index.md): Eine Zero-Trust-Fallstudie: eine von Dr. Patrick Zurheide und Dr. Tobias Schelinski von Taylor Wessing unterzeichnete DSGVO-Antwort, die anhand der eigenen Akte überprüft wurde, sowie das überprüfbare Modell, das keinen Raum für Täuschung oder Zweifel gelassen hätte. - [Halten Sie den Betrieb aufrecht](https://phishdestroy.io/tgwitness/de/docs/server/index.md): Führen Sie TgWitness auf einem Server mit dauerhaftem Speicher, privatem Panel-Zugriff, Backups und Überprüfungen nach einem Neustart aus. - [Finden Sie heraus, was schiefgelaufen ist](https://phishdestroy.io/tgwitness/de/docs/troubleshooting/index.md): Überprüfen Sie den Zugriff auf das Kontrollpanel, die Telegram-Verbindung, fehlende Nachrichten, „FloodWait“ und den Witness-Status anhand der für jedes Problem zutreffenden Signale. ### Reference - [Geheime Chats: Einrichtung und Aufzeichnung](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/index.md): Installieren Sie das Protokoll-Extra für geheime Chats, aktivieren Sie es pro Konto und zeichnen Sie die Chats auf, die TgWitness erstellt oder annimmt. - [TgWitness: Start, Umfang und Nachweise](https://phishdestroy.io/tgwitness/de/docs/reference/overview/index.md): Installation mit einem Befehl oder Erfassung über GitHub Actions. Machen Sie sich mit den Untersuchungsoptionen, dem veröffentlichten Umfang und dem, was ein Archiv verifiziert, vertraut. - [Quellhistorie laden](https://phishdestroy.io/tgwitness/de/docs/reference/history/index.md): Laden Sie vergangene Nachrichten aus aktivierten Quellen, halten Sie den Vorgang an und setzen Sie ihn fort, und überprüfen Sie einen signierten Fortschrittsbericht. - [Archivanalyse](https://phishdestroy.io/tgwitness/de/docs/reference/analysis/index.md): Durchsuchen Sie gespeicherte Nachrichten, überprüfen Sie KI-Eingaben und erstellen Sie Analyseberichte mit Quellenangaben. - [Befehlszeile](https://phishdestroy.io/tgwitness/de/docs/reference/cli/index.md): Suchen, Kontext lesen, Aktivitäten zählen und gespeicherte Nachrichten aus Skripten und Agenten exportieren – mit --json-Ausgabe, stabilen Exit-Codes und bereichsgebundenen, schreibgeschützten Tokens. - [Volltextsuche](https://phishdestroy.io/tgwitness/de/docs/reference/search/index.md): Suche nach gespeicherten Nachrichten anhand von Wortformen, genauen Phrasen, Domains und @Benutzernamen, wobei die besten Treffer zuerst angezeigt werden und der Index mit dem signierten Protokoll verknüpft ist. - [Schreibgeschütztes MCP](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/index.md): Verbinden Sie einen MCP-Client mit ausgewählten Arbeitsbereichen und Chats mit zeitlich begrenztem, widerrufbarem Zugriff. - [Lokale OCR und Transkription](https://phishdestroy.io/tgwitness/de/docs/reference/media-analysis/index.md): Erkennen Sie erfasste Bilder und Audiodateien mit einem lokalen Worker; verknüpfen Sie den abgeleiteten Text weiterhin mit der Quelldatei. - [Ausgehende Webhooks](https://phishdestroy.io/tgwitness/de/docs/reference/webhooks/index.md): Sendet definierte Ereignisse mit HMAC-Signaturen, Wiederholungsversuchen und Zustellstatus an HTTPS-Empfänger. - [Hinweis zur Inkompatibilität mit bestimmten Betreibern](https://phishdestroy.io/tgwitness/de/docs/reference/notice/index.md): Unser Betreiberhinweis zu Taylor Wessing und dessen Quelldatensatz. - [Hinweis zur Lizenz und zur architektonischen Inkompatibilität](https://phishdestroy.io/tgwitness/de/docs/reference/license/index.md): TgWitness steht unter der MIT-Lizenz für jedermann, weshalb es architektonisch nicht mit dem Taylor-Wessing-Workflow kompatibel ist. - [Schnellstart](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/index.md): Alle Möglichkeiten zur Installation und zum Start von TgWitness: Windows-Paket, Python, Docker und die synthetische Demo mit ersten Überprüfungen. - [Konten und Sitzungsformate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/index.md): Melden Sie sich per Telefon, QR-Code oder Authentifizierungsschlüssel an, importieren Sie Sitzungen aus Telethon, Pyrogram oder Telegram Desktop und verwalten Sie mehrere Konten. - [Zugriff und Berechtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/access/index.md): Legen Sie den Zugriff auf Konten und Chats fest, wählen Sie Berechtigungen aus, beschränken Sie Sitzungen und IP-Adressen und entziehen Sie den Zugriff. - [Verbindung, Proxys und Datenschutz](https://phishdestroy.io/tgwitness/de/docs/reference/connection/index.md): Authentifizierung, automatische Proxy-Pools, IP-Modi, Fallback-Richtlinie, externe Anfragen und Speicherung von Geheimnissen. - [Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/index.md): Führen Sie TgWitness als Dienst unter Windows, Linux, macOS oder Docker hinter einer HTTPS-Verbindung aus, einschließlich Backups und Updates. - [So funktioniert die Datenerfassung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/index.md): Beobachtungsumfang, Live-Aktualisierungen, Nachprüfungen, Anhänge, eigene Aktionen und die Bedeutung von Lücken – Eintrag für Eintrag. - [Arbeitsabläufe und Funktionen](https://phishdestroy.io/tgwitness/de/docs/reference/operations/index.md): Täglicher Betrieb des Dashboards: Betriebsmodi, Überwachungskategorien, Parameter, Benachrichtigungen, Exporte, Datensicherung und Kapazität. - [Untersuchungsmodus](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/index.md): Umfassende Untersuchungen ganzer Konten über Kanäle, Gruppen, private Chats und Bots hinweg – vom Untersuchungsumfang bis hin zu einem verifizierten Fallpaket. - [Case-Board-Referenz](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/index.md): Lesezeichen, exakte Markierungen, Aktionsausschnitte, Diskussionen, bereichsbezogener Zugriff und der von Case Board verwendete Verlauf der signierten Anmerkungen. - [Berichtskonfiguration und -überprüfung](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/index.md): Berichtsfilter, acht Designs, Inhaltsvorlagen, gespeicherte Änderungsverläufe und die Bewertung sind in den signierten Exporten enthalten. - [Funktionen und Umfang](https://phishdestroy.io/tgwitness/de/docs/reference/features/index.md): Das aktuelle Erfassungsmodell, Workflows für mehrere Konten, Exporte und operative Grenzen von TgWitness. - [So funktioniert das Beweismaterial](https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/index.md): Hash-Kette, Signaturen, Kontrollpunkte und Zeugen werden anhand der genauen Formeln erläutert, die der Verifizierer verwendet. - [Format der Beweismittel](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/index.md): Inhalt der signierten ZIP-Datei, Protokolltypen, Prozessbestätigungen, Benutzerprofile, externe Kopien und Offline-Überprüfung. - [Unabhängiger Zeuge](https://phishdestroy.io/tgwitness/de/docs/reference/witness/index.md): Führen Sie „Witness“ mit einem eigenen Schlüssel und Bot aus, veröffentlichen Sie signierte Checkpoints in einem Kanal und vergleichen Sie die Exporte damit. - [Zeitstempel](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/index.md): RFC 3161-Zeitstempel für signierte Checkpoints: Was wird an die Behörde gesendet und wie wird eine Antwort verifiziert? - [Berichte für Gerichte übersetzen](https://phishdestroy.io/tgwitness/de/docs/reference/translation/index.md): Welche Datei das Original ist, was mit einer beglaubigten Übersetzung einzureichen ist und welche Begriffe Übersetzer beibehalten. - [Sicherheit und Datenumgang](https://phishdestroy.io/tgwitness/de/docs/reference/security/index.md): Bedrohungsmodell, Zugriffsmodell, gespeicherte vertrauliche Daten, Netzwerkexposition, Import von Sitzungen und Anleitung zur Meldung einer Sicherheitslücke. - [Architektur](https://phishdestroy.io/tgwitness/de/docs/reference/architecture/index.md): Bestandteile des Collectors, des Panels, des Journals, der Worker und des Witness sowie der Datenfluss zwischen diesen Komponenten. - [Was wurde getestet?](https://phishdestroy.io/tgwitness/de/docs/reference/verification/index.md): Der Live-Telegram-Test, automatisierte Prüfungen, Browser-Prüfungen und die nächsten Qualifizierungsläufe. - [Änderungsprotokoll](https://phishdestroy.io/tgwitness/de/docs/reference/changelog/index.md): Alle Änderungen pro Version, einschließlich der noch nicht veröffentlichten Änderungen. - [Anleitung zum Panel](https://phishdestroy.io/tgwitness/de/docs/reference/panel/index.md): Alle Bildschirme des Panels: Chats, Journal, Quellen, Exporte, Extras, Schutzmodi und die Code-Prüfung. - [Erste Einrichtung und Einstellungen](https://phishdestroy.io/tgwitness/de/docs/reference/settings/index.md): Der Einrichtungsassistent, Ziele, Benutzeroberflächenebenen, Verbindungswege und Einstellungen, die von einer Kontengruppe gemeinsam genutzt werden. - [Installieren, überprüfen und aktualisieren](https://phishdestroy.io/tgwitness/de/docs/reference/installation/index.md): Installieren Sie das Tool mit einem einzigen Befehl, überprüfen Sie Signaturen und Hashes, aktualisieren Sie die Installation und entfernen Sie sie. - [Speicherung und Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/reference/storage/index.md): Backups, das Verschieben älterer Dateien in Ihre Cloud, Kopien unter „Object Lock“ und die Wiederherstellung auf einem neuen Rechner. - [Kontoexport](https://phishdestroy.io/tgwitness/de/docs/reference/account-export/index.md): Exportieren Sie, was ein Konto derzeit lesen kann: Umfang, wiederaufnehmbare Aufträge, ein signiertes Archiv und minimierte Freigabekopien. - [Öffentliches Showcase](https://phishdestroy.io/tgwitness/de/docs/reference/showcase/index.md): Veröffentlichen Sie gespeicherte Nachrichten ausgewählter öffentlicher Kanäle und signierte Momentaufnahmen über zeitlich begrenzte, widerrufbare Links. - [Hochsichere Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/index.md): Ein gesicherter 24/7-Server bei Hetzner oder Phala Cloud, Gateway-DNS und Überprüfungen, die von Dritten wiederholt werden können. --- # Telegram · In wenigen Minuten loslegen Canonical page: https://phishdestroy.io/tgwitness/de/docs/start/ Installieren Sie mit einem Befehl, verbinden Sie ein Telegram-Konto und exportieren Sie ein überprüfbares Archiv unter Windows, Linux oder macOS. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Mit einem einzigen Befehl installieren, ein Telegram-Konto verbinden und auswählen, was gespeichert werden soll. ## Auf Ihrem Computer installieren Das Installationsprogramm enthält Python und die erforderlichen Abhängigkeiten. Beginnen Sie mit einem Chat-Export; fügen Sie Beobachtungs- und Untersuchungswerkzeuge hinzu, wenn Sie diese benötigen. ### Linux / macOS ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` ### Windows · PowerShell / CMD ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Ubuntu-Server: Als Root ausführen. Desktop: Als normaler Benutzer ausführen. Öffnen Sie die vom Installationsprogramm angezeigte Panel-Adresse und verwenden Sie den dort angegebenen Zugangsschlüssel. Verbinden Sie anschließend Ihr Telegram-Konto. Der Panel-Schlüssel und Ihre Telegram-Autorisierung sind voneinander getrennt. [Installation, Signaturen und Updates](https://phishdestroy.io/tgwitness/docs/reference/installation/) erläutert den heruntergeladenen Build, den lokalen Zugriff und die Serveroptionen. [Anweisungen zum Quellcode und zu Docker](https://phishdestroy.io/tgwitness/docs/reference/quickstart/) bleiben verfügbar. ## Wählen Sie Ihre erste Aufgabe aus 1. [Verbinden Sie ein Konto](https://phishdestroy.io/tgwitness/de/docs/accounts/) per Telefon, QR-Code oder durch Import einer unterstützten Sitzung. 2. Wählen Sie den Umfang der Chats, des Ordners oder des Kontos aus. 3. [Exportieren Sie den ausgewählten Verlauf](https://phishdestroy.io/tgwitness/docs/reference/account-export/) oder starten Sie die Beobachtung, um zukünftige Änderungen zu erfassen. 4. [Überprüfen Sie das Archiv](https://phishdestroy.io/tgwitness/de/docs/exports/) anhand eines separat vertrauenswürdigen Schlüssel-Fingerabdrucks. ## Verwende einen temporären GitHub-Runner [GitHub Actions capture](https://phishdestroy.io/tgwitness/docs/capture/) führt Sie durch die Schritte Fork, Autorisierung, Gültigkeitsbereich und Archiv-Passwort. Laden Sie nach der Ausführung das verschlüsselte Ergebnis und dessen Workflow-Herkunft herunter. Für diesen Workflow ist kein permanenter Collector-Server erforderlich. ## Schauen Sie sich ohne Konto um [Öffnen Sie die Browser-Demo](https://phishdestroy.github.io/TgWitness/demo/?lang=de), um fiktive Nachrichten zu erkunden, Bearbeitungen zu vergleichen und einen Export zu überprüfen, bevor Sie etwas installieren. ![TgWitness-Konversationsansicht mit Beispielnachrichten](https://phishdestroy.io/tgwitness/assets/chats-dark.png?v=684f81f890cc) Ein Beispiel-Arbeitsbereich. Ihr eigenes Protokoll beginnt separat. ## Untersuchung fortsetzen Fügen Sie für laufende Arbeiten die Quellen, Dateirichtlinien, Suchfunktionen, Berichte und Freigabeberechtigungen hinzu, die Ihr Fall erfordert. „[Start, Skalierung und Nachweis“](https://phishdestroy.io/tgwitness/docs/reference/overview/) erläutert die Auswahlmöglichkeiten und veröffentlichten Messwerte. Befolgen Sie für eine Serverinstallation die Anweisungen unter [„Keep it running](https://phishdestroy.io/tgwitness/de/docs/server/)“. --- # Verwenden Sie ein separates Konto. Niemals Ihr Hauptkonto. Canonical page: https://phishdestroy.io/tgwitness/de/docs/dedicated-account/ Richten Sie ein separates Telegram-Konto für die Datenerfassung ein. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Bitte lesen Sie dies, bevor Sie ein Konto verbinden Unsere Empfehlung, Ihr Hauptkonto nicht zu verwenden, ist kein Scherz. Es ist die Realität. Hauptkonto - Ihr eigener App-Hash: 99 % abgemeldet - Sperren allein aufgrund eines niedrigen Vertrauensniveaus kommen häufig vor - Die Verwendung davon ist eine wirklich dumme Idee Zusätzliches Konto für öffentliche Paare - Über eine Million Konten wurden über diese Paare registriert - Die Paare bestehen seit mehr als 5 Jahren - Niemand kann über diese Ihre Daten einsehen 01 ## Warum nicht Ihr Hauptkonto? Dies sind korrekte Informationen. Wir wissen genau, wo die Fallstricke dieser Probleme liegen. 1. ### Ihr eigener App-Hash: 99 % abgemeldet Wenn Sie sich von einem Konto aus, auf das Sie keinen Zugriff haben, bei my.telegram.org anmelden, um einen App-Hash zu erhalten, und anschließend eine Anfrage über diesen App-Hash stellen, bedeutet dies mit einer Wahrscheinlichkeit von 99 %, dass das Konto abgemeldet ist. Sie können dies überprüfen. 2. ### Sperren allein aufgrund eines niedrigen Vertrauensniveaus kommen häufig vor Konten werden allein deshalb gesperrt, weil Telegram ihnen nicht vertraut, und solche Sperrungen kommen häufig vor. Auch dies können Sie überprüfen. Die Verwendung Ihres eigenen Kontos ist eine wirklich dumme Idee. 3. ### Kopierte Sitzungsschlüssel können widerrufen werden Die gleichzeitige Nutzung eines importierten TData- oder Sitzungsschlüssels in Telegram Desktop und TgWitness kann den Fehler `AUTH_KEY_DUPLICATED` auslösen. Telegram widerruft dann diese Autorisierung; beide Kopien erfordern eine erneute Anmeldung. Auch ein eigens dafür eingerichtetes Konto verhindert das nicht. Beenden Sie den ursprünglichen Client vollständig und lassen Sie ihn geschlossen, während Sie dessen importierte Sitzung nutzen. Für die parallele Nutzung melden Sie sich per Telefon oder QR bei TgWitness an, um eine separate Autorisierung zu erstellen; andere separat autorisierte Clients können angemeldet bleiben. [Lesen Sie die Warnung zum Importieren der Sitzung](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=de#session-warning) Telegram-Dokumentation - [Fehler beim Abmelden: AUTH_KEY_UNREGISTERED, SESSION_REVOKED](https://core.telegram.org/api/errors) - [Erstellen eines eigenen App-Hashs: Abrufen der `api_id`](https://core.telegram.org/api/obtaining_api_id) 02 ## Warum TgWitness über öffentliche App-Hash-/App-ID-Paare funktioniert Aus diesem Grund haben wir TgWitness auf öffentlichen App-Hash-/App-ID-Paaren aufgebaut. Nach unserer Logik ist die Wahrscheinlichkeit von Sperren bei diesen Paaren geringer: Mehr als eine Million Telegram-Konten wurden über diese Paare registriert, und viele verschiedene Programme arbeiten mit ihnen. Unserer Logik zufolge ist dies besser, als direkt mit einem persönlichen App-Hash zu arbeiten: Diese Paare bestehen mit Sicherheit seit mehr als fünf Jahren. ### Ihr eigenes neues Schlüsselpaar Erstellt auf my.telegram.org über das Konto. - Etwa 99 % der Konten sind abgemeldet - Eine neue Anwendung, ein Konto ### Öffentliche Schlüsselpaare des Pools Dieselben API-Paare, die auch viele andere Programme verwenden. - Über eine Million registrierte Konten - Viele verschiedene Programme - Seit mehr als 5 Jahren tätig ### Warum niemand über diese Paare etwas von Ihnen sehen kann - #### Das Paar ist ein Name, kein Schlüssel Telegram fragt die API-ID und den API-Hash ab, wenn sich ein Programm verbindet und wenn es einen Anmeldecode anfordert. Diese identifizieren die Anwendung und gewähren keinerlei Zugriff auf ein Konto; in der Dokumentation von Telethon wird darauf hingewiesen, dass ein solches Paar mit jeder beliebigen Telefonnummer funktioniert. - #### Ihr Sitzungsschlüssel verlässt niemals Ihren Server Bei der Anmeldung wird durch einen Diffie-Hellman-Austausch zwischen Ihrem TgWitness und Telegram ein Autorisierungsschlüssel erstellt; der Schlüssel selbst wird niemals übertragen. Laut der Telegram-Dokumentation wird der Schlüssel nach der Autorisierung dem Nutzer zugeordnet, und jeder Aufruf mit diesem Schlüssel wird als dieser Nutzer ausgeführt. Andere Programme mit demselben Schlüsselpaar verfügen über eigene Schlüssel und können Ihren nicht verwenden. - #### Der Datenverkehr wird mit Ihrem Schlüssel verschlüsselt Jede Anfrage und Antwort wird mit dem Autorisierungsschlüssel der Sitzung verschlüsselt, nicht mit dem API-Hash. Die Kenntnis des API-Hashs ermöglicht keine Entschlüsselung. - #### Der Inhaber eines Paares sieht nichts Telegram verfügt über keine Methode, um Konten, Sitzungen oder Nachrichten anhand der API-ID aufzulisten. Der Inhaber eines Paares sieht auf my.telegram.org lediglich seine eigenen App-Einstellungen. - #### Nur Ihr Konto erkennt, um welche App es sich handelt Unter „Einstellungen → Geräte“ Ihres eigenen Kontos werden für jede Sitzung der App-Name und die API-ID, das Gerät, die IP-Adresse sowie die Daten aufgeführt. Niemand sonst erhält diese Liste. Telegram-Dokumentation - [Benutzerautorisierung: Der Schlüssel wird zum Benutzer](https://core.telegram.org/api/auth) - [auth.sendCode: api_id, api_hash](https://core.telegram.org/method/auth.sendCode) - [initConnection](https://core.telegram.org/method/initConnection) - [Erstellen eines Autorisierungsschlüssels](https://core.telegram.org/mtproto/auth_key) - [MTProto-Verschlüsselung](https://core.telegram.org/mtproto/description) - [account.getAuthorizations](https://core.telegram.org/method/account.getAuthorizations) - [Was ein Sitzungsprotokoll enthält](https://core.telegram.org/constructor/authorization) - [Abrufen der api_id](https://core.telegram.org/api/obtaining_api_id) - [Der Open-Source-Code der Telegram-Apps](https://telegram.org/apps#source-code) Bibliotheken und Diskussionen - [Telethon: Anmelden](https://docs.telethon.dev/en/stable/basic/signing-in.html) - [opentele: Offizielle App-APIs](https://opentele.readthedocs.io/en/latest/documentation/authorization/api/) - [opentele: TelegramClient](https://opentele.readthedocs.io/en/latest/documentation/telethon/telegramclient/) - [Stack Overflow: Sollte der „api_hash“ geheim gehalten werden?](https://stackoverflow.com/questions/49490818/should-telegram-api-hash-be-kept-secret) ### Die entsprechenden Paare in anderen Programmen7 Die API-Paare der offiziellen Telegram-Apps sind öffentlich und in viele unabhängige Programme und Bibliotheken eingebaut: - [opentelePython · src/api.py](https://github.com/anmv/opentele/blob/4df17bd8c443d6452afc5a2d29ec7922fad1a5c3/src/api.py#L575) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [opentele2Rust · opentele2-core/src/api.rs](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/api.rs#L641) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [GrampoPython · Grampo/ut/api.py](https://github.com/abbas-bachari/Grampo/blob/00aa662d853c4ac2180432371c5e0d9444bbfe9e/Grampo/ut/api.py#L526) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [tgmanagePython · api/schemas/api_app.py](https://github.com/xdsnich/tgmanage/blob/f67c46be0ab234bd04526a8663d3936bd98a8597/api/schemas/api_app.py#L47) - Android 6 - iOS 8 - Desktop 2040 - macOS 2834 - Telegram X 21724 - Web K 2496 - [LyChatBotTDLib · helpers/tdlib/index.js](https://github.com/LyoSU/LyChatBot/blob/fac0ae5d5f2cddb8a26312014f51c0f6f40ec191/helpers/tdlib/index.js#L11) - macOS 2834 - [hsadasdPython · config.py](https://github.com/herobrinovaleksandr-png/hsadasd/blob/6842c74895038c16e219324fcd07dbe8153f37f0/config.py#L68) - Desktop 2040 - Desktop 17349 - Telegram X 21724 - macOS 2834 - iOS 10840 - Web 2496 - +4 - [blb.teamblb.team/threads/…294](https://blb.team/threads/app-hash-app-id-ofitsial-nykh-kliyentov.294/) - Android 4 · 5 · 6 - iOS 8 - Desktop 2040 - Desktop 17349 - macOS 2834 - Telegram X 21724 Forum-Liste offizieller App-Paare, veröffentlicht zur Registrierung von Konten 03 ## Möglichkeiten zur Erstellung eines zusätzlichen Kontos Ein Telegram-Konto benötigt eine Telefonnummer, an die der Anmeldecode gesendet wird. Wählen Sie diese entsprechend der gewünschten Lebensdauer des Kontos aus. - Beste Wahl ### Prepaid-SIM oder eSIM ******** Letzte Solange Sie es immer auf dem neuesten Stand halten Bitte beachten Sie Am zuverlässigsten: Telegram akzeptiert echte Mobilfunknummern am besten. Eine Nummer, die der Netzbetreiber zurücknimmt, wird an jemand anderen vergeben. - ### App für virtuelle Rufnummern ******** Letzte Solange die App die Rufnummer für Sie reserviert Bitte beachten Sie Telegram kann eine virtuelle Nummer ablehnen, den Code nicht zustellen oder das neue Konto sofort einschränken; manche Apps ziehen nicht genutzte Nummern wieder zurück. - ### Nummernvermietung ******** Letzte Die Mietdauer Bitte beachten Sie Nach Ablauf der Mietdauer erhält der nächste Kunde die Rufnummer. - ### Einmalige Aktivierung ******** Letzte Ein Code Bitte beachten Sie Die Nummer wird sofort in den Pool zurückgeführt, oft zusammen mit einer Historie früherer Besitzer. Legen Sie als Erstes das Cloud-Passwort fest. Wer auch immer die Nummer später besitzt, kann einen Anmeldecode anfordern. Ein Cloud-Passwort (zweistufige Verifizierung) verhindert, dass sich diese Person anmeldet; ohne dieses Passwort gehört das Konto dem nächsten Inhaber der Nummer. Telegram-Dokumentation - [Spam-FAQ: Virtuelle Nummern und frühere Inhaber](https://telegram.org/faq_spam) - [Zweistufige Verifizierung](https://core.telegram.org/api/srp) ### Gemietete +888-Nummern (Fragment) Einige Marktplätze und Dienste bieten die vorübergehende Anmietung der offiziellen +888-Nummern von Telegram über Fragment an. Ungefährer Preis: 20 US-Dollar pro Tag. - Sie können ein Konto direkt in Telegram Web oder Telegram Desktop registrieren. - Sie können Konten unter der angegebenen Nummer löschen und neue anlegen. - Diese Konten unterliegen in der Regel weniger Betrugsschutzprüfungen, bieten jedoch keine Immunität oder besondere Privilegien. Die Nummer gehört nicht Ihnen. Nach Ablauf der Mietdauer kann der Eigentümer sie zurückfordern. Legen Sie umgehend ein Cloud-Passwort fest und betrachten Sie das Konto nicht als langfristig. Es ist nach wie vor zuverlässiger, wenn Sie die Nummer +888 selbst besitzen oder eine Prepaid-SIM-Karte verwenden, über die Sie die Kontrolle haben. ### Fertigkonten von Marktplätzen Einige Marktplätze (zum Beispiel G2G oder Z2U) verkaufen vorgefertigte Telegram-Konten – neu, mit Alterung oder mit Sitzungsdateien. - [G2G: Telegram-Kontoangebote](https://www.g2g.com/uk/categories/telegram-accounts) - [Z2U: Telegram-Kontoangebote](https://www.z2u.com/telegram/accounts-5-15140) VERWENDEN SIE NIEMALS IHR HAUPTKONTO! Ein auf diese Weise eingerichtetes separates Konto ist immer noch sicherer, als Ihr primäres Telegram-Konto in TgWitness einzurichten. #### Warnhinweise vor dem Kauf - Dies verstößt gegen die Nutzungsbedingungen von Telegram. - Viele Konten wurden massenhaft registriert (Auto-Reg) oder weisen eine unbekannte Historie auf. - Einige Verkäufer verfügen möglicherweise noch über einen Wiederherstellungszugang. - Konten aus solchen Märkten werden häufig später gesperrt oder eingeschränkt. - Vermeiden Sie Marktplätze, auf denen offen Stealer, Phishing-Tools oder eindeutig gestohlene Konten verkauft werden. - Der Kauf eines Kontos – selbst eines, das als „Auto-Reg“ beworben wird – von Plattformen, die offen Phishing-Tools, Stealer, gestohlene Sitzungen oder Konten verkaufen, verstößt nicht nur gegen die Nutzungsbedingungen von Telegram, sondern auch gegen die Gesetze der meisten Länder. Dies kann Ihre Beweise später ungültig machen. Wählen Sie sorgfältig aus. #### Wenn Sie diese Option nutzen 1. Behandeln Sie den Account als Einweg-Account. 2. Beenden Sie alle anderen Sitzungen, richten Sie ein Cloud-Passwort ein und ändern Sie unverzüglich die Wiederherstellungsmethoden. 3. Verwenden Sie 2–3 Konten von verschiedenen Anbietern oder Konten, die Sie selbst registriert haben. **Premium, Löschung und die siebentägige Verzögerung** Verfügt das Konto über „Premium“, kann eine Person mit Zugriff auf die Telefonnummer das Konto nicht sofort löschen. Sie erhalten eine Benachrichtigung und haben sieben Tage Zeit, bevor die Löschung erfolgt. Dies ist wichtig, da Ihre Untersuchung von diesem Konto abhängt: Sie haben Zeit, einen Ersatz vorzubereiten. **Neue Konten und API-Zugangsdaten** Wenn Sie Ihre eigene „api_id“/„api_hash“ von einem neuen Konto beziehen und verwenden, das Sie selbst mit einer Nummer aus einem SMS-Dienst registriert haben, wird das Konto bei der ersten API-Anfrage oder Sitzungsautorisierung abgemeldet. Bitte berücksichtigen Sie dies bei der Planung einer Untersuchung. 04 ## Erstellen des Kontos Von einer Nummer bis zum ersten aufgezeichneten Chat. 1. ### Erhalten Sie eine Nummer Eine Prepaid-SIM-Karte oder eSIM, wenn das Konto langfristig bestehen soll; eine gemietete Karte oder eine einmalige Aktivierung für einen kurzfristigen Auftrag. Die Dienste sind unten aufgeführt. 2. ### Registrieren Sie sich getrennt von Ihrem Hauptkonto Registrieren Sie sich in der offiziellen Telegram-App auf einem separaten Gerät, Emulator oder Telefonprofil, nicht neben Ihrem Hauptkonto. 3. ### Sichern Sie es mit einem Cloud-Passwort Legen Sie umgehend ein Cloud-Passwort und eine Wiederherstellungs-E-Mail-Adresse fest, die nirgendwo sonst verwendet werden. 4. ### Schließen Sie die Datenschutzeinstellungen Telefonnummer **„Niemand“**, „Finden Sie mich über meine Nummer“, **„Meine Kontakte**“, „Zuletzt gesehen“, Profilfotos und Biografie: **„Niemand“** oder **„Meine Kontakte“**; deaktivieren Sie die Kontaktsynchronisierung. 5. ### Verhindern Sie, dass es sich selbst zerstört Stellen Sie die Selbstlöschfunktion des Kontos auf den längsten Zeitraum ein, damit ein gestopptes TgWitness Ihnen nicht den Verlust des Kontos verursacht. 6. ### Verleihen Sie dem Ganzen ein neutrales Profil Keine Namen, Fotos, Benutzernamen oder Biografien aus Ihren anderen Konten, keine persönlichen Kontakte. 7. ### Lassen Sie es sich erst einmal einlaufen Treten Sie zunächst täglich nur einigen Chats bei. Neue Konten, die es überstürzen, werden zunächst eingeschränkt. 8. ### Geben Sie keine Informationen an Bots weiter Klicken Sie bei einem Bot niemals auf „Telefonnummer teilen“ oder „Standort teilen“. Öffnen Sie Links und Mini-Apps über ein VPN oder einen Proxy auf diesem Gerät. 9. ### Verbinden Sie es mit TgWitness Stellen Sie in Ihrem eigenen Arbeitsbereich über **„Konto → QR-Code**“ eine Verbindung her und klicken Sie anschließend auf **„Quellen → Untersuchungsmodus**“. In der App führen Sie Ihre Aktionen durch, TgWitness dient der Aufzeichnung. Telegram-Dokumentation - [Zweistufige Verifizierung](https://core.telegram.org/api/srp) - [Datenschutzeinstellungen](https://core.telegram.org/api/privacy) - [Selbstlöschung des Kontos](https://core.telegram.org/method/account.setAccountTTL) 05 ## Nummerndienste Ausgangspunkte. Länder, Preise und die Frage, ob Telegram eine Nummer akzeptiert, ändern sich häufig; bitte überprüfen Sie dies vor der Zahlung. ### Prepaid-SIM und eSIM 11 - [SMARTYsmarty.co.uk](https://smarty.co.uk) - UK - SIM - [VOXIvoxi.co.uk](https://www.voxi.co.uk) - UK - SIM - [iD Mobileidmobile.co.uk](https://www.idmobile.co.uk) - UK - SIM - [Threethree.co.uk](https://www.three.co.uk) - UK - SIM - [Asda Mobilemobile.asda.com](https://mobile.asda.com) - UK - SIM - [Ultra Mobileultramobile.com](https://www.ultramobile.com) - US - Prepaid PayGo-Tarif, sehr günstig - [US Mobileusmobile.com](https://www.usmobile.com) - US - Prepaid - [Mint Mobilemintmobile.com](https://www.mintmobile.com) - US - Prepaid - [Tracfonetracfone.com](https://www.tracfone.com) - US - Prepaid - [eSIM Plusesimplus.me](https://esimplus.me) - eSIM - [Numero eSIMnumeroesim.com](https://numeroesim.com) - eSIM ### Apps für virtuelle Rufnummern 20 - [Google Voicevoice.google.com](https://voice.google.com) - US Nur in den USA; für die Registrierung ist eine US-Telefonnummer erforderlich - [TextNowtextnow.com](https://www.textnow.com) - US - CA Die Nummer wird zurückgenommen, wenn Sie sie nicht verwenden. - [TextFreetextfree.us](https://www.textfree.us) - US - [2ndLine2ndline.co](https://www.2ndline.co) - US - CA - [Talkatonetalkatone.com](https://www.talkatone.com) - US - [TextMego-text.me](https://go-text.me) - US - CA - Andere Länder - [textPlustextplus.com](https://textplus.com) [Google Play](https://play.google.com/store/apps/details?id=com.gogii.textplus) - [FreeToneGoogle Play](https://play.google.com/store/apps/details?id=com.textmeinc.freetone) - US [TextMe Up · textmeup.com](https://www.textmeup.com) - [Nextplusnextplus.me](https://nextplus.me) - US - [Dingtonedingtone.me](https://www.dingtone.me) - US - CA - [Burnerburnerapp.com](https://www.burnerapp.com) - US - CA - Kostenpflichtig Mit einer Testphase - [Hushedhushed.com](https://hushed.com) - Viele Länder - Kostenpflichtig Günstig - [Sidelinesideline.com](https://www.sideline.com) - US - [MySudomysudo.com](https://mysudo.com) - US - CA - UK - [2NumberGoogle Play](https://play.google.com/store/apps/details?id=com.bpmobile.second.phone) [App Store](https://apps.apple.com/app/id1216135390) - [SLYNUMBERslynumber.com](https://slynumber.com) [Google Play](https://play.google.com/store/apps/details?id=com.dev.slynumber) - [Phonerphonerapp.com](https://phonerapp.com) - [Onoffonoff.app](https://www.onoff.app) - EU Europäische Mobilfunknummern in einer App - [Sonetelsonetel.com](https://sonetel.com) - Viele Länder - Kostenlose Rufnummer - [Zadarmazadarma.com](https://zadarma.com) - Viele Länder Virtuelle Nummern ### Anzahl der Anmietungen und Aktivierungen: 12 Die Mietnummer bleibt über Wochen oder Monate hinweg gültig. Bei einer einmaligen Aktivierung erhalten Sie einen einmaligen Code: Legen Sie das Cloud-Passwort unmittelbar nach der Registrierung fest. - [OnlineSimonlinesim.io](https://onlinesim.io) - Vermietung - Aktivierungen - [SMSPVAsmspva.com](https://smspva.com) - Vermietung - Aktivierungen - [5SIM5sim.net](https://5sim.net) - Vermietung - Aktivierungen - [SMSPoolsmspool.net](https://www.smspool.net) - Vermietung - Einmalig - [VAK-SMSvak-sms.com](https://vak-sms.com) - Vermietung - Aktivierungen - [TextVerifiedtextverified.com](https://www.textverified.com) - Vermietung - Aktivierungen - [JuicySMSjuicysms.com](https://juicysms.com) - Vermietung - Aktivierungen - [365SMS365sms.org](https://365sms.org) - Vermietung - Aktivierungen - [SIMSMSsimsms.org](https://simsms.org) - Vermietung - Aktivierungen - [GrizzlySMSgrizzlysms.com](https://grizzlysms.com) - Einmalig - [SMS-MANsms-man.com](https://sms-man.com) - Einmalig - [Tiger SMStiger-sms.com](https://tiger-sms.com) - Einmalig --- # Telegram · Ein Konto verbinden Canonical page: https://phishdestroy.io/tgwitness/de/docs/accounts/ Verbinden Sie Telegram über einen QR-Code, eine Telefonnummer oder einen Sitzungsimport. Wählen Sie die Quellen aus und überprüfen Sie, ob neue Nachrichten in Ihrem Protokoll erscheinen. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Ein Arbeitsbereich = ein Konto, sein Journal und sein Schlüssel. ## Wählen Sie Ihre Anmeldemethode **Konten** → Arbeitsbereich hinzufügen → Verbindungseinstellungen. Nehmen Sie dafür ein separates Konto. - **QR-Code:** über den Bildschirm „Geräte“ in Telegram scannen und bestätigen. - **Telefonnummer:** Nummer, Code, dann das 2FA-Passwort, falls vorhanden. - **Sitzungsimport:** Ihre eigene Sitzungsdatei oder Telegram-Desktop-Daten. Nutzen Sie ein eingebautes API-Profil oder Ihre eigene API ID samt Hash. Es kennzeichnet nur die App, meldet Sie nicht an und verbirgt nichts. **Benötigen Sie zunächst einen Proxy?** Sie können [die Verbindungsroute vor der Anmeldung auswählen und testen](https://phishdestroy.io/tgwitness/de/docs/proxies/). Jedes Konto verfügt über eine eigene Route. ## Wählen Sie aus, was Sie überwachen möchten 1. Wählen Sie die Chats, Gruppen oder Kanäle, die Sie brauchen. 2. Prüfen Sie die Erfassungseinstellungen, Medien eingeschlossen. 3. Starten Sie und prüfen Sie Verbindung und jüngste Aktivität. Das Konto muss Zugriff haben. Admins und Mitglieder sehen Unterschiedliches, das Journal zeigt, was dieses Konto bekommen hat. Das ganze Konto? **Quellen → Beobachtungsumfang → Ermittlungsmodus**, prüfen, **Umfang speichern**. Komplette Anleitung: [ein ganzes Konto untersuchen](https://phishdestroy.io/tgwitness/de/docs/cases/). ## Überprüfen Sie den gesamten Pfad Schicken Sie in Ihrer Testgruppe eine Nachricht von einem anderen Konto, bearbeiten und löschen Sie sie. Alle drei Ereignisse sollten im Journal erscheinen. Dann [exportieren und prüfen](https://phishdestroy.io/tgwitness/de/docs/exports/). „Verbunden“ heißt, die Verbindung steht. Eine erfasste Testnachricht heißt, Ereignisse kommen wirklich an. ## Ein weiteres Konto hinzufügen Neuer Arbeitsbereich unter **Konten**, gleiche Schritte. Notieren Sie den Schlüssel-Fingerabdruck jedes Kontos, damit Sie Exporte später auseinanderhalten. --- # Telegram · Wählen Sie einen Proxy Canonical page: https://phishdestroy.io/tgwitness/de/docs/proxies/ Verwalten Sie automatische MTProxy-Routen oder verwenden Sie Ihren eigenen Proxy. Wählen Sie IP-Modi, Fallback-Regeln und die Route für externe Anfragen aus. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Halten Sie das Konto online und entscheiden Sie selbst, ob es jemals die IP Ihres Servers zeigen darf. ## Wählen Sie zunächst den IP-Modus aus 01**Adresse ausblenden** Nur Proxy. Wenn keiner geht, wartet es. 02**Direkt als letztes Mittel** Geht nach einer Verzögerung direkt und kehrt zu einem Proxy zurück, sobald einer funktioniert. 03**Server hinter einem Tunnel oder VPN** Direkt ist in Ordnung. Ein VPN wird dabei weder eingerichtet noch geprüft. Die Route bestimmt die Verbindung. Der IP-Modus legt fest, ob eine direkte Verbindung zulässig ist. ## Lassen Sie den Pool die Route verwalten 1. **Konto → Einstellungen → Verbindungseinstellungen**. 2. IP-Modus und **Automatischer MTProxy** wählen, oder eine feste Route. 3. Speichern, **Telegram-Verbindung testen** (geht auch vor der Anmeldung). 4. Erfassung starten und sich selbst eine Testnachricht schicken. Neue Arbeitsbereiche starten mit automatischem MTProxy und **Adresse verbergen**. Der Pool nutzt vier öffentliche Listen, prüft Server, behält die guten und tauscht tote aus. ## Verwenden Sie Ihren eigenen Proxy SOCKS5, HTTP CONNECT, ein Telegram-Proxy-Link oder ein Betreiberkatalog. Vor dem Wechsel die Beobachtung pausieren. Fake-TLS-Geheimnisse (`ee`…) funktionieren nicht. **Einstellungen für Rotation, Weitergabe und Wiederholungsversuche** **Parameter → Automatischer MTProxy**: Fehlerschwellen, Wartezeiten, Rotation, Konten pro Proxy. Limit 1 heißt, ein Konto wartet, statt zu teilen. Verschiedene Proxys können trotzdem dieselbe Ausgangs-IP haben. ## Trennung von Telegram von externen Anfragen MTProxy transportiert nur Telegram. Zeitstempel, Benachrichtigungen, Kopien und Code-Prüfungen laufen über einen separaten SOCKS5/HTTP-Proxy, die SOCKS5/HTTP-Route des Kontos oder direkt, wenn der Modus es erlaubt. Oder schalten Sie sie ab. `TGWITNESS_PROXY_FEED_PROXY` legt die Route für Listen-Downloads fest. Der [Zeuge](https://phishdestroy.io/tgwitness/de/docs/witness/) hat eigene Einstellungen. Nichts davon berührt Ihren Browser oder das Systemnetz. Mehr: [Modi und Standardwerte](https://phishdestroy.io/tgwitness/de/docs/reference/connection/#ip-modes), [wer Routen ändern darf](https://phishdestroy.io/tgwitness/de/docs/access/). --- # Telegram · Exportieren und verifizieren Canonical page: https://phishdestroy.io/tgwitness/de/docs/exports/ Exportieren Sie den erfassten Telegram-Verlauf, überprüfen Sie die Signaturen und vergleichen Sie das Protokoll mit einem von einem unabhängigen Zeugen aufbewahrten Kontrollpunkt. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Geben Sie jemandem Dateien, die er selbst gegen Ihren Arbeitsbereich prüfen kann. Bitte verweisen Sie daraufSignierte ZIP-Datei exportierenDer Empfänger überprüft Neu bei Signaturen und Prüfpunkten? [Ändern Sie einen Beispieleintrag](https://phishdestroy.io/tgwitness/de/docs/concepts/#chain) und sehen Sie, welche Prüfungen es bemerken. Möchten Sie eine Kopie außerhalb des Datensammlers aufbewahren? Gehen Sie zu [„S3-Einrichtung“](https://phishdestroy.io/tgwitness/de/docs/exports/#s3), [„Objekt-Sperre“](https://phishdestroy.io/tgwitness/de/docs/exports/#s3-retention) oder [„verifizierte Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/exports/#s3-restore)“. ## Eine vertrauenswürdige Referenz bereitstellen Notieren Sie den Fingerabdruck des Arbeitsbereichsschlüssels an einem anderen Ort als im Collector. Aktivieren Sie während der Erfassung den Beweismodus, damit die Checkpoints Zeitstempel gemäß RFC 3161 und OpenTimestamps erhalten, oder führen Sie einen [Witness](https://phishdestroy.io/tgwitness/de/docs/witness/) aus, der Beiträge in einem öffentlichen Kanal veröffentlicht. Bewahren Sie signierte Checkpoints ebenfalls an einem anderen Ort auf: Der Empfänger gleicht den Schlüssel, die Zeit und einen früheren Journalzustand mit diesen ab. ## Laden Sie die signierte ZIP-Datei herunter **Exporte** → signiertes Beweis-ZIP. Es enthält das ganze Journal und ein signiertes Dateimanifest. Den lesbaren Bericht gestalten Sie im [Report studio](https://phishdestroy.io/tgwitness/de/docs/reports/), oder Sie schicken nur ausgewählte Daten als [Übergabeauszug](https://phishdestroy.io/tgwitness/de/docs/handover/). HTML-, PDF- und JSON-Berichte tragen eigene Siegel. CSV ist nur eine Arbeitskopie; für die Integrität nehmen Sie die CSV aus dem geprüften ZIP. ## Überprüfen Sie dies anhand einer vertrauenswürdigen Kopie von TgWitness In der Projektumgebung, mit Ihrem eigenen Fingerabdruck und Pfaden: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` Ein erfolgreicher Durchlauf zeigt `key_pinned: true` und `checkpoint_checked: true` an. `--require evidence` benötigt außerdem einen Zeitstempel eines Drittanbieters für den letzten Datensatz, beispielsweise einen geprüften Zeitstempel: Der Checkpoint ist mit Ihrem eigenen Schlüssel signiert, daher reicht er allein nicht aus. Bewahren Sie diese Ausgabe neben dem Archiv auf. Der Checkpoint muss am Ende des Exports oder davor liegen. ## Verwenden Sie das Verifizierungsergebnis - **Dateien:** Das Manifest bindet ihre Hashes, die Signaturen binden das Journal. Jede Änderung fällt auf. - **Identität:** Der aufbewahrte Fingerabdruck belegt, dass es der erwartete Schlüssel ist. - **Früherer Stand:** Ein Prüfpunkt vergleicht den Export mit einem vor der Übergabe gespeicherten Journalanfang. - **Abdeckung:** Lücken, Erfassungsergebnisse und ein Test Senden → Bearbeiten → Löschen zeigen, was dieses Setup wirklich erfasst hat. Details: [was die Prüfung beweist](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope). ## Richten Sie die externe S3-Kopie ein **Exporte → Externe Kopie** in Ihrem Arbeitsbereich. Funktioniert mit AWS S3 und allem, was S3-kompatibel ist. Kopiert Journalsegmente, gespeicherte Dateien, Prüfpunkte mit ihren Zeitstempeln und fertige Chat-Exporte, jeweils mit `AES-256-GCM` verschlüsselt, bevor sie den Collector verlassen. Die Online-Demo zeigt diese Einstellungen mit deaktiviertem Upload. Echte Zugangsdaten nur in Ihrer eigenen Installation eingeben. [![Vollständiges Off-Site-Kopier-Panel: Endpunkt, Region, Bucket, Zugriffsschlüssel, Zeitplan, „Object Lock“- und Wiederherstellungsschlüssel-Steuerelemente](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4)](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4) Das vollständige Bedienfeld mit erweiterten Optionen ist aufgeklappt. Es werden keine Anmeldedaten für den Speicher angezeigt. | Fachgebiet | Was ist einzugeben? | | --- | --- | | Endpunkt | Speicher-URL, ohne Bucket-Pfad oder Zugangsdaten. Beispiel: `https://s3.example.invalid`. | | Region | Was Ihr Anbieter verlangt. Standard `us-east-1`. | | Bucket | Ein vorhandener Bucket mit Schreibrechten. Beispiel: `example-case-backup`. | | Ordner im Bucket | Präfix, Standard `tgwitness`. Ein Präfix pro Arbeitsbereich kommt dazu. | | Zugriffs-ID / Geheimer Zugangsschlüssel | Beide zusammen, im Tresor gespeichert. Später beide leer lassen, um sie zu behalten. | | Adressen im Pfadformat | An: `endpoint/bucket`. Aus: `bucket.endpoint`. Hängt vom Anbieter ab. | | Kopierintervall | 1 bis 1.440 Minuten, Standard 5. Nur solange die App läuft. | | Aufbewahrungsfrist für „Object Lock“ | Tage und Modus, wenn der Bucket Object Lock unterstützt. Null lässt den Bucket-Standard. | 1. Bucket anlegen, Ziel und Zugangsdaten mit deaktiviertem **Externe Kopie behalten** ausfüllen, **Externe Kopie speichern** klicken. 2. **Verbindung testen** lädt ein verschlüsseltes Testobjekt hoch. 3. **Verschlüsselungsschlüssel herunterladen** und fern vom Collector aufbewahren. Kein Schlüssel, keine Wiederherstellung. 4. **Externe Kopie behalten** aktivieren, speichern, dann **Jetzt kopieren** oder den Zeitplan laufen lassen. ## Aufbewahrungsstatus und Kopierfortschritt prüfen Unter **Weitere Optionen** Aufbewahrungstage und `GOVERNANCE` oder `COMPLIANCE` wählen. TgWitness liest die Aufbewahrung von einem hochgeladenen Objekt zurück und meldet: bestätigt, fehlt oder Prüfung fehlgeschlagen. Das Panel zeigt den letzten Durchlauf, Objektanzahl, Bytes, kopierte Journalgrenze und Fehler. Eine fehlende lokale Datei wird gemeldet und im nächsten Durchlauf erneut versucht, der Rest wird weiter kopiert. Uploads laufen direkt, über SOCKS5 oder HTTP. Mit einer reinen MTProxy-Route wartet die Kopie mit einem Fehler. ## Bewahren Sie den Wiederherstellungsschlüssel separat auf Das Schlüssel-JSON enthält den Entschlüsselungsschlüssel, das Ziel, das Präfix und den Schlüssel-Fingerabdruck. Zur Wiederherstellung brauchen Sie es plus Speicherzugangsdaten mit Leserecht. Endpunkt, Bucket oder Präfix geändert? Laden Sie den Schlüssel neu herunter. Am neuen Ziel startet eine frische Kopie, alte Chat-Exporte bleiben, wo sie waren. ## Wiederherstellung und Überprüfung auf einem anderen Rechner Sie brauchen eine vertrauenswürdige TgWitness-Installation, das Schlüssel-JSON, Nur-Lese-Zugangsdaten und einen leeren Ordner: ### Windows PowerShell ``` $env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY' $env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` ### Linux / macOS ``` export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY' export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` Erst wird alles in einem privaten Temp-Ordner geprüft: das ganze Journal, Prüfpunkte, Datei-Hashes und Größen. Unsichere Pfade, widersprüchliche Segmente oder ein Journal kürzer als sein Prüfpunkt schlagen fehl, und dann wird nichts geschrieben. Bei Erfolg bekommen Sie `events.jsonl`, `media/`, `checkpoints/` und `exports/`. Bewahren Sie die JSON-Ausgabe des Befehls dazu auf und vergleichen Sie mit selbst aufbewahrten Prüfpunkten oder Zeugen-Einträgen. --- # 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) . --- # Telegram · Untersuchungen über alle Chats hinweg Canonical page: https://phishdestroy.io/tgwitness/de/docs/cases/ Führen Sie eine lückenlose Telegram-Untersuchung über Kanäle, Gruppen, private Chats und Bots hinweg durch: Erfassung des gesamten Kontos, Verlauf, Personen, Links, Dateien, Zeitachsen und verifizierte Beweise. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Ein ganzer Fall über Kanäle, Gruppen, private Chats und Bots: erfassen, verknüpfen, die Zeitleiste rekonstruieren, übergeben. Ein erfundener Vorfall von Anfang bis Ende. Erfassung, Suche und Personenprofile finden die Einträge, [Case Board](https://phishdestroy.io/tgwitness/de/docs/case-board/) ordnet sie, [Report studio](https://phishdestroy.io/tgwitness/de/docs/reports/) präsentiert sie. BEARBEITETER FALL / EINE GEÄNDERTE ZAHLUNGSADRESSE ### Ein Vorfall. Vier Unterhaltungen. Eine Spur, die es zu rekonstruieren gilt. Ein Kanalbeitrag verweist auf einen Bot. Eine Gruppe spricht über einen neuen Zahlungslink, der Bot zeigt ihn an. Der Beitrag wird bearbeitet, ein privater Chat wiederholt den Link, eine Gruppennachricht verschwindet. Wer hat die jeweilige Version gepostet?Wo ist der Link erschienen?Welche Datei wurde gesichert?Was hat sich geändert und wann? Verlauf laden, KI, MCP, OCR und Webhooks: [Mit dem Archiv arbeiten](https://phishdestroy.io/tgwitness/de/docs/archive/). ## 1. Erfassen Sie den gesamten Account Umfang „ganzes Konto“ nur auf einem eigenen Konto. Ein Hauptkonto bekommt ausgewählte Chats oder einen Ordner. 1. [Verbinden Sie das Konto](https://phishdestroy.io/tgwitness/de/docs/accounts/) in einem eigenen Arbeitsbereich. Notieren Sie Fallreferenz, Konto-ID, Arbeitsbereich und Schlüssel-Fingerabdruck. 2. **Quellen → Beobachtungsumfang → Ermittlungsmodus**: **Ganzes Konto**, alle vier Quellentypen, **Eigene Aktionen**. Jeder neue Chat bekommt Profil und die letzten **200 sichtbaren Nachrichten** gespeichert. **Umfang speichern** und bestätigen. 3. **Chats laden** und mit der Chatliste des Kontos vergleichen. Das Limit liegt bei 1.000 Dialogen (bis 20.000 unter **Parameter → Aus der Kontoliste gelesene Chats**); Chats darüber hinaus tauchen auf, sobald sie aktiv werden. 4. **Aufzeichnungseinstellungen** → **Alle sichtbaren Aktivitäten**, Anhangslimits und Speicherplatz prüfen. Starten, dann mit einer Nachricht, einer Bearbeitung und einer Löschung testen. KanäleGruppenPrivate ChatsBots EIN KONTO / EIN SIGNATURSCHLÜSSEL**Alle ausgewählten, für das Konto sichtbaren Aktivitäten → ein Protokoll** Nachrichten · Bearbeitungen · Löschhinweise · sichtbare Reaktionen · Mitgliederereignisse · eigene Aktionen „Ganzes Konto“ heißt jeder Chat, den dieses Konto öffnen kann, abzüglich Ausschlüssen. Geheime Chats zeichnet das Modul Secret Chats auf. Neue Chats kommen hinzu, sobald sie auftauchen; alter Verlauf wird auf Anfrage geladen. ## 2. Verlauf erfassen und Dateien sichern Legen Sie eine Case-Board-Sammlung an und markieren Sie, was wichtig ist. Führen Sie ein Quellenregister: Chat-ID, Titel, Konto, Rolle, Beginn der Live-Erfassung, Verlaufsergebnis, Medienergebnis, Lücken. | Anforderungen | Aktivität im Panel | Was es bietet | | --- | --- | --- | | Verlauf aller aktivierten Chats | Quellen → Vollständigen Verlauf laden | Verfügbare frühere Nachrichten werden in das Arbeitsbereichsprotokoll aufgenommen, mit den Funktionen „Pause/Fortsetzen“ und einem signierten Fortschrittsbericht. [Anleitung zur Verlaufsanzeige](https://phishdestroy.io/tgwitness/de/docs/reference/history/). | | Bestehender Chat-Kontext im Protokoll | Quellen → Aufzeichnungseinstellungen → Verlaufs-Snapshot | Aktuelle Nachrichten als signierte Einträge. Standard 500, bis 10.000 unter **Parameter → Größter Verlaufs-Snapshot**. | | Vollständiger, derzeit sichtbarer Verlauf eines Chats | Gesamten Chat exportieren → Gesamten Chat exportieren oder Chats → Chat exportieren | Ein separates signiertes Paket mit `chat.json` und `chat.html`, eines pro Chat. | | Kontext beim Erscheinen eines neuen Chats | Beobachtungsumfang → Wenn ein neuer Chat oder Bot erscheint | Sein Profil und bis zu 1.000 aktuelle Nachrichten (200 im Ermittlungsmodus). Gilt nicht für bestehende Chats. | | Anhangsgröße | Sichtbare Anhänge herunterladen + Begrenzungen pro Dateityp | Achten Sie auf `media.saved` mit SHA-256 und Größe. In der Warteschlange, übersprungen oder fehlgeschlagen heißt nicht gespeichert. | Ein Chat-Export landet nicht im Journal oder in Personenprofilen. Um alten Verlauf in TgWitness zu durchsuchen, nehmen Sie **Gesamten Verlauf laden** oder Snapshots. Hier: der Kanal, die Gruppe, der Bot-Chat und der private Chat, dazu die Rechnungsdatei und ihr Hash. Was vor der Erfassung gelöscht wurde, ist weg. ## 3. Behalten Sie den Verlauf der Unterhaltung und Ihre eigenen Handlungen im Blick Lassen Sie es laufen. Markieren Sie die heißen Chats mit Stern als Priorität, stellen Sie Nachprüfungen unter **Aufzeichnungseinstellungen → Nachprüfung** ein und behalten Sie `recheck.completed`, FloodWait und Medienergebnisse im Blick. **Chats → Profil → Profil jetzt speichern** speichert Chatbeschreibung, Bot-Befehle und weitere Metadaten. **Ein Bot oder eine Einladung im Rahmen des Falles folgen** 1. **Chats → Telegram-Link öffnen**, zuerst die Vorschau speichern. Link und Vorschau werden signierte Einträge. 2. Falls nötig, tritt **Beitreten / öffnen und beobachten** dem Chat bei oder startet den Bot mit seinem Startparameter. 3. Um eine Aktion zu dokumentieren, antworten Sie oder nutzen Sie **Button drücken** im Panel. Sie bekommen `interaction.requested` und `interaction.result` mit der Antwort des Bots. Das sind echte Aktionen. In einer anderen App gedrückte Buttons sind nicht sichtbar, nur die Antwort des Bots. Keine Web-Apps, Zahlungen oder Telefon/Standort. ## 4. Verfolgen Sie Personen, Links und Dateien über Chats hinweg 1. **Journal**, **Alle Quellen**, suchen Sie eine Phrase, Domain oder einen Benutzernamen. Öffnen Sie Treffer und schicken Sie sie **Aufs Board**. 2. **Chats → Personen → Profile einschalten**, wählen Sie eine Person: Namensverlauf, Antworten, Aktivität, **Auch in…**, Links, Wallets, Telefone. Öffnen Sie die zitierten Einträge. 3. Verfolgen Sie dieselbe numerische Benutzer-ID in andere Chats. Ein übereinstimmender Name, eine Wallet oder ein Avatar ist ein Hinweis, der mit der numerischen ID abzugleichen ist. 4. Vergleichen Sie Datei-Hashes. Gleicher SHA-256 = gleiche Bytes. FALLÜBERSICHT / VERWEISEN VERFOLGENFiktiver Fall · keine Echtzeit-Grafik KANAL / ANKÜNDIGUNG**Original → bearbeitete Zielversion** Einträge Nr. 101, Nr. 188, Nachricht Nr. 84 · Absender nicht zugeordnet GRUPPE / EINSÄTZE**Benutzer 71001 veröffentlicht den neuen Link** Eintrag Nr. 146 · Nachricht Nr. 309 · Gespeicherte Empfangsbestätigung Nr. 151 BOT / BESTELLUNGSGESPRÄCH**Eine Schaltfläche führt zu dieser Seite** Eintrag Nr. 173 · Nachricht Nr. 12 Metadaten der „Zurück“-Schaltfläche PRIVAT / WEITERFÜHRUNG**Benutzer 71001 wiederholt das Ziel** Eintrag Nr. 205 · Nachricht Nr. 922 · Speicherbestätigung Nr. 209 Vier Chats liefern unterschiedliche Beobachtungen. Verfolgen Sie die Quelldatensätze für jede Verbindung; der Kanalbeitrag hat keinen zuordenbaren Absender. Die numerischen IDs und Datensatzreferenzen wurden für diese Anleitung fiktiv erstellt. Diese übersichtliche Darstellung zeigt, wie Suchergebnisse, Profile und geprüfte Datensätze miteinander verknüpft werden; das „Case Board“ speichert die entsprechenden Karten und Quellenangaben. | Zusammenhang | Unterstützende Anmerkung | Fazit: Beibehalten | | --- | --- | --- | | Gleicher Telegram-Account | Benutzer-ID 71001 in der Gruppe #146 und im privaten Chat #205 | Dieselbe Absender-ID in beiden Chats. | | Wiederholtes Ziel | `pay.example.invalid/new` in #146, Metadaten der Schaltfläche #173, bearbeitete Beiträge #188 und #205 | Derselbe Link an vier Stellen. | | Gleiche Dateigröße | Identische vollständige SHA-256-Werte in den abgeschlossenen Medienbelegen Nr. 151 und Nr. 209 | Beide Dateien sind byte-identisch. | Profile umfassen nur Personen, die in *diesem Arbeitsbereich* etwas geschrieben haben, keine Mitgliederliste. Zitate pro Fakt: **Parameter → Zitierte Einträge pro Fakt**. ## 5. Rekonstruieren Sie die Abfolge und markieren Sie die Lücken Versionen in **Chats**, dann **Journal** mit **Alle Quellen** + **Bearbeitungen**, **Löschungen**, **Abdeckung**. Beide Zeiten in die Zeitleiste: Telegrams Datum und wann es beobachtet wurde. 1. 09:00 · #101**Erfasster Kanalbeitrag** Das ursprüngliche Ziel bleibt erhalten. 2. 09:12 · #146 / #151**Die Gruppe fügt einen anderen Link hinzu** Benutzer 71001 veröffentlicht den Beitrag; der Download eines Anhangs wird abgeschlossen. 3. 09:16 · #173**Der Bot zeigt denselben Zielort an** Die gespeicherten Tastatur-Metadaten enthalten den Link. 4. 09:20 · #188**Änderungen bei den Kanalankündigungen** Sowohl die ursprünglichen als auch die bearbeiteten Einträge bleiben erhalten. 5. 09:24 · #205 / #209**In einer privaten Folge wird dies wiederholt** Der gespeicherte Anhang weist denselben vollständigen SHA-256-Hashwert wie #151 auf. 6. 09:28 · #231**Benachrichtigung über die Löschung einer Gruppe geht ein** Die frühere Feststellung gilt weiterhin: Weder der Verfasser der Löschung noch ein genauer Zeitpunkt der Löschung werden angegeben. Beispielhafte Beobachtungszeitpunkte und Verweise. Zwischen diesen Einträgen befinden sich weitere Protokollaufzeichnungen. Die Journalreihenfolge ist die Eingangsreihenfolge, nicht unbedingt die Reihenfolge der Ereignisse. Halten Sie Live-Einträge, Snapshots, wiederhergestellte Nachrichten, Löschungen und „bei Nachprüfung nicht gefunden“ auseinander und markieren Sie jede Lücke als unbekannt. ## 6. Erweitern Sie den Fall auf andere Sammelkonten Ein Arbeitsbereich pro Konto, gleiche Schritte. Notieren Sie Rolle und Fingerabdruck von jedem. Nachrichtennummern gelten pro Konto, also immer Arbeitsbereich und Chat angeben. Eine [Kontogruppe](https://phishdestroy.io/tgwitness/de/docs/groups/) zeigt den Status, teilt Einstellungen und exportiert alle zusammen, jeweils mit eigenem Journal und Schlüssel. Eine kontenübergreifende Zeitleiste bauen Sie in Ihren Notizen. Langer Fall? Fügen Sie einen [unabhängigen Zeugen](https://phishdestroy.io/tgwitness/de/docs/witness/) hinzu und testen Sie, was jedes Konto wirklich erfasst. ## 7. Ein überprüfbares Fallpaket liefern Ein signiertes ZIP aus jedem Arbeitsbereich (immer das ganze Journal, Filter spielen keine Rolle), dazu Personenprofile, Chat-Exporte und Dateien. ``` CASE-001/ # assembled by the analyst case-notes.md # question, findings, alternative explanations sources.csv # every chat, role, acquisition result and gap timeline.csv # account + chat + message + seq + both times workspace-A/ evidence.zip # complete signed observation journal retained-checkpoint.json profiles-operations.json # separately signed people profiles history-channel.zip # signed current-history export history-group.zip verification.txt workspace-B/ # separate journal and trusted fingerprint witness/ # retained checks, journal and signed posts SHA256SUMS # hashes of the delivered files ``` Schicken Sie die Fingerabdrücke separat. Prüfen Sie alles gegen seinen eigenen Arbeitsbereich: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Der Checkpoint ist mit dem Collector-Schlüssel signiert, erfüllt also für sich genommen nicht die Mindestanforderungen für einen Nachweis; `--require evidence` benötigt zusätzlich einen geprüften Zeitstempel oder einen Witness-Beitrag, der den letzten Eintrag abdeckt. Bewahren Sie Prüfausgabe, Originale, Abdeckung und Übergabeprotokoll bei Ihren Ergebnissen auf. Schreiben Sie alles im Report studio zusammen. Braucht der Empfänger weniger, erstellen Sie eine [minimierte Übergabe](https://phishdestroy.io/tgwitness/de/docs/handover/). --- # Telegram · Erstellen Sie ein Case Board Canonical page: https://phishdestroy.io/tgwitness/de/docs/case-board/ Sammeln Sie gespeicherte Beobachtungen, genaue Markierungen und Aktionsausschnitte auf einem privaten Board, besprechen Sie diese mit Ihrem Team und präsentieren Sie eine Zusammenstellung. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Machen Sie aus gespeicherten Nachrichten einen Fall, an dem Ihr Team gemeinsam arbeitet. Lesezeichen, exakte Zitate, Ausschnitte und Diskussionen, jeweils mit der Quelle verknüpft. Jede Änderung ist eine signierte Revision. ## Von einer Nachricht zur Fallkarte 1. **Ermittlung → Case Board** (Modus Standard oder Experte). Legen Sie eine Sammlung für den Fall an. 2. Im **Journal** oder in einem Chat **Aufs Board** (oder **B**) drücken. Die Karte landet im Eingang, geben Sie ihr einen Titel und verschieben Sie sie. 3. Text in einer Nachricht markieren, **Hervorheben → Board** behält exaktes Zitat und Version. Notieren Sie, warum es wichtig ist. 4. Diskutieren, Status setzen, bei Bedarf zur Quelle zurückspringen. **Präsentation** führt das Team durch das Material. ### Folgen Sie einem geänderten Zahlungslink Synthetisches Beispiel · lokale Illustration 1. **Erfassung.** Öffnen Sie die gespeicherte Beobachtung Nr. 142 und deren Nachrichtenversion. 2. **Lesezeichen.** Speichern Sie das Zitat, die Quellenangabe und Ihre Frage auf einer Karte. 3. **Überprüfen.** Fügen Sie einen Teamkommentar hinzu und verschieben Sie die Karte in den Status „Überprüfen“. 4. **Präsentieren.** Gehen Sie die Erfassung durch und öffnen Sie den Kontext der zitierten Quelle. #### Gespeicherte Beobachtung Nr. 142 „Verwenden Sie den neuen Zahlungslink.“ Operations-Chat · Nachricht 38 · beobachtet um 09:12 UTC #### Karte: Ziel geändert > Verwenden Sie den neuen Zahlungslink. Frage: Welches Ziel tauchte in der früheren Version auf? #### Team-Überprüfung Analyst: Vergleichen Sie dies mit Beobachtung Nr. 101. Status: Überprüfung · Überarbeitung beibehalten #### Quelltextkontext Karte → gespeicherte Version → frühere Beobachtung Die Anmerkungen und die Telegram-Beobachtungen bleiben separat identifizierbar. ## Speichern Sie einen nützlichen Bereich einmalig Umschalt-Klick auf zwei Nachrichten für **Ausschnitt dazwischen**, **Ausschnitt nach Zeit** nutzen oder die aktuellen Journalfilter speichern. **Seit dem Lesezeichen hinzugekommene Einträge zeigen** zeigt, was später kam. Zeitausschnitte nutzen die Beobachtungszeit, Ausschnitte nach Nachrichten-ID folgen diesen Nachrichten, wenn sie sich ändern. ## Weisen Sie jedem Kollegen die richtige Rolle zu **Prüfer** liest, **Analyst** fügt Karten und Kommentare hinzu, **Operator** verwaltet zusätzlich Sammlungen und Entscheidungen. Chat-Berechtigungen gelten auch für Karten. ## Setzen Sie die Arbeit in ein lieferbares Ergebnis um Ausschnitte werden als signiertes JSON oder CSV exportiert. Berichte können Lesezeichen, Ausschnitte und Kommentare enthalten, das stellen Sie im [Report studio](https://phishdestroy.io/tgwitness/de/docs/reports/) ein. Für einen eingeschränkten Empfänger nehmen Sie eine [Übergabe](https://phishdestroy.io/tgwitness/de/docs/handover/). Details: [Case-Board-Referenz](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/). --- # Telegram · Erstellen Sie einen Bericht Canonical page: https://phishdestroy.io/tgwitness/de/docs/reports/ Wählen Sie die Berichtsdaten, eines von acht Designs und den Inhalt aus, zeigen Sie dann eine Vorschau an und exportieren Sie HTML, ein signiertes PDF oder ein vollständiges Beweismittelpaket. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Führen Sie den Leser von der Fallfrage direkt zu den gespeicherten Einträgen. Report studio stellt Ihre ausgewählten Daten, Änderungsverläufe, Diagramme und Ergebnisse zusammen. Acht Designs, HTML und natives PDF. Jeder HTML-, PDF- und JSON-Bericht wird mit Ihrem Schlüssel versiegelt. ## Erstellen Sie einen Bericht in drei Schritten 1. **Exporte → Konfigurieren und Vorschau → Daten**: der ganze Arbeitsbereich oder ausgewählte Chats, Autoren, Daten (UTC, wann TgWitness den Eintrag gesehen hat) und Eintragstypen. 2. **Design & Inhalt**: Design wählen und was hineinkommt: Diagramme, Teilnehmer, Transkript, Änderungen, Case-Board-Elemente, Falldaten und Notizen. 3. **Vorschau**: Zahlen, Aktivität, Stichproben und fehlende ID-Bereiche prüfen. Speichern, dann das benötigte Format herunterladen. ### Ordnen Sie das gespeicherte Material für den Leser entsprechend an Synthetisches Beispiel · schematisches Layout, kein generierter Bericht 1. **Auswahl.** Wählen Sie zwei Chats und den Beobachtungszeitraum für den Fall aus. 2. **Verfassen Sie den Text.** Wählen Sie ein Layout und die Abschnitte aus, die die Frage beantworten. 3. **Vorschau.** Überprüfen Sie die ausgewählten Zählwerte und den gespeicherten Vorher-Nachher-Text. 4. **Überprüfen.** Erstellen Sie die endgültige Datei und vergleichen Sie deren Signatur mit dem Fingerabdruck des vertrauenswürdigen Arbeitsbereichs. #### Ausgewählte Beobachtungen 2 Chats · 1 Beobachtungstag Nachrichten, Bearbeitungen und Löschhinweise #### Berichtsstruktur ##### Geänderte Zahlungsadresse Fallfrage → Umfang → Ergebnisse → Verweise auf Datensätze **Nachrichtenkontext** Anmerkung Nr. 142: „Verwenden Sie den neuen Zahlungslink.“ **Gespeicherte Änderungen** Vorher: old.example.invalid → Nachher: new.example.invalid #### Überprüfen Sie die Auswahl 18 Beobachtungen · 2 gespeicherte Bearbeitungen Zeitangaben zu Versand, Bearbeitung und Beobachtung sind separat gekennzeichnet. #### Endgültiges Ergebnis Signiertes PDF + signiertes JSON oder eine signierte ZIP-Datei mit dem lesbaren Bericht Der Empfänger überprüft die Datei und den vertrauenswürdigen Fingerabdruck. ## Wählen Sie einen Lesestil **Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, and Ledger & margin**: gleiche Einträge, anderes Aussehen. Beim Wechsel bleiben Auswahl und Notizen. Jede der 25 Sprachen. PDFs werden mit mitgelieferten Schriften erzeugt, kein Browser nötig. Chinesisch, Japanisch und Koreanisch brauchen eine Schrift wie Noto Sans CJK auf dem Server (systemweit oder in `TGWITNESS_FONT_DIR`), sonst gibt es nur HTML und JSON. ## Lesen Sie eine Änderung im Kontext Bearbeitungen zeigen vorher und nachher, Löschungen die letzte gespeicherte Version. Antworten, Weiterleitungen, Reaktionen, Buttons und Anhänge behalten ihre Verweise. Die Design-Vorschau nutzt die ersten 50.000 Einträge, die Datenvorschau zählt alles exakt. Für das endgültige Seitenlayout erzeugen Sie das PDF. ## Wählen Sie die Empfängerfassung sorgfältig aus Filter formen nur den Bericht, das Beweis-ZIP enthält weiter das ganze Journal und alle Dateien. Soll der Empfänger weniger bekommen, nutzen Sie eine [minimierte Übergabe](https://phishdestroy.io/tgwitness/de/docs/handover/). Mehr: [Berichtsinhalte](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/), [den Export prüfen](https://phishdestroy.io/tgwitness/de/docs/exports/). --- # Telegram · Bereiten Sie eine Kopie zur Weitergabe vor Canonical page: https://phishdestroy.io/tgwitness/de/docs/handover/ Wählen Sie die Datensätze und Felder aus, die ein Empfänger erhalten darf, prüfen Sie die fertige Kopie und verifizieren Sie das signierte Manifest sowie die Grenzen des Quelljournals. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Teilen Sie nur, was nötig ist, das Original bleibt unberührt. Eine Übergabe ist ein separater signierter Auszug: Chats und Personen wählen, Identitäten oder Text verbergen, Dateien und Teamnotizen auswählen. Das Manifest hält fest, was behalten, gekürzt und weggelassen wurde. ## Auszug für den Empfänger vorbereiten 1. **Exporte → Übergabeauszug**: Zweck eintragen, Chats und Zeitraum wählen, **Personen der gewählten Chats laden**, wenn Sie namentlich genannte Personen brauchen. 2. Alle anderen: Pseudonyme, weggelassen oder wie aufgezeichnet. Text und Dateien sind getrennte Schalter; Telefonnummern und E-Mails lassen sich maskieren. 3. Case Board: nichts, Lesezeichen und Ausschnitte oder Karten mit Kommentaren. Teamnamen lassen sich durch Aliasse ersetzen. 4. **Übergabeauszug herunterladen**, öffnen, prüfen, vor dem Versenden durchsehen. ### Ein Original, eine Kopie zur Weitergabe Fiktives Beispiel · dient nur zur Veranschaulichung 1. **Auswählen.** Den Fall-Chat einbeziehen und die Person identifizieren, um die es in dem Auszug geht. 2. **Minimieren.** Wählen Sie aus, wie ein anderer Teilnehmer in der Freigabekopie angezeigt wird. 3. **Überprüfen Sie** den Bericht und die Datensätze des generierten Archivs**,** bevor Sie es versenden. 4. **Teilen.** Liefern Sie die geprüfte Fassung und übermitteln Sie den zugehörigen vertrauenswürdigen Fingerabdruck separat. #### Ursprüngliche Anmerkung Nora · Benutzer 71002 „Ich habe den überarbeiteten Link erhalten.“ Das Quellprotokoll bewahrt diese gespeicherte Beobachtung auf. #### Kopie für den Empfänger Wie aufgezeichnet anzeigen: Nora · Benutzer 71002 · „Ich habe den überarbeiteten Link erhalten.“ Pseudonym: P01 · „Ich habe den überarbeiteten Link erhalten.“ Weglassen: Die Nachricht dieses Teilnehmers wird im Text nicht berücksichtigt. #### Prüfen Sie die tatsächlichen Dateien Lesen Sie die Dateien „report.html“ und „records.jsonl“. Überprüfen Sie Identitäten, Text, Anhänge und optionale Teamkommentare. #### Signierter Auszug Auswahl + Datei-Hashes + signiertes Manifest Ein separates Paket, das mit den Grenzen des zugehörigen Quellprotokolls verknüpft ist ## Verwenden Sie die Steuerelemente gemeinsam | Kontrolle | Auswirkungen auf den Text | | --- | --- | | Personen | Ausgewählte Personen bleiben namentlich genannt, andere bekommen Pseudonyme oder werden weggelassen. | | Text | Der ganze Text, nur der der ausgewählten Personen und Ihres Kontos, oder keiner. | | Dateien | Dateien der ausgewählten Personen und Ihres Kontos, alle angezeigten Dateien oder keine. | | Fallübersicht | Nichts, Lesezeichen und Ausschnitte oder Karten mit Diskussion. | Lesen Sie auch Text und Dateien: Ein Pseudonym entfernt keine Namen, die in einer Nachricht oder einem Anhang stehen. Fehlt eine ausgewählte Datei, stellen Sie sie wieder her oder lassen Sie Anhänge weg. ## Der Text muss unabhängig überprüfbar bleiben. ``` python -m tgwitness.verify handover.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` Behalten Sie das Originalarchiv und die Prüfpunkte selbst. Der Empfänger kann seine Kopie prüfen, ohne den ganzen Arbeitsbereich zu bekommen. Design: [Report studio](https://phishdestroy.io/tgwitness/de/docs/reports/). Vertrauenswürdige Referenzen: [Exportprüfung](https://phishdestroy.io/tgwitness/de/docs/exports/). --- # Telegram · Verwalten Sie eine Gruppe von Konten Canonical page: https://phishdestroy.io/tgwitness/de/docs/groups/ Vergleichen Sie Gruppen-Arbeitsbereiche, suchen Sie eine Quelle, überprüfen Sie Beobachtungszeiträume und wenden Sie gemeinsame Einstellungen mit Ausnahmen pro Konto an. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Betreiben Sie mehrere Konten zusammen, jedes weiterhin mit eigenen Einträgen und eigenem Schlüssel. Eine Gruppe bringt Verbindungsstatus, Start/Pause, gemeinsame Einstellungen und Exporte auf einen Bildschirm. Praktisch, wenn mehrere Konten am selben Fall arbeiten. ## Gruppenübersicht öffnen Öffnen Sie die Gruppe unter **Konten**. Jedes Konto zeigt Status, Route, Latenz und letzte gespeicherte Nachricht. **Erfordert Aufmerksamkeit** listet die defekten, **Beheben** bringt Sie direkt hin. **Alle starten** / **Alle pausieren** fragen vorher nach. **Gruppeneinstellungen** werden geteilt, aber die eigenen Werte eines Kontos bleiben, bis Sie sie ersetzen. ### Überprüfen Sie eine Routenänderung innerhalb einer Gruppe Fiktives Beispiel · illustrative Prüfungen und Ergebnisse 1. **Auswählen.** Wählen Sie die Gruppe aus und prüfen Sie, welche Konten sich ändern werden. 2. **Vorbereitung:** Behalten Sie den eigenen Pfad eines Kontos bei, wenn dieser getrennt bleiben soll. 3. **Überprüfen.** Testen Sie die vorgeschlagene Verbindung und überprüfen Sie die Messergebnisse. 4. **Anwenden.** Vor dem Speichern noch einmal überprüfen und das Ergebnis für jedes Konto kontrollieren. #### Fallteam Kanal-Collector · Gruppen-Collector · Referenzkonto 3 separate Arbeitsbereiche #### Überprüfte Auswahl 2 Konten folgen dem vorgeschlagenen Vorgehen. Das Referenzkonto verfügt über eine eigene Route. #### Vorbereitungsprüfungen Kanal-Collector: Telegram-Übertragungszeit 84 ms Gruppen-Collector: Telegram-Übertragungszeit 91 ms Diese Zahlen sind fiktive Messwerte für das Beispiel. #### Anwendungsergebnisse Kanal-Collector: Speicherung abgeschlossen, Beobachtung fortgesetzt. Gruppen-Collector: Überprüfung fehlgeschlagen, vorherige Einstellungen wiederhergestellt. Referenzkonto: eigene Route beibehalten. ## Ändern Sie die Route mit einem Überprüfungsschritt 1. **Gruppenroute ändern**, Typ und Einstellungen wählen. 2. **Auswahl prüfen**: welche Konten sich ändern und welche eine eigene Route haben. 3. **Vorbereiten und prüfen** testet eine frische Telegram-Verbindung und, wo möglich, die Ausgangs-IP. 4. **Geprüfte Verbindung anwenden** und jedes Ergebnis ansehen. Laufende Konten machen weiter, inaktive bleiben inaktiv. Latenz ist die Zeit für den Verbindungsaufbau zu Telegram, die Ausgangs-IP ist das, was die Route bei der Prüfung zeigte. Ergebnisse können je Konto abweichen. ## Verwenden Sie überlappende Zugriffsrechte **Chats, die mehrere Konten sehen** listet gemeinsame Quellen und ihre Abdeckung. Kanäle und Supergruppen lassen sich mit **Mit … Konten exportieren** von mehreren Konten gleichzeitig exportieren. Private Chats und einfache Gruppen nicht, ihre Nachrichtennummern gelten pro Konto. ## Die Gruppe als Paket exportieren **Gruppe exportieren** liefert ein ZIP mit dem signierten Export jedes Kontos und einer signierten Liste davon. Jedes behält seinen Fingerabdruck für die Prüfung. Eine zusammengeführte Zeitleiste bauen Sie weiterhin selbst. Weiter: [Berichte](https://phishdestroy.io/tgwitness/de/docs/reports/), [Case Board](https://phishdestroy.io/tgwitness/de/docs/case-board/), [Exporte prüfen](https://phishdestroy.io/tgwitness/de/docs/exports/). --- # Telegram · Erfahren Sie, wie die Beweissicherung funktioniert Canonical page: https://phishdestroy.io/tgwitness/de/docs/concepts/ Verfolgen Sie eine Nachricht von der Erfassung bis zum Prüfpunkt. Ändern Sie einen Beispieldatensatz, berechnen Sie dessen SHA-256-Kette neu und sehen Sie, was ein gespeicherter Prüfpunkt erkennt. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Nachrichten ändern sich. Ihre Aufzeichnung dessen, was Sie gesehen haben, sollte das nicht, und jeder sollte das prüfen können. Unten zwei kleine Experimente. Erfundene Nachrichten, alles läuft im Browser, nichts geht an Telegram. ## Vom Chat-Export zum überprüfbaren Datensatz Ein [Telegram-Desktop-Export](https://telegram.org/blog/export-and-more) speichert den gerade sichtbaren Verlauf als HTML oder JSON. TgWitness ergänzt ein laufendes Änderungsjournal, Signaturen auf jedem Eintrag und Prüfpunkte, mit denen andere vergleichen können. | Aufgabe | Export aus Telegram Desktop | TgWitness | | --- | --- | --- | | Gespeicherte Unterhaltungen lesen | HTML oder JSON mit ausgewählten Medien | Gespeicherte Chats, durchsuchbares Protokoll und Offline-Berichte | | Verfolgen Sie eine Veränderung im Zeitverlauf | Der beim Export verfügbare Verlauf | Alte Versionen, spätere Bearbeitungen und Löschungen, alles behalten | | Dateien nach der Übergabe überprüfen | Standardmäßige HTML-/JSON-Exportdateien sind nicht signiert. | Signiertes Manifest, signierte Einträge und versiegelte Berichte, geprüft gegen einen vertrauenswürdigen Schlüssel | | Vergleichen Sie mit einem früheren gespeicherten Zustand | Bewahren Sie eine separate Referenzkopie oder einen Hash auf | Signierte Kontrollpunkte, ein separater Zeuge und optionale externe Zeitstempel | Der Vergleich beruht auf dem [Exportcode von Telegram Desktop](https://github.com/telegramdesktop/tdesktop/tree/768d47cda6c7f447c10a25d1f363279493a90ed7/Telegram/SourceFiles/export/output) mit Stand 2. November 2026. ## Eine Nachricht, drei Beobachtungen Eine neue Nachricht, eine Bearbeitung und eine Löschung werden drei getrennte Einträge. Die Bearbeitung überschreibt den ersten nicht, die Löschung entfernt ihn nicht. 01 / DER WEG DER NACHRICHTBeispielablauf Telegram delivers an update to the collector, which appends a journal record. · Telegram · Collector · Protokoll · Aktualisierung → · Anhängen → AKTUELLE CHAT-ANSICHT Nachricht Nr. 42 Nachricht gelöscht Die Nachricht ist aus der Chat-Ansicht verschwunden. BEOBACHTUNGSPROTOKOLL 3 Einträge 1. 01 `message.new` Treffpunkt um 10:00 Uhr ✓ 2. 02 `message.edited` Treffpunkt um 11:00 Uhr ✓ 3. 03 `message.deleted` Löschhinweis zu Nr. 42 ✓ Alle drei erfassten Beobachtungen verbleiben im Protokoll. Vereinfachter Pfad für eine bereits ausgewählte Quelle. Operative Aufzeichnungen greifen ebenfalls auf das tatsächliche Protokoll zurück. Die Erfassung hängt davon ab, was das Konto einsehen kann und was Telegram bereitstellt. ## Ändern Sie einen Datensatz. Folgen Sie dem Hash. Jeder Eintrag enthält den Hash des vorherigen. Ein anderswo aufbewahrter Prüfpunkt hält Journallänge und letzten Hash fest. 02 / HASH-CHAIN-SANDBOXEchtes SHA-256 · Beispieldatensätze AUFZEICHNUNG 01**Nachricht empfangen**`h₁ = SHA-256(e₁)`Links zu 64 Nullen AUFZEICHNUNG 02**Treffpunkt um 11:00 Uhr**`h₂ = SHA-256(e₂)`Enthält h₁ AUFZEICHNUNG 03**Löschung festgestellt**`h₃ = SHA-256(e₃)`Enthält h₂ AN ANDERER STELLE GESPEICHERT**3 Einträge · Kopfzeile `h₃`**Vergleichen Sie diese festgelegte Abgrenzung mit dem bereitgestellten Protokoll. Das Ändern eines Ereignisses verändert dessen Hash-Wert. Das Neuerstellen der Kette verändert deren Kopf. Das Entfernen des Endes führt dazu, dass die Kette kürzer ist als der beibehaltene Kontrollpunkt. **Sehen Sie sich Datensatz 2 und die vollständigen Hashes an** Dies ist der exakte UTF-8-JSON-Text, der in diesem Beispiel gehasht wurde. Die Werte sind fiktiv; die neun Felder und die Serialisierung entsprechen dem Protokollformat. ``` ``` Hash des gespeicherten Datensatzes 2 `` Neu berechneter Hash von Datensatz 2 `` Diese Sandbox berechnet Hashes, keine Signaturen. Der eigentliche Verifizierer überprüft zudem die Ed25519-Signatur, die Sequenz und den Link jedes Ereignisses. Durch die bloße Rekonstruktion von Hashes lassen sich unter dem vertrauenswürdigen Schlüssel keine gültigen Signaturen erstellen. ## Die eigentlichen Regeln in wenigen Zeilen HASH + SIGNATUR h0 = 064 hi = hex(SHA-256(C(ei))) σi = Ed25519.Sign(sk, unhex(hi)) **C** sind die neun Ereignisfelder als UTF-8-JSON: sortierte Schlüssel, kein zusätzlicher Leerraum, kein ASCII-Escaping, kein NaN/Unendlich. `previous_hash` ist hi−1, h0 sind 64 Nullen, Signaturen decken die 32 Rohbytes des Digests ab. Die Felder: `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload`, `previous_hash`. Vollständige Spezifikation: [Ereigniskodierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#event-canonicalization). BEIBEHALTENER PRÜFPUNKT Nexport ≥ Ncheckpoint hexport[Ncheckpoint] = Hcheckpoint Prüfen Sie die Signatur des Prüfpunkts gegen den festgelegten Schlüssel und vergleichen Sie ihn dann mit dem Journal. Ein späterer Export darf länger sein, muss aber am Prüfpunkt übereinstimmen. ## Drei Fragen, drei verschiedene Überprüfungen [01 / INTEGRITÄT**Hat sich dieser Eintrag geändert?** Hashes und Signaturen gegen einen Schlüssel, dem Sie vertrauen.](https://phishdestroy.io/tgwitness/de/docs/exports/)[02 / KONTINUITÄT**Was wurde zuvor beibehalten?** Vergleichen Sie den Export mit Prüfpunkten, die ein Zeuge aufbewahrt hat.](https://phishdestroy.io/tgwitness/de/docs/witness/)[03 / LIEFERUNG**Sind diese Testereignisse eingegangen?** Senden, bearbeiten und löschen Sie Testnachrichten und sehen Sie, was jedes Konto erfasst hat.](https://phishdestroy.io/tgwitness/de/docs/cases/) Signaturen beantworten „wurde es geändert?“, Prüfpunkte „passt es zu dem, was vorher da war?“, Testnachrichten „haben wir alles erfasst?“. [Was die Prüfung beweist.](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) Weiter: eine [Untersuchung des ganzen Kontos](https://phishdestroy.io/tgwitness/de/docs/cases/) vom Start bis zum Fallpaket. [Export-Workshop: Sehen Sie sich das kontrollierte Desktop-Experiment an](https://phishdestroy.io/tgwitness/de/docs/export-clinic/). Vergleichen Sie den zweiminütigen Film, die Originalaufnahme und sieben Paare von Test-Exporten. Lokale Änderungen werden offengelegt. --- # Telegram · Sorgen Sie für Sicherheit Canonical page: https://phishdestroy.io/tgwitness/de/docs/security/ Erfahren Sie, wo Sitzungen, Schlüssel und Beweismaterial gespeichert sind, welche Daten Ihren Rechner verlassen, welchen Schutz die Sicherheitsmaßnahmen bieten und wie Sie eine Installation absichern können. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Was Ihren Rechner verlässt, was jedes Geheimnis öffnet und was die Schutzmaßnahmen abdecken und was an Ihnen hängt. **127.0.0.1**Standardmäßige Panel-Adresse **256-Bit**Zufälliges Panel-Token **0**CDNs, Analysetools oder Remote-Schriftarten **Ed25519**Signatur auf jedem Datensatz ## Hier finden Sie alles Collector, Panel und alle Einträge bleiben auf Ihrem Rechner. Standardmäßig wird nur Telegram kontaktiert, alles andere ist ein eigener Schalter. 06 / WAS DIE MASCHINE VERLÄSSTIhre Installation IHR COMPUTER ODER SERVER **Panel**127.0.0.1:8787 · Bearer-Token **Collector**Ein Telegram-Client pro Arbeitsbereich DATENVERZEICHNIS **Protokoll**SQLite · Hash-verknüpft · signiert **Medien**Dateien, benannt nach SHA-256 **Vault**Fernet · Sitzung, API-Paar, Signaturschlüssel, Proxy - **Telegram**Immer · über Ihren Weg Die MTProto-Verbindung des Kontos: direkt, SOCKS5, HTTP oder MTProxy. Der „IP verbergen“-Modus wartet auf einen funktionierenden Proxy. Für den direkten Fallback ist ein Modus erforderlich, der dies ausdrücklich zulässt. - **Text für externe Seiten**Optional · standardmäßig deaktiviert Das Protokoll, die Dateien und die Kontrollpunkte werden vor dem Hochladen in einen S3-kompatiblen Speicher mit AES-GCM verschlüsselt. Der Schlüssel verbleibt bei Ihnen; Anhänge werden anhand von schlüsselgebundenen Hashes benannt, nicht anhand ihres Inhalts-Hashes. - **Benachrichtigungen**Optional · standardmäßig deaktiviert Probleme und Änderungszähler mit Chat-Titeln. Nachrichtenauszüge werden nur gesendet, wenn Sie diese Funktion aktivieren. - **Zeitstempeldienst**Optional · standardmäßig deaktiviert Lediglich der SHA-256-Hash eines signierten Checkpoints und ein zufälliger Nonce. Keine Nachrichten, keine Chat-Namen. - **Zeuge**Optional · standardmäßig deaktiviert Ruft signierte Checkpoints und Erfassungszähler mit einem schreibgeschützten Token ab. Es kann weder Unterhaltungen lesen noch Einstellungen ändern. Standard: Nur die Telegram-Verbindung verlässt diesen Rechner. Optionale Speicherorte werden pro Arbeitsbereich konfiguriert. ## Was jedes Geheimnis enthüllt | Geheim | Wo es aufbewahrt wird | Was es ermöglicht | Falls es bekannt wird | | --- | --- | --- | --- | | **Panel-Token** | `panel-token.txt` im Datenverzeichnis; der Browser behält es pro Tab | Alles in jedem Arbeitsbereich | TgWitness stoppen, `panel-token.txt` löschen, neu starten: Sie bekommen ein neues | | **Telegram-Sitzung** | Vault, verschlüsselt (`credentials.enc`) | Der Telegram-Account selbst | Beenden Sie die Sitzung in Telegram unter *„Einstellungen“ → „Geräte“* | | **Signaturschlüssel** | Vault, verschlüsselt (`signing.enc`) | Einträge unter Ihrem Fingerabdruck signieren | Anderswo aufbewahrte Prüfpunkte, ein Zeuge und Zeitstempel zeigen weiterhin, was vorher existierte | | **Tresorschlüssel** | `vault.key` neben den Daten oder ein externer Hauptschlüssel | Den Tresor | Gehen Sie davon aus, dass Sitzung und Signaturschlüssel ebenfalls geleakt sind | | **Witness-Token** | Auf dem Witness-Host | Nur lesen: Prüfpunkte und Zustand | Auf der Zeugen-Seite löschen, ein neues erstellen | | **Schlüsseltext für externe Seiten** | Vault; einmal herunterladen, um Daten wiederherzustellen | Die externe Kopie | Wer auch den Bucket hat, kann sie entschlüsseln: betrachten Sie die Kopie als offengelegt | ## Was die Schutzmaßnahmen abdecken ### Abgedeckt - Ein geänderter, entfernter oder umsortierter Eintrag: Die Hash-Kette oder eine Signatur bricht. - Ein Journal, das gekürzt oder neu aufgebaut wurde, nachdem Sie einen Prüfpunkt anderswo gespeichert haben: Der Prüfpunkt passt nicht mehr. - Das Token erraten: 256 Zufallsbits, Vergleich in konstanter Zeit, 15 Fehlversuche pro Minute und die Adresse wird gesperrt. - Feindselige Chat-Inhalte: Text bleibt Text, nie HTML; Anhänge werden als Dateien heruntergeladen; das Panel lädt nichts von anderen Seiten. - Ein gestohlenes Datenverzeichnis bei externem Tresorschlüssel: Sitzungen und Schlüssel bleiben verschlüsselt. ### Ich überlasse es Ihnen - Das Haupttoken kann alles. Geben Sie anderen begrenzten Zugriff und behalten Sie das Haupttoken für sich. - Bewahren Sie Fingerabdruck und Prüfpunkte anderswo auf. - Verschlüsseln Sie die Festplatte, schränken Sie die Rechte ein. - Einfaches HTTP außerhalb von localhost gibt das Token preis. Nutzen Sie HTTPS oder einen SSH-Tunnel. - Prüfen Sie die Abdeckung auf Lücken und testen Sie die Zustellung auf Ihren eigenen Konten und Quellen. [Teilen Sie den Zugriff auf einen Fall](https://phishdestroy.io/tgwitness/de/docs/access/) mit Berechtigungen, Ablaufdatum und Sitzungslimits. ## Eine Installation absichern 0 von 8 fertiggestellt 1. **Nutzen Sie ein eigenes Telegram-Konto**, nie Ihr Hauptkonto. 2. **Lassen Sie das Panel auf 127.0.0.1.** Fernzugriff nur über HTTPS (mitgeliefertes Caddy) oder einen SSH-Tunnel. 3. **Verschlüsseln Sie die Festplatte** mit dem Datenverzeichnis. 4. **Beschränken Sie das Datenverzeichnis** auf das Dienstkonto (0700 unter Unix, Ordnerrechte unter Windows). 5. **Bewahren Sie den Tresorschlüssel anderswo auf** auf Servern: setzen Sie `TGWITNESS_VAULT_KEY_FILE` vor dem ersten Start. 6. **Speichern Sie Fingerabdruck und Prüfpunkte** auf einem anderen System, betreiben Sie einen Zeugen auf einem anderen Host. 7. **Laden Sie niemals** `data/`-, Sitzungs-, `panel-token.txt`- oder Tresorschlüssel auf GitHub oder in einen Chat **hoch**. 8. `Authorization`-Header oder Request-Bodies **dürfen** an einem Reverse-Proxy **nicht protokolliert werden**. **Kann ich das Panel-Token ändern, ohne Daten zu verlieren?** Ja, es öffnet nur das Panel. TgWitness stoppen, `panel-token.txt` löschen, neu starten. Journal, Sitzungen und Schlüssel bleiben. Ist `TGWITNESS_TOKEN` gesetzt, hat dieser Wert Vorrang vor der Datei. ## Eine Sicherheitslücke melden **Security → Report a vulnerability** auf GitHub. Version, Auswirkung und ein minimales Beispiel mit erfundenen Daten. Schicken Sie nie Zugangsdaten, Kontoordner oder echte Beweise. Ist die private Meldung aus, eröffnen Sie ein Issue und bitten Sie um einen privaten Kanal, ohne Exploit-Details. --- # Telegram · Einen Witness-Bot einrichten Canonical page: https://phishdestroy.io/tgwitness/de/docs/witness/ Veröffentlichen Sie signierte Protokoll-Checkpoints in Ihrem Telegram-Kanal mit einem separaten Zeugen, einem eigenen Schlüssel und einem schreibgeschützten Zugriff für den Collector. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Ein separater Prozess prüft Ihr Journal und veröffentlicht signierte Prüfpunkte in einem Kanal. ## Zwei Hosts, zwei Signaturschlüssel HOST A / COLLECTOR**Konto + Protokoll** Signaturschlüssel des Telegram-Session-Collectors Endpunkt für schreibgeschützte Checkpoints ← Signierte Antwort anfordern → HOST B / WITNESS**Überprüfen + aufbewahren** Festgelegter Fingerabdruck des Erfassers; separater Signaturschlüssel des Zeugen Eigenes Protokoll + Bot-Token Witness → Telegram-Bot-API →**Ihr Kanal · signierte TGW1-Beiträge** Der „Witness“ führt die Überprüfungen selbst durch. Der Zugriff des „Collectors“ ist schreibgeschützt. Die Veröffentlichung durch den Bot erfolgt über die Verbindung und das Token des „Witness“; dem „Witness“ wird keine Kontositzung zugewiesen. 03 / CHECKPOINT-ENTSCHEIDUNGENBeispielantworten ZULETZT AKZEPTIERT**120 Einträge**`head 9c7d…` NÄCHSTE ANTWORT**128 Einträge**`head a4f2…` Akzeptiert: Die Zählung steigt, die Signatur wird verifiziert und der Schlüssel stimmt überein. Der Witness behält diese neue Grenze bei. Alle Antwortbeispiele setzen eine gültige Signatur und den festgesteckten Schlüssel voraus. Die hier angegebenen Hashes dienen lediglich der Veranschaulichung. Um zu bestätigen, dass das gesamte alte Präfix unverändert ist, vergleichen Sie einen Export mit aufbewahrten Checkpoints. ## Bereiten Sie einen Bot und einen Kanal vor Erstellen Sie einen Bot mit BotFather und lassen Sie ihn in Ihrem Kanal posten. Betreiben Sie den Zeugen woanders: ein anderer Host, idealerweise von jemand anderem betrieben, ist viel mehr wert als ein zweiter Prozess neben dem Collector. ## Drei Schritte unter „Extras“ 1. **Nur-Lese-Zugriff.** **Extras → Unabhängiger Zeuge**, Token erstellen, Datei speichern. Es liest Prüfpunkte und Zustand, sonst nichts. 2. **Kanal und Intervall.** Telegram-Kanal oder Discord-Webhook, dazu eine Collector-Adresse, die der Zeuge erreicht. Einstellungsdatei speichern. 3. **Starten.** Legen Sie `witness.json`, `witness-token.txt` und `bot-token.txt` zusammen auf den Zeugen-Host und führen Sie aus: ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json ``` Warten Sie auf den ersten signierten Beitrag im Kanal und speichern Sie dann den Fingerabdruck des Zeugen an einem sicheren Ort. Lieber Discord? Speichern Sie die Webhook-URL als `discord-webhook.txt`. Ein Zeuge postet an einen Ort; lange Prüfungen kommen auf Discord als Datei. ## Wählen Sie aus, wie oft Sie Beiträge veröffentlichen möchten Jede Prüfung zu posten ergibt eine stetige externe Aufzeichnung: alle fünf Minuten sind das etwa 288 Beiträge pro Tag und Arbeitsbereich. Erweiterte Einstellungen können nur bei Änderungen oder Problemen posten, einen Proxy oder eine eigene Bot API nutzen. **Was bestätigt der Bot tatsächlich?** Er fragt den Collector nach einem signierten Prüfpunkt, prüft ihn gegen den erwarteten Schlüssel und führt ein eigenes signiertes Journal, einschließlich verpasster und abgelehnter Antworten. Er prüft den Journalzustand, beobachtet Telegram aber nicht selbst. Dafür machen Sie einen kontrollierten Zustelltest. ## Überprüfen Sie die Beweise später Bewahren Sie das Zeugen-Journal, die Beiträge und die Fingerabdrücke auf. [So prüfen Sie sie](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#verify) gegen den Export des Collectors. --- # Warum Zero Trust: Taylor Wessing, Dr. Zurheide, Dr. Schelinski Canonical page: https://phishdestroy.io/tgwitness/de/docs/signed-export/ Eine Zero-Trust-Fallstudie: eine von Dr. Patrick Zurheide und Dr. Tobias Schelinski von Taylor Wessing unterzeichnete DSGVO-Antwort, die anhand der eigenen Akte überprüft wurde, sowie das überprüfbare Modell, das keinen Raum für Täuschung oder Zweifel gelassen hätte. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) **Laufender Fall**Echte Dokumente · echte Signaturen · Hashwerte unten veröffentlicht · Zählungen offline reproduzierbar Eine Fallstudie dazu, warum Zero Trust notwendig ist. Ein Antrag auf Auskunft über die eigenen Daten nach Art. 15 DSGVO, beantwortet von Partnern einer führenden internationalen Anwaltskanzlei unter qualifizierten elektronischen Signaturen. Jede Zusicherung in der Antwort musste man einfach glauben: die Signatur, die Titel, „ein Monat manueller Prüfung“, der Schutz Dritter, „jedes Gericht wird zustimmen“. Gegen die übermittelte Datei geprüft, hält keine davon stand. Diese Seite zeigt, wozu das Vertrauen geführt hat und wie ein überprüfbares Modell keinen Raum für Täuschung oder Zweifel gelassen hätte. 15. August 2025 · Schreiben[Dr. Tobias Schelinski](https://www.taylorwessing.com/en/people/germany/hamburg/dr-tobias-schelinski)Partner bei Taylor Wessing · Fachanwalt für IT-Recht 1. Oktober 2025 · Schreiben und Anlage 1[Dr. Patrick Zurheide, LL.M.](https://www.taylorwessing.com/de/people/germany/hamburg/patrick-vincent-zurheide)Salary Partner, Taylor Wessing, seit 2025 · IT, Datenschutz und Rechtsstreitigkeiten im Technologiebereich Die beruflichen Funktionen wurden den verlinkten Profilen der Kanzlei entnommen. Auf dieser Seite wird nicht darauf eingegangen, ob die Sperrung des Steam-Kontos gerechtfertigt war. Es wird dargestellt, was die übermittelte Datei enthält und was in den unterzeichneten Schreiben dazu steht. Jede Angabe lässt sich anhand der Dateien überprüfen. **830 Seiten**in der Anlage zum zweiten Schreiben **36 Sekunden**von der Erstellung bis zur letzten Änderung dieser Anlage **905.672 Zeichen, die** unter den schwarzen Rechtecken lesbar sind **2 Signaturen**in beiden Schreiben erklärt, je eine **Kurz gesagt:** Eine Signatur gibt Auskunft darüber, wer eine Datei gesendet hat. Sie sagt jedoch nichts darüber aus, ob die Datei vollständig, richtig oder wahr ist. Das können nur Byte-Prüfungen feststellen, und diese kann jeder durchführen. ## Zero Trust: Überprüfen Sie die Datei, nicht den Absender „Zero Trust“ bedeutet, dass niemandem blind vertraut werden darf: weder einer Kanzlei, noch einem Titel, noch einer Signatur – und auch nicht uns. Eine Antwort auf ein Auskunftsersuchen muss sich selbst belegen. Sie muss drei Fragen beantworten, und eine Signatur beantwortet keine davon. **Ist die Kopie vollständig?**Hat der Antragsteller alles, was ihm zusteht, und wurde jede Auslassung erfasst und begründet? **Ist die Kopie unverändert?**Entspricht jeder Datensatz dem ursprünglich gespeicherten Wert, und würden spätere Änderungen sichtbar sein? **Wer hat entschieden, was verborgen bleibt?**Wurde die Einbehaltung von einer entscheidungsbefugten Person beschlossen, und kann dies im Nachhinein von jemandem überprüft werden? Die meisten Rechtsstreitigkeiten in der EU bleiben unter Verschluss: Vergleiche unter Geheimhaltungsvereinbarungen, versiegelte Akten, Entscheidungen, die niemals veröffentlicht werden. Dagegen haben wir nichts einzuwenden. Dieser Fall ist anders, und das liegt wahrscheinlich nicht daran, dass das, was darin passiert ist, selten vorkommt. Es gibt keine Geheimhaltungsvereinbarung und kein Gerichtsurteil, sodass man ihn von Anfang bis Ende nachlesen kann: ein sehr einfaches Gesetz, die DSGVO; eine Anfrage nach den eigenen Daten einer Person; was tatsächlich geliefert wurde; und schwarze Rechtecke, die jeder entfernen kann. Das Besondere daran ist, wer geantwortet hat und wie. Dr. Tobias Schelinski und Dr. Patrick Zurheide sind Partner bei Taylor Wessing, nach eigenen Worten [„a European legal services powerhouse“](https://www.businesswire.com/news/home/20251217415857/en/Taylor-Wessing-Diversifies-Its-International-Strategy). Beide sind promoviert; der eine ist Fachanwalt für IT-Recht, der andere hat einen Master of Laws aus Aberdeen. Sie brauchten 106 Tage, um einen rechtmäßigen Auskunftsantrag nicht zu bearbeiten. Dabei übermittelten sie dem gemeldeten Kontoinhaber die Beschwerdetexte und Logins von mehr als 1.800 anderen Personen – darunter möglicherweise auch Minderjährige – unter schwarzen Rechtecken, die jeder entfernen kann. **Die Einschätzung von PhishDestroy.** Ein Login, also der Benutzername, ist eine hochgradig personenbezogene Angabe. Er wird dienstübergreifend wiederverwendet, und ein Konto, das seit Jahren besteht, ist in den meisten Fällen mit einer realen Person verknüpft, die dadurch identifiziert werden kann. Betrachtet man nur die fünfzig sichtbaren Fragmente, so könnte unserer Meinung nach tatsächlich jedes Gericht in die Irre geführt werden. Betrachtet man jedoch das Gesamtbild, so machen die Zeitachse und die Berechnungen auf dieser Seite deutlich, dass der DSGVO-Antrag nicht bearbeitet wurde. Weder eine Signatur noch ein falsch geschriebener Name ändert etwas an dieser Tatsache. ## Was das Vertrauen bewirkt hat und was das Modell getan hätte Jede Zusicherung der Antwort wird im Folgenden der übermittelten Datei und dem auf dieser Seite vorgeschlagenen überprüfbaren Modell gegenübergestellt. Die Belege für jede Zeile folgen weiter unten. **Die Signatur** „Dieses Schreiben ist qualifiziert elektronisch signiert“ Sie zeigt, wer die Schreiben versandt hat. Darunter bleiben 905.672 Zeichen unter schwarzen Rechtecken lesbar. [Belege](https://phishdestroy.io/tgwitness/de/docs/signed-export/#signature) Die Kanzlei signiert einen gesalzenen Hash jedes zurückgehaltenen Feldes. Geprüft wird der Inhalt, nicht der Absender. **Die Auswahl** Die Anwälte entscheiden, was der Antragsteller lesen darf. 50 Beschwerden blieben lesbar, alle nach der Sperrung und dem Antrag eingereicht; 43 davon lauten “Suspected Hijacker”. 1.944 wurden überdeckt. [Belege](https://phishdestroy.io/tgwitness/de/docs/signed-export/#convenient) Eine Regel, die bei der Anfertigung der Kopie festgelegt und unterzeichnet wird, wobei jeder zurückgehaltene Datensatz gezählt und die Entscheidung von der zuständigen Behörde überprüft wird. **„Ein Monat manueller Prüfung“** „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ Eine 830-seitige Datei, erstellt in 36 Sekunden. Ihre erste lesbare Zeile ist eine homophobe Beleidigung, und den lesbar gelassenen Beschwerden widerspricht dieselbe Datei. [Belege](https://phishdestroy.io/tgwitness/de/docs/signed-export/#refuted) Niemandes Aussage über den Aufwand zählt. Die Datei spricht für sich selbst, und jeder kann darin einen Widerspruch finden. **Rechte Dritter** „soweit keine Rechte Dritter entgegenstehen“ Die Logins und Beschwerdetexte von mehr als 1.800 anderen Personen, übermittelt unter schwarzen Rechtecken, die jeder entfernen kann. [Belege](https://phishdestroy.io/tgwitness/de/docs/signed-export/#under) Die Daten anderer Personen gelangen niemals in die Kopie des Antragstellers. Sie werden verschlüsselt übertragen und können nur mit dem Schlüssel der Behörde entschlüsselt werden. **Die Kopie der Daten** „Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ Zahlungen, Support-Tickets und die Unterlagen zur Sperrung fehlen. Nur die Beschwerden scheinen vollständig zu sein. [Belege](https://phishdestroy.io/tgwitness/de/docs/signed-export/#inventory) Das signierte Manifest listet auf, was enthalten ist, und zählt, was fehlt. Keine Lücke bleibt unbemerkt. **„Jedes Gericht“** „Aus unserer Erfahrung wird jedes Gericht …“ Fünfzig Fragmente können in die Irre führen. Die gesamte Datei zeigt einen Antrag, der nicht bearbeitet wurde. [Belege](https://phishdestroy.io/tgwitness/de/docs/signed-export/#authority) Das Gericht oder die Aufsichtsbehörde öffnet das vollständige Original und vergleicht jedes Feld mit dem, was die Kanzlei unterzeichnet hat. **Jede Zeile hat denselben Aufbau.** Eine Zusicherung, die man glauben musste, eine Datei, die ihr widerspricht, und eine Überprüfung, die diese Zusicherung überflüssig gemacht hätte. Bei diesem Modell gibt es nichts, womit man täuschen könnte, und nichts, woran man zweifeln könnte: Der Antragsteller sieht, was ihm zusteht, die Behörde sieht den Rest, und jedes Feld ist an das gebunden, was die Kanzlei unterzeichnet hat. [Zum Modell](https://phishdestroy.io/tgwitness/de/docs/signed-export/#sealed) ## Die Belege, Punkt für Punkt Jede Zeile des obigen Vergleichs stützt sich auf die folgenden Dateien: zwei signierte Schreiben und Anlage 1. Die Seitenangaben folgen der Seitenreihenfolge im PDF, und jede Zahl lässt sich offline nachprüfen. ### Der Text blieb unter den schwarzen Rechtecken erhalten. So sieht die Antwort auf einen einfachen Auskunftsantrag aus, wenn sie von der Spitze des Berufsstands kommt. Unter den schwarzen Rechtecken blieb der Text in der Datei erhalten. Dadurch ließen sich beide Gruppen lesen und vergleichen: die 50 sichtbar gelassenen Beschreibungen und die 1.944 überdeckten. DAS SCHREIBENDIE ÜBERMITTELTE DATEI „Unabhängig von den Einzelheiten der Beschwerden“ Schon allein diese Zahl soll auf wiederholte Verstöße gegen die Steam-Vereinbarung hindeuten. Dr. Schelinski · 15. August 2025 · S. 2 „Unabhängig von den Einzelheiten der Beschwerden …“ **50**Beschreibungen sichtbar gelassen **August–September 2025** **1.944**Beschreibungen überdeckt **Februar 2021–Juli 2025** 43 der 50 sichtbaren Beschreibungen tragen die Kategorie “Suspected Hijacker”. Von den 1.944 überdeckten Beschreibungen tragen 269 diese Kategorie. Anlage 1, S. 444–620. Ein weiterer Datensatz weist eine leere Beschreibung auf: 50 + 1.944 + 1 = 1.995 Zeilen in der bereitgestellten Tabelle. ### Fünfzig Beschwerden, die den Anwälten gelegen kommen Das Schreiben vom Oktober nennt den Grund für die Sperrung: Das Konto wurde gesperrt als „Used for Hijacking“ (Dr. Zurheide, S. 8). Von den fünfzig Beschwerden, die der Antragsteller lesen durfte, sagen 43 dasselbe: “Suspected Hijacker”. Alle fünfzig wurden Monate nach der dauerhaften Sperrung des Kontos eingereicht, nach dem Auskunftsantrag und nach der letzten Anmeldung, die dieselbe Datei verzeichnet. Anlage 1 nennt auf Seite 1 `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)`. Das Konto wurde am 7. Mai 2025 gesperrt. Am 9. Mai 2025 beantwortete der Steam-Support das erste Ticket: Die Sperrung sei kein Fehler, sie sei dauerhaft, und das Ticket wurde geschlossen. Der Auskunftsantrag folgte am 17. Juni. Nach den Schreiben selbst war das Konto zu diesem Zeitpunkt bereits bei einem Dritten: Dr. Schelinski schreibt, es sei nach dem 3. Mai 2025 von einem Dritten erworben worden (S. 2), Dr. Zurheide, ein Dritter habe nach dem 3. Mai darüber Zahlungen getätigt, zuletzt am 30. Juli 2025 (S. 1–2). Die übermittelte Beschwerdetabelle verzeichnet sodann: **53**August 2024 **54**Sep. **70**Okt. **79**Nov. **82**Dez. **92**Januar 2025 **32**Feb. **35**März **20**Apr. **12**Mai*gesperrt am 7. Mai , letzte Anmeldung am 23. Mai* **1**Juni **7**Juli **47**Aug. **3**Sep. Beschwerdetext unter einem schwarzen RechteckDer Text der Beschwerde bleibt lesbar Beschwerden pro Monat in Anlage 1, August 2024 bis September 2025, gezählt anhand der Textebene der Datei; die vollständige Historie finden Sie unter [Überprüfen Sie es selbst](https://phishdestroy.io/tgwitness/de/docs/signed-export/#verify). Nach der Sperrung am 7. Mai und der letzten Anmeldung am 23. Mai: eine Beschwerde im Juni, sieben im Juli, dann 47 im August. 1. 3. Mai 2025**Ab diesem Datum, gemäß den Schreiben: ein Dritter**Das Konto sei „von einem Dritten erworben“ worden: Dr. Schelinski, S. 2 · „Zahlungen durch einen Dritten“: Dr. Zurheide, S. 1 2. 7. Mai 2025**Konto gesperrt**Steam 3. 9. Mai 2025**Kein Fehler, dauerhaft; Ticket geschlossen**Steam-Support, erstes Ticket 4. 23. Mai 2025**Letzte Anmeldung**Anlage 1, S. 1 5. 17. Juni 2025**Auskunftsantrag**Dr. Zurheide, S. 1 6. 29. Juli 2025**Die Frist beginnt, „wenn überhaupt“**Dr. Schelinski, S. 1 7. 30. Juli 2025**Letzte „Zahlung durch einen Dritten“; erst ab hier werden Daten dem Antragsteller zugeordnet**Dr. Zurheide, S. 2 8. August 2025**47 Beschwerden, alle lesbar**Anlage 1, S. 444–448 9. 15. August 2025**Kündigung: 1.938 Beschwerden, „unabhängig von den Einzelheiten“**Dr. Schelinski, S. 2 10. September 2025**3 Beschwerden, lesbar**Anlage 1, S. 444 11. 29. September 2025**„Date of Report“**Anlage 1, S. 1 12. 1. Oktober 2025**Die Antwort: „die volle Monatsfrist“, Daten „manuell“ bereinigt**Dr. Zurheide, S. 1 Dr. Zurheide schreibt, die volle Monatsfrist habe ausgeschöpft und die Daten hätten manuell bereinigt werden müssen: „musste leider die volle Monatsfrist ausgeschöpft werden … manuell die Daten bereinigt werden mussten“ (S. 1). Drei der lesbaren Beschwerden sind auf September 2025 datiert, der Bericht selbst auf den 29. September. Sie gingen in den letzten Wochen vor der Antwort ein, während die Daten nach seinen Angaben bereinigt wurden. > “This account just started acting shady overnight” > > Suspected Hijacker · August 2025 · S. 446 > “Suddenly messaging people weird links probably stolen” > > Suspected Hijacker · August 2025 · S. 448 > “Friend warned me to report this one” > > Suspected Hijacker · August 2025 · S. 446 > “Everyone in voice chat agrees it's a stolen account” > > Suspected Hijacker · August 2025 · S. 446 #### Dieselbe Datei widerspricht ihnen Einige der fünfzig enthalten Behauptungen, die sich anhand von Anlage 1 selbst prüfen lassen. Die Datei verzeichnet die Anmeldungen des Kontos und seine Security History. Beides ist enthalten; die Security History liegt unter einem schwarzen Rechteck. Lesbar gelassen · Suspected Hijacker · August 2025 · S. 446 > “My friend can't log in, says someone changed the password” Security History · S. 830 · unter einem schwarzen Rechteck**Letzte Passwortänderung: Juli 2024** Nicht vom Inhaber vorgenommen, wie dieselbe Datei zeigt. 2025 gibt es keine Passwortänderung. Lesbar gelassen · Aug. 2025 · S. 446, 448 > “This account just started acting shady overnight” > “Suddenly messaging people weird links probably stolen” Anmeldeverlauf · S. 1–119**Letzte Anmeldung: 23. Mai 2025** Der Anmeldeverlauf endet im Mai 2025. Im Juni, Juli, August und September wurde keine einzige Anmeldung verzeichnet. Das Konto war seit dem 7. Mai 2025 gesperrt; am 9. Mai erklärte der Steam-Support die Sperre für dauerhaft. Lesbar gelassen · Aug. 2025 · S. 445, 448 > “Real person probably got locked out” > “My friend said they can't get into this account anymore” Security History · S. 830**Keine sicherheitsrelevante Änderung im Jahr 2025** Die letzte Änderung, die im Sicherheitsprotokoll vermerkt ist, ist die Passwortzurücksetzung vom Juli 2024. **Die Lesart von PhishDestroy.** Die Beleidigung auf Seite 444 musste übersetzt werden. Diese Beschwerden sind auf Englisch verfasst, und die Antwort darauf befindet sich in derselben Datei. Ein Monat manueller Prüfung ließ sie lesbar und legte über die Zeile, die ihnen widerspricht, ein Rechteck. #### Wie sich die fünfzig lesen Die Formatierung beweist nicht, wer eine Beschwerde verfasst hat. Sie ist aber genau das, worauf ein Gericht achten würde, bevor es eine Beschwerde mitzählt. | Prüfpunkt | Lesbar gelassen · 50 | Überdeckt · 1.944 | | --- | --- | --- | | Zeitraum | August–September 2025 | Februar 2021–Juli 2025 | | “Suspected Hijacker” Kategorie | **86 % 43** von 50 | **13,**8 % (269 von 1.944) | | Die Beschreibung enthält kyrillische Zeichen | **4 % 2** von 50 | **55,4 %** 1.077 von 1.944 | | Login der meldenden Person: lateinische Buchstaben + 3–5 Ziffern | **62 % 31** von 50 | **21,**6 % (420 von 1.944) | Kyrillisch: mindestens ein Zeichen dieser Schrift. Login-Muster: lateinische Buchstaben, gefolgt von 3–5 Ziffern, sonst nichts. Alle 1.995 Logins der Meldenden, auch die neben den 50 sichtbaren Texten, sind überdeckt und weiterhin extrahierbar. Kein Login wird hier wiedergegeben. Vier lesbare Texte wiederholen sich Wort für Wort in neun Datensätzen; “Acting way off pretty sure someone else is using it” kommt dreimal vor (S. 446, 447). Dr. Schelinski · 15. August 2025 · S. 2 > „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ Sinngemäß: Allein die Zahl der Beschwerden soll die Verstöße belegen, unabhängig von ihrem Inhalt. **Ist der Inhalt für ein Gericht wirklich irrelevant?** Dr. Zurheide · 1. Oktober 2025 · S. 9 > „Aus unserer Erfahrung wird jedes Gericht die Sperrung … als rechtmäßig qualifizieren.“ Sinngemäß: Jedes Gericht werde die Sperrung für rechtmäßig halten, gestützt auf „unsere Erfahrung“. **Umfasst seine Erfahrung jedes Gericht? Und würde jedes Gericht zustimmen, bei Daten, die so verarbeitet wurden?** Die beiden Fragen stammen von PhishDestroy. Wir geben keine Stellungnahme dazu ab, wie ein Gericht über die Sperre entscheiden sollte. Wir sagen lediglich, dass ein Gericht in der Lage sein sollte, das zu lesen, was es zählen soll. ### Was die schwarzen Rechtecke dem Blick entziehen In den beiden Schreiben werden dieselben Beschwerden auf unterschiedliche Weise behandelt. Dr. Schelinski hat sie alle gegen den Antragsteller gewertet, „1.938 Mal“, unabhängig von deren Einzelheiten (15. August 2025, S. 2). Dr. Zurheide zog daraufhin eine Grenze zum 30. Juli 2025: Erst ab diesem Datum „können wir … davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen“ (1. Oktober 2025, S. 2). Die schwarzen Rechtecke folgen dieser Linie: Jeder Beschwerdetext bis zum 23. Juli 2025, der letzten Beschwerde vor dieser Linie, ist überdeckt; jeder ab August ist lesbar. **Die Lesart von PhishDestroy.** Vor dem 30. Juli 2025 zählen die Beschwerden als Zahl gegen den Antragsteller und werden ihm als Daten vorenthalten, die nicht seine seien. Das Schreiben vom Oktober argumentiert selbst mit „zwischen 2019 und 2023“ (S. 7). Anlage 1 · Seite 444 · die erste lesbare Zeile Offensive AvatarSeptember 2025`p***r` Eine homophobe Beleidigung, die hier unkenntlich gemacht wurde. Es handelt sich um den ersten Eintrag, den der Antragsteller nach einem Monat manueller Überprüfung lesen konnte. #### Was sich unter den Rechtecken verbirgt 1.148 Beschwerden, mehr als die Hälfte der Tabelle, laufen unter “Offensive Profile”. Keine einzige blieb lesbar: Bei 1.147 ist der Text überdeckt, eine hat keinen Text. Unter den Rechtecken gelesen und ohne Logins wiedergegeben, kehren die überdeckten Beschreibungen immer wieder zu denselben Themen zurück: | Thema | Überdeckt | Lesbar | | --- | --- | --- | | Nazi, Nationalsozialismus | **110** | 0 | | Hass, Hassrede | **108** | 0 | | Rassismus | **99** | 0 | | Ukraine, Ukrainer | **90** | 0 | | Russophobie | **84** | 0 | | Beleidigung der Nation oder der Russen | **65** | 0 | | Propaganda | **64** | 0 | | Ethnische Beleidigung für Ukrainer | **50** | 0 | | Politik | **46** | 0 | 615 der 1.944 überdeckten Beschreibungen berühren mindestens eines dieser Themen; keine der fünfzig lesbaren tut dies. Auch lange Texte wiederholen sich: 18 Texte mit acht oder mehr Wörtern tauchen Wort für Wort in 48 Zeilen auf. Zwei davon jeweils viermal: > “I made this account to report this user because he has stolen my account” > > Überdeckt · 4 Zeilen > “I created this account in order to expose this user because he robbed my account.” > > Überdeckt · 4 Zeilen Einer der fünfzig lesbaren Texte (S. 448) ist eine eingefügte Steam-Profilseite, die andere Nutzer namentlich nennt. Er wird hier nicht wiedergegeben. Die Rechtecke überdeckten die Logins aller Meldenden und ließen diese Seite lesbar. ### Die Aussagen und die gelieferten Unterlagen Jede Aussage unten ist aus den signierten Schreiben zitiert. Jeder Beleg findet sich in den Dateien, die sie geliefert haben. Dr. Schelinski · S. 2 ### „Hunderte“ jedes Jahr „In jedem Jahr, bis ins Jahr 2025 hinein, gab es demnach hunderte Beschwerden.“ **2021: 25 · 2022: 122** Die jährlichen Zahlen sind in der beigefügten Tabelle aufgeführt. Die vollständigen monatlichen Zahlen finden Sie unter [Überprüfen Sie es selbst](https://phishdestroy.io/tgwitness/de/docs/signed-export/#verify). Dr. Zurheide · S. 1 ### Die volle Monatsfrist, manuell bereinigt „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ **36 Sekunden** Anlage 1 wurde um 19:58:05 erstellt und zuletzt um 19:58:41 geändert; sie umfasst 830 Seiten. Die erste lesbare Beschwerde darin ist eine homophobe Beleidigung. Dr. Schelinski · S. 3 ### Wahrung der Rechte Dritter „soweit keine Rechte Dritter entgegenstehen“ **905.672 Zeichen bleiben lesbar** Der Text ist unter den 1.044 schwarzen Rechtecken, die ihn überlappen, weiterhin lesbar. Die Rechtecke verdecken zudem die eigene Sicherheitshistorie des Kontos (S. 830). Dr. Zurheide · S. 7 ### „Zwischen 2019 und 2023“ „Über einen Zeitraum von mehreren Jahren, zwischen 2019 und 2023 …“ **Erstellt im August 2020** In Anlage 1, Seite 1, ist das Erstellungsdatum des Kontos angegeben: August 2020. Dr. Zurheide · S. 9 ### Jedes Gericht wird dem zustimmen „jedes Gericht … als rechtmäßig qualifizieren“ **Eine Prognose** In dem Satz heißt es, jedes Gericht werde die Sperrung des Steam-Kontos für rechtmäßig befinden. Es wird weder ein Gericht namentlich genannt noch ein Urteil angeführt. ### Was die Signatur zeigen kann – und was nicht Eine qualifizierte elektronische Signatur ist ein starker Nachweis für die Identität des Absenders. Sie ist kein Nachweis für den Inhalt. Diese beiden Aspekte müssen getrennt geprüft werden. ### Eine Signatur kann zeigen - wer das Dokument unterzeichnet hat - dass sich die signierten Bytes seit der Signierung nicht verändert haben ### Eine Signatur kann nicht zeigen - dass der Export vollständig ist - dass durch die Schwärzung etwas entfernt wurde - dass die darin enthaltenen Aussagen wahr sind - dass sie vor der Unterzeichnung überhaupt jemand gelesen hat DREI PRÜFUNGEN · DOK.-NR. 42603633 · ANLAGE 1Offline 01 · ABSENDER**Qualifizierte elektronische Signatur**`„qualifiziert elektronisch signiert“`Von der Kanzlei auf Seite 9 angegeben. 02 · INTEGRITÄT**SHA-256 von Anlage 1**`2bb927e2…4ff7d6af`Stimmt mit dem gespeicherten Hash überein. 03 · INHALT**Textebene von Anlage 1**`pdftotext Anlage1.pdf -`905.672 Zeichen, lesbar unter 1.044 Rechtecken. Absender: angegeben. Integrität: stimmt überein. Inhalt: fehlerhaft. Die Signatur beantwortete die erste Frage, aber keine der anderen. Für die Prüfungen 02 und 03 benötigen Sie lediglich die Datei und die Standardwerkzeuge. Bei Prüfung 01 erfahren Sie, wer die Datei gesendet hat. Nur bei den Prüfungen 02 und 03 erfahren Sie, was gesendet wurde. Dok.-Nr. 42603633 · Seite 1Eine Seite, zwei Schreibweisen `Dr. Patrick Zurheide, LL.M. (Aberdeen)`Unterzeichner `p.zurheode@*****wessing.com`Briefkopf `p.zurheide@*****wessing.com`Öffentliches Register Der Titel ist korrekt geschrieben. Der Name des Unterzeichners im Briefkopf hingegen nicht. Seite 6 enthält „Die Antwortet lautet ja, in den dort genannten Grenzen.“ zweimal, Wort für Wort, am Ende der Abschnitte 1.5 und 1.6. Seite 3 übersendet die Daten mit den Worten „Anbei übersenden wie Ihnen …“. ### Der Antrag, den der Export beantworten sollte Hinter den Signaturen steht ein einziger Antrag auf Auskunft über die eigenen Daten. Das Gesetz dazu ist kurz. VERORDNUNG (EU) 2016/679 · AMTLICHER TEXT Art. 15 Abs. 1 „Die betroffene Person hat das Recht, von dem Verantwortlichen eine Bestätigung darüber zu verlangen, ob sie betreffende personenbezogene Daten verarbeitet werden; ist dies der Fall, so hat sie ein Recht auf Auskunft über diese personenbezogenen Daten …“ Art. 15 Abs. 3 „Der Verantwortliche stellt eine Kopie der personenbezogenen Daten, die Gegenstand der Verarbeitung sind, zur Verfügung.“ Art. 12 Abs. 3 „… unverzüglich, in jedem Fall aber innerhalb eines Monats nach Eingang des Antrags zur Verfügung. Diese Frist kann um weitere zwei Monate verlängert werden, wenn dies … erforderlich ist.“ Quelle: [EUR-Lex](https://eur-lex.europa.eu/eli/reg/2016/679/oj) Die Schreiben kennen dieses Gesetz. Dr. Zurheides Schreiben beginnt damit: „nachfolgend erteilen wir Namens und in Vollmacht unserer Mandantin Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ (S. 1). Abgesehen von einem Verweis auf Rechte Dritter (Dr. Schelinski, S. 3) nennt keines der beiden Schreiben eine Vorschrift, die einem Verantwortlichen erlaubt, die Auskunft zu beschränken: weder Art. 12 Abs. 5 noch Art. 23 noch das BDSG. Was der Antrag stattdessen erhielt: 1. 15. August 2025 · Dr. Schelinski · S. 1**Die Frist, „wenn überhaupt“** „Die Frist nach Art. 15 DSGVO hat, wenn überhaupt, erst … am 29. Juli 2025 begonnen“ 2. 15. August 2025 · Dr. Schelinski · S. 2**Das Konto wird gekündigt** „Hiermit kündigen wir daher Namens und in Vollmacht der Valve Corporation … mit sofortiger Wirkung.“ 3. 15. August 2025 · Dr. Schelinski · S. 2**Beweis durch Zählung: 1.938 Beschwerden, unabhängig von deren Einzelheiten** „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ 4. 1. Oktober 2025 · Dr. Zurheide · S. 2**Daten erst ab dem 30. Juli 2025** „… können wir erst ab diesem Zeitpunkt davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen.“ 5. 1. Oktober 2025 · Dr. Zurheide · S. 8**Der Rest, unter einer Bedingung** „Gerne beauskunften wir die restlichen (bzw. noch weitere) personenbezogene Daten, sobald Ihr Mandant uns nachvollziehbar darstellen kann …“ 6. 1. Oktober 2025 · Dr. Zurheide · S. 8**„Komplizen“** „… dass Ihr Mandant bzw. dessen Komplizen seine Phishing-Angriffe … in verschleierter Form fortsetzen will“ 7. 1. Oktober 2025 · Dr. Zurheide · S. 9**Vier Straftatbestände** „… §§ 263, 263a, 202a, 303a StGB) einer strafrechtlichen Verfolgung zuzuführen.“ **Nichts davon ist eine Voraussetzung nach Art. 15.** Ein Auskunftsrecht entfällt nicht durch eine Kündigung, eine Prognose über Gerichte oder einen Straftatbestand. 106 Tage nach dem Antrag bestand es unverändert fort. **Die Lesart von PhishDestroy.** Die Doktoren zitieren das Gesetz auf Seite 1 und schreiben anschließend so, als gäbe es dieses Gesetz gar nicht. ### In dem Schreiben wird aufgeführt, welche Daten Valve verarbeitet. In der Datei wird der größte Teil davon ausgelassen. Auf den Seiten 2–6 zitiert das Schreiben vom Oktober die Steam-Datenschutzrichtlinie, um die von Valve verarbeiteten personenbezogenen Daten zu beschreiben. Jede darin genannte Kategorie wird im Folgenden mit Anlage 1 verglichen. Anlage 1 umfasst zwölf Abschnitte: Konto, Profil, Namensverlauf, Anmeldungen, Produktschlüssel, Spielzeit, Telefonnummer, Beschwerden, Chat, Steam-Guard-Geräte, Freunde und Sicherheitsänderungen. | Daten | Im Schreiben genannt | In Anlage 1 | | --- | --- | --- | | Transaktionen und Zahlungen | „Transaktions- und Zahlungsdaten“ · p. 2 „… Transaktionsdaten … für einen Zeitraum von bis zu zehn (10) Jahren aufbewahren muss“ · p. 6 | **Fehlt** | | Handel und Community-Markt | „… Konsistenz des Gameplays oder Steam-Community-Marktes …“ · p. 6 | **Fehlt** | | Erfolge, Spielfortschritt, Gegenstände im Spiel | „Ihre erspielten Errungenschaften … Ihren Spielfortschritt … Ihre im Spiel erhaltenen Gegenstände“ · p. 4 | **Fehlt** | | Besitz von Spielen | „… mindestens Ihr Eigentum am fraglichen Spiel“ · p. 4 | **Fehlt** · nur Spielzeit und 100 Produktschlüssel-Aktivierungen von einem einzigen Tag | | Level, Abzeichen, Sammelkarten | „Daten über die Nutzung des Steam-Clients und der Steam-Websites“ · p. 3 · items and market · pp. 4, 6 | **Fehlt** | | Beiträge, Kommentare, Follower | „… veröffentlichen, kommentieren oder denen Benutzer folgen“ · p. 3 „Message Boards, Foren und/oder Chatbereiche“ · p. 5 | **Fehlt** | | Chat | „Informationen, die Benutzer im Chat gesendet haben“ · p. 3 | 2 Einträge, überdeckt | | Support-Tickets | „… wenn Benutzer Informationen oder Support von Valve anfordern“ · p. 3 | **Fehlt** · auch das Ticket vom Mai 2025, das die Sperrung bestätigte | | Verbundene Konten von Drittanbietern | „… mit dem Konto eines Drittanbieters zu verknüpfen“ · p. 5 | **Fehlt** | | Unterlagen zur Sperrung | „Zum Entdecken von Verstößen erforderliche Informationen“ · p. 3 „… nach einer manuellen Prüfung durch einen Mitarbeiter der Valve Corporation“ · p. 7 | **Fehlt** · kein Prüfvermerk, keine Geräteverknüpfung, keine Phishing-Meldung | **Das Schreiben beschreibt die Daten. Die Anlage enthält sie nicht.** Die Zahlungen sind die Grundlage für die Schlüsse beider Anwälte zur Inhaberschaft, doch gerade die Zahlungskategorie fehlt in der Datei. #### Was die Datei enthält und für welchen Zeitraum Die Zeiträume werden aus den Datumsangaben in der Datei entnommen, einschließlich der Datumsangaben unter den schwarzen Rechtecken. | Abschnitt | In Anlage 1 | Zeitraum in der Datei | | --- | --- | --- | | Grundlegende Kontodaten · E-Mail-Adresse, Land, Benutzername, Steam-ID | Lesbar | Aktueller Stand | | Anmeldungen | Datum und Typ lesbar; Uhrzeit, IP-Adresse und Hardware-ID verdeckt | Okt. 2023 – Mai 2025 · Das Konto besteht seit Aug. 2020 | | Spielzeit | Spiele lesbar; Datum und Uhrzeit der letzten Nutzung verdeckt | Dezember 2020 – Mai 2025 | | Chat | 2 Einträge, überdeckt | Nur im September 2025 | | Beschwerden bezüglich des Kontos | 1.995 Zeilen · 50 lesbare Beschreibungen | Februar 2021 – September 2025 | | Freunde und Blockierungen | 5.789 Zeilen · überdeckt | Februar 2021 – September 2025 | | Steam Guard-Geräte · registriertes Telefon · Sicherheitsänderungen | Überdeckt | Sicherheitsprotokoll: Aug. 2020 – Juli 2024 · 4 Zeilen | | Aktivierung von Produktschlüsseln | Schlüssel überdeckt | 100 Zeilen, ein Datum: 13. März 2025 | **Nur die Beschwerden scheinen vollständig enthalten zu sein.** Sonst fast nichts: Die Anmeldungen beginnen im Oktober 2023, die Freunde im Februar 2021, die Produktschlüssel an einem einzigen Tag, und ganze Kategorien, die Valve speichert, fehlen. Die Kategorien, von denen die Entscheidungen des Schreibens abhängen, Zahlungen und die Unterlagen zur Sperrung, sind gar nicht in der Datei. Die Freundesliste hat 5.789 Zeilen: 4.410 „Blocked User“, 1.182 „Friend“ und 200 „Inviter“, datiert vom 24. Februar 2021 bis zum 28. September 2025; 74 sind nach der letzten Anmeldung datiert. Ob es die aktuelle Kontaktliste oder ein vollständiger Verlauf einschließlich entfernter Einträge ist, lässt sich der Datei nicht entnehmen. Die Antwort zu Art. 15 Abs. 1 wirft drei weitere Fragen auf. Die Empfänger (Buchstabe c) und die Quelle der Daten (Buchstabe g) werden lediglich als allgemeiner Text aus den Datenschutzbestimmungen angegeben, nicht speziell für dieses Konto. Die Speicherdauer (Buchstabe d) ist ein Zitat aus den Datenschutzbestimmungen ohne konkrete Angaben. Und in dem Schreiben werden die Daten übermittelt „als Anlage 1 und 2“ (S. 3); hier wird lediglich Anlage 1 behandelt. ### Valve hatte bereits überprüft, wem das Konto gehört Das Konto wurde als Steamworks-Partner registriert, um ein Spiel zu veröffentlichen. Dieser Vorgang umfasst eine Steam-Direct-Gebühr in Höhe von 100 US-Dollar, eine steuerliche Befragung, die Angabe von Bankdaten für Auszahlungen sowie eine von Valve selbst durchgeführte Identitätsprüfung. All dies sind personenbezogene Daten, die Valve verarbeitet. Art. 15 DSGVO gilt für alle Kategorien verarbeiteter personenbezogener Daten, nicht nur für diejenigen, die in einer Datenschutzerklärung aufgeführt sind. Nichts davon ist in Anlage 1 aufgeführt. Dr. Schelinski · S. 1 ### „Kein einziger Beleg für die Inhaberschaft“ „… kein einziger Beleg für die Inhaberschaft (Verfügungsbefugnis) Ihres Mandanten für den Account …“ **Identität durch Valve geprüft** Die Partnerprüfung, ihre Unterlagen und die Zahlung von 100 US-Dollar liegen bei der Mandantin, in deren Namen das Schreiben verfasst ist. Dr. Schelinski · S. 3 ### Vom Antragsteller zu erbringender Nachweis „… gefälschten ‚Utility Bill‘ …“ · „… tatsächlich alleiniger Inhaber des Accounts …“ **Dem Antragsteller wurde der Nachweis vorenthalten** Der Antragsteller soll seine Inhaberschaft nachweisen, während die von Valve selbst geprüften Nachweise in seiner Auskunftskopie fehlen. ## Das Modell: Niemand entscheidet allein, nichts lässt sich austauschen Hier geht es nicht um eine bestimmte Software. Es geht darum, wer entscheidet. In diesem Fall haben zwei Anwälte entschieden, welche fünfzig Beschwerden von Bedeutung waren und welche nicht. Kein Gericht, keine Aufsichtsbehörde. Manches muss verborgen bleiben: Die Logins der Meldenden sind Daten anderer Personen. Die Frage ist, wer entscheidet und ob jemand die Entscheidung nachträglich prüfen kann. Ein schwarzes Rechteck beantwortet keine der beiden Fragen, und jeder kann es entfernen. Zwei Standardwerkzeuge beantworten beide: ein gesalzener Hash in der Kopie des Antragstellers und das Original, versiegelt für den öffentlichen Schlüssel einer Aufsichtsbehörde oder eines Gerichts. GESALZENES COMMITMENT · EINES JE ZURÜCKGEHALTENEM FELD c = SHA-256(salt ‖ value) Das Salt besteht aus 16 Zufallsbytes, für jedes Feld neu. Die Kopie des Antragstellers enthält `c` anstelle des Werts, unter der Signatur der Kanzlei. Wert und Salt reisen in einem Umschlag, verschlüsselt für den öffentlichen Schlüssel der Behörde, mit OpenPGP oder mit X25519 und AES-GCM. Ohne den privaten Schlüssel der Behörde kann ihn niemand öffnen, und die Kanzlei kann keinen Wert austauschen, ohne das signierte Commitment zu brechen. 1. Schritt 1 · Der Antragsteller**Überreicht die Kopie und den Umschlag** Die signierte Kopie mit ihren Commitments und der versiegelte Umschlag gehen an die Aufsichtsbehörde oder das Gericht. 2. Schritt 2 · Die Behörde**Öffnet den Umschlag und führt die Berechnung erneut durch** Der Prüfer entschlüsselt mit dem privaten Schlüssel der Behörde und berechnet SHA-256(Salt ‖ Wert) für jedes Feld neu. Jedes Ergebnis muss dem von der Kanzlei signierten Commitment entsprechen. 3. Schritt 3 · eine unabhängige Stelle**Entscheidet, was tatsächlich geschützt war** Die Behörde, nicht die Kanzlei, liest alles Zurückgehaltene, hier 1.944 Beschwerdetexte und eine Security History, und entscheidet, ob die Rechte Dritter die Zurückhaltung erforderten. ANLAGE 1 · SEITE 514 · EINE ZEILE, ZWEI ARTEN, SIE ZU VERBERGENLive · in Ihrem Browser Wie geliefert · schwarze RechteckeNur visuelle Überlagerung Aspose.PDF for .NET 20.8 · page 514Textebene + Rechtecke Meldende Person: [Login · hier nicht wiedergegeben] Datum: 2024-03-28 Typ: Offensive Profile Text: русофоб Darüber werden schwarze Rechtecke eingezeichnet. Der darunterliegende Text bleibt in der Datei erhalten. Kopie des Antragstellers · gesalzene CommitmentsVon der Kanzlei unterzeichnet c = SHA-256(salt ‖ value)Für die Behörde versiegelt Meldende Person: [zurückgehalten · Commitment] Datum: 2024-03-28 Typ: Offensive Profile Text: [withheld · commitment] Umschlag · RSA-OAEP-256 + AES-256-GCMfür den öffentlichen Schlüssel der Behörde Die Kopie enthält Commitments. Werte und Salts liegen im Umschlag. 1. **1**Der Antragsteller übergibt die Kopie und den Umschlag 2. **2**Die Behörde öffnet ihn und berechnet jedes Commitment neu 3. **3**Die Behörde entscheidet, was zurückgehalten wird Beide Ansichten verbergen dieselben zwei Felder. Lesen Sie die Rohbytes, dann führen Sie die Prüfung der Behörde aus. Links: eine Zeile aus Anlage 1, wie geliefert; der Beschwerdetext liegt auf Seite 514 unter einem schwarzen Rechteck und wird ohne das Login der meldenden Person zitiert, dessen Feld einen Platzhalter enthält. Rechts: dieselbe Zeile mit gesalzenen Commitments, deren Werte für den Schlüssel einer Behörde versiegelt sind. Das Schlüsselpaar wird für diese Demonstration in Ihrem Browser erzeugt, und der Umschlag ist derselbe, den TgWitness für die versiegelte Zustellung verwendet. Die Entscheidung in Schritt 3 ist ein Beispiel. **Niemand entscheidet allein**Die Kanzlei unterbreitet weiterhin Vorschläge, welche Informationen zurückgehalten werden sollen. Jemand, der den Gesamtzusammenhang kennt und kein persönliches Interesse an dem Streitfall hat, überprüft diese Vorschläge. **Nichts dringt nach außen**Der Antragsteller sieht keine Daten anderer Personen. Das Salt macht ein Commitment für Rateversuche nutzlos: Ohne Salt ließe sich eine Ein-Wort-Beschwerde durch das Hashen einer Wortliste finden. **Nichts kann ausgetauscht werden**Jeder Wert ist an das Commitment gebunden, das die Kanzlei signiert hat. Ein anderer oder fehlender Text besteht die Prüfung nicht. **Die Signatur bekommt Gewicht**Eine qualifizierte Signatur über die Commitments bindet die Kanzlei an jeden verborgenen Wert, nicht nur an das Anschreiben. **Titel spielen keine Rolle**Die Überprüfung erfolgt rechnerisch. Dazu werden die Kopie, der Umschlag und der Schlüssel der Behörde benötigt – nicht das Wort einer einzelnen Person. Dafür ist keine neue Infrastruktur erforderlich. Die deutschen Aufsichtsbehörden veröffentlichen bereits OpenPGP-Schlüssel: Der Bundesbeauftragte für den Datenschutz [führt für jedes Referat einen Schlüssel auf](https://www.bfdi.bund.de/DE/Service/Kontakt/Schluessel/Schluessel-node.html), und der LfDI Baden-Württemberg [stellt seinen öffentlichen Schlüssel für verschlüsselte E-Mails zur Verfügung](https://www.baden-wuerttemberg.datenschutz.de/kontaktdaten-des-verantwortlichen/). Deutsche Gerichte nehmen Eingaben bereits über das EGVP entgegen, dessen [End-to-End-Verschlüsselung auf dem OSCI-Protokoll basiert](https://egvp.justiz.de/behoerdenpostfach/Informationsmaterial_fuer_Behoerden_zu_BeBPo_und_eEB_V1_3_2.pdf). **Die Position von PhishDestroy.** Wer hat den Anwälten das Recht gegeben, zu entscheiden, was wesentlich ist und was nicht? Anwälte sollten diese Entscheidung nicht treffen. Es sollte alles übergeben werden: nicht unter schwarzen Rechtecken, die jeder entfernen kann, sondern versiegelt, sodass nur ein Gericht oder eine Aufsichtsbehörde den Schlüssel dazu hat, damit kein Spielraum für „Fehler“, für „Missverständnisse“ oder dafür bleibt, nur das zu zeigen, was gerade gelegen kommt. ## Das ehrliche Modell: vollständige Daten, eine erklärte Regel, der Schlüssel bei der Behörde Der Antragsteller erhält sofort alles, was unstreitig ist. Was zurückgehalten wird, wird weder durch eine Zeichnung verdeckt noch stillschweigend vorenthalten. Es wird vollständig und unterzeichnet, verschlüsselt mit dem Schlüssel der Behörde, die zur Entscheidung darüber befugt ist, übermittelt. | Frage | Was geschah | Ehrliches Modell | | --- | --- | --- | | Wer entscheidet, was zurückgehalten wird? | Rechtsbeistand der Streitpartei | Eine Regel, die bei der Erstellung der Kopie festgelegt und unterzeichnet wird; die zuständige Behörde prüft sie | | Was der Antragsteller erhält | Ausgewählte Zeilen; ganze Kategorien fehlen; ein Stichtag ohne dokumentierte Grundlage | Jeder unbestrittene Eintrag, unverzüglich | | Daten von Dritten | Mit Zeichnungen überdeckt und weiterhin in der Datei | Aus der Kopie des Antragstellers entfernt; im Original für die Behörde beibehalten | | Zurückgehaltene Teile | Anzahl unbekannt, Inhalt unbekannt | Im signierten Manifest gezählt; das vollständige Original verschlüsselt für den Schlüssel der Behörde | | Nachweis, wie die Kopie ausgewählt wurde | Es existiert nur, weil die Schwärzung fehlgeschlagen ist | Eingebaut: Regel, Anzahl, Hash des Originals | | Umstrittene Felder | Vom Schreiben entschieden: „jedes Gericht wird zustimmen“ | Entscheidet die Aufsichtsbehörde oder das Gericht, die sie öffnen können | | Zeit | 106 Tage | Export plus Lieferung | | Rolle des Rechtsbeistands | Legt den Anwendungsbereich, die Beweislast und das Urteil fest | Vertritt den Fall vor Gericht; bearbeitet die Daten des Antragstellers nicht | Auch die Behörde ist nicht auf Vertrauen angewiesen. Art. 58 Abs. 1 Buchst. e DSGVO ermächtigt eine Aufsichtsbehörde bereits, Zugang zu allen personenbezogenen Daten zu erhalten, die ein Verantwortlicher verarbeitet. Das Modell übermittelt diese lediglich in einer Form, die bei Erhalt überprüft werden kann. **Die in den Schreiben genannten Gründe, Zweifel an der Inhaberschaft, Zahlungen durch Dritte, Beschwerden, Phishing-Verdacht, erklären, warum Art. 15 nicht erfüllt wurde. Sie erfüllen ihn nicht.** Unabhängig von der Grundlage ist das Ergebnis dasselbe: Der Antragsteller hat seine Daten nicht erhalten, Daten anderer Personen wurden unter Zeichnungen übermittelt, und die Auswahl ließ sich nur zufällig überprüfen. Das Auskunftsrecht ist ein Recht der betroffenen Person, kein Faustpfand im Streit anderer. ## Wie TgWitness Originale aufbewahrt und Kopien überprüfbar macht TgWitness exportiert Unterhaltungen als Beweismittel. Das Konzept basiert auf den Erkenntnissen aus diesem Fall: Ein Export sollte nicht allein aufgrund der Person, die ihn übergibt, als glaubwürdig angesehen werden. Das ursprünglich erfasste Protokoll bleibt erhalten. Eine Kopie zur Weitergabe enthält in ihrem signierten Manifest die ausgewählten Datensätze und Felder, die Offenlegungsregeln sowie die Anzahl der ausgeschlossenen Datensätze. Das „Zero-Trust“-Prinzip gilt für alle, auch für uns. Bewahren ### Bewahren Sie das Original auf Bewahren Sie das vollständig erfasste Journal und dessen Signaturen auf. Führen Sie unabhängig davon einen Kontrollpunkt, damit ein späterer Austausch oder eine Kürzung überprüft werden kann. Schützen ### Die Zustellung verschlüsseln Verschlüsseln Sie das Archiv mit einem Empfängerschlüssel oder schützen Sie eine Zustellung mit einem Passwort. Zur Entschlüsselung sind der entsprechende Schlüssel oder das entsprechende Passwort erforderlich. Offenlegen ### Auslassungen benennen Tragen Sie den Zweck und die Regeln in das unterzeichnete Manifest ein. Kennzeichnen Sie minimierte Datensätze, zählen Sie ausgeschlossene Datensätze und bewahren Sie Verweise auf die Quelljournal auf. TgWitness versiegelt bereits vollständige Originale für einen Empfängerschlüssel – wie bei dem in der obigen Demonstration verwendeten Umschlag – und kennzeichnet, welche Inhalte bei der Offenlegung zurückgehalten werden. Der Prüfer überprüft die Datensatzsignaturen und den Link der Freigabekopie zum Quelljournal; um zurückgehaltene Inhalte anhand ihres ursprünglichen Hashwerts zu überprüfen, ist das aufbewahrte vollständige Original erforderlich. Feldspezifische, mit einem Salt versehene Verpflichtungen für eine Autorität sind der Schritt, für den dieser Fall plädiert. | In Anlage 1 | TgWitness-Funktion | Aufgezeichnete Prüfung | | --- | --- | --- | | Text unter schwarzen Rechtecken | Ausgeblendete Felder wurden aus der Freigabekopie entfernt; das Original wird separat aufbewahrt | Benannte Auslassungen und der Hashwert der Originalaufzeichnung | | 50 Beschreibungen sichtbar; 1.944 überdeckt | Signierte Offenlegungsregeln und Zahl der ausgeschlossenen Datensätze | Der ausgewählte Umfang und der Verweis auf die Quelljournal | | PDF-Anlage | Verschlüsselte Übermittlung des erfassten Archivs | Authentifizierte Entschlüsselung; Archivsignaturen und Hashwerte | | Die Datei, die durch den unten angegebenen SHA-256-Hash identifiziert wird | Datensatz-Hashes, Signaturen und aufbewahrte Checkpoints | Vergleich mit dem zuvor gespeicherten Journal | ### Was die Software gewährleisten soll **Integrität der Daten**Jeder Datensatz wird per Hash in eine Kette eingebunden und mit Ed25519 signiert. Der Prüfer berechnet jeden Datensatz neu, sodass jede Änderung sichtbar wird. **Lieferung, die Sie überprüfen können**Archive werden verschlüsselt an den Empfänger übertragen; große Archive werden in verschlüsselte Teile mit einem signierten Manifest aufgeteilt, die lokal zusammengesetzt und überprüft werden. **Die Daten anderer Personen bleiben vertraulich**Eine Kopie zur Weitergabe hält nach Regel zurück und benennt, was sie zurückhält. Das Aufdecken eines maskierten Werts im Panel wird protokolliert. **Kein Spielraum für Fehler**Die Überprüfungen sind rein rechnerischer Natur: die Datei, ein Fingerabdruck eines vertrauenswürdigen Schlüssels und ein gespeicherter Prüfpunkt. Es ist niemandes Wort erforderlich. **Kein Spielraum für Manipulationen**Bearbeitungen und Löschungen werden zu neuen Datensätzen, ein gekürztes Protokoll scheitert an einem beibehaltenen Prüfpunkt, und eine Offenlegung wirkt niemals vollständig, wenn sie es nicht ist. Ein Tippfehler in einem Namen hat keinen Einfluss auf die von der Software signierten Daten. Auch wenn die Frist um einen Monat überschritten wurde, bleiben die ursprünglichen Datensätze unverändert. Jede Änderung unterbricht die Kette, und der Prüfer weist darauf hin. Probieren Sie beide unten stehenden Optionen aus. SHA-256 · IN IHREM BROWSERBearbeiten Sie eine der beiden Zeilen Wie unterzeichnet · Schreibenkopf`86582990a7b364adbd83071c9edb4774ed6e8ea50b80dca1ae426c3fa679a1d6` Öffentliches Register`17fae25500c51998112b146c76b21b04bf3d4034407f2f958bced7d6d6e928ba` **1** Zeichen Unterschied**60** von 64 Hexadezimalziffern unterscheiden sich**128** von 256 Bits unterscheiden sich Ein Zeichen Unterschied. Zwei nicht miteinander in Zusammenhang stehende Fingerabdrücke. Ein Hash hat den einen Buchstaben bemerkt, den der Signaturprozess übersehen hatte. Ein Titel besteht lediglich aus zusätzlichen Bytes: Er verändert den Fingerabdruck, niemals die Fakten. SIGNIERTE JOURNAL · VEREINFACHTBeispielhafte Datensätze EINTRAG 1**17.06.2025 · access request**`adc396074b0f04…`= gespeicherter Hash EINTRAG 2**01.10.2025 · letterhead p.zurheode**`0b8eda5c2f43ae…`= gespeicherter Hash EINTRAG 3**01.10.2025 · Anlage 1 · 830 pages**`dbe2eef85bfb5a…`= gespeicherter Hash Jeder Datensatz enthält den Fingerabdruck des vorhergehenden Datensatzes. Eine Änderung an Datensatz 2 verändert dessen Hash-Wert und unterbricht die Verknüpfung zu Datensatz 3. Vereinfacht ausgedrückt: Jeder Fingerabdruck umfasst den vorherigen Fingerabdruck und eine Textzeile. TgWitness erstellt Hashwerte für neun kanonische Ereignisfelder, darunter den vorherigen Hashwert, und signiert jeden Digest mit Ed25519. [Siehe die vollständige Kette mit Checkpoints](https://phishdestroy.io/tgwitness/de/docs/concepts/) [So funktioniert das Teilen von Kopien bei TgWitness](https://phishdestroy.io/tgwitness/de/docs/handover/) · [Der versiegelte Umschlag](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md#cryptographic-handoff) · [Umfang der Umsetzung und Überprüfung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) ## Überprüfen Sie es selbst Jede Aufsichtsbehörde, jedes Gericht und jeder Prüfer, dem die Dateien vorliegen, kann jede Prüfung auf dieser Seite offline wiederholen. Nur aggregierte Ergebnisse: Logins der Meldenden, Kontokennungen und Profildaten werden hier nicht veröffentlicht. **Alle Monate: 2021–2025** | Jahr | Jan | Feb. | März | Apr. | Mai | Juni | Juli | Aug. | Sep. | Okt. | Nov. | Dez. | Gesamt | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 2021 | 0 | 2 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 1 | 20 | **25** | | 2022 | 10 | 7 | 43 | 9 | 2 | 7 | 2 | 11 | 7 | 6 | 5 | 13 | **122** | | 2023 | 111 | 48 | 156 | 59 | 52 | 53 | 66 | 52 | 73 | 44 | 53 | 58 | **825** | | 2024 | 69 | 58 | 111 | 36 | 33 | 46 | 83 | 53 | 54 | 70 | 79 | 82 | **774** | | 2025 | 92 | 32 | 35 | 20 | 12 | 1 | 7 | 47 | 3 | — | — | — | **249** | 0 bedeutet, dass in diesem Export keine Datensätze für diesen Monat enthalten sind; — liegt nach dem Stichtag September 2025. Gesamt: **1.995**. **Alle Meldekategorien in der gelieferten Tabelle** | Erfasster Meldetyp | Alle Datensätze | Lesbare Beschreibungen | Überdeckte Beschreibungen | | --- | --- | --- | --- | | Offensive Profile | 1,148 | 0 | 1,147 | | Suspected Hijacker | 312 | 43 | 269 | | Cheating | 290 | 2 | 288 | | Offensive Persona Name | 87 | 1 | 86 | | Offensive Avatar | 57 | 3 | 54 | | Belästigung | 46 | 1 | 45 | | Spam | 37 | 0 | 37 | | Spoofing | 16 | 0 | 16 | | Automatische Moderation | 1 | 0 | 1 | | Handelsbetrug | 1 | 0 | 1 | Die Gesamtzahl für Offensive Profile enthält die eine leere Beschreibung. Gesamtzahlen: 1.995 Datensätze, 50 lesbare Beschreibungen, 1.944 überdeckte Beschreibungen, 1 leere Beschreibung. **Anmeldungen und Sicherheitsverlauf** Anlage 1, Seite 1: `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)` und `Date of Report: 09-29-2025`. Der Anmeldeverlauf auf den Seiten 1–119 listet die jüngsten Anmeldungen an erster Stelle auf; die neuesten Einträge stammen aus dem Mai 2025, und es gibt keine späteren Einträge. Seite 830, „Security History“, liegt unter schwarzen Rechtecken. Die letzte Passwortänderung stammt aus dem Juli 2024; für 2025 ist keine Änderung verzeichnet. Daten, Adressen und Kennungen aus diesen Zeilen werden nicht wiedergegeben. ``` pdftotext -f 1 -l 1 Anlage1.pdf - # last logon, date of report pdftotext -f 830 -l 830 Anlage1.pdf - # security history ``` **PDF-Metadaten und Signaturerklärungen** PDF-Metadaten: Producer `Aspose.PDF for .NET 20.8`; erstellt am 1. Oktober 2025 um 19:58:05, geändert um 19:58:41, jeweils UTC+02:00. Die beiden Zeitstempel liegen **36 Sekunden auseinander**. In beiden Schreiben wird auf der letzten Seite eine qualifizierte elektronische Signatur angegeben: „Dieses Schreiben ist qualifiziert elektronisch signiert“. Die Signaturprüfung ist eine von den hier gezeigten Inhalts- und Schwärzungsprüfungen getrennte Überprüfung. **Zählungen reproduzieren und Quell-Hashes vergleichen** Das Zählskript ist auf den unten angegebenen Hash von Anlage 1 festgelegt. Es rekonstruiert die Tabellenzeilen auf den Seiten 444–620 und verbindet 118 Zellen, die über Seitengrenzen hinweg fortgesetzt werden. Die Sichtbarkeit ergibt sich aus der Überschneidung der Wortrahmen mit deckenden schwarzen Rechtecken; die eine leere Beschreibung wird gesondert erfasst. Kyrillische Zählungen verwenden U+0400–U+052F. Der Vergleich des Login-Formats verwendet das Muster für die gesamte Zeichenfolge `[A-Za-z]+[0-9]{3,5}`. Wiederholungen werden nach Normalisierung der Leerzeichen aus der Extraktion gezählt. Die Wortzählungen in den überdeckten Beschreibungen erfassen Wortstämme unabhängig von Groß- und Kleinschreibung. Es handelt sich um beschreibende Messungen, nicht um eine automatisierte Feststellung gemeinsamer Urheberschaft oder eines Fehlverhaltens. Optionale Sprachschätzungen im JSON verwenden lokal Lingua 2.2.0; kurze und mehrdeutige Texte bleiben unzugeordnet. Die Prüfung der 905.672 Zeichen zählt jedes Nicht-Leerzeichen, dessen Begrenzungsrahmen ein schwarzes Rechteck schneidet, genau einmal; 1.044 der 1.329 schwarzen Rechtecke überdecken solchen Text. [Aggregierte Zählungen · JSON](https://phishdestroy.io/tgwitness/assets/signed-export-statistics.json?v=b84f21c8824d) · [Skript zur lokalen Zählung · Python](https://phishdestroy.github.io/TgWitness/assets/signed-export-audit.py) ``` python signed-export-audit.py Anlage1.pdf --output counts.json sha256sum Anlage1.pdf pdfinfo Anlage1.pdf | grep -E "Producer|CreationDate|ModDate" pdftotext -layout Anlage1.pdf - | less ``` Das Skript benötigt PyMuPDF und lingua-language-detector. Es führt keine Netzwerkanfragen durch und gibt aggregierte Daten aus, keine Beschwerde-Texte oder Logins. | Datei | SHA-256 | | --- | --- | | Dok.-Nr. 42603633 (Dr. Zurheide) | `de0fdcf6bfaccedc98d1670438bc7ca3330479096875e716dbb9678922b43ab9` | | Dok.-Nr. 42282474 (Dr. Schelinski) | `b48e09c28ee40a46f1d404041751f718fb185d1eb774ddabb4373fdd53bbe2f1` | | Anlage 1 | `2bb927e2c42fdc2e3ad089ae302dd887c343f6798aba00fcfac279224ff7d6af` | **Die Lehre für jeden Export.** Anwälte können einen Export unterzeichnen. Die Signatur gibt an, wer ihn versandt hat, nicht aber, was darin wahr ist. Die Wahrheit ist das, was einer Überprüfung standhält, die jeder wiederholen kann. ## Unsere Position **Die Position von PhishDestroy.** Wir respektieren das Gesetz und die Gerichte. Das Gesetz steht nicht im Widerspruch zur Wahrheit. Diejenigen, die es beugen, um sich nicht daran halten zu müssen, sind keine Verbündeten eines Gerichts, und ein Doktortitel kann für ein Gericht keine Autorität sein. Eine Promotion ist eine historische Tatsache: eine Forschungsarbeit in einem engen theoretischen Fachgebiet, die einmal verteidigt wurde. Das macht noch niemanden zu einem IT-Anwalt. Soweit wir sehen, steht der Titel für keinen der Fehler ein: nicht für die unter der Signatur formulierten Argumente, nicht für den falsch geschriebenen Namen, nicht für das Datenleck, das die Schreiben selbst angeblich verhindern sollten. Beide Unterzeichner reichten später Anträge auf Löschung aus den Suchergebnissen gemäß Art. 17 ein (siehe den [Hinweis für den Betreiber](https://phishdestroy.io/tgwitness/de/docs/reference/notice/)). Das Recht auf Vergessenwerden sollte die berufliche Fahrlässigkeit eines Fachmanns nicht auslöschen. Und überprüft überhaupt jemand die Dokumente, die mit einer qualifizierten Signatur versendet werden? Diese Schreiben lesen sich wie eine E-Mail an einen Freund, nicht wie ein Dokument von öffentlicher Bedeutung. Zero Trust – gegenüber allen. Geld ist gut. Die Gesetze des eigenen Landes dafür zu verkaufen, ist unserer Ansicht nach jedoch nicht die beste Art, damit umzugehen. Aber wir sind keine Experten. PhishDestroy ist nicht an dem Streitfall beteiligt und äußert sich nicht dazu, ob die Sperrung des Steam-Kontos gerechtfertigt war. Die betroffene Person wird auf dieser Seite nicht identifiziert; Kontokennungen, Logins, IP-Adressen und personenbezogene Daten werden nicht wiedergegeben. Beschwerdetexte werden ohne die Logins der Beschwerdeführer zitiert, einschließlich der Texte unter schwarzen Rechtecken, die in der Textebene der Datei verbleiben. Schreiben: Dok.-Nr. 42282474, 15. August 2025 (3 Seiten); Dok.-Nr. 42603633, 1. Oktober 2025 (9 Seiten). Anlage: Anlage 1 (830 Seiten). Seitenverweise beziehen sich auf die Seitenreihenfolge im PDF. Englische Übersetzungen deutscher Zitate stammen von uns. [Umfassende Fallakte](https://phishdestroy.io/steam_dossier/taylor_wessing) · [Die 106-tägige DSGVO-Akte](https://github.com/phishdestroy/TgWitness/blob/main/docs/TAYLOR-WESSING-GDPR-FILE.md). --- # Telegram · Das Archiv bearbeiten Canonical page: https://phishdestroy.io/tgwitness/de/docs/archive/ Laden Sie den Verlauf, durchsuchen Sie gespeicherte Datensätze, überprüfen Sie KI-Quellen und verbinden Sie Ihre Tools. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Die Nachricht finden. Die Quelle überprüfen. Den Fall aufbauen. 01**Den Verlauf einbeziehen** Holen Sie frühere Nachrichten Ihrer aktiven Quellen in den Arbeitsbereich. 02**Den Quellen folgen** Suchen Sie und öffnen Sie dann die gespeicherte Nachricht hinter jedem Treffer. 03**Sorgen Sie für eine klare Übergabe** Ihre Analyse in einer Datei, die signierten Beweise daneben. Erfasste Datensätze, erkannter Text und Schlussfolgerungen der Analysten bleiben klar voneinander getrennt. ## Frühere Nachrichten laden 1. **Quellen → Chats im Umfang**: aktive Chats prüfen, Beobachtung starten. 2. **Gesamten Verlauf laden**. Nimmt die Quellenliste, wie sie gerade ist. 3. **Verlauf pausieren** / **Verlauf fortsetzen** jederzeit. Nach einem Neustart von Hand fortsetzen. 4. Ergebnisse pro Quelle und die Download-Warteschlange prüfen, den signierten Fortschrittsbericht beim Export behalten. Das füllt den Arbeitsbereich. Ein Einzel-Chat-Export als HTML/JSON ist etwas anderes. [Details](https://phishdestroy.io/tgwitness/de/docs/reference/history/). ## Erst suchen, dann über KI entscheiden 1. **Journal** sucht lokal, filtert nach Quelle und Zeit. 2. Suchen Sie eine Phrase oder Domain, öffnen Sie den Eintrag und seine Versionen. 3. Für KI richtet der Admin einen Anbieter unter **Integrationen** ein. Dann **Archiv fragen**: Chats und Zeitraum wählen, **An das Modell gesendete Daten** ansehen und abwählen, was nicht raus soll. 4. Zitate prüfen, Antwort als Bericht speichern, eigene Notizen ergänzen. Die Suche braucht keine KI. Berichte behalten Quellen und Revisionen, getrennt vom signierten Journal. [Anbieter einrichten](https://phishdestroy.io/tgwitness/de/docs/reference/analysis/). ## Wählen Sie die gewünschte Verbindung aus | Aufgabe | Öffnen | Einrichtung | | --- | --- | --- | | Einen KI-Client ausgewählte Chats lesen lassen | **Integrationen → MCP** | [MCP installieren, begrenztes Token erstellen, verbinden](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/) | | Text in gespeicherten Medien erkennen | Ein `media.saved`-Eintrag → **Anhang erkennen** | [Den lokalen Docker-Worker einrichten](https://phishdestroy.io/tgwitness/de/docs/reference/media-analysis/) | | Ereignisse an n8n oder ein SIEM senden | **Integrationen → Ausgehende Webhooks** | [Empfänger hinzufügen, HMAC prüfen, IDs entduplizieren](https://phishdestroy.io/tgwitness/de/docs/reference/webhooks/) | **Welches Zugriffstoken gehört wohin?** Panelzugang ist für Menschen. MCP bekommt eigene Nur-Lese-Tokens, Webhooks ein eigenes HMAC-Geheimnis. Keiner davon braucht eine Telegram-Sitzung. [Zugriff auf das Share-Panel gewähren](https://phishdestroy.io/tgwitness/de/docs/access/) oder [einen MCP-Client konfigurieren](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/). ## Quellen und Schlussfolgerungen angeben Legen Sie den Bericht neben das signierte ZIP. Der Bericht ist Ihre Lesart der Quellen, das ZIP ist das, was der Empfänger prüft. [Exportieren und verifizieren](https://phishdestroy.io/tgwitness/de/docs/exports/) · [Durchführung einer vollständigen Untersuchung](https://phishdestroy.io/tgwitness/de/docs/cases/) --- # Telegram · Einen Fall teilen Canonical page: https://phishdestroy.io/tgwitness/de/docs/access/ Gewähren Sie Prüfern und Analysten Zugriff auf ausgewählte Konten und Chats mit separaten Berechtigungen, Sitzungsbeschränkungen und widerrufbaren Tokens. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Teilen Sie den Fall, den jemand benötigt. Behalten Sie die Kontrolle über den Rest. 01**Wählen Sie die Beweise aus** Ganze Arbeitsbereiche oder einzelne Chats. 02**Wählen Sie die Aktionen aus** Ansehen, exportieren oder nur die nötigen Aktionen. 03**Legen Sie die Grenzen fest** Ein persönliches Token mit Ablaufdatum, Sitzungslimits und IP-Regeln, wenn Sie wollen. Der Erfassungsumfang bestimmt, was aufgezeichnet wird. Der Zugriffsumfang bestimmt, was eine Person sehen und tun kann. ## Jemandem Zugriff gewähren 1. Als Admin **Zugriff** öffnen. 2. Benennen, Arbeitsbereiche und Chats wählen. 3. Ein Prüfer braucht nur **Ansehen**. Für Downloads **Exportieren** hinzufügen. 4. Legen Sie die Einschränkungen fest und klicken Sie anschließend auf **„Zugriff erstellen**“. 5. Token kopieren (wird einmal angezeigt) und privat mit der Panel-Adresse schicken. 6. Prüfen Sie vorher in einer separaten Browser-Sitzung, was die Person sehen wird. ## Beginnen Sie mit der Aufgabe, die sie zu erledigen haben | Person | Zugriff | Ergebnis | | --- | --- | --- | | Rezensent | Ausgewählte Chats; nur zur Ansicht | Liest den Chat, kann nichts ändern. | | Analyst | Ausgewählte Chats; anzeigen und exportieren | Liest und lädt herunter, was der Fall braucht. | | Betreiber | Ausgewählte vollständige Arbeitsbereiche; Quellen und Sammlung | Entscheidet, was beobachtet wird, startet und stoppt Collectoren. | Das sind nur Beispiele, keine festen Rollen. Auf Chats beschränkter Zugriff bekommt nie Kontoeinstellungen oder vollständige Journal-Exporte. Zugriff auf alle Arbeitsbereiche schließt später hinzugefügte Konten ein. ## Sie können Ihre Meinung jederzeit ändern Zugriff jederzeit bearbeiten, es gilt ab der nächsten Anfrage. Eine Sitzung beenden oder alles widerrufen. Bereits heruntergeladene Dateien sind weg. Die Erfassung läuft weiter. **Sitzungs- und IP-Beschränkungen** Parallele Sitzungen und Anmeldungen begrenzen, ein Enddatum setzen, IPs oder Subnetze erlauben oder an die IP der ersten Anmeldung binden. Der Ablauf zählt Inaktivität, ein offenes Panel gilt als aktiv. Hinter einem Proxy prüfen, welche Client-IP die App sieht. **Der Hauptschlüssel und das Aktivitätsprotokoll** Das Haupttoken bleibt beim Admin. Vergebener Zugriff kann weder fremden Zugriff verwalten noch die Admin-Konsole öffnen. Zugriffsänderungen und Sitzungen werden ins Journal signiert, ohne Tokens. Der Server-Admin sieht weiterhin alles. Alle sieben Berechtigungen und Sitzungsregeln: [Zugriffsreferenz](https://phishdestroy.io/tgwitness/de/docs/reference/access/). --- # Telegram · Halten Sie den Betrieb aufrecht Canonical page: https://phishdestroy.io/tgwitness/de/docs/server/ Führen Sie TgWitness auf einem Server mit dauerhaftem Speicher, privatem Panel-Zugriff, Backups und Überprüfungen nach einem Neustart aus. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Halten Sie den Collector am Laufen und die Daten über Neustarts hinweg sicher. ## Wählen Sie eine Startmethode Nativ: der [Starter](https://phishdestroy.io/tgwitness/de/docs/start/) plus Dienstvorlagen in [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Docker, aus dem Projektordner: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Das Panel lauscht auf localhost:8787. Lokal oder über einen SSH-Tunnel öffnen, mit dem Token aus dem zweiten Befehl. ## Behalten Sie das gesamte Datenverzeichnis bei Nativ: `data/live`. Docker: das Volume `tgwitness-data`. Journale, Sitzungen und Schlüssel gehören zusammen. Ein signierter Export ist ein Beweis, kein Backup. 1. Zuerst die Erfassung stoppen. 2. Das ganze Datenverzeichnis an einen sicheren Ort außerhalb des Hosts kopieren. 3. Die Wiederherstellung auf einer separaten Installation testen, bevor Sie sich darauf verlassen. ## Bitte nach einem Neustart überprüfen Arbeitsbereich und Schlüssel, Verbindung, Quellen und eingehende neue Nachrichten prüfen. TgWitness holt nach, was Telegram noch hat, nicht alles, was während der Ausfallzeit passiert ist. Ein „gesunder“ Container heißt, der Webserver antwortet. Ob die Erfassung funktioniert, zeigen eine Testnachricht und der Zeuge. ## Veröffentlichen Sie nur das, was Sie beabsichtigen HTTPS, Volumes, Updates und Wiederherstellung stehen in der Deployment-Referenz. Was tatsächlich getestet wurde: [Prüfprotokoll](https://phishdestroy.io/tgwitness/de/docs/reference/verification/). --- # Telegram · Finden Sie heraus, was schiefgelaufen ist Canonical page: https://phishdestroy.io/tgwitness/de/docs/troubleshooting/ Überprüfen Sie den Zugriff auf das Kontrollpanel, die Telegram-Verbindung, fehlende Nachrichten, „FloodWait“ und den Witness-Status anhand der für jedes Problem zutreffenden Signale. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Fangen Sie beim Symptom an, prüfen Sie eins nach dem anderen. ## Das Panel fordert ein Token an Es will das Panel-Token aus der Datei, die der Starter angezeigt hat. Docker: `docker compose exec tgwitness cat /data/panel-token.txt`. Kein Telegram-Code, kein Bot-Token, nicht das Zeugen-Token. ## Telegram stellt keine Verbindung her Verbindungsprüfung ausführen. Bei einem öffentlichen Proxy einen anderen wählen und speichern. Proxy-Typ und Geheimnisformat prüfen. Listen aktualisieren wechselt die Route nicht von selbst. ## Verbunden, aber keine neuen Nachrichten 1. Läuft die Beobachtung, im richtigen Arbeitsbereich? 2. Ist die Quelle ausgewählt und für dieses Konto sichtbar? 3. Schicken Sie eine eindeutige Nachricht in Ihre Testgruppe und suchen Sie danach. 4. Suchen Sie im Journal nach Unterbrechungen oder Telegram-Fehlern. Ein ruhiger Chat hat einfach nichts Neues. Wenn Vollständigkeit zählt, machen Sie einen kontrollierten Zustelltest. ## FloodWait oder eine Lücke nach einem Neustart FloodWait ist Telegram, das „langsamer“ sagt. Abwarten und die Last senken, neu verbinden hilft nicht. Nach einem Neustart holt TgWitness nach, was Telegram noch hat; der Rest ist eine Lücke, notieren Sie sie. ## Der Bot ist konfiguriert, veröffentlicht jedoch nichts Läuft der Zeuge, darf der Bot im Kanal posten, erreicht er Collector und Bot API? Suchen Sie in seinem Journal nach fehlgeschlagenen Beiträgen. Eine Abfrage auf Collector-Seite heißt nicht, dass ein Beitrag rausging. ## Wo befindet sich die GitHub-Token-Integration? **In Planung.** Unter „Extras“ wird der vorgeschlagene Workflow zur Fork- und Build-Verifizierung beschrieben. Derzeit gibt es weder ein GitHub-Token-Formular noch eine automatisierte Bestätigung, dass eine laufende Installation mit einem Repository übereinstimmt. Siehe den [aktuellen Status der Funktionen](https://phishdestroy.io/tgwitness/de/docs/reference/features/). Sie melden einen Fehler? Version, Betriebssystem, Schritte und ein bereinigter Fehler. Legen Sie nie Sitzungen, Tokens, private Nachrichten oder das Datenverzeichnis in ein öffentliches Issue. --- # Export Clinic Canonical page: https://phishdestroy.io/tgwitness/de/docs/export-clinic/ Sehen Sie sich ein kontrolliertes Experiment zum Exportieren von Telegram Desktop an, vergleichen Sie sieben Testkonversationen und sehen Sie sich die Originalaufzeichnung sowie die zugehörigen Dateien an. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Im Chat steht „FAIL“. Auf der exportierten Seite steht „PASS“. Beobachten Sie die Änderung, vergleichen Sie die Dateien und prüfen Sie, wie es dazu gekommen ist. Bei diesem Experiment kommen Testkonten und vorprogrammierte Unterhaltungen zum Einsatz. Telegram Desktop wurde von der offiziellen Quelle heruntergeladen, und die ausführbare Datei wurde nicht verändert. Ein lokaler Helfer hat ausgewählte Exportdateien absichtlich verändert. Beobachten Sie den Download, die Anmeldung und den Export und vergleichen Sie anschließend die Telegram-Konversation mit dem veränderten HTML- und JSON-Code. Das Experiment zeigt, wo ein gewöhnlicher Export verändert werden kann und warum die Protokollierung des Erfassungsprozesses wichtig ist. **1:59,7** – Kurzfilm**6:08,8 –** vollständige Originalaufnahme**7** Testgespräche ## Sehen Sie sich das Experiment an [Den Film herunterladen](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) 1:59,7 · Die Einrichtung und wiederholte Schritte werden um das 2- bis 15-Fache beschleunigt und beschriftet. Die Anmeldung, der erste Export und ausgewählte Vergleiche laufen in ihrer ursprünglichen Geschwindigkeit ab. Kein Ton. [Original-MKV herunterladen ↗](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) ## Vergleichen Sie die Test-Exporte Diese Auszüge stammen aus den gespeicherten und bearbeiteten JSON-Dateien. Wählen Sie eine Konversationsart aus, vergleichen Sie die Nachrichten und laden Sie anschließend die vollständigen, zusammengehörigen Exportdateien herunter, um den HTML-Code, die JSON-Daten und die enthaltenen Bilder selbst zu überprüfen. ### Export-Ratgeber | PDF-Prüfung 5 Nachrichten · 2 Änderungen **VOR DER ÄNDERUNG VOR ORT**Beibehaltene Original-Bytes DOKUMENTPRÜFUNG / SYNTHETISCHER TEST ERGEBNIS: NICHT BESTANDEN Der versteckte Text unter dem schwarzen Rechteck lässt sich weiterhin markieren. Dies ist ein vorprogrammiertes Ergebnis für die Demo-PDF-Datei und keine Prüfung eines Dokuments eines Drittanbieters. d58d19814e1e07d5… **NACH DER ÄNDERUNG VOR ORT**Absichtlich veränderte Bytes DOKUMENTENPRÜFUNG / SYNTHETISCHER TEST ERGEBNIS: BESTANDEN Alle sensiblen Textstellen wurden dauerhaft entfernt. Dies ist das absichtlich ersetzte Demonstrationsergebnis. 83a0a37eb7110d51… result.json · Meldung 1216 Skriptgesteuerter Szeneninhalt. Das Urteil des Bots stellt keine Prüfung eines echten Dokuments eines Dritten dar. Geänderte Nachricht 1 von 2 **Vergleichen Sie ein in diesem Export enthaltenes Bild** ![Bild vor der lokalen Bearbeitung](https://phishdestroy.io/tgwitness/de/docs/export-clinic/) VORHER · Beibehaltene Bildbytes ![Absichtlich bearbeitetes Bild](https://phishdestroy.io/tgwitness/de/docs/export-clinic/) NACHHER · bewusst ausgetauschtes Bild Anhänge wurden bei diesem Bot-Export nicht berücksichtigt. Das Archiv behält diese Einschränkung bei. JavaScript ist deaktiviert. Der Standard-Bot-Vergleich und alle Downloads stehen weiterhin zur Verfügung. Laden Sie das zugehörige Archiv herunter, um die anderen sechs Unterhaltungen einzusehen. ## Was der Vergleich verdeutlicht [Die normale Exportfunktion](https://telegram.org/blog/export-and-more) von Telegram speichert den Chatverlauf und ausgewählte Medien als lokale Dateien. Hier ändert ein Helfer mit Schreibzugriff diese Dateien, während der offizielle Client weiterhin den ursprünglichen Chat anzeigt. Anhand der beiden Dateien können Sie jede Änderung überprüfen. 1. **Offizieller Client:** Herunterladen, Anmelden und die Testgespräche ansehen. 2. **Native Exportfunktion:** Der Client schreibt HTML, JSON und ausgewählte Bilder. 3. **Bekanntgegebene Manipulation:** Ein lokaler Helfer ändert gezielt ausgewählte Dateien. 4. **Vergleich:** Der Chatverlauf und der geänderte Export werden nebeneinander angezeigt. ### Erfassen Sie die Daten direkt bei der Erhebung Der Zeitpunkt der Signatur ist entscheidend. Durch das Signieren einer bereits veränderten Datei wird diese veränderte Version festgehalten. TgWitness stellt eine Verbindung zu Telegram her, zeichnet die an das Konto übermittelten Inhalte auf und signiert sowie verknüpft die Protokolleinträge während der Erfassung. Der Empfänger kann die gespeicherten Datensätze und Dateien anhand dieser Signaturen und unabhängig davon gespeicherter Checkpoints überprüfen. Bei einem extern aufgezeichneten Erfassungsprozess führen [GitHub Actions](https://phishdestroy.io/tgwitness/de/docs/capture/) einen angehefteten TgWitness-Collector mit einer neuen Telegram-Sitzung aus. GitHub beglaubigt das daraus resultierende Archiv. Bei der Überprüfung werden der genehmigte Workflow und die Collector-Version sowie der Archiv-Digest, das Journal und die Anhänge überprüft. [Ein TgWitness-Archiv überprüfen](https://phishdestroy.io/tgwitness/de/docs/exports/#verify) · [Versuchen Sie, einen signierten Datensatz zu ändern](https://phishdestroy.io/tgwitness/de/docs/concepts/#chain) · [GitHub-Erfassung durchführen](https://phishdestroy.io/tgwitness/de/docs/capture/) ## Was forensische Tools tatsächlich zertifizieren „Export Clinic“ veranschaulicht einen konkreten Fall. Das dabei zutage tretende Muster ist nicht auf Telegram beschränkt. In der überwiegenden Mehrheit der von uns untersuchten Verfahren – darunter Gerichtsunterlagen, Fallbesprechungen und veröffentlichte Analysen – weisen „digitale Beweismittel“ ein einheitliches Format auf: einen Telegram-Export (HTML- oder JSON-Datei, manchmal eine Bildschirmaufnahme, manchmal ein Video von einem iPhone, auf dem durch Profilseiten navigiert wird) in Verbindung mit einer Beglaubigung durch einen Sachverständigen. Das ist in der Regel die gesamte Beweiskette. Telegram-Exporte bieten eine Momentaufnahme zur Gewährleistung der Portabilität personenbezogener Daten. TgWitness fügt einen Erfassungsdatensatz, gespeicherte Beobachtungen und Änderungen, Datei-Hashes, Signaturen des Erfassers sowie die für den ausgewählten Modus verfügbaren externen Verifizierungsdatensätze hinzu. Zusammen ermöglichen diese dem Empfänger, das gespeicherte Material mit dem aufgezeichneten Kontext, dem Zeitpunkt und den Erfassungsbedingungen abzugleichen. ### Die Werkzeuge sind objektiv. Das Problem ist, was die Menschen glauben, dass sie damit beweisen. Wir haben direkt mit UFED Cellebrite gearbeitet. Es ist eine hervorragende Software. Wenn sie Daten von einem Gerät extrahiert, SHA-256-Hashes berechnet und einen signierten Bericht erstellt, bescheinigt sie damit ganz genau eines: *Diese Bytes befanden sich zum Zeitpunkt der Extraktion auf diesem Gerät, und während der Übertragung hat sich nichts verändert.* Das ist wahr. Das ist nützlich. Das ist alles, was damit bewiesen wird. Es sagt nichts darüber aus, was sich auf dem Gerät befand, bevor die Strafverfolgungsbehörden es in die Hände nahmen. Es sagt nichts darüber aus, ob die Daten die historische Realität widerspiegeln. Das Tool ist korrekt. Das Tool ist kein Zeuge. Wir könnten Tools heranziehen, die speziell für die Verarbeitung von Telegram-Chat-Exporten entwickelt wurden – Viewer, Archivierungsprogramme, Wrapper für die Vorlage vor Gericht –, jedes einzelne anhand vorbereiteter Exportdateien testen und eine Vergleichstabelle erstellen. Das werden wir jedoch nicht tun. Es geht nicht darum, welches Tool was erfasst. Keines davon ist dazu in der Lage. Sie verarbeiten lediglich den Inhalt des Exports. Wenn der Export bereits vor der Verarbeitung durch das Tool zusammengestellt wurde, geben sie dessen Aufbau originalgetreu wieder. Eine kryptografische Signatur bescheinigt die Integrität der Daten *ab dem Zeitpunkt der Signierung*. Sie sagt nichts darüber aus, was zuvor geschehen ist. Wurde die Eingabe vor der Extraktion erstellt, ist der Bericht kryptografisch einwandfrei, aber sachlich falsch. Das Tool stellt beide Ergebnisse identisch dar. ### Die Rechenschaftslücke Stellen Sie sich einen Rechtsraum vor, in dem forensische Geräte im Rahmen öffentlicher Ausschreibungen beschafft werden – wobei die Modelle, Konfigurationen und Beschaffungszeitpläne aus öffentlichen Unterlagen ersichtlich sind. In dem kein Gesetz vorschreibt, dass die Geräte über die aktuelle Firmware verfügen müssen. In dem Sachverständige vor Gericht keine persönliche strafrechtliche Haftung für ihre Schlussfolgerungen tragen. In den Vereinigten Staaten und im Vereinigten Königreich trägt ein forensischer Sachverständiger für jede Handlung, die er im Umgang mit Beweismitteln vornimmt, die persönliche rechtliche Verantwortung. Diese Verantwortung – und nicht die Software – ist es, die das Funktionieren der Beweiskette gewährleistet. Nimmt man sie weg, steht dasselbe Werkzeug, das der Gerechtigkeit dient, dem Lizenzinhaber zur Verfügung, um damit jeden beliebigen Zweck zu verfolgen, den er für zweckmäßig hält. **Technische Umsetzung des Zustands vor dem Auslösen der Vorrichtung** Wenn eine betroffene Person mit ausreichendem Vorlauf von einem bevorstehenden Anfall erfährt – sieben Tage sind mehr als genug –, sind Panikreaktionen sowohl kontraproduktiv als auch in manchen Rechtsordnungen als eigenständiger Straftatbestand angesehen. Eine vorbereitete betroffene Person mit technischem Zugang und entsprechenden Ressourcen handelt anders: Sie schafft einen Gerätestatus. **Das Firmware-Fenster.** Die Spitzenmodelle Samsung Galaxy S Ultra und Z Fold – Knox-Schutz, gesperrter Bootloader. Die Zeitspanne zwischen der Veröffentlichung eines Sicherheitspatches und dessen Verfügbarkeit für ein bestimmtes regionales Gerät beträgt in der Regel einen Monat. Bei neu auf den Markt gebrachten Modellen ist dieses Zeitfenster in den ersten drei bis vier Monaten deutlich größer. Uns ist keine Rechtsordnung bekannt, die gesetzlich vorschreibt, dass auf einem privaten Gerät die aktuelle Firmware installiert sein muss. **Tools zur Service-Level-Verwaltung.** Kommerzielle Wartungssoftware ermöglicht während dieses Zeitfensters einen Zugriff auf die Geräte auf niedriger Ebene, ohne die Knox-Manipulationsindikatoren auszulösen, nach denen ein forensischer Gutachter suchen würde. **Erstellung einer Zeitachse.** Eine vollständige Gerätesicherung, die auf einem Emulator bereitgestellt wird, sowie skriptgesteuerte Zeitmanipulation und Netzwerkisolierung ermöglichen die Erstellung einer gewünschten Zeitachse für Ereignisse: Anrufe, Nachrichten, Anwendungsaktivitäten, GPS-Koordinaten. **Standortbestimmung ohne Mobilfunk-Exposition.** Die Abrechnungsdaten von Mobilfunkmasten lassen sich unabhängig überprüfen – greifen Sie nicht darauf zurück. Stattdessen werden Verbindungen zu öffentlichen WLAN-Zugangspunkten protokolliert. Die MAC-Adressen öffentlicher Infrastrukturen werden von großen Technologiekonzernen systematisch erfasst und weitergegeben. Aus öffentlich zugänglichen Daten lässt sich eine lückenlose geografische Kette für jeden beliebigen Zeitraum zusammenstellen. **Kontowechsel.** Die vollständige Löschung eines Samsung-Kontos dauert etwa sieben Tage. Es wird ein neues Konto erstellt und das vorbereitete Backup wiederhergestellt. Es treten keine Konflikte hinsichtlich der Systemintegrität auf, der Bootloader bleibt unberührt und es wird kein Manipulationsflag ausgelöst. **Insbesondere Telegram.** Bei bestimmten Gerätefamilien können die Anwendungsdatenbank und der Cache – Unterhaltungen, Medien, Metadaten zu Benachrichtigungen, Aktivitätsmuster – auf Betriebssystemebene ohne klassischen Root-Zugriff ersetzt werden. Eine eingehende Analyse durch Spezialisten, die einen vollständigen Rohdatendump untersuchen, könnte möglicherweise Anomalien aufdecken. Diese Analyse ist kostspielig, zeitaufwendig und wird unserer Erfahrung nach in Standardverfahren so gut wie nie angefordert. ### Müll rein, Müll raus Der signierte Bericht ordnet die extrahierten Bytes dieser Erfassung zu. Der frühere Geräteverlauf wird anhand von Datensätzen aus dem vorangegangenen Zeitraum ausgewertet. Die darauf folgende Kette – Sachverständige, die die Ergebnisse des Tools auswerten, Analysen verfassen und Schlussfolgerungen unterzeichnen – ist in jedem einzelnen Schritt ebenso korrekt. Niemand in dieser Kette lügt. Niemand in dieser Kette beweist historische Wahrheit. Jeder Beteiligte gibt genau das wieder, was er aus dem vorherigen Schritt erhalten hat. Ein Doktorgrad ist ein Nachweis für abgeschlossene Forschungsarbeiten in der Vergangenheit. Er ist kein Nachweis für aktuelle Kompetenz und kann eine mathematisch nicht überprüfbare Behauptung nicht wahr machen. Wir schlagen einen anderen Maßstab vor: **Vertraut der Mathematik, nicht dem Titel.** ### Zero Trust als Beweisgrundlage In der Informationssicherheit bedeutet „Zero Trust“, dass keinem Akteur standardmäßig vertraut wird, unabhängig von seiner Position oder seinen Berechtigungen – jede Behauptung muss unabhängig überprüft werden. Wir schlagen vor, dasselbe Prinzip auf digitale Beweismittel anzuwenden. Vertrauen ist eine Schwachstelle. Wenn eine Behauptung nicht unabhängig und mathematisch überprüft werden kann, handelt es sich um eine Vertrauensbehauptung – und Vertrauen kann fehlgeleitet, erkauft oder erzwungen werden. Speziell in Bezug auf Telegram-Exportnachweise gilt: Vertrauen Sie weder uns noch Telegram, noch dem Analysten, noch dem Sachverständigen. Überprüfen Sie die Berechnungen selbst. So sieht das in der Praxis aus: TgWitness-Bescheinigungen beziehen sich auf das SLSA v1 Level 3-Modell – eine von der GitHub Actions-Infrastruktur signierte Build-Herkunftsnachweis, der an einen bestimmten Commit-Hash und einen bestimmten Workflow-Lauf gebunden ist. Die Bescheinigung kann unabhängig überprüft werden, ohne dass man einer der an der Erfassung beteiligten Personen vertrauen muss. Sie beseitigt nicht alle Vertrauensannahmen – sie dokumentiert vielmehr genau, welche Annahmen bestehen bleiben und um welche es sich dabei handelt. **Über Sachverständige und finanzielle Anreize** Ein Anwalt, der eine Partei in einem Rechtsstreit vertritt und sich gleichzeitig als neutraler Sachverständiger in demselben Verfahren präsentiert, wobei seine Vergütung vom Ausgang des Verfahrens für seinen Mandanten abhängt: Das ist ein struktureller Widerspruch. Wir erheben keine Vorwürfe gegen einzelne Personen. Wir fragen, warum diese Struktur als akzeptabel gilt und warum sie so selten hinterfragt wird. Das übliche Gegenargument: *Wie viel würde es sie kosten, zu lügen?* In Rechtsordnungen, in denen das Recht auf Löschung und das Recht auf Vergessenwerden gelten, sind die praktischen Kosten für die Verfolgung von Sachverständigen, die einen Meineid begangen haben, häufig sehr gering. Wer Bedenken hinsichtlich einer falschen Sachverständigenaussage äußert, erhält in der Regel ein juristisches Schreiben, in dem er aufgefordert wird, diese Bedenken nicht weiter zu verfolgen. Dieses Verfahren ist für die Person, die die Bedenken äußert, kostspielig. Für den Sachverständigen ist es hingegen nicht kostspielig. Wir wollen damit nicht sagen, dass alle Sachverständigen unehrlich sind. Wir wollen vielmehr darauf hinweisen, dass die Aussage „Es würde sie zu viel kosten, zu lügen“ kein Beweismaßstab ist. Es handelt sich vielmehr um einen Vertrauensmaßstab. Und Vertrauen ist eine Schwachstelle. Eine Person, die eine TgWitness-Bescheinigung anfechten möchte, müsste die kryptografische Signatur manipulieren, die Signaturinfrastruktur von GitHub davon überzeugen, rückwirkend etwas zu bescheinigen, was dort nie ausgeführt wurde, und dies vor dem Hintergrund einer unveränderlichen Commit-Historie – und zwar in Anwesenheit eines Zeugen. Sollten diese Möglichkeiten tatsächlich bestehen und lediglich durch die Schwierigkeiten bei der Bedienung von PDF-Software verdeckt worden sein, würden wir einen entsprechenden Nachweis sehr begrüßen. Wir behaupten nicht, dass unsere Tools besser sind – wir haben kein kommerzielles Produkt und auch kein Interesse daran. Wir haben ein Problem festgestellt: die weit verbreitete Annahme, dass die Ergebnisse forensischer Software der historischen Wahrheit entsprechen und dass die Einschätzungen von Experten als Beweis gelten. Diese Annahme wird auf technischer Ebene in den Verfahren, in denen sie am wichtigsten ist, selten hinterfragt. Dieses Experiment ist ein kontrollierter Datenpunkt. Die Mathematik nimmt zu Titeln keine Stellung. ## Laden Sie die Unterlagen herunter Videos und ZIP-Dateien werden auf [phishdestroy.io](https://phishdestroy.io/) gehostet. Wählen Sie die Dateien aus, die Sie überprüfen möchten. Beide ZIP-Dateien enthalten ausgewählte Testdaten und Dokumentation. Das Bearbeitungstool, der Quellcode, die Konfiguration, die Anmeldedaten und die Sitzungen sind davon ausgenommen. ### Vor und nach dem Export Sieben Testkonversationen: HTML, JSON, eingebundene Bilder und die Standard-Viewer-Assets. Enthält ein Dateimanifest und ein ausgewähltes Änderungsprotokoll. [Testexporte · ZIP · 3,0 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-paired-files.zip) Kein Video. Kein Bearbeitungsprogramm. ### Video- und Testexporte Die vollständige Originalaufnahme, der zweiminütige Film, die beiden Exportdateien, die Erläuterung, die Überprüfung der Metadaten, die Bearbeitungskarte und die Prüfsummen. [Video + Test-Exporte · ZIP · 46,9 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-review-package.zip) Enthält die kleinere ZIP-Datei. Kein Bearbeitungsprogramm. **Was genau ist in der 46,9 MB großen ZIP-Datei enthalten?** - `video/ExportClinic_2026-11-03_12-50-40.mkv` — die unbearbeitete vollständige Aufnahme, 6:08,8. - `video/export-clinic-2min.mp4` — die Kurzfassung des Films, 1:59,7. - `data/export-clinic-paired-files.zip` — Entpacken Sie diese verschachtelte ZIP-Datei, um die `before/` und `modified/` Ordner. - `description/article-en.md` — die Erläuterung und die Grenzen. - `verification/` — vier JSON-/Markdown-Dateien, die die Bearbeitung der Karte, die Überprüfung der Metadaten und die Paketprüfung abdecken. - `README.md` und `SHA256SUMS.txt` — Anweisungen und Dateiprüfsummen lesen. Zehn Dateien im äußeren ZIP-Archiv. Die separate MP4-Datei in voller Länge wurde weggelassen, da die ursprüngliche MKV-Datei bereits die vollständige Aufzeichnung enthält. Standardmäßig `js/script.js` In jedem exportierten Chat befindet sich die unveränderte HTML-Viewer-Datei von Telegram. ### Einzelne Videodateien - [Original-MKV · 6:08,8 · 29,6 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) – byteweise identische Quellaufnahme. - [MP4 vollständig öffnen · 6:08,8 · 29,9 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-full.mp4) – eine browserfreundliche Container-Konvertierung ohne Neukodierung des Videos. - [Komprimierte MP4-Datei öffnen · 1:59,7 · 14,3 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) – Änderungen der Wiedergabegeschwindigkeit sind gekennzeichnet. [Prüfsummen herunterladen](https://phishdestroy.io/tgwitness/assets/export-clinic/SHA256SUMS.txt)[Karte zur Videobearbeitung](https://phishdestroy.io/tgwitness/assets/export-clinic/recording-manifest.json?v=42fbcde007f1)[Manifest für Dateipaare](https://phishdestroy.io/tgwitness/assets/export-clinic/review-file-manifest.json?v=c725b2ecbe50)[Überprüfung der Metadaten](https://phishdestroy.io/tgwitness/assets/export-clinic/original-metadata-notes.md)[Aktueller Leitfaden zur Erläuterung und Überprüfung](https://phishdestroy.io/tgwitness/assets/export-clinic/article-en.md) Die ZIP-Datei mit der Rezension zum Herunterladen enthält die ursprüngliche README-Datei und den Artikel. Die aktuelle Anleitung umfasst die Anleitung zur Erfassung und Überprüfung von TgWitness. **So wurde „vorher“ zusammengestellt:** Dies ist eine rekonstruierte Ordnerstruktur aus der Zeit vor der Änderung. Geänderte Dateien wurden Byte für Byte aus den aufbewahrten Sicherungskopien wiederhergestellt und mit ihren gespeicherten Hashwerten abgeglichen. Unveränderte Viewer-Assets wurden aus dem erfassten Export kopiert. Das Dateimanifest dokumentiert die bereitgestellten Versionen. In den sieben Unterhaltungen gibt es insgesamt 45 Nachrichtenaufzeichnungen; 17 Aufzeichnungen und 32 Dateien weichen voneinander ab. Jede Version enthält 340 Dateien. PDF-Anhänge wurden bei den protokollierten Exporten nicht ausgewählt und sind in diesen Archiven nicht enthalten. ## Details zum Experiment **Wo hat die Änderung stattgefunden?** Ein lokaler Helfer hat Dateien geändert, die von Telegram Desktop erstellt wurden. Die ausführbare Datei des offiziellen Clients und die in Telegram angezeigten Chats blieben unverändert. Der Vergleich zeigt die ursprünglichen Nachrichten neben dem geänderten Export. **Handelt es sich hierbei um vollständige Kontoexporte?** Nein. Die Materialien umfassen sieben eigene Testgespräche: einen privaten Chat, einen Bot, eine private Gruppe, private und öffentliche Supergruppen sowie private und öffentliche Kanäle. Sie enthalten 45 Nachrichtenaufzeichnungen. Es sind keine nicht damit in Zusammenhang stehenden Chats, Kontakte oder das kontoweite Archiv enthalten. **Sind die PDF-Anhänge enthalten?** Nein. Die gespeicherten Exporteinstellungen schlossen Dateianhänge aus. Die Testnachrichten und Bilder beziehen sich auf eine PDF-Datei, doch diese Archive enthalten diese PDF-Datei nicht. Diese Unterscheidung bleibt in den Dateien und der Beschreibung erhalten. **Ist das Umbauwerkzeug im Lieferumfang enthalten?** Es sind keine ausführbaren Dateien, Hilfsquellcode, Transformationskonfigurationen, Sitzungsdaten, Anmeldedaten oder vollständige Betriebsprotokolle enthalten. Bei den kleinen JavaScript-Dateien in den beiden Exportdateien handelt es sich um die unveränderten Standard-HTML-Viewer-Ressourcen von Telegram, die überprüft wurden und in beiden Versionen identisch sind. **Wie überprüfe ich die heruntergeladenen Dateien?** Berechnen Sie den SHA-256-Wert jeder Datei und vergleichen Sie ihn mit den veröffentlichten Prüfsummen. Übereinstimmende Werte bestätigen, dass Sie über die veröffentlichten Byte-Daten verfügen. Das Dateimanifest listet beide Exportversionen auf; die Videobearbeitungskarte dokumentiert den gekürzten Film. Die Aufzeichnungszeiten stammen von der Host-Uhr. **Wie sorgt TgWitness dafür, dass die Aufzeichnungen überprüfbar sind?** Der Collector signiert Einträge, sobald er Daten von Telegram empfängt. Das Archiv enthält das Protokoll, Datei-Hashes und Verifizierungsdaten. Speichere einen Schlüssel-Fingerabdruck und einen Checkpoint separat und vergleiche anschließend die Kopie des Empfängers damit. Die GitHub-Erfassung umfasst zusätzlich eine Überprüfung des genehmigten Erfassungsworkflows und seiner Ergebnisse. [Befolge die Schritte zur Überprüfung ↗](https://phishdestroy.io/tgwitness/de/docs/exports/) Für dieses Experiment wurden die sieben Gespräche vorbereitet. Die Aufzeichnung, die zugehörigen Exportdateien und das Änderungsprotokoll dokumentieren die oben beschriebenen Änderungen an den lokalen Dateien. Kontrolliertes Experiment mit lokalen Dateien · 3. November 2026 Vollständiger SHA-256-Hash kopiert --- # 56 329 Nachrichten. Canonical page: https://phishdestroy.io/tgwitness/de/docs/validation/ 56.329 Telegram-Nachrichten wurden in zwei gemessenen Durchläufen exportiert. Vergleichen Sie die Anzahl der Nachrichten, die Erfassungsgeschwindigkeit, die Exportdauer und die signierten Archive. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) TGWITNESS / REAL EXPORTS Erfasst. Exportiert. Zwei aktuelle Telegram-Exporte – mit Zeitangaben von der Erfassung bis zum fertigen Archiv. Sehen Sie sich den Arbeitsbereich an, prüfen Sie die Zahlen und laden Sie ein Beispiel herunter. [Entdecken Sie die Demo](https://phishdestroy.github.io/TgWitness/demo/?lang=en)[Beispiel-Export herunterladen](https://phishdestroy.github.io/TgWitness/demo/downloads/tgwitness-demo.zip) Die interaktive Demo und das Beispiel verwenden fiktive Nachrichten. Die folgenden Messwerte stammen aus tatsächlichen Exportvorgängen. TGW / 001 Aufgezeichneter Schnappschuss · keine Live-Überwachung Überprüft am 2026-11-06 18:37:38 UTC Geprüfte Überarbeitung [92e539af](https://github.com/phishdestroy/TgWitness/commit/92e539af40d8368d198ff5e040f1d876f2c1310e) Text + Metadaten · signierte Archive **56 329**Exportierte Nachrichten **160.531**Beiträge/s · Bester Sammel-Lauf **2**Signierte Exportläufe **3**Überprüfte Server Server AWARP · 2 Konten **27 030**Exportierte Nachrichten **142.983**Nachrichten/s Nur Abholung 189.043 s Vollständiger Export 211.647 s Server BWARP · 2 Konten **29 299**Exportierte Nachrichten **160.531**Nachrichten/s Nur Abholung 182.513 s Vollständiger Export 206.650 s 01 / ## Gemessen an den tatsächlichen Exporten. Ein neuer Export pro Server, wobei auf jedem Server zwei Konten verwendet werden. Text und Metadaten über WARP; Anhänge ausgenommen. Nachrichten/s Server A**142.983 Nachrichten/s** Server B**160.531 Nachrichten/s** Server C Nicht gemessen — Nachrichten ÷ Abholzeit. Vorbereitung, Auswahl und Verpackung fallen nicht in diesen Zeitraum. Nachrichten ÷ Gesamtdauer des gemessenen Versands, einschließlich Vorbereitung und Verpackung. Für Server C liegt kein Beleg über die Erhebung der Benchmark-Gebühr vor. In keinem der beiden Durchläufe gab es wiederverwendete Datensätze oder doppelte IDs. Auf Server A lief zudem im Hintergrund ein Lesevorgang mit geschützter Quelle. Die „FloodWait“-Pausen wurden eingehalten: A · 4, B · 3. **Genaue Messwerte und Archiv-Hashes** | Server | Nachrichten | Nur Abholung | Vollständiger Export | | --- | --- | --- | --- | | Server A | 27 030 | 189.043 s **142.983 Nachrichten/s** | 211.647 s **127.713 Nachrichten/s** | | 2026-11-06T18:26:51.500Z → 2026-11-06T18:30:23.228Z SHA-256 `20e507fc68446680ed002fd486d0968a944ec0c71e02f937331ae2b19ab4cd66` | | | | | Server B | 29 299 | 182.513 s **160.531 Nachrichten/s** | 206.650 s **141.781 Nachrichten/s** | | 2026-11-06T18:25:40.419Z → 2026-11-06T18:29:07.173Z SHA-256 `824601b502762efaabb8ff9afdb1e8d7fff189862ef2cbc4d8d26d0d68c83e4c` | | | | Beide Archive haben die Überprüfung mit einem festgelegten Collector-Schlüssel bestanden. 02 / ## Alle drei, mit genauer Angabe des Geltungsbereichs. Auf jedem Server wurden die Integrität der Protokolle, die Dateiberechtigungen, der Speicherplatz, die Netzwerkrouten und die laufenden Prozesse überprüft. A Geprüft ### Server A Erfassung und Export 8 vCPU · 16 GiB · Ubuntu 24.04 Zeitschriften geprüft 21 Ereignisse im Journal 4 517 Checkpoints 147 Benchmark für die Erfassung neuer Daten, Überprüfung des Archivs und Integritätsprüfungen der Sicherungskopien. B Geprüft ### Server B Erfassung und Export 8 vCPU · 16 GiB · Ubuntu 24.04 Zeitschriften geprüft 21 Ereignisse im Journal 1 993 Checkpoints 147 Benchmark für die Erfassung neuer Daten, Überprüfung des Archivs und Integritätsprüfungen der Sicherungskopien. C Geprüft ### Server C Panel und verschachtelte VM 8 vCPU · 32 GiB · Ubuntu 24.04 Zeitschriften geprüft 14 Ereignisse im Journal 7 185 Checkpoints 973 Panel-Authentifizierung, Loopback-Bindung und eine verschachtelte VM wurden überprüft. Auf diesem Server wurde kein Erfassungs-Benchmark durchgeführt. **Testergebnisse, Umfang und technische Hinweise** 03 / ## Pässe und Lücken, Seite an Seite. Aktuelles Ergebnis pro pytest-Fall, einschließlich Wiederholungsläufe. Eigenständige Browser- und Evidence-Suiten werden im Folgenden separat gezählt; sie werden nicht zur pytest-Gesamtsumme hinzugerechnet. **1 585**Bestanden **3**Fehlgeschlagen **37**Übersprungen Drei Browser-Capture-Tests erfordern die Chromium-Sandbox, die diese Container nicht bereitstellen; die Sandbox bleibt aktiviert. Die 37 Plattform-Übersprünge werden getrennt von den bestandenen Tests gezählt. - Browser-Suiten**102 bestanden** - Schnittstellen-Suiten**66 bestanden** - Beweismittelpakete**15 bestanden** - Website-Pakete**9 bestanden** - Weitere Suiten**13 bestanden** 04 / ## Geltungsbereich dieser Momentaufnahme. 1. 01 ### Browser-Sandbox Drei Browser-Prüfungen warten auf eine Umgebung mit der Chromium-Sandbox. 2. 02 ### Aktualität der Sicherungen 42 Sicherungsprotokolle und 51.285 Dateien haben die Integritätsprüfungen bestanden. Zum Zeitpunkt der Momentaufnahme lag die letzte Sicherung 3.507 Ereignisse hinter der Live-Erfassung zurück. 3. 03 ### Netzabdeckung 24 von 40 Routen erfüllten die Voraussetzungen. Die übrigen 16 Konten blieben getrennt, anstatt auf eine direkte Verbindung zurückzugreifen. 4. 04 ### Freizeit Das aufbewahrte Zeugenprotokoll hat die Integritätsprüfungen bestanden. Der letzte Eintrag erfolgte am 6. November um 07:27 UTC. 5. 05 ### Sicherheitsmaßnahmen Im Sicherheitsmodell werden der Schlüsselschutz, der Kontoschutz, die dauerhafte Speicherung und die Freigabekontrollen beschrieben; die Ergebnisse dieser Prüfung sind im unterzeichneten Bericht aufgeführt. 6. 06 ### Geprüfte Server Die drei überprüften Server bilden den Gegenstand dieser Seite. 7. 07 ### Gemessene Arbeitsbelastung Zwei öffentliche Quellen, zwei einzelne Durchläufe, Text und Metadaten ohne Downloads von Anhängen. Server C lief ohne Messung der Erfassungsrate. Die jeweiligen Zahlen beziehen sich auf die jeweils erfasste Arbeitslast. 05 / ## Ein veralteter Datensatz, der sich auf die Zahlen zurückführen lässt. Messungen der Betreuer, signiert mit dem Audit-Schlüssel. Die JSON-Datei enthält ausschließlich aggregierte Daten. Quellen- und Kontoidentitäten, Nachrichteninhalte, Anmeldedaten und private Archive werden nicht veröffentlicht. 1. Die Quellversion festlegen und die installierte Version überprüfen. 2. In einen neuen Arbeitsbereich zusammenführen, ohne wiederverwendete Datensätze beizubehalten. 3. Erfassen Sie die Messwerte und die Intervalle für den vollständigen Export getrennt voneinander. 4. Überprüfen Sie das Archiv anhand seines festgelegten Schlüssels; speichern Sie den SHA-256-Hash. Getestete Version `92e539af40d8-83e41104669e` [Daten herunterladen ↓](https://phishdestroy.io/tgwitness/validation/snapshot.json) SIGNED AUDIT / ENGLISH ### Check the numbers. The English report includes the measured results, open findings and a reproducible signature check. [Read the report ↗](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)[Signed statement ↓](https://phishdestroy.io/tgwitness/validation/audit/PROOF.json)[Measurements CSV ↓](https://phishdestroy.github.io/TgWitness/validation/audit/MEASUREMENTS.csv)[Python verifier ↓](https://phishdestroy.github.io/TgWitness/validation/audit/VERIFY.py)[File checksums ↓](https://phishdestroy.io/tgwitness/validation/audit/SHA256SUMS.txt) The signature binds the report and its measurements to the audit key; a change to any signed file fails VERIFY.py. The report records the completed audit at 19:08 UTC; the infrastructure snapshot above was taken earlier. **Zusammenfassungen von Quellbelegen** Diese Hashes identifizieren die aufbewahrten, signierten Belege der Messungen; die privaten Originale werden von den Betreibern aufbewahrt. - benchmark-1.json`66cdf2db25901ee1f780a0e2d14b9b84888dbe525bff73bae19819b217f95d0c` - benchmark-2.json`ad2978fe2a7563476da43293eaaf5f498ee12522f0ea3e401bc43205c64874d1` - test-totals.json`922cf87d9320b149f2fc6791fc05f98335ec0952f9258e6eaeff179aeef33bb1` - infra-summary.json`325d390ef752b15f44203f97348863e24f0f631fe88998d5e1f398a5311a9339` In jeder Abbildung sind die jeweilige Revision, die Arbeitslast und die Umgebung angegeben. Eine nicht durchgeführte Messung wird als fehlend ausgewiesen. --- # TgWitness: Telegram Export, OSINT & Verification Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/ Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/llms.txt) Installation mit einem Befehl oder Erfassung über GitHub Actions. Machen Sie sich mit den Untersuchungsoptionen, dem veröffentlichten Umfang und dem, was ein Archiv verifiziert, vertraut. TgWitness ist ein Open-Source-Telegram-Exporter und Untersuchungsarbeitsbereich. Installieren Sie es mit einem einzigen Befehl, verbinden Sie ein Konto, wählen Sie die Chats aus und exportieren Sie ein signiertes Archiv. Es unterstützt zudem die vorübergehende Datenerfassung über GitHub Actions sowie die Fortsetzung von Untersuchungen mit gespeicherten Bearbeitungen, Löschbeobachtungen, Suchfunktionen und Berichten. ## Beginnen Sie mit der Aufgabe, die Sie haben | Ihre Aufgabe | Kürzester Weg | Was Sie erhalten | | --- | --- | --- | | Eine Unterhaltung oder ein Konto speichern | Installieren, ein Konto verbinden, den Exportumfang auswählen | Ein signiertes Archiv mit dem ausgewählten Verlauf, den Ergebnissen der Datenerhebung und dem Verifizierungsmaterial | | Auf einem temporären Runner sammeln | Verwenden Sie GitHub Actions, um Daten zu erfassen, autorisieren Sie eine neue Sitzung und wählen Sie den Geltungsbereich aus. | Ein verschlüsseltes Archiv mit Herkunftsnachweis über den GitHub-Workflow | | Verfolgen Sie die Änderungen im Zeitverlauf | Die Beobachtung für ausgewählte Chats weiterlaufen lassen | Gespeicherte Versionen, Löschhinweise, Anhänge und aufgezeichnete Abdeckung | | Untersuchen und Ergebnisse teilen | Durchsuchen Sie das Archiv, nutzen Sie das Case Board und konfigurieren Sie einen Bericht oder eine Kopie zum Teilen. | Quellenverlinkte Ergebnisse und eine für den Empfänger geeignete, überprüfbare Übergabe | ### Installation mit einem einzigen Befehl Das Installationsprogramm enthält Python und die erforderlichen Abhängigkeiten. Ein Checkout des Quellcodes, Docker, ein KI- Anbieter und ein unabhängiger Witness sind optionale Optionen, keine Voraussetzungen für die Einrichtung. Linux / macOS: ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Windows, in PowerShell oder der Eingabeaufforderung: ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Öffnen Sie das Fenster, verbinden Sie Ihr Telegram-Konto und wählen Sie den Erfassungsumfang aus. Die Installation startet die Erfassung nicht automatisch. Die [Installationsanleitung](https://phishdestroy.io/tgwitness/de/docs/reference/installation/) erläutert den lokalen Zugriff, Server, Updates und die Überprüfung der heruntergeladenen Version. Für eine temporäre Ausführung folgen Sie [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Dieser Workflow erfordert einen GitHub-Fork, eine Autorisierung und ein Archivpasswort. Auf der Capture-Seite werden diese Schritte sowie die verfügbare Sitzungsdauer vor der Ausführung erläutert. Laden Sie das resultierende Archiv und das zugehörige Verifizierungsmaterial herunter und bewahren Sie es auf. ## Weitere Einstellungen, falls für die Aufgabe erforderlich Für den Export eines einzelnen Chats sind ein Konto und ein ausgewählter Umfang erforderlich. Fortlaufende Beobachtung, mehrere Konten, Proxys, Richtlinien für Anhänge, Berichtsgestaltung, Zugriff für Prüfer, externe Zeitstempel und externe Speicherung dienen unterschiedlichen Ermittlungs- und Übergabeanforderungen. Konfigurieren Sie diese Funktionen, sofern sie relevant sind. Geltungsbereich, Berechtigungen und minimierte Freigabekopien helfen Betreibern bei der Auswahl dessen, was erfasst und offengelegt werden soll. Leitlinien zur Rechtshoheit und Berichtseinstellungen dokumentieren das ausgewählte Verfahren und die Vorbereitungsschritte. Siehe [Kontoexport](https://phishdestroy.io/tgwitness/de/docs/reference/account-export/), [Zugriff](https://phishdestroy.io/tgwitness/de/docs/reference/access/) und [Berichtskonfiguration](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/). Die Anwendung läuft auf dem ausgewählten Computer oder Server. Die grundlegende Erfassung erfordert keine GPU oder ein LLM. Optionale OCR, Transkription und KI-Analyse haben ihre eigenen Ressourcenanforderungen. Passen Sie die Bereitstellung an die Nachrichtenrate, Anhänge, den gespeicherten Verlauf und die Anzahl gleichzeitiger Konten an. ## Bewahren Sie die Aufzeichnungen auf, wem auch immer sie helfen mögen Der Zweck besteht darin, beobachtetes Material, Kontext und Änderungen zu bewahren, unabhängig davon, wessen Position sie stützen. Beweismittel können die eigene Darstellung der Ereignisse durch den Sammler in Frage stellen. Halten Sie Quellbeobachtungen, fehlende Abdeckung und analytische Schlussfolgerungen identifizierbar, damit eine andere Person dasselbe Material bewerten kann. Die Logik lautet: für das Konto sichtbare Beobachtung → signiertes Protokoll → Export → Überprüfung durch den Empfänger. Gespeicherte Bearbeitungen fügen Versionen hinzu. Gelöschte Beobachtungen behalten zuvor erfasste Inhalte bei. Abdeckungsaufzeichnungen zeigen bekannte Unterbrechungen auf. Berichte und KI- Analysen verweisen auf gespeicherte Quellen zurück; eine Interpretation wird nicht zur Quellenbeobachtung, nur weil sie in einem signierten Bericht erscheint. | Verifizierungsprüfung | Was ein Empfänger feststellen kann | | --- | --- | | Datei-Hashes, Signaturen und Journal-Kette | Die bereitgestellten Datensätze und Dateien stimmen mit dem erwarteten Schlüssel und den Journalgrenzen überein. | | Ein separat gespeicherter Checkpoint oder Witness | Das Archiv stimmt mit einem zuvor gespeicherten Journalzustand überein | | Ein verifizierter externer Zeitstempel | Die referenzierten Bytes existierten zum Zeitpunkt des Zeitstempels unter den angegebenen Vertrauensannahmen. | | GitHub-Erfassungsbescheinigung | Das Archiv entspricht dem genehmigten Workflow, der Collector-Revision und dem aufgezeichneten Digest. | | Intel TDX-Attestierung | Das Zitat, der Plattformstatus, die erwarteten Betriebssystem-/Anwendungsmesswerte, die Aktualität und die Identität des Collectors bestehen ihre konfigurierten Prüfungen. | Bei der beglaubigten Erfassung sind die authentifizierte Telegram-Verbindung des zugelassenen Collectors und dessen Ausgabe an die geprüfte Ausführungsumgebung gebunden. Das Archiv bewahrt den erfassten Inhalt und Kontext auf; Berichte und Analysen beziehen sich auf diese Datensätze. Verwenden Sie die modusspezifischen Verifizierungsschritte und vertrauenswürdigen Eingaben aus [dem Vertrauensleitfaden](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) und [dem Beweisformat](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/). ## Veröffentlichte Skalierbarkeit und gemessene Leistung Die folgenden Ergebnisse beschreiben unterschiedliche Arbeitslasten und Zeitpunkte. Die Zahlenangaben sind nicht austauschbar: Ein Protokollereignis entspricht nicht zwangsläufig einer einzelnen Telegram-Nachricht. | Datum | Arbeitsaufwand | Veröffentlichtes Ergebnis | Was wurde gemessen? | | --- | --- | --- | --- | | 1. November 2026 | Laufender Server, zehn Arbeitsbereichsdatenbanken | 1,610,818-Protokollaufzeichnungen; 900,232-Ereignisse bei neuen Nachrichten, 80,683-Bearbeitungsereignisse und 400,536-Löschereignisse | Schreibgeschütztes Verzeichnis der gespeicherten Journale | | 5. November 2026 | Suche in synthetischen 1,000,000-Nachrichten in 200-Chats | Index erstellt in 71 Sekunden; mediane Suchzeiten pro Abfrage von 9–190 ms | Benchmark für die lokale Suche | | 6. November 2026 | Zwei aktuelle, echte Telegram-Exporte | 27,030- und 29,299-Meldungen; 56,329 in beiden Durchläufen | Zwei Konten pro Durchlauf über WARP, Text und Metadaten, keine Downloads von Anhängen | | 6. November 2026 | Die gleichen beiden Exporte, einschließlich Vorbereitung und Verpackung | 127.713- und 141.781-Nachrichten pro Sekunde | Gemessene Voll-Export-Raten; beide Archive wurden anhand der festgesteckten Schlüssel verifiziert | Der [Verifizierungsdatensatz](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) enthält die Serverbestandsliste, Live- Erfassungsprüfungen und Suchmessungen. [Die Exportleistung](https://phishdestroy.io/tgwitness/docs/validation/) veröffentlicht die beiden tatsächlichen Durchläufe, die Hardware, die Dauer, Archiv-Hashes und signierte Messdateien, jeweils mit der aufgezeichneten Revision und den Bedingungen. Die [Public-History-Qualifikation](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) erfasst zudem **48 verifizierte Archive mit 3,598,381 Datensätzen** aus einer Eingabeliste mit 50 Quellen und 40 Konto-Arbeitsbereichen. Die Quelle A mit acht Konten erfasste **768,007 Verlaufsdatensätze in 1,117.082 Sekunden**, einschließlich Wartezeiten: **687.512 Datensätze/Sekunde**, wobei das Herunterladen von Anhängen deaktiviert war. Der gesamte Versuch, einschließlich der Validierung, dauerte 1,574.920 Sekunden. Diese Messungen beschreiben diese Arbeitslast neben den oben genannten kleineren Fresh-Export-Beispielen. ### Testverlauf und -dauer TgWitness wurde über einen Zeitraum von etwa sechs Monaten entwickelt und getestet. Zunächst entstanden der Collector, das signierte Protokoll und der Verifier; das Web-Panel und die Zusatzmodule wurden später darauf aufbauend entwickelt. Dieses Repository wurde am 29. Oktober 2026 neu für die Veröffentlichung angelegt und basiert auf dem bestehenden Code, sodass sein Alter nicht dem Alter des Projekts ([Entwicklungsgeschichte](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)) entspricht. Die kumulierte Testlast liegt in der Größenordnung von 100 Millionen, einschließlich früherer Durchläufe, Fehler, Korrekturen und wiederholter Validierungen. Ausgewählte Durchläufe, jeweils mit eigener Revision, Methode und Ergebnis, sind in den [datierten öffentlichen Messungen](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements) dokumentiert. ## Den Status der Lesbarkeit genau erfassen Bewerten Sie jeden Workflow anhand seiner Implementierung, des veröffentlichten Builds und der aufgezeichneten Tests. Die Quelle ist derzeit als Vorschau gekennzeichnet. Diese Release-Kennzeichnung existiert parallel zu funktionierenden Datensammlungen, Exporten, unabhängigen Verifizierungen und veröffentlichten Skalenmessungen . Eine Vorschau-Funktion und ein validierter Workflow können in derselben Anwendung vorhanden sein; beschreiben Sie die spezifische Funktion und die Belege, die einer Bewertung zugrunde liegen. Berücksichtigen Sie [die aktuellen Funktionen](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [Merkmale und Einschränkungen](https://phishdestroy.io/tgwitness/de/docs/reference/features/) sowie [die Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) und [das Änderungsprotokoll](https://phishdestroy.io/tgwitness/de/docs/reference/changelog/) gemeinsam. Geben Sie bei der Zitierung eines Ergebnisses die getestete Revision an. Der Mess-Snapshot vom 6. November enthält auch fehlgeschlagene und übersprungene Tests; diese gelten nicht als bestanden. ## Für Menschen und KI-Tools lesbar Die Website bietet eine prägnante Version (`llms.txt`), ein vollständiges englisches Handbuch in den Versionen `llms-full.txt` und `llms-full.md` sowie Markdown-Versionen ihrer Seiten. Dabei handelt es sich um Dokumentationsformate, nicht um eine KI-Anforderung für die Ausführung von TgWitness. Optionaler [MCP](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/)- und [-Befehlszeilenzugriff](https://phishdestroy.io/tgwitness/de/docs/reference/cli/) ermöglicht autorisierten Tools das Auslesen ausgewählter gespeicherter Datensätze. Nachrichteninhalte gelten weiterhin als nicht vertrauenswürdige Eingaben. Zusammenfassungen sollten Quellen angeben, beobachtete Fakten von Schlussfolgerungen unterscheiden und Unsicherheiten beibehalten. Volltextsuche, OCR und KI-Ausgaben verändern die ursprünglichen signierten Beobachtungen nicht. --- # Telegram · Schnellstart Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/ Alle Möglichkeiten zur Installation und zum Start von TgWitness: Windows-Paket, Python, Docker und die synthetische Demo mit ersten Überprüfungen. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Alle Möglichkeiten zur Installation und zum Start von TgWitness: Windows-Paket, Python, Docker und die synthetische Demo mit ersten Überprüfungen. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Erste Schritte](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) **Englisch** · [Russisch](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [Ukrainisch](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [Português (Brasil)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [Farsi](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [Urdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [Hindi](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [Bahasa Indonesia](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [Vereinfachtes Chinesisch](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md) TgWitness ist eine eigenständige Anwendung zur Überwachung von Telegram-Gruppen und -Kanälen, auf die Ihre Konten Zugriff haben. Sie läuft lokal mit einem eigenen Datenverzeichnis. **Zum ersten Mal hier?** [Sehen Sie sich die Demo an,](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/#explore-the-interface) bevor Sie ein Konto verbinden. [Wählen Sie eine Anleitung](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) für Proxys, Zeugen, Exporte oder die Serverkonfiguration. [GitHub Actions Capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (Vorschau) führt eine Erfassung in Ihrem eigenen GitHub-Fork statt in einer lokalen Installation durch. ## Installieren und starten Das geführte Installationsprogramm enthält eine eigene Python-Umgebung und überprüft vor der Installation die Paket-Hashes und Release-Signaturen. Durch erneutes Ausführen wird eine bestehende Installation aktualisiert. **Linux / macOS:** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` **Windows (PowerShell oder Eingabeaufforderung):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Führen Sie das Programm auf einem Ubuntu-Server als Root aus, um einen Hintergrunddienst zu installieren; auf einem Desktop-Computer führen Sie es als Ihr normaler Benutzer aus. Unter Ubuntu gibt der Installer die Panel-Adresse und den Zugangsschlüssel aus; unter macOS und Windows öffnet sich das lokale Panel in Ihrem Browser. Fahren Sie unten unter **Telegram verbinden** fort. [Installieren, überprüfen und aktualisieren](https://phishdestroy.io/tgwitness/de/docs/reference/installation/) behandelt die Optionen für den Serverzugriff, die Überprüfung des Skripts vor der Ausführung sowie Aktualisierungen und die Deinstallation. ### Andere Methoden GitHub-Releases, der Quellcode und Docker sind Alternativen zum Installationsprogramm. Portierbare Downloads stehen nach Veröffentlichung eines Release-Builds zur Verfügung: | Host | Keine Installation erforderlich | Aus der Quelle: Python 3.11+ | Docker: Engine/Desktop mit Compose 2.20+ | | --- | --- | --- | --- | | Windows | `TgWitness--windows-amd64-portable.zip` aus den GitHub-Veröffentlichungen extrahieren, auf `TgWitness.cmd` doppelklicken | Doppelklicken Sie auf „`Start.cmd`“ | Doppelklicken Sie auf „`scripts\Docker.cmd`“ | | Linux / macOS | — | `sh start.sh` | `sh scripts/docker-start.sh` | Für die Quellcode-Methoden [laden Sie den aktuellen `main`-Branch herunter und entpacken Sie ihn](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) oder klonen Sie das Repository: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` `Start.cmd` bietet an, Python 3.12 für Ihren Windows-Benutzer zu installieren, falls kein passendes Python gefunden wird (über winget oder das signierte Installationsprogramm von python.org). `start.sh` gibt den genauen Installationsbefehl für Ihre Linux-Distribution oder macOS aus, falls Python fehlt. Beim ersten Start aus dem Quellcode wird `.venv` erstellt und die Abhängigkeiten werden automatisch installiert. Docker erstellt die Anwendung und startet sie im Hintergrund; ein Python-Host ist nicht erforderlich. „`scripts\Docker.cmd`“ und „`scripts/docker-start.sh`“ geben die Panel-Adresse und das Token aus, wenn der Container ordnungsgemäß läuft. Die entsprechenden Docker-Befehle auf jedem unterstützten Host lauten: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Öffnen Sie **http://127.0.0.1:8787**. Verwenden Sie das vom Docker-Helper ausgegebene Token oder den zweiten Docker-Befehl, oder lesen Sie **die Datei „data/live/panel-token.txt“** für eine portable oder Quellcode-Installation. Fahren Sie unten unter **„Telegram verbinden“** fort. Native und Docker-Installationen verwenden getrennte Speicher; beim Starten von Docker wird ein bereits vorhandenes natives Protokoll nicht importiert. Bei einem Server umfasst [die Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) automatisches HTTPS, Neustart, veröffentlichte Bilder, Updates und Backups. ## Entdecken Sie die Benutzeroberfläche 1. Führen Sie **„TgWitness-Demo.cmd“** im portablen Paket, **„scripts\Demo.cmd“** in einem Windows-Quellordner oder „`sh start.sh --demo` “ unter Linux/macOS aus. Beim Start aus dem Quellordner wird zunächst „`.venv` “ erstellt und die Abhängigkeiten werden installiert. 2. Open-**http://127.0.0.1:8787**. 3. Die lokale Demo öffnet das Beispielprotokoll automatisch. Für den direkten lokalen Zugriff ist keine Token-Kopie erforderlich. Die Beispielnachrichten sind fiktiv. Im Demomodus kann keine Verbindung zu einem echten Telegram-Konto hergestellt werden. ## Telegram verbinden > [!WARNUNG] **Verwenden Sie dedizierte Konten.** Telegram kann Konten aufgrund von Anfragevolumina, die es als übermäßig erachtet, einschränken oder dauerhaft sperren, unabhängig vom Client. Verbinden Sie Konten, die für die Beobachtung vorgesehen sind, anstatt persönliche oder wertvolle Konten, und erstellen Sie eine API-ID/einen Hash auf einem dedizierten Konto. 1. Falls die native Demo ausgeführt wird, beenden Sie diese und führen Sie **„Start.cmd“** oder „`sh start.sh`“ aus. Andernfalls lassen Sie die oben gestartete Live-Installation weiterlaufen. 2. Verwenden Sie das Panel-Token, um sich anzumelden. Bei [der ersten Einrichtung](https://phishdestroy.io/tgwitness/de/docs/reference/settings/) öffnet sich ein neuer Arbeitsbereich. Wählen Sie **Nur herunterladen**, **Chats verfolgen** oder **Beweismaterial für einen Fall**. 3. Überprüfen Sie die Verbindungsprüfung. Konfigurieren Sie bei Bedarf Ihren eigenen Proxy; die Verbindungseinstellungen bleiben nach der Einrichtung verfügbar. 4. Wählen Sie bei **„Connect Telegram**“ eine Telefonnummer, einen QR-Code, Kontodateien (TData, `.session`, StringSession, Konto-JSON) oder einen vollständigen Autorisierungsschlüssel aus. Geben Sie bei Aufforderung die Telegram-Bestätigung, den Code und das Passwort für die zweistufige Authentifizierung ein. 5. Überprüfen Sie das angezeigte Konto, wählen Sie die Chats aus und überprüfen Sie Ihre Einstellungen. Beenden Sie den Vorgang auf dem letzten Bildschirm. Bei **Nur herunterladen** startet **Export starten** einen einmaligen Export und öffnet Exporte, um den Fortschritt anzuzeigen; eine fortlaufende Beobachtung wird dadurch nicht aktiviert. Nach der Einrichtung ändert **Chats → Auswählen** die ausgewählten Chats. Unter **Einstellungen** werden die Erfassung und Dateien gesteuert; **Weitere Tools → Quellen** bietet die detaillierte Quellenliste auf Standard- oder Expertenebene. Die [Bedienungsanleitung](https://phishdestroy.io/tgwitness/de/docs/reference/panel/) beschreibt die sechs Hauptabschnitte und ihre kontextbezogenen Steuerelemente. **API-ID + Hash** sind optional: Der Arbeitsbereich verwendet sein gespeichertes oder importiertes Paar oder ein funktionierendes Paar aus dem integrierten Pool. Um Ihre eigene App zu verwenden, fügen Sie ein `API ID:API Hash`-Paar in das Feld API-ID ein. Fügen Sie für **den Auth-Schlüssel** alle 512 hexadezimalen Zeichen ein und wählen Sie die bereitgestellte DC-ID aus. Die Benutzer-ID ist optional und wird bei Eingabe überprüft. API-Zugangsdaten identifizieren Ihre Anwendung; sie autorisieren kein Konto an sich. Private Gruppen benötigen keinen öffentlichen Benutzernamen, aber Ihr Konto muss über Zugriffsrechte verfügen. Für bestehende Konten siehe [Konten und Sitzungsformate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/): Das Bedienfeld akzeptiert Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP für Einzelkonten sowie unterstützte Konto-JSON-Dateien. Wählen Sie eine Sitzung und die dazugehörige JSON-Datei gemeinsam aus, klicken Sie auf **Dateien prüfen** und anschließend auf **Konto verbinden**. Die QR-Anmeldung ist ebenfalls mit denselben optionalen API-Einstellungen verfügbar. TDLib, Bot-Sitzungen und CSV-/JSON- Kontobestände werden nicht unterstützt. Verwenden Sie für mehrere Konten **Konten → Konten importieren** und wählen Sie deren unterstützte Sitzungsdateien aus. Zugehörige JSON-Dateien werden anhand des Basisnamens zugeordnet; jedes importierte Konto erhält seinen eigenen Arbeitsbereich. Siehe [Massenimport und Kontogruppen](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#bulk-import-and-account-groups). Um ein weiteres Konto hinzuzufügen, klicken Sie auf **das +** neben der Kontoauswahl oder verwenden Sie **Konten → Konto hinzufügen**. Arbeitsbereiche verfügen über separate Sitzungen, Journale, Schlüssel, Quellen und Warteschlangen. Beim Wechseln der Ansicht laufen andere Collector-Instanzen weiter. Dasselbe Telegram-Konto kann in dieser Installation nicht zwei Arbeitsbereichen zugewiesen werden. Es gibt keine festgelegte Anzahl von Arbeitsbereichen; sie teilen sich einen Prozess, sodass die Kapazität von der Rechenleistung des Computers abhängt. Das Live-Panel-Token schützt den Zugriff auf Ihre Telegram-Berechtigungen und gespeicherte Daten; es ist unabhängig von den Anmeldedaten für die Telegram-API. Nur eine explizit gestartete, direkt aufgerufene lokale Demo erhält automatisch einen Eintrag. Eine Remote- oder Proxy-Demo verwendet weiterhin „ `data/demo/panel-token.txt`“. ## Überprüfen und exportieren - **Protokoll:** Beobachtungen nach Quelle und Ereignistyp suchen und filtern. - Wählen Sie ein Ereignis aus, um dessen Originaldatensatz, Zuordnung und gespeicherte Versionen einzusehen. - Die Bearbeitungsdetails zeigen den verfügbaren Inhalt vor und nach der Bearbeitung an. Die Löschdetails zeigen den zuletzt erfassten Inhalt, sofern vorhanden; ein unbekannter Akteur bleibt unbekannt. - **Exportformate:** signierte ZIP-, JSONL- und CSV-Dateien sowie Offline-HTML. - **Vollständiger Chat-Export** (**Chats → Chat exportieren** oder **Exporte → Einen Chat erfassen oder exportieren**): Laden Sie den gesamten sichtbaren Verlauf eines Chats als signiertes Bundle mit `chat.json` (im Telegram-Export-Stil) und einer lesbaren `chat.html`-Datei herunter. Private Chats funktionieren, wenn das Konto Mitglied ist. Es handelt sich um eine aktuelle Momentaufnahme, nicht um eine Rekonstruktion gelöschter oder zuvor bearbeiteter Nachrichten. Überprüfen Sie eine Kopie mit `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256`. - **Checkpoint beachten:** Die Grenze des signierten Protokolls muss außerhalb des Collectors liegen. - **Signierten Ausführungsbeleg herunterladen:** Bewahren Sie die Programm- und Versionsdaten des Erfassungsprogramms auf. - **Zeitstempelanfrage vorbereiten:** Bereiten Sie eine Offline-Anfrage an einen Zeitstempeldienst vor; befolgen Sie die Anweisungen in [der Datei „TIMESTAMP.md“,](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/) um eine Antwort zu erhalten und zu überprüfen. - **Protokoll überprüfen:** Überprüfen Sie Ereignissignaturen und Kettenverknüpfungen. Beim ZIP-Export werden auch Medieninhalte überprüft. Unterstützte Browser speichern umfangreiche Exporte direkt in einer Datei Ihrer Wahl. Andere Browser puffern maximal 128 MiB. Solange der Server läuft, unterstützt die Streaming-CLI größere Downloads, ohne die gesamte Antwort zwischenspeichern zu müssen: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Für einen weiteren Arbeitsbereich fügen Sie `--profile ID` über **Exports → Workspace ID** hinzu. Für einen Remote-Server fügen Sie `--url https://your-server` hinzu. Das Standard-Übertragungslimit beträgt 5 GiB; `--max-mib` ändert es. Signierte ZIP-Inhalte haben standardmäßig ein separates Verifizierungslimit von 4 GiB im unkomprimierten Zustand (über **Weitere Tools → Parameter** lässt sich dieses erhöhen; verifizieren Sie solche Archive mit `verify.py --max-gib N`). Verifizieren Sie das Archiv mithilfe einer vertrauenswürdigen Kopie des Verifizierers, eines unabhängig aufbewahrten Schlüssel-Fingerabdrucks und – als Mindestanforderung für die Nachweisfähigkeit – des Stammzertifikats des Zeitstempeldienstes (`--tsa-ca`). ## Installationsanleitung ``` python start.py --setup-only python start.py --check python start.py --check --json ``` `--check` überprüft lokale Abhängigkeiten, die Signaturunterstützung, den Speicher, die Schlüsselkonfiguration und die Abhöradresse. Es wird nichts installiert und keine Verbindung zu Telegram hergestellt. Ein belegter Port kann darauf hindeuten, dass eine andere Instanz läuft. Verwenden Sie ein anderes `--port` oder beenden Sie diese zunächst. Der Launcher wird in „`.venv`“ installiert. Zusatzbefehle für „`python -m tgwitness...`“ müssen unter Windows „`.venv\Scripts\python.exe`“ oder unter Linux/macOS „`.venv/bin/python`“ verwenden, es sei denn, diese Umgebung ist bereits aktiviert. ## Sitzungen, Schutz und Betrieb Eine geschlossene, konsistente Telethon-SQLite-Datei `.session` kann lokal mit `python -m tgwitness.sessions account.session --out account.tgwitness-session` konvertiert und anschließend unter **Weitere Tools → Konto → Dateien** geladen werden. Ein direkter Dateiimport und eine QR-Anmeldung sind ebenfalls verfügbar. Informationen zu Anmeldeformaten, SOCKS5, HTTP CONNECT, MTProxy und externen Hauptschlüsseln finden Sie in [der Datei CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/de/docs/reference/connection/). **Beobachtung pausieren** stoppt die Erfassung. **Sperren** schließt nur den Browserzugriff. Beim Schließen eines Tabs läuft der Erfassungsprozess weiter. Das Beenden des Prozesses unterbricht die Erfassung; eine Momentaufnahme des Verlaufs kann nicht alle verpassten Bearbeitungen oder Löschungen rekonstruieren. Einzelheiten zu Ereignisrichtlinien, Anhangswarteschlangen, Kontoisolierung und Neustarts finden Sie unter [So funktioniert die Erfassung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/). Sitzungen und Geheimnisse sind verschlüsselt. Nachrichteninhalte, Medien und Exporte erfordern eine verschlüsselte Festplatte oder ein verschlüsseltes Volume. Überprüfen Sie Journalsignaturen anhand eines vertrauenswürdigen Schlüssels und bewahren Sie Checkpoints separat auf. Überprüfen Sie Erfassungsdatensätze, externe Zeitbelege und Umgebungsbescheinigungen für den ausgewählten Erfassungsmodus. Lesen Sie [„OPERATIONS.md“](https://phishdestroy.io/tgwitness/de/docs/reference/operations/) für Informationen zu Sicherung und Wiederherstellung, [„DEPLOYMENT.md“](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) zum Thema Hosting sowie [„deploy/“](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) für Anwendungsbeispiele. Das installierte Panel enthält zudem eine Anleitung zur Offline-Einrichtung unter „`/guide.html`“. Die tatsächliche Verifizierung und die verbleibenden Einschränkungen sind in [den Dateien „VERIFICATION.md“](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) und [„READINESS.md“](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) dokumentiert. --- # Installieren, überprüfen und aktualisieren Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/installation/ Installieren Sie das Tool mit einem einzigen Befehl, überprüfen Sie Signaturen und Hashes, aktualisieren Sie die Installation und entfernen Sie sie. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Installieren Sie das Tool mit einem einzigen Befehl, überprüfen Sie Signaturen und Hashes, aktualisieren Sie die Installation und entfernen Sie sie. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Erste Schritte](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) ![Erste Schritte](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Projekt](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [Schnellstart](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) · [Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) **Auf dieser Seite** - [Installation mit einem Befehl](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#install-with-one-command) - [Wo alles läuft](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#where-everything-runs) - [Einstellungen für die Volltextsuche](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#full-text-search-settings) - [Zugriff über die Befehlszeile](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#command-line-access) - [Vor der Ausführung überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#verify-before-running) - [Eine bestehende Installation aktualisieren](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#update-an-existing-installation) - [Alltägliche Befehle unter Ubuntu](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#everyday-commands-on-ubuntu) - [Entfernen TgWitness](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#remove-tgwitness) ## Installation mit einem einzigen Befehl Der offizielle Download-Dienst des Projekts, `get.destroy.tools`, stellt das geführte Installationsprogramm und die signierten Release-Dateien bereit. Er enthält eine private Python-Laufzeitumgebung und überprüft vor der Installation die Paket-Hashes und Release-Signaturen. Mit jeder Veröffentlichung werden die Einstiegsskripte, Hashes, Signaturen und Build-Informationen gemeinsam aktualisiert; jeder Build verfügt zudem über eine unveränderliche Release-URL. Wählen Sie den geführten Installationsassistenten für eine schnelle Einrichtung oder nutzen Sie [GitHub-Releases, den Quellcode oder Docker](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) . Dies sind unterstützte Installationspfade für dasselbe Open-Source-Projekt. Für eine Bereitstellung, die die Genehmigung eines bestimmten Builds vor der Ausführung erfordert, verwenden Sie [Vor der Ausführung verifizieren](https://phishdestroy.io/tgwitness/de/docs/reference/installation/#verify-before-running) mit einem unabhängig gespeicherten Release-Key-Fingerabdruck und der unveränderlichen URL des Builds. Eine Aktualisierung des Download-Dienstes führt nicht automatisch zu einer Aktualisierung eines installierten Panels. **Linux / macOS (Bash):** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` Führen Sie das Programm auf einem Ubuntu-Server als Root aus, um einen Hintergrunddienst zu installieren. Auf einem Desktop-Rechner führen Sie es als normaler Benutzer aus. **Windows (PowerShell oder Eingabeaufforderung):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Unter Windows ist kein Administrator erforderlich. Der untergeordnete PowerShell-Prozess lässt Ihr Terminal mit dem Ergebnis geöffnet. Python und die Abhängigkeiten verbleiben in der Installation. Wählen Sie unter Ubuntu **„Dieser Computer**“, **„Temporärer HTTPS-Link**“ oder **„Eigene Domain**“. Das Installationsprogramm zeigt die Panel-Adresse und den Zugangsschlüssel an. Für einen temporären Link öffnen Sie diese HTTPS-Adresse in Ihrem Browser und geben Sie den Schlüssel ein. Bei lokalem Zugriff auf einen Remote- Server verwenden Sie eine SSH-Weiterleitung von Ihrem Computer (`ssh -L 8787:127.0.0.1:8787 user@server`) und öffnen Sie `http://127.0.0.1:8787`. Unter macOS und Windows öffnet sich das lokale Panel in Ihrem Browser; lassen Sie das Terminal weiterlaufen. Melden Sie sich im Panel bei Telegram an und wählen Sie aus, was erfasst werden soll. Die Installation allein löst die Telegram-Erfassung nicht aus. ## Wo alles läuft `get.destroy.tools` ist ein **Cloudflare Worker, der statische Downloads bereitstellt**. Er verfügt weder über ein TgWitness-Panel noch über eine Telegram-Sitzung oder eine Datenbank mit Benutzerdaten. Er wird nicht an einen Projekt-VPS weitergeleitet. Die Anwendung läuft auf dem Rechner, auf dem Sie den Befehl ausführen. | Installation | Programm | Daten | | --- | --- | --- | | Ubuntu als Root | `/opt/tgwitness` | Systemdienst: `/var/lib/tgwitness-`; den `tgwitness paths` für den genauen Pfad. | | Linux-/macOS-Benutzer | `~/.local/share/tgwitness` | `data/live` unter dieser Installation. | | Windows-Benutzer | `%LOCALAPPDATA%\TgWitness` | `data\live` unter dieser Installation. | Wählen Sie `TGWITNESS_INSTALL_DIR` , um einen anderen Ordner auszuwählen. Installierte Versionen und Daten sind voneinander getrennt. Das Installationsprogramm lädt Ihre Konten, Nachrichten oder Schlüssel nicht auf die Download-Seite hoch. Wenn Sie einen Cloudflare-Tunnel auswählen, wird der Datenverkehr des Panels über Cloudflare geleitet; die Verwendung Ihrer eigenen Domain verweist auf Ihren eigenen Server. Mit `TGWITNESS_TRUSTED_PROXIES` akzeptiert das Panel einen einzelnen `X-Forwarded-Proto: https`-Header von einem vertrauenswürdigen Proxy, um Secure Download-Cookies zu setzen. Jede Installation enthält **die Dateien „START-HERE.html“** und **„START-HERE.txt“** mit lokalen Pfaden, Befehlen und Links zum Repository. Führen Sie `tgwitness guide` aus, um die Anleitung zu öffnen. Unter Windows verwenden Sie `& "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide` in der PowerShell. ## Einstellungen für die Volltextsuche [Die Volltextsuche](https://phishdestroy.io/tgwitness/de/docs/reference/search/) (Vorschau) erfordert keine Einrichtung. Der Index wird nach einem Update im Hintergrund erstellt. | Variable oder Befehl | Wirkung | | --- | --- | | `TGWITNESS_FULLTEXT=disk` | Standard: Das Verzeichnis „index“ wird in `search/fulltext.sqlite3` jedes Arbeitsbereichs | | `TGWITNESS_FULLTEXT=memory` | Keine Indexdatei; der Index wird bei jedem Start neu erstellt | | `TGWITNESS_FULLTEXT=off` | Kein Index; nur Exaktsuche | | `tgwitness index status` | Indexstatus jedes Arbeitsbereichs | | `tgwitness stop`, `tgwitness index rebuild`, `tgwitness start` | Erstellen Sie jeden Index aus dem signierten Protokoll neu. | Die vom Administrator unter **„Journal“ → „Filter“ → „Suchindex“** getroffene Auswahl überschreibt die Variable für diesen Arbeitsbereich. Befehle suchen das Datenverzeichnis der Installation, in der sie ausgeführt werden; fügen Sie andernfalls `--data-dir` den Pfad aus `tgwitness paths`. Für ein vollständiges ukrainisches Wörterbuch (GPL-3.0-Daten) installieren Sie `pymorphy3-dicts-uk` in der Python-Umgebung der Installation. ## Zugriff über die Befehlszeile Die [Befehlszeile](https://phishdestroy.io/tgwitness/de/docs/reference/cli/) (Vorschau) liest das Archiv nach Skripten und Agenten ab. | Variable | Wirkung | | --- | --- | | `TGWITNESS_URL` | Panel-Adresse für `tgwitness search`, `context`, `messages`, `stats` und `export`; Standardwert `http://127.0.0.1:8787` , wenn ein Token festgelegt ist | | `TGWITNESS_MCP_TOKEN` | Archivieren Sie das Verbindungstoken unter **Weitere Tools → Integrationen → MCP**, das mit MCP-Clients geteilt wird; `--token-file` liest es stattdessen aus einer Datei ein | | `TGWITNESS_DATA` | Das Datenverzeichnis wird direkt gelesen, wenn keine `--data-dir`, URL oder Token angegeben wird | ## Vor der Ausführung überprüfen Das Installationsprogramm bettet den öffentlichen Schlüssel der Projektversion ein und überprüft die SHA-256- und RSA- Signaturen des Anwendungspakets und der Abhängigkeitssperre, bevor diese installiert werden. Sowohl Bash als auch PowerShell brechen ab, wenn eine erforderliche Überprüfung fehlschlägt. Das Startskript wird über HTTPS bereitgestellt und verfügt über eine eigene, vom Hauptskript getrennte Signatur; mit den folgenden Befehlen können Sie dieses Skript ebenfalls vor der Ausführung überprüfen. Der öffentliche Veröffentlichungsschlüssel lautet [„release-signing.pub](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/release-signing.pub)“. Sein SHA-256 lautet: ``` 039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d ``` Bewahren Sie diesen Fingerabdruck aus einer Repository-Revision auf, der Sie vertrauen. Eine Prüfsumme vom selben Download-Server erkennt Abweichungen; der unabhängig vertrauenswürdige öffentliche Schlüssel dient zur Authentifizierung einer Release-Signatur. Verwenden Sie für die unten aufgeführten Verifizierungs-Downloads ein neues, leeres Verzeichnis. **Linux / macOS – in einem neuen, leeren Download-Verzeichnis ausführen** (erfordert curl und OpenSSL): ``` curl -fSLO https://get.destroy.tools/install.sh && curl -fSLO https://get.destroy.tools/install.sh.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh && bash install.sh ``` Die `&&` Kette wird vor der Ausführung angehalten, wenn ein Download, eine Schlüssel-Fingerabdruck- oder Signaturprüfung fehlschlägt. Wenn zwischen dem Herunterladen des Skripts und dessen Signierung eine Veröffentlichung erfolgt, werden beide erneut heruntergeladen. Alte Installationsprogramme behalten ihre unveränderlichen Paket-URLs bei. **Windows – Überprüfen Sie vor der Ausführung das SHA-256:** ``` Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing Get-FileHash .\install.ps1 -Algorithm SHA256 Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt ``` Vergleichen Sie den Hash mit der `install.ps1` Zeile. Für eine unabhängige Signaturprüfung verwenden Sie OpenSSL (zum Beispiel über Git Bash) und denselben Fingerabdruck des öffentlichen Schlüssels wie oben: ``` curl -fSLO https://get.destroy.tools/install.ps1 && curl -fSLO https://get.destroy.tools/install.ps1.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 && powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1 ``` Die Windows-Installation selbst überprüft die Paketsignaturen mit .NET und benötigt kein OpenSSL. Es handelt sich um separate RSA-3072-Signaturen (SHA-256), nicht um Authenticode. Das [Manifest](https://get.destroy.tools/manifest.json) enthält die Softwareversion, den genauen Git-Commit, die unveränderliche Release-ID und die SHA-256 jedes Artefakts. Die Seite enthält einen Link zur entsprechenden Quelle. Das Manifest und die Prüfsummenliste verfügen ebenfalls über separate Signaturen (`manifest.json.sig` und `SHA256SUMS.txt.sig`). ## Eine bestehende Installation aktualisieren **Eine neue Veröffentlichung aktualisiert die Download-Seite; installierte Programme werden aktualisiert, wenn Sie das Installationsprogramm erneut ausführen.** Es gibt keinen unbeaufsichtigten Updater und keinen automatischen Neustart einer laufenden Sammlung. Der aktuelle Installationskanal ist **„Preview“**; er folgt veröffentlichten, geprüften Builds von `main`, deren Commit neuer sein kann als die letzte nummerierte GitHub-Version. Die Versionsangabe der Seite stammt aus `pyproject.toml`; ihr Commit und ihre Build-ID unterscheiden Aktualisierungen innerhalb derselben Preview-Version. Die Veröffentlichung erfolgt automatisch, nachdem genau dieser Commit die Anwendungs- und Sicherheitsprüfungen bestanden hat und das signierte Paket auf Ubuntu und Windows authentifiziert, installiert und überprüft wurde. Pull-Anfragen, die den Installer ändern, führen außerdem `install.sh` und `install.ps1` zweimal auf einer lokalen Kopie der Website aus. Während die Prüfungen laufen oder falls sie fehlschlagen, installieren dieselben Befehle weiterhin den zuvor geprüften Build. Das Build-Manifest zeigt an, welcher Commit derzeit verfügbar ist; die Versionsnummer allein kann zwischen den Vorschau-Updates unverändert bleiben. Verwenden Sie denselben Installationsordner und denselben Betriebssystembenutzer wie zuvor. Sichern Sie das gesamte Datenverzeichnis, während die Erfassung angehalten ist; `tgwitness paths` identifiziert es. Ein signierter Export ist keine vollständige Installationssicherung. **Ubuntu-Root-Installation unter `/opt/tgwitness`:** ``` curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start ``` Nach erfolgreicher Installation: ``` /opt/tgwitness/bin/tgwitness restart /opt/tgwitness/bin/tgwitness status /opt/tgwitness/bin/tgwitness open ``` Für eine Installation unter Linux/macOS verwenden Sie die Originaldatei `TGWITNESS_INSTALL_DIR` oder die Standardeinstellung und führen Sie den ersten Installationsbefehl erneut aus. Schließen Sie ein Panel im Vordergrund vor der Aktualisierung und starten Sie es anschließend erneut. Für einen konfigurierten Linux-Dienst führen Sie den entsprechenden `tgwitness restart` Befehl aus. **Windows:** Schließen Sie das geöffnete Fenster, führen Sie den Windows-Installationsbefehl erneut aus und öffnen Sie dann `bin\tgwitness.cmd` in derselben Installation. Das Installationsprogramm behält Daten, Sitzungen, Zugriffseinstellungen und Signaturschlüssel bei. Es wechselt den Launcher erst, nachdem die neue Umgebung die Prüfungen bestanden hat; bei fehlgeschlagener Installation bleibt der vorherige Launcher erhalten. Bewahren Sie die Sicherung vor dem Upgrade wegen Änderungen am Speicherformat auf. ## Alltägliche Befehle unter Ubuntu | Befehl | Ergebnis | | --- | --- | | `tgwitness open` | Aktuelle Panel-URL und Zugriffsschlüssel. | | `tgwitness paths` | Genaue Pfade zu Programmen, Daten und Anleitungen. | | `tgwitness guide --print` | Anleitung für den Offline-Betrieb. | | `tgwitness status` / `tgwitness logs` | Verfügbarkeits- und Dienstprotokolle. | | `tgwitness stop` / `tgwitness start` | Dienst anhalten/fortsetzen; Daten beibehalten. | | `tgwitness token rotate` | Ersetzen Sie den Administratorschlüssel und beenden Sie die Browsersitzungen. | | `tgwitness tunnel off` | Den öffentlichen Quick-Tunnel deaktivieren; das lokale Panel beibehalten. | | `tgwitness tunnel on` / `tgwitness tunnel restart` | Erstellen Sie einen Quick-Tunnel-Link bzw. ersetzen Sie dessen Adresse. | Siehe [„Zugriff“](https://phishdestroy.io/tgwitness/de/docs/reference/access/) für Kollegentokens, Sitzungen und IP-Einschränkungen sowie [„Veröffentlichung des Installers“](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) für den Release-Workflow von GitHub zu Cloudflare. ## TgWitness entfernen Es gibt kein Deinstallationsprogramm: Sie beenden das Panel und löschen dessen Ordner. Durch das Löschen des Datenordners werden Journale, Signaturschlüssel, Telegram-Sitzungen und gespeicherte Dateien endgültig gelöscht. Zuvor: 1. Exportieren Sie, was Sie benötigen (**Exporte → Signierte ZIP herunterladen**), und bewahren Sie den Fingerabdruck des Signaturschlüssels sowie die Checkpoints außerhalb dieses Rechners auf. Um den Arbeitsbereich selbst zu sichern, kopieren Sie den gesamten Datenordner, während die Erfassung angehalten ist. 2. Löschen Sie Server, die unter **Weitere Tools → Extras → „Server 24/7“** erstellt wurden, aus **Ihre Server** oder mit `python -m tgwitness.cloud destroy`; der Anbieter stellt diese so lange in Rechnung, bis sie gelöscht sind. 3. Beenden Sie die Sitzung jedes Kontos in Telegram unter **„Einstellungen“ → „Geräte**“. Das Löschen der Dateien führt nicht dazu, dass die Sitzung auf der Seite von Telegram abgemeldet wird. **Root-Installation unter Ubuntu.** Notieren Sie sich den Datenordner, stoppen Sie den Dienst und entfernen Sie anschließend den Dienst, die Ordner und die Verknüpfung: ``` /opt/tgwitness/bin/tgwitness paths /opt/tgwitness/bin/tgwitness stop systemctl list-unit-files 'tgwitness-*' systemctl disable tgwitness- rm /etc/systemd/system/tgwitness-.service systemctl daemon-reload rm -rf /opt/tgwitness /var/lib/tgwitness- /usr/local/bin/tgwitness ``` **Installation für Linux- oder macOS-Benutzer.** Schließen Sie das Fenster. Ein konfigurierter Linux-Benutzerdienst wird mit `systemctl --user disable --now tgwitness-`; seine Einheit befindet sich in `~/.config/systemd/user/`. Löschen Sie anschließend `~/.local/share/tgwitness` (oder Ihr `TGWITNESS_INSTALL_DIR`) sowie die `~/.local/bin/tgwitness` Verknüpfung. **Windows.** Schließen Sie das Fenster und löschen Sie `%LOCALAPPDATA%\TgWitness` (oder Ihre `TGWITNESS_INSTALL_DIR`). Das Installationsprogramm fügt weder einen Dienst noch eine geplante Aufgabe oder eine Verknüpfung hinzu. --- # Telegram · Erste Einrichtung und Einstellungen Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/settings/ Der Einrichtungsassistent, Ziele, Benutzeroberflächenebenen, Verbindungswege und Einstellungen, die von einer Kontengruppe gemeinsam genutzt werden. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Der Einrichtungsassistent, Ziele, Benutzeroberflächenebenen, Verbindungswege und Einstellungen, die von einer Kontengruppe gemeinsam genutzt werden. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Erste Schritte](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) ![Erste Schritte](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Konten](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/) · [Zusammenhang](https://phishdestroy.io/tgwitness/de/docs/reference/connection/) · [Zugriff](https://phishdestroy.io/tgwitness/de/docs/reference/access/) Ein neuer Arbeitsbereich wird geöffnet `/first-run`. Auf dem ersten Bildschirm werden Sie gefragt, was Sie tun möchten: **„Nur herunterladen**“, **„Chats verfolgen**“ oder **„Beweismaterial für einen Fall**“. Die Auswahl legt das Ziel und die Benutzeroberfläche-Ebene fest: „Einfach“ für „Nur herunterladen“, „Standard“ für die beiden anderen Optionen. Die Ebene bestimmt, wie viele Felder jedes Formular anzeigt; jede Seite bleibt im Menü erhalten. **Weitere Optionen** auf demselben Bildschirm legen die Stufe, das Design und die Zeitzone explizit fest; die Sprachliste befindet sich in der Kopfzeile des Assistenten. Die nächsten Bildschirme befassen sich mit der Verbindung, Telegram und den Chats. Die Verbindungswege bleiben während der automatischen Überprüfung ausgeblendet und werden geöffnet, wenn diese fehlschlägt. Ein fünfstufiger Fortschrittsbalken kehrt zu bereits abgeschlossenen Schritten zurück. Jede Antwort wird auf dem Server gespeichert, sobald sie geändert wird, sodass beim Neuladen derselbe Schritt fortgesetzt wird. Der letzte Bildschirm listet die Antworten auf und ermöglicht es Ihnen, zu jeder beliebigen Antwort zurückzukehren. Sprache, IANA-Zeitzone, Design und Stufe werden pro Benutzer und pro Arbeitsbereich gespeichert. Die Standardeinstellungen sind die Browsersprache, die Zeitzone des Geräts, das Systemdesign und die einfache Benutzeroberfläche. Beim Ändern der Sprache bleibt die Panel-Sitzung erhalten. Die Zeiten im signierten Protokoll ändern sich nie. `/settings` bearbeitet dieselben Datensätze wie der Assistent. Die Suche umfasst die Hauptfelder, Parameter und die erweiterten Formulare; ein ausgeblendetes Feld lässt sich öffnen, ohne die Ebene zu ändern. Ebenen ändern nur, was angezeigt wird: Die Berechtigungen prüft der Server selbst. Ein Abschnitt, dessen Einstellungen alle über der gewählten Ebene liegen, zeigt sie trotzdem an. Erfassungseinstellungen und die erste Verbindung obliegen dem Administrator des Arbeitsbereichs. Die Einstellungsseite ist eine Liste. Die Kontokarte oben öffnet **Telegram-Konto**. Darunter nennt jede Zeile einen Abschnitt und den aktuellen Wert: **Welche Chats?** und **Verbindung** unter **Konto**; **Ziel**, **Aufzeichnung und Dateien**, **Schutz der Aufzeichnung** und **Benachrichtigungen und externe Kopie** unter **Aufzeichnung**; **Sprache, Zeit und Darstellung** unter **Panel**; die Expertenseiten unter **Weitere Tools**. Neben der Liste zeigt eine Karte, ob die empfohlenen Werte aktiv sind, mit den wichtigsten Werten und **Letzte Änderung rückgängig machen**, und **Letzte Änderungen** listet die letzten Änderungen auf. Ein Abschnitt wird in einem Fenster über der Liste geöffnet und hat eine eigene Adresse, z. B. `/settings/connection`. Der Zurück-Pfeil, die Schaltfläche „Schließen“, die Escape-Taste, ein Klick außerhalb des Fensters und die Zurück-Schaltfläche des Browsers führen zurück zur Liste. **Welche Chats?** bleibt bei **Chat-Auswahl speichern** erhalten; beim Schließen mit ungespeicherten Änderungen wird zunächst nachgefragt. Beim Speichern bleiben die Quellentypen, ausgeschlossene Chats, eigenen Aktionen und Einstellungen für neue Chats unter **Weitere Tools → Quellen → Umfang** erhalten; ein hier ausgewählter Chat wird aus den ausgeschlossenen Chats entfernt und als manuell ausgewählte Quelle gespeichert. Bei jeder Änderung wird 20 Sekunden lang **Rückgängig** angezeigt, und jeder Eintrag unter **Letzte Änderungen** kann später rückgängig gemacht werden. Ein Rückgängig-Vorgang stellt nur die Einstellungen wieder her, die durch diesen Eintrag geändert wurden, einschließlich benutzerdefinierter Dateigrößenbeschränkungen. Wenn eine spätere Änderung dieselben Einstellungen betraf, wird der Rückgängig-Vorgang abgelehnt und es ändert sich nichts . Ein Rückgängig-Vorgang ist ein neuer Eintrag `settings.changed` im Protokoll. | Ebene | Felder | Seitenleiste | | --- | --- | --- | | Einfach | Nur das Wesentliche | Startseite, Chats, Protokoll, Exporte, Konten und Einstellungen | | Standard | Allgemeine Einstellungen mit Erläuterungen | Fügt unter Weitere Tools die Bereiche Fallübersicht, Quellen, Zugriff und Dokumentation hinzu | | Experte | Alle Felder, Beschränkungen und technischen Details | Fügt außerdem unter Weitere Tools die Bereiche Systemkarte, Netzwerktopologie, Extras, Das Archiv befragen, Parameter, Konto, Systemprotokoll und Integrationen hinzu. | Die Abschnittsnamen bleiben auf jeder Ebene gleich. Öffnen Sie Darstellung am unteren Rand der Seitenleiste, um die Ebene zu ändern. Die [Anleitung zum Bedienfeld](https://phishdestroy.io/tgwitness/de/docs/reference/panel/) beschreibt jeden Abschnitt. ## Ziele | Ziel | Sammlung | Dateien | Externe Dienste | Serveradresse | | --- | --- | --- | --- | --- | | Einfach herunterladen | Der einmalige Export beginnt auf dem abschließenden Einrichtungsbildschirm; die fortlaufende Erfassung bleibt deaktiviert. | Fotos bis zu 20 MB | Zeitstempel | Automatisch | | Chats verfolgen | Kontinuierlich | Fotos und Videos mit einer Länge von bis zu 60 Sekunden bzw. einer Größe von bis zu 20 MB | Zeitstempel und Problembenachrichtigungen | Automatisch | | Beweismittel für einen Fall | Kontinuierlich | Alle Dateien bis zu 1 GB | Zeitstempel, drand, Benachrichtigungen | Nein, ausblenden | Als Beweismittel werden die externe Kopie, der Witness-Bot und die Code-Prüfung empfohlen. Speicher- und Benachrichtigungsadressen benötigen zunächst ein Ziel. Eine Funktion, die mit einem externen Dienst kommuniziert, fordert dazu auf, Anfragen außerhalb von Telegram zuzulassen; wenn man diese deaktiviert, wird angeboten, Zeitstempel, Benachrichtigungen und die externe Kopie ebenfalls zu deaktivieren. Wenn das Ziel geändert wird, wird zunächst der Unterschied angezeigt, und manuelle Änderungen können beibehalten werden. Ein Feld, das vom Ziel abweicht, wird **mit „Von Ihnen geändert“** gekennzeichnet und kann wiederhergestellt werden. Die Einstellungsrevision verhindert, dass eine geprüfte Änderung eine Änderung überschreibt, die in einem anderen Reiter vorgenommen wurde. ## Zusammenhang Solange hier keine Route ausgewählt wird, verwendet ein neuer Arbeitsbereich **Automatischer MTProxy · öffentliche Listen** mit **der Option Adresse verbergen** ([Verbindungssicherheit](https://phishdestroy.io/tgwitness/de/docs/reference/connection/)). Die untenstehende Option **Automatisch** ist ein separater Einrichtungsschritt. **Automatic** versucht es zunächst mit WARP, dann mit öffentlichen MTProxy-Servern und schließlich mit einer direkten Verbindung, wobei Letzteres nur dann erfolgt, wenn die Adresse des Servers angezeigt werden darf. Automatic und WARP können hash-geprüfte Komponenten installieren und den Server bei Cloudflare registrieren; ohne diese Zustimmung überspringt Automatic WARP. WARP nutzt den bestehenden wgcf/wireproxy-Manager und einen lokalen SOCKS5- Port; die Routing-Tabelle des Systems wird nicht verändert. **Beim Massenimport** wird nach der Route gefragt, bevor eine Sitzung Telegram erreicht: WARP (Standard), öffentlicher MTProxy oder direkt. Die Sitzungsprüfung verwendet dieselbe Art von Route, und jedes importierte Konto erhält vor seiner ersten Anmeldung einen eigenen WARP-Tunnel. Ihr eigener Proxy akzeptiert `tg://proxy`, `socks5://`, `http://` und `https://`. Das Zertifikat eines HTTPS- Proxys wird überprüft, bevor Anmeldedaten an ihn gesendet werden. Eine Verbindungsprüfung ist fünf Minuten lang gültig und an die Route, die Richtlinie und die Antworten des Assistenten gebunden; eine Änderung einer dieser Komponenten erfordert eine neue Prüfung. **Die Option „Ohne Prüfung fortfahren“** ist verfügbar und ersetzt nicht die Telegram-Anmeldung. Die gewählte Route wird im Hintergrund erneut überprüft, und „Automatic“ führt seine Kette nach einem Verbindungsabbruch erneut aus. Wenn kein öffentlicher Proxy antwortet, wird die Zählung rot angezeigt, begleitet von WARP- und Neuüberprüfungsaktionen. ## Kontogruppen Konten in einer Gruppe nutzen gemeinsame Einstellungen. Öffnen Sie **„Konten“ → „Gruppen und gemeinsame Einstellungen“ → „Gemeinsame Einstellungen**“ oder **„Gruppeneinstellungen“** auf der Einstellungsseite eines Kontos. Die Gruppe teilt das Ziel, gespeicherte Dateien, Zeitstempel, Drand, Problembenachrichtigungen, externe Kopien, Anfragen außerhalb von Telegram, den IP-Modus, die Aufzeichnungsinhalte, den Zeitplan für die erneute Überprüfung, Benachrichtigungsregeln, Berichtseinstellungen, Parameter und die Verbindungsroute. Benachrichtigungsempfänger, Proxy-Anmeldedaten und die Anmeldung bleiben pro Konto bestehen, ebenso wie das Starten und Anhalten der Erfassung. - Jedes Mitglied folgt der Gruppe. Unter „Einstellungen“ wird ein Wert festgelegt: 🔗 **Aus der Gruppe** oder ✏️ **Eigener Wert**; mit **„Zurück zum Gruppenwert“** wird der ursprüngliche Wert wiederhergestellt. - Eine Änderung listet die betroffenen Konten auf (**gilt für 2 von 3 Konten**) und fragt jedes Konto einzeln ab, bevor ein eigener Wert ersetzt wird. Nicht markierte Konten behalten ihren Wert bei. - Ein Parameter, den die Gruppe nicht teilt, bleibt **Nicht geteilt: Jedes Konto behält seine eigenen Werte bei**, bis Sie auf **Diesen Wert teilen** klicken. - **Beim Kopieren der Einstellungen eines Kontos** werden die Werte des ausgewählten Kontos als Einstellungen der Gruppe übernommen. - Ein Konto, das in eine Gruppe verschoben wird, wird gefragt: **„Die Werte der Gruppe übernehmen?“** Andernfalls behält es seine eigenen Werte bei, gekennzeichnet mit ✏️. Später hinzugefügte Konten beginnen mit den Werten der Gruppe. - Ein Beobachtungskonto behält seinen IP-Modus bei, bis es pausiert wird. Jede Änderung wird im signierten Protokoll des Hauptarbeitsbereichs und jedes Mitglieds, das davon betroffen ist, festgehalten. Beim Löschen einer Gruppe bleiben deren Konten und deren aktuelle Werte erhalten. Die Gruppenseite `/groups/` zeigt die Mitglieder, was Aufmerksamkeit erfordert und die Chats, die mehrere Konten sehen. Siehe [Kontengruppen](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#bulk-import-and-account-groups). ## Vorhandene Arbeitsbereiche Ein Arbeitsbereich mit einer laufenden Sitzung oder einer zuvor abgeschlossenen Einrichtung zeigt den Assistenten nicht an. Seine Werte werden beim Laden der Seite nicht durch ein Ziel ersetzt. Das Ausblenden eines Feldes deaktiviert die Funktion nicht und löscht auch nicht deren Wert. **Das Öffnen der Ersteinrichtung** unter „Einstellungen“ zeigt erneut dieselben Bildschirme an; deren Abschluss löst keinen neuen Export oder keine neue Beobachtung aus und weist darauf hin, und eine geänderte Chat-Auswahl wird nur durch **Chat-Auswahl speichern** beibehalten. Die Schätzung von Umfang und Zeitaufwand basiert auf bis zu drei ausgewählten Chats und bis zu 20 Nachrichten aus jedem Chat. Es handelt sich um eine Schätzung: Sie berücksichtigt weder die Telegram-Limits noch die Geschwindigkeit eines bestimmten Servers oder die Dateien in jedem Chat. --- # Telegram · Konten und Sitzungsformate Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/accounts/ Melden Sie sich per Telefon, QR-Code oder Authentifizierungsschlüssel an, importieren Sie Sitzungen aus Telethon, Pyrogram oder Telegram Desktop und verwalten Sie mehrere Konten. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Translation coverage: this edition includes material from the English original. Melden Sie sich per Telefon, QR-Code oder Authentifizierungsschlüssel an, importieren Sie Sitzungen aus Telethon, Pyrogram oder Telegram Desktop und verwalten Sie mehrere Konten. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Erste Schritte](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) ![Erste Schritte](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) TgWitness meldet sich über MTProto als **Telegram-Benutzerkonto** (nicht als Bot) an und nutzt dabei Telethon. Jedes Konto befindet sich in einem eigenen **Arbeitsbereich** (in der API und den Befehlszeilentools als *„Workspace“* bezeichnet) mit eigener Sitzung, eigenen Quellen, eigenem Protokoll und eigenem Signaturschlüssel. Sitzungsdateien, Sitzungsstrings und Auth-Keys sind **Kontoautorisierungen**: Wer auch immer im Besitz einer solchen ist, kann im Namen dieses Kontos handeln. Sie enthalten keinen Nachrichtenverlauf. > [!WARNUNG] **Verwenden Sie dedizierte Konten.** Telegram schränkt Konten ein und kann diese dauerhaft sperren, wenn das Anfragevolumen als übermäßig angesehen wird, unabhängig vom Client oder Zweck, und dokumentiert diese Grenzen nur teilweise. Verbinden Sie Konten, die für die Beobachtung vorgesehen sind, anstatt persönliche oder anderweitig wertvolle Konten, und erstellen Sie eine API-ID / einen API-Hash auf einem dedizierten Konto. - [Auf einen Blick](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#at-a-glance) - [Bevor Sie beginnen: API-ID und API-Hash](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#before-you-start-api-id-and-api-hash) - [Telefonnummer](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#phone-number) · [QR-Code](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#qr-code) · [Authentifizierungsschlüssel + DC-ID](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#auth-key--dc-id) - [Kontodateien](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#pyrogram-session) · [Paar aus Sitzung und JSON](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#telethon-stringsession) · [Auth-Schlüssel und DC in einer Zeile](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [JSON-Datei für das Konto](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#account-json) - [Ermitteln Sie, was Ihnen vorliegt](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#identify-what-you-have) · [Nicht unterstützte Formate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#unsupported-formats) - [Mehrere Konten](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#multiple-accounts) · [Sichere Aufbewahrung von Kontodateien](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#keeping-account-files-safe) · [Fehlerbehebung](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#troubleshooting) ## Auf einen Blick | Was Sie haben | Registerkarte **„Konto hinzufügen“** | Außerdem benötigen Sie | | --- | --- | --- | | Die Telefonnummer und der Zugriff auf die Anmeldedaten | **Telefon** | 2FA-Passwort, sofern aktiviert | | Telegram auf einem anderen Gerät geöffnet | **QR-Code** | 2FA-Passwort, sofern aktiviert | | Eine `.session`-Datei (Telethon oder Pyrogram) | **Dateien** | Optionales begleitendes JSON-Dokument für App-Einstellungen | | `.session` + `.json` mit demselben Namen | **Dateien** (bitte beide auswählen) | In der Regel nichts weiter | | Ein „`tdata`“-Ordner in Telegram Desktop | **Dateien** (als ZIP) | Der lokale Desktop-Zugangscode, sofern einer festgelegt wurde | | Eine Telethon-StringSession (Text, `.txt`, `.tgwitness-session`) | **Dateien** | Es ist kein separates API-Paar erforderlich | | Ein Auth-Schlüssel und DC in einer Zeile: `<512 hex>:<1–5>` | **Dateien** (Einfügetext oder Textdatei) | Es ist kein separates API-Paar erforderlich | | Ein „`.json`“ mit einer Sitzung oder einem Authentifizierungsschlüssel | **Dateien** | Es ist kein separates API-Paar erforderlich | | Ein Auth-Schlüssel (512 Hexadezimalzeichen) und dessen DC-Nummer | **Authentifizierungsschlüssel** | Optionale Benutzer-ID | TgWitness erkennt Dateien anhand ihres **Inhalts**, nicht anhand ihrer Namen. Das Umbenennen einer Datei führt niemals zu einer Konvertierung. ## Bevor Sie beginnen: API-ID und API-Hash Sie können sich anmelden, ohne eine Telegram-API-Anwendung zu erstellen. Wenn kein Schlüsselpaar eingegeben, importiert oder bereits im Arbeitsbereich gespeichert wurde, wählt TgWitness ein Schlüsselpaar aus seinem integrierten Pool von 50 öffentlichen API-Schlüsselpaaren aus (`tgwitness/api_pool.py`), wobei bei einer neuen Anmeldung Telegram Desktop bevorzugt wird und ein gespeichertes Paar vorrangig verwendet wird; die übrigen Kandidaten werden zufällig gemischt. Wenn Telegram ein Paar ablehnt (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`), wird das nächste ausprobiert, bis zu acht pro Anmeldung; abgelehnte Paare werden bis zum Neustart übersprungen. Das Paar, mit dem die Anmeldung erfolgte, wird zusammen mit dem Konto gespeichert und für dieses wiederverwendet. Die integrierten Paare sind öffentlich: Sie werden im Open-Source-Code der Telegram- Clients und -Bibliotheken veröffentlicht. Eine **API-ID** und **ein API-Hash** identifizieren die Anwendung gegenüber Telegram und gewähren keinen Zugriff auf Kontodaten. Die Anmeldung erfolgt über die kontoeigene Autorisierung: einen Anmeldecode und ein 2FA-Passwort oder eine bereits vom Konto autorisierte Sitzung. Jeder `observation.started` Datensatz nennt das verwendete Paar, sodass ein integriertes Paar für Gerichtszwecke genauso dokumentiert ist wie Ihr eigenes. Sie können stattdessen auch Ihr eigenes Paar unter my.telegram.org eingeben. Nach den Erfahrungen des Projekts führt ein neues persönliches Paar dazu, dass die meisten Konten abgemeldet werden. Verwenden Sie es daher nur, wenn ein Fall Ihre eigene Anwendung erfordert: Erstellen Sie es mit einem dafür vorgesehenen Konto und geben Sie es ein, bevor die Datenerfassung beginnt (Schritte siehe unten). Fehlende Verbindungsfelder verwenden ein deterministisches Geräte-/Betriebssystem-Paar aus den mitgelieferten [opentele2-2.0.0-Katalogen](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735): Desktop `2040`, Android `6`, Android X `21724`, iOS `10840`, macOS `2834` und Web `2496`. Die Source-Build-ID `4` von Android verwendet ebenfalls den Android-Katalog, wie in [Telegram Android’s BuildVars](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java) angegeben. Web verwendet standardmäßig A; ein importiertes `K`-App-Versionssuffix oder ein `macos`-Sprachpaket wählt K aus, und die Version `0.7.0` wählt Webogram aus. Unbekannte Anwendungs-IDs behalten die Standardwerte des Telethon-Hosts bei. Importierte Felder haben immer Vorrang, einschließlich einer älteren App-Version und eines leeren Sprachpakets. Der Katalog ändert niemals die API-ID/den Hash. Sein Versions-Snapshot wird explizit überprüft und nicht während der Anmeldung abgerufen. Ein gespeichertes Profil bleibt nach Updates stabil. `account.getAuthorizations` meldet die von Telegram gespeicherten Autorisierungsmetadaten; es handelt sich dabei nicht um eine Wiederholung jedes neuen `initConnection`. Vergleiche es mit dem tatsächlich gesendeten Profil. Das Verknüpfen einer bestehenden Autorisierung validiert nicht den zugehörigen API-Hash: `initConnection` sendet die API-ID, während der Hash bei Anmeldeanfragen verwendet wird. Nach einer neuen Telefon- oder QR-Autorisierung fordert TgWitness die Konfiguration, das nächstgelegene Rechenzentrum, den Online-Status, Sprachen (sofern das Sprachpaket nicht leer ist), App-Updates und Aktualisierungen der Nutzungsbedingungen an, wobei zwischen den Anfragen 0.3–1.5 Sekunden liegen. Die Statusaktualisierung markiert das Konto kurzzeitig als online. Diese Abfolge wird einmalig nach Abschluss der Anmeldung ausgeführt, nicht bei Importen, erneuten Verbindungen oder Neustarts. Die Autorisierung wird zuerst gespeichert; eine fehlgeschlagene Anfrage stoppt die Abfolge, ohne einen erneuten Versuch zu unternehmen oder die Anmeldung zu verwerfen. Die Ergebnisse werden als `account.initialized` aufgezeichnet, wobei Fehlernamen anstelle von Antwortinhalten verwendet werden. Die Richtlinien von Telegram legen die Kontobeschränkungen fest. Für `tdesktop` verwendet ein fehlendes `tz_offset` den lokalen UTC-Offset des Servers, gerundet auf 900 Sekunden unter Verwendung des [opentele2-Algorithmus](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT; Lizenz in `tgwitness/client_profiles.LICENSE` ). Dieser wird bei jeder Verbindung aktualisiert, sodass Änderungen durch die Sommerzeit berücksichtigt werden. Ein importierter `tz_offset` -Wert hat auf jeder Plattform Vorrang und wird exakt beibehalten, einschließlich des Werts Null. Andere `initConnection.params` -Einträge bleiben erhalten. Das HTTP-Anmeldeformular akzeptiert die durch den Dateiimport zurückgegebene numerische Zeitzone; Boolesche Werte, Bruchteile und Offsets außerhalb des unterstützten Bereichs werden abgelehnt. Direkte, SOCKS5- und HTTP-CONNECT-Routen verwenden Telethons `ConnectionTcpObfuscated` (verschleiertes, gekürztes MTProto). HTTPS CONNECT behält TLS zum Proxy bei und nutzt denselben verschleierten Transport innerhalb des Tunnels. MTProxy behält seinen erforderlichen zufälligen Zwischentransport und die geheime Handhabung bei. Routenwechsel wenden die gleichen Optionen an. Die Verschleierung verändert die Paketgestaltung; sie verbirgt weder das Konto noch dessen Client-Metadaten vor Telegram und impliziert keine Immunität gegenüber Einschränkungen. Nach dem Verbindungsaufbau mit einem autorisierten Client überprüft TgWitness die Konfiguration, den nächstgelegenen DC, die aktuelle Autorisierung, die überprüfte Layer-Baseline, Sprachen, App-Updates sowie Aktualisierungen der Nutzungsbedingungen. Diese Diagnosen werden einmal pro Client-Instanz vor der Datenerfassung durchgeführt und unter den Verbindungsdetails mit dem jeweiligen Zeitpunkt angezeigt. `account.connection_checked` protokolliert das Ergebnis ohne Sitzungs-Hashes, IP-Adressen, Token oder API-Hashes. Es werden niemals Nutzungsbedingungen akzeptiert oder Updates installiert. Ein Fehlschlag bei einer Anfrage oder „FloodWait“ stoppt nachfolgende Anfragen; ein fehlendes Ergebnis bleibt unbekannt. Lokale Prüfungen können ihre Ergebnisse weiterhin melden, während Netzwerkprüfungen übersprungen werden. Wenn [Strict Chats](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#strict-chosen-chats) aktiviert ist, wird die aktuelle Autorisierung nicht angefordert und diese Prüfung wird als übersprungen angezeigt. Nach der Anmeldung und bei jeder neuen Verbindung liest TgWitness die Einstellung für sensible Inhalte des Kontos aus. Ist diese deaktiviert und erlaubt Telegram die Änderung, aktiviert TgWitness sie, damit Inhalte, die Telegram als sensibel (18+) kennzeichnet, gespeichert werden, und zeichnet `account.content_settings` auf. Die Einstellung gehört zum Konto und gilt in jeder Telegram-App. Bei aktivierten „Strict Chats“ bleibt sie unverändert; aktivieren Sie diese Option vor der Anmeldung. Gleichzeitige Anfragen zur Wiederherstellung der Verbindung eines Arbeitsbereichs nutzen denselben Client und warten, bis der Verbindungsaufbau abgeschlossen ist. Bei einem fehlgeschlagenen oder abgebrochenen Versuch wird die nächste Anfrage freigegeben, um einen erneuten Versuch zu starten. Wenn sich die gespeicherten Anmeldedaten, der Client oder der Autorisierungsstatus während des Verbindungsaufbaus ändern, wird der ältere Versuch abgebrochen, anstatt eine bereitstehende Verbindung zu melden. Die FloodWait-Diagnose speichert die fehlgeschlagene TL-Methode, etwaige Takeout-/Range-Wrapper, die vom Server angeforderte Wartezeit und die effektive Frist in `telegram.backoff`. Die Verbindungsdetails zeigen die Methode und die Frist an, während Anfragen angehalten sind. Die Diagnose umfasst Client-Aufrufzähler pro Methode seit der Erstellung des jeweiligen Clients; sie zählen verschachtelte Peer-Auflösungen separat, berücksichtigen jedoch keine Pakete oder interne Wiederholungsversuche von Telethon. Aktuelle Zählerstände sind auch als `collector.rpc_activity` in der Status-API verfügbar. Es sind keine Anfrageargumente, Benutzernamen, Zugriffs- Hashes oder Ausnahmetexte enthalten. Die letzte Diagnose und die vollständige Frist bleiben nach einem Neustart erhalten. Frühere Wartezeiten ohne Methodendatensatz können nicht nachträglich zugeordnet werden. Siehe „[-Exportgrenzen“](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-LIMITS.md) für die Quellcodeüberprüfung und die Unterscheidung zwischen Erkennung und Historienerfassung. `official_app=True` oder `False` ist das Flag für die aktuelle Autorisierung bei Telegram. Keiner der Werte gibt Aufschluss darüber, ob das Konto eingeschränkt, vertrauenswürdig oder unter Beobachtung steht. Die bestehenden `account.devices`-Snapshots im Beweismodus bleiben die Historie aller angemeldeten Geräte; die Verbindungsdiagnose behält nur die aktuelle Gerätebeschreibung bei. Vor der Verbindung vergleichen beratende Prüfungen die API-Plattform, das Sprachpaket, die Formate für Gerät/Betriebssystem und App-Version, die Ländereinstellung des mobilen Systems sowie die tatsächliche Schemaebene von Telethon mit der überprüften Katalog-Baseline. Warnungen erscheinen im Server- Protokoll und in den Metadaten des Kontostatus; sie ersetzen niemals importierte Werte oder ändern die Schemaebene. Eine abweichende Ebene ist ein Signal, die Kompatibilität zu überprüfen; der eigene Verbindungsstatus des Kontos zeigt an, ob die Verbindung funktioniert. Telegram legt die Einschränkungen auf seiner Seite fest, unabhängig davon, welches Client-Profil verwendet wird. Der Status eines getrennten Kontos verwendet das gespeicherte Profil, anstatt eine weitere Gerätebeschreibung zu generieren. Um stattdessen Ihre eigene Anwendung zu verwenden: 1. Öffnen Sie [my.telegram.org](https://my.telegram.org) und melden Sie sich mit einer beliebigen Telefonnummer an, die Ihnen gehört. Der Code wird in der Telegram-App angezeigt, nicht per SMS. 2. Wählen Sie **API-Entwicklungstools** aus. 3. Erstellen Sie eine Anwendung: beliebiger Titel und Kurzname (5–32 Zeichen), Plattform **„Desktop**“. URL und Beschreibung können leer bleiben. 4. Kopieren Sie **die App-API-ID** (eine Zahl) und **den App-API-Hash** (32 hexadezimale Zeichen). Im Bedienfeld finden Sie die Felder **„API-ID“ und „Hash“** unterhalb des Anmeldeformulars. Sie können ein einzelnes „`api_id:api_hash`“-Paar in **das Feld „API-ID“** einfügen, woraufhin beide Felder automatisch ausgefüllt werden. Ein einziges Paar kann für alle Ihre Konten verwendet werden. Nach erfolgreicher Anmeldung wird es verschlüsselt ausschließlich in diesem Arbeitsbereich gespeichert und niemals an den Browser zurückgesendet. Es sind drei verschiedene Zugangsdaten beteiligt: | Geheim | Öffnet | Verfügbarkeit | | --- | --- | --- | | Panel-Token | Das TgWitness-Webpanel | `panel-token.txt` im Datenverzeichnis oder `TGWITNESS_TOKEN` | | API-ID + Hash | Für sich genommen nichts Besonderes; identifiziert die App | Integriertes Paar, importierte Einstellungen oder Ihre eigene App unter my.telegram.org | | Kontoautorisierung | Der Telegram-Account | Erstellt per Telefon-/QR-Anmeldung oder als Sitzung importiert | Falls Telegram über einen Proxy erreicht werden muss, richten Sie dies zunächst unter **Weitere Tools → Konto → Einstellungen → Verbindungseinstellungen → Verbindungsroute ändern** ein. ## Telefonnummer 1. Öffnen Sie **Weitere Tools → Konto**, Registerkarte **Telefon**, und geben Sie die Nummer im internationalen Format ein, zum Beispiel `+44 7700 900123`. Leerzeichen und Bindestriche werden automatisch entfernt. 2. Klicken Sie auf **„Weiter**“. Die Felder „API-ID“ und „Hash“ können leer bleiben. 3. Geben Sie den Code ein, den Telegram in der Regel an die Telegram-App sendet; Telegram entscheidet, ob eine SMS versendet wird. 4. Falls für das Konto eine zweistufige Verifizierung eingerichtet ist, geben Sie dieses Passwort ein. Es handelt sich dabei nicht um das Panel-Token und auch nicht um einen Gerätezugangscode. 5. Überprüfen Sie die nach der Anmeldung angezeigte Konto-ID und wählen Sie anschließend die Quellen aus. Anmeldedaten und das 2FA-Passwort werden niemals auf die Festplatte geschrieben. ## QR-Code Verwenden Sie diese Option, wenn das Konto bereits auf einem Smartphone oder einem anderen Computer angemeldet ist. 1. Registerkarte **„QR-Code“** → **QR-Code anzeigen**. API-ID + Hash können leer bleiben. 2. Auf dem angemeldeten Gerät: **Einstellungen → Geräte → Desktop-Gerät verknüpfen**, den Code scannen und bestätigen. 3. Geben Sie das 2FA-Passwort in TgWitness ein, falls Telegram Sie dazu auffordert. Das QR-Bild wird lokal generiert. Codes verfallen; klicken Sie auf **„Einen weiteren QR-Code generieren“,** um es erneut zu versuchen. Das Sperren des Fensters, das Wechseln des Arbeitsbereichs oder das Starten einer weiteren Anmeldung bricht einen ausstehenden Code ab. ## Authentifizierungsschlüssel + DC-ID Ein Auth-Key ist der 256-Byte-Autorisierungsschlüssel, der jeder Telegram-Sitzung zugrunde liegt und als **512 hexadezimale Zeichen** zusammen mit der Rechenzentrumsnummer **DC 1–5** geschrieben wird. 1. Registerkarte **„Auth-Schlüssel**“. Fügen Sie den vollständigen Schlüssel ein; ein verkürzter Schlüssel, der „`…`“ enthält, funktioniert nicht. 2. Wählen Sie die mit dem Schlüssel bereitgestellte DC-ID aus. 3. Geben Sie optional die **Benutzer-ID** ein. TgWitness lehnt die Verbindung dann ab, falls Telegram ein anderes Konto meldet. 4. Press **Connect-Konto**. Ein Auth-Schlüssel (512 Zeichen) ist kein API-Hash (32 Zeichen). Derselbe Schlüssel kann auch als JSON importiert werden, siehe [Account-JSON](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#account-json). ## Kontodateien Open **Add account → Files** and select up to **four files belonging to one account**, **8 MiB** in total, press **Check files**, then **Connect account**. Choosing files or pasting session text sends nothing; **Check files** sends them to your TgWitness server, which reads them without signing in and shows the session it found. Die Formulare „**Files**“, „**Auth key**“ und Bulk-Import zeigen vor dem Verbindungsaufbau die Warnung bezüglich paralleler Sitzungen an. Standardmäßig werden importierte Autorisierungen wiederverwendet. Halten Sie den ursprünglichen Client geschlossen, solange dessen Schlüssel hier verwendet wird. „**Files**“ und „**Auth key**“ bieten zudem die Option „**Create an independent authorization**“ an, die weiter unten beschrieben wird. Der Massenimport nutzt weiterhin den Direktmodus. Bei der Anmeldung per Telefon und über interaktiven QR-Code werden separate Autorisierungen erstellt. Die Warnungsüberschrift bleibt im Importformular sichtbar; die vollständige Erklärung wird automatisch angezeigt, sobald Dateien oder eine Schlüssel-/Sitzungszeichenfolge eingegeben werden. Sie kann nach dem Lesen ausgeblendet werden, sodass die Dateiauswahl und die Verbindungssteuerelemente auf einem Smartphone weiterhin nutzbar bleiben. Bei einer [zertifizierten Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/) (Phala Cloud, Intel TDX) erfolgt keine Erfassung eines importierten Schlüssels. Dort werden **Dateien** und **Auth-Schlüssel** nur verbunden, wenn **die Option Unabhängige Autorisierung erstellen** ausgewählt ist; ein Massenimport wird abgelehnt. Die Anmeldung per Telefon und QR-Code funktioniert wie gewohnt. - Die Dateien werden **im Arbeitsspeicher** Ihres TgWitness-Servers konvertiert. Hochgeladene Dateien werden nicht gespeichert, ZIP-Dateien werden nicht auf die Festplatte entpackt und es wird kein externer Dienst kontaktiert. - Die daraus resultierende Sitzung wird anschließend mit Telegram abgeglichen. Wenn eine Datei eine Benutzer-ID enthält, muss diese mit dem von Telegram gemeldeten Konto übereinstimmen. - Dateien, die verschiedene Konten oder unterschiedliche API-Zugangsdaten beschreiben, werden abgelehnt, anstatt sich für eine Option zu entscheiden. - **Passwort oder Sitzungstext** enthält das lokale TData-Passwortfeld, ein Feld zum Einfügen einer StringSession sowie die Option **Dateien lesen, ohne sich anzumelden** (füllt das Formular aus, ohne Telegram zu kontaktieren). Das Einfügen einer „StringSession“ löscht die ausgewählten Dateien, und die Auswahl von Dateien löscht den eingefügten Text, sodass die Überprüfung und die Verbindung die jeweils aktuelle Auswahl verwenden. Drücken Sie nach einer Passwortänderung erneut auf **Dateien prüfen**. ### Erstellen Sie eine eigenständige Autorisierung Wählen Sie „**Unabhängige Autorisierung erstellen“**, bevor Sie importierte Dateien oder einen Auth-Schlüssel verbinden. TgWitness verbindet den importierten Spender kurzzeitig, nutzt ihn zur Genehmigung des QR-Anmeldetokens des neuen Clients und trennt die Verbindung zum Spender unmittelbar nach der Genehmigung. Der neue Client verfügt über einen eigenen Autorisierungsschlüssel und ein separat ausgewähltes Desktop- Profil. Die vom Spender bereitgestellten API-Anmeldedaten und das Geräteprofil werden ausschließlich für die Verbindung zum Spender verwendet. Keine bestehende Autorisierung wird abgemeldet oder widerrufen. **Halten Sie den ursprünglichen Client des Spenders während dieses Schritts vollständig geschlossen.** Die anfängliche Verbindung nutzt weiterhin den kopierten Schlüssel, sodass dieser Modus das anfängliche Risiko einer parallelen Nutzung nicht beseitigen kann. Sobald die neue Autorisierung hergestellt ist, kann der Eigentümer den ursprünglichen Client wieder öffnen und beide gleichzeitig nutzen. Die interaktive **QR-Code-Anmeldung** ermöglicht es dem ursprünglichen Client, die Anmeldung zu genehmigen, ohne seinen Schlüssel hier zu kopieren oder zu verbinden. **Melden Sie sich nicht ab und beenden Sie die Spender-Sitzung nicht.** Wenn die Sitzung, die eine QR- Anmeldung genehmigt hat, endet, beendet Telegram auch die von ihr genehmigte Sitzung; bei einem Live-Test wurde die neue Autorisierung innerhalb einer Sekunde nach der Abmeldung des Spenders beendet. Der Import protokolliert die Spender-Sitzung (`session_origin.approved_by`: Gerät, API-ID und Erstellungszeit). Die Sitzungsliste markiert sie, **Sitzung beenden** lehnt sie ab, und **Alle anderen Sitzungen beenden** sowie **Diese zur einzigen Sitzung machen** lassen den Spender angemeldet bleiben. Wenn Telegram eine 2FA anfordert, verwendet dieser Modus `twoFA` die Daten aus der ausgewählten JSON-Datei, sofern vorhanden, oder fordert die Eingabe des Passworts an. Bei Ablehnung eines importierten Passworts kehrt man zum Passwortformular zurück. Passwörter werden nicht gespeichert. Der Schlüsselkandidat wird verschlüsselt gespeichert `independent_login.enc`, einschließlich Änderungen während der Migration des Rechenzentrums. Nach einer Unterbrechung wählen Sie denselben Spender und diese Option aus, um den gespeicherten Kandidaten fortzusetzen. Der Spender wird `help.getAppConfig` vor der Freigabe; bei einem gesperrten Konto wird der Vorgang an dieser Stelle abgebrochen. Wenn Telegram den Spender vor der Freigabe der Anmeldung ablehnt, wird der nicht freigegebene Kandidatenschlüssel verworfen und der Import kann erneut gestartet werden. Ein anderer Spender ersetzt einen gespeicherten Kandidaten nur dann, wenn Telegram diesen Kandidaten als nicht angemeldet meldet; ein Kandidat, der angemeldet ist oder auf sein 2FA-Passwort wartet, bleibt erhalten. Der Arbeitsbereich bleibt für dieses Konto reserviert; ein fehlgeschlagener Abschluss löscht den neuen Arbeitsbereich nicht. Behalten Sie dessen Datenverzeichnis und Tresorschlüssel bei. Die endgültigen Anmeldedaten und der `account.authorized` Journal-Eintrag enthalten die Importmethode, die Eingabeformate und die API-ID des Spenders, jedoch ohne den Spender-Schlüssel oder das Passwort. Am 5. November 2026 bestand ein spezielles Konto Live-Prüfungen mit den Anbietern Telethon, Pyrogram und TData: Abschluss der 2-Faktor-Authentifizierung, eindeutige neue Autorisierungsschlüssel, gleichzeitiger Zugriff durch den Anbieter und einen neuen Client sowie das Lesen eines öffentlichen Kanals. Im Telethon-Fall wurde zudem ein gespeicherter Kandidat nach einer Unterbrechung im Passwortschritt wieder aufgenommen. Jede neue Autorisierung schloss die sechs Initialisierungsanfragen nach der Anmeldung ab, und das signierte Journal wurde verifiziert. Die ursprüngliche Sitzung blieb in allen vier bereitgestellten Formaten nutzbar. Die [RPC-Fehlerdatenbank von Telegram](https://core.telegram.org/api/errors.json) ordnet `FRESH_CHANGE_ADMINS_FORBIDDEN` dem Wechsel von Administratoren, `FRESH_CHANGE_PHONE_FORBIDDEN` der Änderung der Telefonnummer und `FRESH_RESET_AUTHORISATION_FORBIDDEN` dem Widerrufen anderer Sitzungen, der Änderung ihrer Laufzeit oder der Registrierung eines Passworts zu. `SESSION_TOO_FRESH_*` und `PASSWORD_TOO_FRESH_*` betreffen Eigentumsübertragungen sowie Einnahmen- oder Geschenkabhebungen. Hierbei handelt es sich nicht um Erfassungsvorgänge; eine neue Anmeldung bedeutet kein pauschales 24-stündiges Leseverbot. Der Export kann `TAKEOUT_INIT_DELAY_*` separat zurückgeben. TgWitness behält vom Server angeforderte Pausen bei und versucht nicht, die Token-Akzeptanz automatisch erneut durchzuführen oder Sitzungen zu widerrufen, um Einschränkungen zu umgehen. **Weitere Tools → Konto → Kontosicherheit → Sitzungen dieses Kontos → Alle anderen Sitzungen beenden:** Ruft auf Anfrage des Betreibers `auth.resetAuthorizations` auf und protokolliert `account.all_other_sessions_terminated` mit der Anzahl der Sitzungen vor und nach dem Vorgang. Telegram akzeptiert dies von einer Sitzung, die seit 24 Stunden angemeldet ist. Wenn dieser Arbeitsbereich über einen QR-Code aus einer importierten Sitzung angemeldet wird, bleibt die Sitzung, die dies genehmigt hat, angemeldet: TgWitness beendet die anderen nacheinander mit ``account.resetAuthorization`` und protokolliert ``kept_approving_session``. **Machen Sie diese zur einzigen Sitzung**, beenden Sie den Vorgang dann mit diesem Grund und ändern Sie kein Passwort. **Stellen Sie sicher, dass dies die einzige Sitzung ist**, die dasselbe für einen Schlüssel durchführt, der durch die Anmeldung über diesen Arbeitsbereich erstellt wurde, und aktivieren Sie anschließend eine zweistufige Passwortauthentifizierung, falls das Konto noch keine besitzt. Das Fenster zeigt dieses Passwort einmalig an; TgWitness speichert es nur bis zu diesem Zeitpunkt im Tresor des Arbeitsbereichs. Das Protokoll zeichnet auf `session.exclusive_from`. Wenn Telegram später eine weitere Sitzung auflistet, wird dies im Journal vermerkt `session.exclusive_ended` und das Bedienfeld löst eine Warnung aus. Der Verifizierer gibt beides aus. **Machen Sie dies zur einzigen Sitzung, wenn Telegram dies zulässt** – es handelt sich um dieselbe Aktion mit einem Timer. Die Option erscheint unter **Sitzungen dieses Kontos** für einen in diesem Arbeitsbereich erstellten Schlüssel und wird als `session.exclusive_automatic` aufgezeichnet. Während der Beobachtung prüft der Collector alle fünf Minuten, ob seit dem `account.authorized`-Eintrag dieses Schlüssels 24 Stunden vergangen sind – Telegram antwortet zuvor mit `FRESH_RESET_AUTHORISATION_FORBIDDEN` – und führt dann denselben Vorgang einmal aus. Ein Erfolg wird wie bei der manuellen Schaltfläche als `session.exclusive_from` aufgezeichnet. Eine Ablehnung wird einmalig als `session.exclusive_postponed` mit der Begründung von Telegram protokolliert, und der Collector versucht es erneut mit einer steigenden Verzögerung von bis zu sechs Stunden. Der schreibgeschützte Modus hat hier keine Auswirkung: Das Beenden von Sitzungen ist eine Maßnahme zur Kontosicherheit, keine Chat-Aktion. Ein durch den automatischen Lauf generiertes Zwei-Schritt-Passwort wird im Workspace-Tresor gespeichert und mit dem Workspace-Schlüssel verschlüsselt, bevor Telegram es festlegt. Das Bedienfeld ruft es einmal von `POST /api/account/sessions/only/password`, wodurch es gelöscht wird, und zeigt es im selben Dialogfeld wie beim manuellen Ablauf an, wenn Sie **die Sitzungen dieses Kontos** öffnen. Auf der Verbindungsseite wird darauf hingewiesen, dass ein Passwort aussteht. Es wird niemals in das Protokoll aufgenommen und bleibt auch nach einem Neustart erhalten, bis es angezeigt wurde. Während der Beobachtung werden auch neue Sitzungen gemeldet: Wenn die Sitzungsliste von Telegram einen Eintrag erhält, nennt der Datensatz `account.sessions` diesen unter `added`, und das Panel löst eine Warnmeldung mit dem Gerät, der Anwendung und dem Land aus diesem Snapshot aus. ### Zeugenabfrage **Weitere Tools → Konto → Kontosicherheit → Witness Probe** prüft, ob ein anderer Client die Aktualisierungen dieses Kontos empfängt. Fügen Sie einen zweiten Arbeitsbereich hinzu, der mit einem anderen Telegram-Konto und einem eigenen Sitzungsschlüssel angemeldet ist, erstellen Sie eine private Gruppe mit beiden Konten, wählen Sie dann diese Gruppe als **Probe- Chat** und den zweiten Arbeitsbereich als **Witness-Arbeitsbereich** aus und aktivieren Sie die Probe. Bei beiden Konten muss **Nur Lesen** deaktiviert sein, und der Witness-Arbeitsbereich muss den Beobachtungsmodus aktiviert haben. Während der Beobachtung sendet dieser Arbeitsbereich alle 60–120 Sekunden `probe::` an die Gruppe und protokolliert `probe.sent`. Der Zeuge antwortet mit `ack::` und protokolliert `probe.seen` sowie `probe.ack_sent`. Ein Ack, das diese Sitzung innerhalb von 20 Sekunden als Live-Update erreicht, wird als `probe.acked` protokolliert. Andernfalls liest der Arbeitsbereich den aktuellen Verlauf der Gruppe aus. Eine Bestätigung, die dort gefunden, aber nicht live übermittelt wurde, wird als `coverage.gap` mit dem Grund `probe_ack_missed_live` protokolliert: Das Panel löst eine Warnung aus und markiert die Ereignisaufnahme als fehlgeschlagen, bis eine spätere Bestätigung live eintrifft (`connection.restored`, Grund `probe_ack_live`). Keine Bestätigung wird als `probe.unanswered` protokolliert; eine Verbindungsunterbrechung während der Wartezeit oder ein unlesbarer Verlauf als `probe.inconclusive`. Schreibschutz, Telegram-Einschränkungen und FloodWait-Pausen werden einmalig als `probe.skipped` protokolliert. ### Telethon `.session` | | | | --- | --- | | Was ist das? | Die SQLite-Datenbank, die von Telethon-basierten Tools erstellt wird, zum Beispiel `my_account.session` | | Anerkannt von | Tabellen `sessions` (zusammen mit `dc_id`, `server_address`, `port`, `auth_key`) und `version` = 7 oder 8 | | Anforderungen | Genau eine Zeile mit autorisierten Sitzungen; eine geschlossene, vollständige Datenbank | Schließen Sie zunächst das Programm, das die Datei erstellt hat. Falls `my_account.session-journal` oder `my_account.session-wal` daneben vorhanden sind, ist die Datenbank noch nicht abgeschlossen: Öffnen und schließen Sie den ursprünglichen Client ordnungsgemäß. Das Löschen dieser Sidecar-Dateien kann zu einer beschädigten Kopie führen. ### Pyrogram `.session` | | | | --- | --- | | Was ist das? | Die SQLite-Datenbank, die von Pyrogram-basierten Tools erstellt wird | | Anerkannt von | Tabelle `sessions` mit `dc_id`, `auth_key`, `test_mode`, `user_id`, `is_bot`; `version` = 2 oder 3 | | Anforderungen | Eine autorisierte Benutzersitzung im Produktionsnetzwerk. Bot- und Test-DC-Sitzungen werden abgelehnt. | Die gespeicherte Benutzer-ID wird bei der Anmeldung mit den Daten von Telegram abgeglichen. ### Paar aus Sitzung und JSON Die Datensätze werden häufig als zwei Dateien mit demselben Namen bereitgestellt, beispielsweise „ `447700900123.session`“ und „`447700900123.json`“. Wählen Sie **beide** gleichzeitig aus. - Ausgehend vom JSON verwendet TgWitness `app_id`/`api_id` und `app_hash`/`api_hash`, sodass Sie in der Regel keine API-Anmeldedaten eingeben müssen. - Das Verbindungsprofil verwendet `device_model` (Alias `device`), `system_version` (Alias `sdk`), `app_version`, `lang_code`, `system_lang_code` (Alias `system_lang_pack`), `lang_pack` und optional `tz_offset` (Sekunden ab UTC, -43200 bis 50400). Angegebene Felder haben Vorrang vor generierten Standardwerten und der Sprache des Panels bzw. Browsers . Widersprüchliche Aliase werden abgelehnt. Das aufgelöste Profil wird in den verschlüsselten Arbeitsbereichs-Anmeldedaten gespeichert und nach einem Neustart wiederverwendet, einschließlich der App-Version. - `phone`, Proxy-Einstellungen und Gerätetoken werden **ignoriert**. `twoFA` ist schreibgeschützt, wenn **Unabhängige Autorisierung erstellen** ausgewählt ist; beim direkten Import wird es ignoriert. - Ein JSON ohne ein unterstütztes Autorisierungsfeld ist lediglich Metadaten. Fügen Sie die zugehörige Sitzungsdatei hinzu oder fahren Sie mit der Anmeldung per Telefon oder QR-Code fort. Ein JSON, das eine unterstützte Sitzung oder einen Auth-Schlüssel enthält, kann eigenständig autorisieren; siehe [Account JSON](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#account-json). ### Telegram Desktop (TData) TData ist der Ordner „`tdata`“ der Telegram-Desktop-Anwendung (die plattformübergreifende App von desktop.telegram.org). | System | Standardstandort „`tdata`“ | | --- | --- | | Windows | `%APPDATA%\Telegram Desktop\tdata` (portables Telegram: neben `Telegram.exe`) | | Linux | `~/.local/share/TelegramDesktop/tdata` | | macOS | `~/Library/Application Support/Telegram Desktop/tdata` | So importieren Sie es: > **Warnung vor parallelen Sitzungen.** Der direkte TData-Import verwendet den Autorisierungsschlüssel von Telegram Desktop erneut . Verwenden Sie diesen Schlüssel nicht gleichzeitig in Desktop und TgWitness. Telegram kann die Autorisierung mit `AUTH_KEY_DUPLICATED` ungültig machen, wodurch beide Instanzen bis zu einer erneuten Anmeldung unbrauchbar werden. > > > > Beenden Sie Desktop vollständig, einschließlich des Taskleistens-Prozesses, und lassen Sie diese Instanz geschlossen, während TgWitness die importierte Sitzung nutzt. **Beenden Sie die Anwendung, melden Sie sich nicht ab und widerrufen Sie die Sitzung nicht:** Ein Widerruf macht auch die importierte Instanz ungültig. Wenn beide Clients laufen müssen, wählen Sie **Unabhängige Autorisierung erstellen** und lassen Sie den Desktop geschlossen, bis die neue Anmeldung erfolgreich ist, oder melden Sie sich bei TgWitness per Telefon oder QR-Code an. Ein eigenes Konto wird empfohlen, macht die parallele Nutzung geklonter Schlüssel jedoch nicht sicher. > > > > Dies gilt auch für importierte `.session`-Dateien, StringSession-Text und Auth-Key-HEX-Daten. Andere Clients mit eigenen, unabhängig erstellten Autorisierungen können angemeldet bleiben. Siehe [die Dokumentation zu „AUTH_KEY_DUPLICATED“ von Telegram](https://core.telegram.org/api/errors#406-not-acceptable). 1. Beenden Sie Telegram Desktop vollständig. 2. Erstellen Sie eine ZIP-Datei, die **ausschließlich** diese beiden Elemente aus `tdata` enthält: - `key_datas` - die 16-stellige Dateiendung „`s`“ daneben, in der Regel „`D877F783D5D3EF8Cs`“ Das Komprimieren des gesamten Ordners einschließlich seines Medien-Caches überschreitet in der Regel die Grenzwerte (512 Einträge, 32 MiB entpackt). 3. Wählen Sie die ZIP-Datei unter **„Dateien“** aus. Falls für Telegram Desktop ein **lokaler Passcode** eingerichtet ist, geben Sie diesen zunächst unter **„Passcode“ oder „Sitzungstext“** ein. Dies ist nicht das 2FA-Passwort. Unterstützt: ein Konto pro Archiv, moderner `key_datas`-/`key_data0`-/`key_data1`-Speicher, lokaler Passcode. Nicht unterstützt: Ordner mit mehreren angemeldeten Konten, ältere Desktop- Layouts, passwortgeschützte ZIP-Dateien sowie die separate native macOS-App „Telegram für macOS“. ### Telethon StringSession Eine einzelne Textzeile, die in der Regel mit „`1`“ beginnt und etwa 350 Zeichen lang ist. Laden Sie sie als „`.txt`“- oder „`.tgwitness-session`“-Datei (maximal 4 KiB) hoch oder fügen Sie sie unter **„Passcode“ oder „Sitzungstext“** ein. Es werden ausschließlich Telethon-Zeichenfolgen akzeptiert; Pyrogram- und TDLib- Zeichenfolgen verwenden andere Formate. ### Auth-Schlüssel und DC in einer Zeile Kontolisten enthalten oft die rohe Autorisierung im Format `<512 hexadecimal characters>:`, zum Beispiel `a1b2…ef:5`. Fügen Sie diese Zeile unter **Passcode oder Session Text** ein, laden Sie sie als Textdatei hoch oder tragen Sie sie in das Feld `session` eines [Konto-JSONs](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#account-json) ein. TgWitness ordnet DC 1–5 denselben Produktionsadressen zu wie der JSON-Import von `auth_key` + `dc_id` und meldet das Format als **Auth key HEX und DC**. Jede andere DC-Nummer oder Schlüssellänge wird abgelehnt. ### JSON-Datei für das Konto Ein JSON-Objekt mit einer Größe von maximal **64 KiB** in einer Datei mit der Endung „**`.json`**“. | Feld (Aliase) | Bedeutung | | --- | --- | | `api_id` (`app_id`) | Anwendungs-ID, eine positive Zahl | | `api_hash` (`app_hash`) | Anwendungs-Hash, 32 hexadezimale Zeichen | | `string_session` (`session_string`, `session_str`; veraltetes `session`) | Telethon-StringSession-Text oder `<512 hexadecimal characters>:`, kein Dateiname | | `auth_key` (`auth_key_hex`) + `dc_id` | Vollständiger Auth-Schlüssel mit 512 Zeichen und DC 1–5 | | `user_id` (`id`) | Optional; vor dem Speichern der Autorisierung mit Telegram abgeglichen | | `device_model` (`device`) | Beschreibung des Verbindungsgeräts | | `system_version` (`sdk`) | Version des verbundenen Betriebssystems | | `app_version` | An Telegram gesendete Anwendungsversion | | `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | Client-Sprache, Systemsprache und Client-Sprachpaket; ein leeres `lang_pack` ist zulässig | | `tz_offset` | Optionaler UTC-Offset in Sekunden, gesendet in `initConnection.params`; Ganzzahl oder dezimale Ganzzahl als Zeichenkette | Sind sowohl ein Alias als auch der Hauptname vorhanden, müssen diese übereinstimmen. Explizite Telethon- Sitzungsfelder haben Vorrang vor einem generischen `session`-Blob in einem anderen Format. Wenn beide erkennbare Telethon-Sitzungen enthalten, müssen sie dieselbe Autorisierung beschreiben. Ohne ein explizites Feld muss `session` eine gültige Telethon-StringSession oder ein Auth-Schlüssel und eine DC im Format `<512 hexadecimal characters>:` sein. Beispiele: ``` { "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" } ``` ``` { "api_id": 1234567, "api_hash": "0123456789abcdef0123456789abcdef", "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS", "dc_id": 2, "user_id": 123456789 } ``` Im ersten Beispiel werden lediglich die API-Anmeldedaten eingegeben; melden Sie sich per Telefon oder QR-Code an oder fügen Sie eine Sitzungsdatei hinzu. Massenlisten (ein JSON-Array mit Konten) werden nicht akzeptiert. ## Ermitteln Sie, was Ihnen vorliegt | Wie Sie sehen | Es ist | Verwendung | | --- | --- | --- | | `*.session`; beim Öffnen in einem Texteditor wird oben „`SQLite format 3`“ angezeigt | Telethon oder Pyrogram SQLite | **Dateien** (werden automatisch erkannt) | | Ein Ordner „`tdata`“, der „`key_datas`“ enthält | Telegram Desktop TData | Zwei Dateien als ZIP-Datei komprimieren, dann **„Dateien“** | | Eine Textzeile, beginnend mit `1`, ca. 350 Zeichen | Telethon StringSession | **Dateien** | | Eine Textzeile `512 characters 0-9a-f`, gefolgt von `:` und einer Ziffer zwischen 1 und 5 | Authentifizierungsschlüssel und DC | **Dateien**, **Passcode für Box oder Sitzungstext** | | `*.json` mit `app_id`/`app_hash` | Begleitende Metadaten | **Dateien** zusammen mit der zugehörigen Sitzung | | `*.json` mit `auth_key` oder `string_session` | JSON-Datei für das Konto | **Dateien** | | 512 Zeichen `0-9a-f` | Auth-Schlüssel | **Authentifizierungsschlüssel** | | 32 Zeichen `0-9a-f` | API-Hash | **API-ID + Hash** | | `td.binlog` oder ein `db.sqlite` aus einer TDLib-App | TDLib-Speicher | Nicht unterstützt | | `123456789:AA…` | Bot-Token | Nicht unterstützt | ## Nicht unterstützte Formate | Format | Alternative | | --- | --- | | TDLib-Speicher (`td.binlog`) und TDLib-Exporte | Anmeldung per Telefon oder QR-Code | | Pyrogram-Sitzungs**strings** | Verwenden Sie die Pyrogram-Datei „`.session`“ oder den Telefoncode bzw. den QR-Code. | | TData mit mehreren angemeldeten Konten | Melden Sie sich von den anderen Konten in Telegram Desktop ab oder verwenden Sie die jeweilige Sitzungsdatei des jeweiligen Kontos | | Bot-Token | Nicht unterstützt: TgWitness fungiert als Benutzerkonto | | CSV-/JSON-Listen zahlreicher Konten | Importieren Sie unterstützte Sitzungsdateien über **Konten → Konten importieren** oder melden Sie sich per Telefon/QR in separaten Arbeitsbereichen an | | Test-DC- oder Bot-Sitzungen | Verwenden Sie ein Produktionsbenutzerkonto | ## Mehrere Konten Drücken Sie die Taste **+** neben der Kontoauswahl oder öffnen Sie **Weitere Tools → Konto → Einstellungen → Verbindungseinstellungen → Arbeitsbereiche**, geben Sie eine Bezeichnung ein und melden Sie sich an. - Beliebig viele Arbeitsbereiche, einschließlich des Hauptarbeitsbereichs. Jeder verfügt über eine eigene Sitzung, eine eigene Proxy-Route, Quellen, Erfassungsrichtlinien, ein Protokoll, einen Signaturschlüssel, Checkpoints und Exportfunktionen. - Das Wechseln des angezeigten Arbeitsbereichs führt nicht dazu, dass die anderen angehalten werden. - Ein Protokoll bleibt an das Konto gebunden, das es erstellt hat. Die Anmeldung mit einem anderen Konto erfordert einen weiteren Arbeitsbereich, und ein Konto kann nicht zwei Arbeitsbereichen zugeordnet werden. - Das Haupt-Panel-Token steuert alle Arbeitsbereiche. [Durch die Erteilung von Zugriffsrechten](https://phishdestroy.io/tgwitness/de/docs/reference/access/) können andere Personen auf ausgewählte Konten und Chats beschränkt werden, wobei separate Berechtigungen und Sitzungslimits gelten. - **„Accounts“** benennt einen Arbeitsbereich um und löscht einen hinzugefügten Arbeitsbereich samt dessen Sitzung, Protokoll, Quellen und Signaturschlüssel. Der Hauptarbeitsbereich kann nicht über das Bedienfeld gelöscht werden. ### Stapelimport und Kontogruppen Verwenden Sie **„Konten“ → „Konten importieren“**, um mehrere Konten hinzuzufügen, Dateien anhand des Basisnamens zuzuordnen und die jeweiligen Anmeldeergebnisse einzusehen. Jedes Konto erhält einen eigenen Arbeitsbereich. Eine Gruppe fasst verwandte Konten zusammen, ohne deren Sitzungen, Schlüssel oder Beweismaterialien zusammenzuführen. **„Gruppe** unter **‚Konten‘ öffnen**“ führt zu deren Seite unter `/groups/`: - **Konten:** Verbindungsweg, Beobachtungen und letzte Nachricht jedes Mitglieds, mit den Funktionen **„Alle** starten“ und **„Alle pausieren**“. - **Erfordert Aufmerksamkeit:** Konten, bei denen die Anmeldung beendet wurde, die nicht verfügbar sind oder bei denen ein Verbindungs-, Erfassungs-, Quellen- oder Medienproblem vorliegt; jeder Name führt zu der entsprechenden Karte. - **Chats mehrerer Konten zeigen:** gemeinsam genutzte Quellen, die Konten, die diese beobachten, sowie Unterbrechungen im verfügbaren Beobachtungszeitraum des Arbeitsbereichs (bis zu sieben Tage). **Der Export mit N Konten** teilt den Export eines Kanals oder einer Supergruppe auf diese Konten auf und signiert ein Archiv. - **Gruppe exportieren:** ein ZIP mit dem signierten Export jedes Kontos unter `accounts/` und `manifest.json` mit einer Auflistung der SHA-256- und Schlüssel-Fingerabdrücke, signiert vom Haupt- Arbeitsbereich in `manifest.signature.json`. Überprüfen Sie jedes Kontoarchiv einzeln mit `python -m tgwitness.verify` und dem vertrauenswürdigen Fingerabdruck dieses Kontos. Die Mitglieder nutzen die gemeinsamen Einstellungen der Gruppe; ein Konto kann jedoch eigene Werte beibehalten. Siehe [„Gemeinsame Einstellungen“](https://phishdestroy.io/tgwitness/de/docs/reference/settings/#account-groups), [die Anleitung zu Import und Gruppen](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) sowie [das Dashboard „MTProxy-Pool](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources)“. ## Abmelden **Weitere Tools → Konto → Bei Telegram abmelden** (mit angehaltener Beobachtung) fordert Telegram auf, die Sitzung zu beenden, sodass sie auch aus den **Einstellungen → Geräte** des Kontos verschwindet und die Sitzung aus dem Arbeitsbereich-Tresor entfernt wird. Das Journal, die Quellen, die Einstellungen und der Signaturschlüssel bleiben erhalten, und das Journal protokolliert die Abmeldung. Der Arbeitsbereich gehört weiterhin zu seinem Konto: Nur dieses Konto kann sich erneut damit verbinden. Wenn Telegram nicht antwortet, wird die Sitzung dennoch hier entfernt und das Fenster zeigt dies an; beenden Sie sie in Telegram unter **Einstellungen → Geräte**. ## Wenn Telegram die Sitzung beendet Wenn Telegram das Konto sperrt, friert oder abmeldet oder die Sitzung von einem anderen Gerät aus beendet, protokolliert das Journal den Grund, den Telegram-Fehler, die Route und das Rechenzentrum. Der Zustand des Kontos zeigt **Bericht über den Kontoverlust herunterladen** an: eine signierte JSON-Datei mit den Journal-Einträgen der letzten 24 Stunden vor dem Verlust, nämlich Verbindungen, Routen, Sitzungen, Kontobenachrichtigungen und Abdeckungslücken, jeweils mit ihrem Journal-Hash und ihrer Signatur. Überprüfen Sie dies mit `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`; der Beweisexport enthält die vollständige Hash-Kette. Ein gesperrtes Konto wird ebenfalls erkannt, wenn es eine Verbindung herstellt und während der Überwachung, und seine Sende- und Beitrittsaktionen werden deaktiviert. ## Sichere Aufbewahrung von Kontodateien - Behandeln Sie jedes `.session`, jede TData-ZIP-Datei, jede StringSession, jeden Auth-Schlüssel und jede Konto-JSON-Datei wie ein Passwort. TgWitness speichert die importierten Autorisierungsdaten in seinem verschlüsselten Tresor; Sie können die Originaldateien anschließend löschen. - Führen Sie dieselbe Autorisierung nicht gleichzeitig in zwei Programmen aus. Telegram könnte diese widerrufen (`AUTH_KEY_DUPLICATED`), woraufhin beide Instanzen nicht mehr funktionieren. - Eine abgelaufene oder widerrufene Sitzung kann nicht durch eine Konvertierung wiederhergestellt werden. Bitte melden Sie sich erneut an. ## Fehlerbehebung | Meldung oder Symptom | Vorgehensweise | | --- | --- | | *Diese Sitzung kann nicht gelesen werden. Schließen Sie den ursprünglichen Client…* | Die SQLite-Datei ist geöffnet oder unvollständig (Sidecar-Datei `-journal`/`-wal`). Beenden Sie das ursprüngliche Programm ordnungsgemäß und kopieren Sie die Datei erneut. | | *Unterstützte Telethon-SQLite-Schemas: 7 und 8* / *Pyrogram … 2 und 3* | Die Datei wurde mit einer sehr alten oder unbekannten Bibliotheksversion erstellt. Melden Sie sich stattdessen per Telefon/QR-Code an. | | *Es werden ausschließlich autorisierte Produktionsnutzersitzungen unterstützt* | Die Pyrogram-Datei gehört zu einem Bot oder zum Testnetzwerk. | | *Das TData-Archiv umfasst mehr als 512 Einträge oder 32 MiB* | Bitte nur die ZIP-Dateien „`key_datas`“ und „`D877F783D5D3EF8Cs`“, nicht den gesamten Ordner. | | *TData kann nicht entschlüsselt werden. Überprüfen Sie den lokalen Passcode auf dem Desktop.* | Geben Sie den lokalen Passcode von Telegram Desktop unter **„Passcode“ oder „Sitzungstext“** ein. | | *Importieren Sie jeweils ein TData-Konto* | Telegram Desktop verfügte über mehrere Konten; siehe [„Nicht unterstützte Formate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#unsupported-formats)“. | | *Ausgewählte Dateien beschreiben verschiedene Konten oder API-Zugangsdaten* | Wählen Sie Dateien nur aus einem einzigen Konto aus. | | *Die JSON-Datei enthält keine unterstützten API-Anmeldedaten oder Autorisierungen.* | Überprüfen Sie die Feldnamen in [der JSON-Datei „Account](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#account-json)“. | | *Ausschließlich API-Metadaten* | Die JSON-Datei enthält keine Sitzung. Fügen Sie die Datei „`.session`“ hinzu oder verwenden Sie die Telefonnummer bzw. den QR-Code. | | *Der Auth-Key (HEX) muss alle 512 hexadezimalen Zeichen enthalten* | Der Schlüssel ist abgeschnitten oder enthält „`…`“. | | Die Konto-ID stimmt nicht mit dem importierten Konto überein | Die Benutzer-ID der Datei weicht von der von Telegram gemeldeten ab; die Datei bezieht sich auf ein anderes Konto. | | Das Konto gehört bereits zu einem anderen Arbeitsbereich | Öffnen Sie diesen Arbeitsbereich, anstatt das Konto zweimal hinzuzufügen. | | Verbunden, aber in der Chat-Liste unter **Weitere Tools → Quellen** fehlt eine private Gruppe. | Überprüfen Sie die Mitgliedschaft. Der Picker untersucht die ersten 1,000 Dialoge; erhöhen Sie das Limit unter **Weitere Tools → Parameter**. | | Proxy-Verbindung fehlgeschlagen | Überprüfen Sie den Routing- und IP-Modus. „Automatic“ MTProxy versucht es mit einem anderen funktionierenden Eintrag. „Hide the address“ wartet; „Direct“ kann als letztes Mittel nach der konfigurierten Verzögerung eine direkte Verbindung herstellen. Siehe [Routing-Modi](https://phishdestroy.io/tgwitness/de/docs/reference/connection/#ip-modes). | Siehe auch: [Verbindung und Sicherheit](https://phishdestroy.io/tgwitness/de/docs/reference/connection/) für Proxys und Verschlüsselung, sowie [die Funktionsweise der Datenerfassung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/) hinsichtlich der nach der Anmeldung erfassten Inhalte. --- # Telegram · Zugriff und Berechtigungen Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/access/ Legen Sie den Zugriff auf Konten und Chats fest, wählen Sie Berechtigungen aus, beschränken Sie Sitzungen und IP-Adressen und entziehen Sie den Zugriff. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Legen Sie den Zugriff auf Konten und Chats fest, wählen Sie Berechtigungen aus, beschränken Sie Sitzungen und IP-Adressen und entziehen Sie den Zugriff. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Erste Schritte](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) ![Erste Schritte](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) Gewähren Sie einem Prüfer Zugriff auf einen Chat, einem Analysten die Berechtigung zum Exportieren eines Falls oder einem Operator die Kontrolle über ausgewählte Konten. Jede Person erhält ihr eigenes Token. Das Haupt- Panel-Token verbleibt beim Administrator. [Einrichtung eines Kontos](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/) · [Verbindungswege](https://phishdestroy.io/tgwitness/de/docs/reference/connection/) · [Sicherheitsmodell](https://phishdestroy.io/tgwitness/de/docs/reference/security/) ## Zwei Anwendungsbereiche, zwei unterschiedliche Aufgabenbereiche **Der Erfassungsumfang** bestimmt, was ein Konto aufzeichnet: ausgewählte Chats, einen Telegram-Ordner oder das gesamte Konto. **Der Zugriffsumfang** legt fest, welche dieser aufgezeichneten Konten und Chats eine andere Person einsehen und nutzen kann. Die Gewährung von Zugriff bedeutet nicht, dass man einem Telegram-Chat beitritt, die Erfassung startet oder Berechtigungen für das Telegram-Konto erhält. Ein Zugriff kann ausgewählte Arbeitsbereiche, ausgewählte Chats innerhalb dieser, alle Arbeitsbereiche oder jedes Konto einer [Kontengruppe](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#bulk-import-and-account-groups) umfassen. **Alle Arbeitsbereiche, einschließlich später hinzugefügter,** umfassen auch zukünftige Konten. Ein Gruppenzugriff umfasst ebenfalls Konten, die dieser Gruppe später hinzugefügt werden. Wählen Sie Arbeitsbereiche explizit aus, wenn ein Fall auf diese beschränkt bleiben soll. ## Jemandem Zugriff gewähren 1. Melden Sie sich als Hauptadministrator an und öffnen Sie **Weitere Tools → Zugriff**. 2. Geben Sie unter **„Jemandem Zugriff gewähren**“ einen Namen ein, den Sie im Protokoll wiedererkennen werden. 3. Wählen Sie die Arbeitsbereiche und, falls erforderlich, die einzelnen Chats aus. 4. Wählen Sie aus, was diese Person tun könnte. **Die Ansicht** ist stets enthalten. 5. Legen Sie die Gültigkeitsdauer, die Anmelde-/Sitzungslimits und die zulässigen Adressen nach Bedarf fest. 6. Klicken Sie auf **„Zugriff erstellen**“. Kopieren Sie das Token jetzt: Es wird nur einmal angezeigt. 7. Senden Sie die Panel-Adresse und das Token privat. Der Empfänger gibt dieses Token auf der normalen Anmeldeseite ein; er benötigt weder Ihr Haupt-Panel-Token noch eine Telegram-Sitzung. Öffnen Sie das Fenster mit dem ausgestellten Token in einer separaten Browsersitzung und überprüfen Sie die sichtbaren Chats sowie die zulässigen Aktionen, bevor Sie es weitergeben. Zugriffsnamen verbleiben im verschlüsselten lokalen Speicher und werden über das Administrator-Panel aufgelöst. Namen werden in neuen Prüfprotokollen zu Zugriffen und zur Erstellung von Arbeitsbereichen weggelassen; bestehende signierte Datensätze behalten ihre ursprünglichen Felder bei. ## Wählen Sie die Berechtigungen aus Verwenden Sie für eine rein textbasierte öffentliche Demonstration **die Option „Public Showcase“** anstelle des normalen Reviewer-Zugriffs. Dabei werden explizit ausgewählte öffentliche Kanäle, gespeicherte Bearbeitungen und Löschungen sowie signierte Statistiken angezeigt, wobei Autorenfelder unkenntlich gemacht und Dateien an der API-Grenze geschlossen werden. [Erstellen und überprüfen Sie ein Showcase](https://phishdestroy.io/tgwitness/de/docs/reference/showcase/). | Genehmigung | Was es ermöglicht | | --- | --- | | `view` | Lesen Sie freigegebene Chats, erfasste Nachrichten, Profile, Dateien und gefilterte Protokollaufzeichnungen. Immer enthalten. | | `export` | Der Export von Chat-Verläufen und Dossiers ist zulässig. Für den Export von Beweismaterial aus dem gesamten Arbeitsbereich ist Zugriff auf den gesamten Arbeitsbereich erforderlich. | | `sources` | Verwalten Sie Quellen, Momentaufnahmen und Profilerfassungen. Der auf Chats beschränkte Zugriff ist nur in zugelassenen Chats möglich; die kontoweite Quellenerkennung und die Umfangseinstellungen bleiben deaktiviert. | | `collect` | Einen Collector starten oder stoppen. Erfordert Zugriff auf den gesamten Arbeitsbereich, da die Erfassung Auswirkungen auf das Konto hat. | | `interact` | Führen Sie unterstützte Telegram-Interaktionen innerhalb des Zugriffsumfangs durch. Bei einem auf den Chat beschränkten Zugriff können keine kontoweiten Link-Vorschauen genutzt werden. | | `settings` | Ändern Sie die Erfassungseinstellungen, Zeitstempel, Benachrichtigungen, externe Kopien und Parameter. Erfordert Zugriff auf den gesamten Arbeitsbereich. | | `account` | Melden Sie sich bei Telegram an oder ab und verwalten Sie Verbindungswege. Erfordert Zugriff auf den gesamten Arbeitsbereich. | | `board.read` | Lesen Sie die Notizen im Case Board nur innerhalb des zulässigen Arbeitsbereichs und der zulässigen Chats. | | `board.write` | Fügen Sie Lesezeichen, Markierungen, Ausschnitte, Kommentare sowie Öffnungs- und Überprüfungsstatus hinzu. Erfordert außerdem „`board.read`“. | | `board.manage` | Verwalten Sie Sammlungen, endgültige Teamstatus und die Karten anderer Teilnehmer. Erfordert außerdem Lese- und Schreibzugriff auf das Board. | Nur der Hauptadministrator kann den Wiederherstellungsschlüssel für die externe Replik herunterladen. Ein delegierter Zugriff auf `settings` oder `account` gewährt keinen Zugriff auf diesen Schlüssel. Berechtigungen und Geltungsbereich werden gemeinsam geprüft. Das Aktivieren einer Berechtigung führt nicht dazu, dass andere Chats geöffnet werden oder bei einem auf einen Chat beschränkten Zugriff eine arbeitsbereichsweite Aktion freigeschaltet wird. Für einen parallelen Export muss der Zugriff den exportierten Chat in jedem ausgewählten Konto abdecken. Ein erteilter Zugriff darf keine neuen Zugriffe erstellen, keine Sitzungen anderer Personen verwalten oder die Administratorkonsole öffnen. ### Drei nützliche Konfigurationen | Person | Geltungsbereich | Berechtigungen | | --- | --- | --- | | Rezensent | Aufgezeichnete Chats aus einem Fall | `view` | | Analyst, der eine Übergabe vorbereitet | Die zu untersuchenden und zu exportierenden Chats | `view`, `export`; fügen Sie `interact` nur hinzu, falls diese über Telegram agieren sollen | | Erfassungsoperator | Ausgewählte vollständige Arbeitsbereiche | `view`, `sources`, `collect`; fügen Sie `settings` oder `account` nur bei Bedarf hinzu | Zu den Startvoreinstellungen des Zugriffsformulars gehört auch das Fall-Dashboard: Prüfer können lesen, Analysten können lesen und schreiben, und Betreiber können es verwalten. Die Voreinstellungen bleiben bearbeitbar, und bestehende Berechtigungen werden nicht automatisch erweitert. Siehe [Fall-Dashboard](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/) für vererbte Chat-Bereiche und Exportdatenschutz. ## Beschränkungen und Sitzungen | Einleitung | So funktioniert es | | --- | --- | | Parallelsitzungen | Begrenzen Sie die Anzahl gleichzeitiger Sitzungen auf 1–100. Bei Erreichen der Obergrenze lehnen Sie die nächste Anmeldung ab oder beenden Sie die älteste Sitzung. | | Anmeldungen sind zulässig | Die Anzahl der erfolgreichen Verwendungen des Tokens zum Starten von Sitzungen ist begrenzt. Bestehende Sitzungen werden nicht beendet, nur weil die letzte zulässige Anmeldung genutzt wurde. | | Gültig bis | Eine absolute Ablauffrist für den Zugriff. Bei abgelaufenem Zugriff ist eine Anmeldung oder die weitere Übermittlung von Anfragen nicht mehr möglich. | | Minuten ohne Aktivität | Zeitlimit für Inaktivität in einer Sitzung: von 5 Minuten bis zu 30 Tagen. Erfolgreiche Anfragen verlängern dieses Limit; ein geöffnetes Fenster kann durch regelmäßige Abfragen seine Aktivität aufrechterhalten. | | Zulässige Adressen | Geben Sie bestimmte IP-Adressen oder CIDR-Subnetze an. Lassen Sie das Feld leer, um alle Adressen zuzulassen, sofern die Bindung bei der ersten Anmeldung nicht aktiviert ist. | | Bei der ersten Anmeldung verknüpfen | Bei der ersten erfolgreichen Anmeldung wird die zulässige Adresse für diesen Zugriff festgelegt. | Die IP-Adresse ist die vom Programm erkannte Client-Adresse. Wenn Sie sich hinter einem Reverse-Proxy oder einem Tunnel befinden, überprüfen Sie bitte die unter **„Offene Sitzungen“** angezeigte Adresse, bevor Sie sich auf IP-Regeln verlassen: Andernfalls könnte es den Anschein haben, dass sich mehrere Benutzer die Adresse des Proxys teilen. ## Zugriff ändern oder widerrufen Bearbeiten Sie einen Eintrag unter **„Gewährter Zugriff“**, um dessen Geltungsbereich, Berechtigungen oder Einschränkungen zu ändern. Änderungen am Geltungsbereich und an den Berechtigungen werden bei nachfolgenden Anfragen überprüft, einschließlich Anfragen aus bereits geöffneten Sitzungen. Das Widerrufen eines Zugriffs beendet dessen Sitzungen und macht das ausgestellte Token unbrauchbar. Über **„Offene Sitzungen“** kann der Administrator auch eine einzelne Sitzung beenden, ohne den gesamten Zugriff zu widerrufen. Gespeicherte Exportkopien behalten ihren Ersteller, Arbeitsbereich, Chat-Gültigkeitsbereich und die erforderlichen Berechtigungen bei. Ein berechtigter Nutzer kann seine eigenen Kopien nur so lange auflisten oder herunterladen, wie diese Berechtigungen noch gelten; Kopien, die das Case Board enthalten, erfordern zusätzlich `board.read`. Der Administrator kann alle Kopien abrufen. Ältere Kopien ohne diese Metadaten und Gruppenbündel sind nur für den Administrator zugänglich. Download-Tickets und vorbereitete Dateiantworten überprüfen den Zugriff erneut nach der Vorbereitung der Datei, bevor deren Daten gesendet werden. Jeder Nutzer, einschließlich des Administrators, kann pro Arbeitsbereich zehn ausstehende Download-Tickets halten; das arbeitsbereichsweite Limit beträgt 1,000. Tickets verfallen nach 120 Sekunden und sind nur einmal verwendbar. Durch eine Widerrufung können bereits heruntergeladene Dateien nicht wiederhergestellt werden. Das Abmelden, das Sperren des Fensters oder das Beenden einer Sitzung stoppt einen laufenden Collector nicht. ## Was der Administrator sehen kann Prüfer und Analysten erhalten Informationen zum Erfassungsfortschritt ohne Proxy-Endpunkte, Pool-Diagnosen, Serverpfade oder rohe Verbindungsfehler. Für die Verbindungsdiagnose ist die Berechtigung „`account`“ für den gesamten Arbeitsbereich erforderlich. Das Lesen von Benachrichtigungen, Offsite-Kopien und Parametereinstellungen erfordert die Berechtigung „`settings`“. Vollständige Browser-User-Agent-Zeichenfolgen werden in Zugriffssitzungen nicht beibehalten. Bei einem Upgrade werden sie zudem aus dem veränderbaren Sitzungscache entfernt. Das Protokoll des Panel-Prozesses maskiert IP-Literale, URL-Anmeldedaten und gekennzeichnete Geheimnisse. Lokale Dienstprotokolle und zuvor signierte Journal-Einträge werden nicht überschrieben. Zugriffsregeln und signierte Anmeldeeinträge verwenden weiterhin die Client-Adresse. ### Den Hauptschlüssel ersetzen Verwenden Sie **Weitere Tools → Zugriff → Meine Limits → Administratorschlüssel neu ausstellen** oder führen Sie `tgwitness token rotate` von einer verwalteten Installation aus, während das Panel läuft. Alle bestehenden Browsersitzungen werden beendet, einschließlich der mit Kollegen- Tokens eröffneten Sitzungen. Der anfragende Browser erhält eine neue Sitzung; speichern Sie den neuen Administratorschlüssel, bevor Sie ihn ausblenden. Ausgestellte Kollegen-Tokens bleiben gültig, bis sie separat widerrufen werden. Eine Installation, die `TGWITNESS_TOKEN` verwendet, muss diese Umgebungseinstellung ändern und neu starten. ### Anfrage- und Proxy-Grenzen Die API lässt bis zu 600 Anfragen pro Minute pro Client und Anmeldefamilien zu: Panel, Archiv/MCP oder Witness. Die Sperrzeiten für die Authentifizierung gelten für diese Familien separat. Zehn abgelehnte Authentifizierungsversuche innerhalb einer Minute lösen eine exponentielle Sperrzeit aus, die von einer Sekunde bis zu fünf Minuten reicht. Ein fehlgeschlagener Versuch nach Ablauf der Wartezeit verlängert diese; zehn Minuten ohne fehlgeschlagenen Versuch setzen die Eskalation zurück. Bei Ablehnungen werden HTTP-Code 429 und `Retry-After` zurückgegeben. Die Limits werden im Arbeitsspeicher verwaltet und von allen Arbeitsbereichen innerhalb eines Panel-Prozesses gemeinsam genutzt; ein Neustart löscht sie. Live-Streams sind auf vier pro Bearer-Token und 32 für den Panel-Prozess begrenzt. Das Öffnen eines Streams verbraucht ebenfalls das API-Anfragebudget. Anfrage-Hauptteile haben eine Empfangsfrist von 60 Sekunden, die für die Anmeldung, den Demo-Zugang, die Archiv-API und witness-head-Pfade auf 10 Sekunden bzw. für den MCP-Transport auf 8 Sekunden reduziert ist. Jede Anwendung erlaubt vier unvollständige Hauptteile pro Client-Adresse, mit Gesamtgrenzen von 32 und 64 MiB an reservierten Routenkontingenten. Anfragen ohne Hauptteile belegen diese Slots nicht. Übergroße Hauptteile führen zu einem 413-Fehler, Hauptteile mit Zeitüberschreitung zu einem 408-Fehler und eine überschrittene Client-Kapazität zu einem 429-Fehler mit `Retry-After: 1`. Bei erschöpfter Gesamtkapazität für Body-Daten wird der Status 503 mit `Retry-After` zurückgegeben. Weitergeleitete IP-Header werden ignoriert, es sei denn, der tatsächliche TCP-Peer gehört zu `TGWITNESS_TRUSTED_PROXIES` (durch Kommas getrennte IPs oder CIDRs). Setzen Sie `TGWITNESS_PROXY_HEADER` auf `x-forwarded-for` oder `cf-connecting-ip`. XFF wird vom nächstgelegenen Proxy in Richtung des ersten nicht vertrauenswürdigen Peers durchlaufen. Fehlerhafte oder doppelte Metadaten vertrauenswürdiger Adressen werden abgelehnt, sodass sie keine Proxy-Adresse aus der Zulassungsliste erben können. Der verwaltete Quick-Tunnel vertraut dem lokalen Cloudflare-Connector; die Eigen-Domain-Konfiguration vertraut lokalem Caddy. Direkte Bereitstellungen vertrauen standardmäßig keinem Proxy. Wenn Sie Uvicorn selbst starten, deaktivieren Sie dessen Proxy-Header-Verarbeitung, damit diese Grenze den tatsächlichen Peer empfängt. `TGWITNESS_PANEL_ALLOWED_IPS` beschränkt den gesamten Zugriff auf das Panel, einschließlich des Administrators, auf aufgeführte IP-Adressen oder CIDRs. Die Routing-Identity-Prüfung des Installationsprogramms bleibt öffentlich und gibt keine Kontodaten zurück. Fügen Sie die erforderliche lokale Verwaltungsroute ein, bevor Sie die Zulassungsliste aktivieren. Der Leitfaden „**START-HERE**“ für eine verwaltete Installation enthält die Anweisungen zur Dienstkonfiguration und Wiederherstellung. Ein API-Abfrage-Selektor vom Typ „`ws`“ muss den Arbeitsbereich im Anforderungspfad identifizieren; unbekannte, nicht übereinstimmende und doppelte Selektoren werden mit dem Status 404 abgelehnt. Panel-Skripte und -Stile enthalten SHA-384-Integritätsmetadaten. Eine Import-Map deckt zudem lokal importierte JS-Module in Browsern ab, die die Integrität von Import-Maps unterstützen. Die dynamisch generierte Sprachantwort ist separat. Diese Prüfungen erkennen die Substitution von Assets im Vergleich zur ausgelieferten Seite; die Seite selbst und ihre Hashes stammen vom Panel-Server, daher müssen dieser Server und sein Auslieferungspfad geschützt werden. **Das Protokoll seit dem Start** kombiniert Prozessprotokolle mit Protokollaktivitäten aus jedem Arbeitsbereich: Anmeldungen, Ablehnungen, Routenänderungen und Bedieneraktionen. Es handelt sich um eine In-Memory-Konsole für den aktuellen Prozess, nicht um eine dauerhafte Kopie jeder einzelnen Nachricht. Häufig auftretende Nachrichtenereignisse verbleiben im Protokoll, anstatt die Konsole zu überfüllen. Das Erteilen, Ändern und Widerrufen von Zugriffsrechten sowie das Starten oder Beenden von Sitzungen führen ebenfalls zur Erstellung signierter `access.*`-Protokollaufzeichnungen. Token sind in diesen Aufzeichnungen nicht enthalten. Ausgegebene Token und Sitzungszugangsdaten werden als Hash-Werte im verschlüsselten Tresor gespeichert. Eine ausstehende QR-Anmeldung gehört zu der Panel-Sitzung, die sie gestartet hat. Das Beenden oder Widerrufen dieser Sitzung oder die Rotation des Haupt-Panel-Tokens hebt den ausstehenden QR-Client auf dem Server auf. Dies gilt auch, wenn der Browser keine eigene Aufhebungsanfrage senden kann. Die Token-Rotation hebt auch QR-Anmeldungen auf, die direkt mit dem Haupt-Panel-Token gestartet wurden. Eine QR-Anfrage, die auf einen weiteren Vorgang wartet, überprüft den Zugriff erneut, bevor sie gestartet wird. Abgeschlossene Telegram-Autorisierungen und ausstehende Anmeldungen, die von einer anderen Panel-Sitzung gestartet wurden, bleiben erhalten. ****Hauptadministrator und Vertrauensgrenze**** Das Haupt-Panel-Token unterliegt keinen Einschränkungen. Browser-Anmeldungen mit diesem Token erstellen Sitzungen, die den vom Administrator konfigurierten Sitzungslimits unterliegen. Skripte, die das Haupt-Token direkt senden, behalten den vollen Zugriff und werden nicht als Browsersitzungen gezählt. Es handelt sich hierbei um eine Zugriffskontrolle auf Anwendungsebene innerhalb einer Installation. Alle Arbeitsbereiche nutzen gemeinsam den Serverprozess; es besteht keine Isolierung vom Host-Administrator. Halten Sie das Haupt-Token, die Telegram-Sitzungen, die Signaturschlüssel und das Datenverzeichnis geheim. Ein Witness-Token ist ein separater Checkpoint/Zustandsnachweis, kein Zugriffstoken für das Panel. --- # Telegram · Verbindung, Proxys und Datenschutz Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/connection/ Authentifizierung, automatische Proxy-Pools, IP-Modi, Fallback-Richtlinie, externe Anfragen und Speicherung von Geheimnissen. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Authentifizierung, automatische Proxy-Pools, IP-Modi, Fallback-Richtlinie, externe Anfragen und Speicherung von Geheimnissen. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) ![Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Dieses Dokument beschreibt das Verhalten von TgWitness0.9.3 und dessen Grenzen. Authentifizierung, Quellenzugriff, Netzwerkverbindung und Erfassungsvollständigkeit sind separate Zustände. Informationen zu Anmeldeschritten, Dateiformaten und mehreren Konten finden Sie unter [Konten und Sitzungsformate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). Informationen zu Ereignisrichtlinien und zum Verhalten bei Neustarts finden Sie unter [So funktioniert die Erfassung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/). ## Anleitung zur Verbindungsherstellung Unter **Weitere Tools → Konto → Verbindungsroute** kann der Administrator zwischen **Dieses Konto**, **Eine Kontogruppe** oder **Alle Konten** wählen und anschließend eine Route auswählen. **Unter Auswahl überprüfen** werden die betroffenen Konten aufgelistet. **Mit Vorbereiten und prüfen** wird die vorgeschlagene Route getestet, ohne die gespeicherte Route zu ändern. **Mit Geprüfte Verbindung anwenden** wird die Vorschau validiert, die Überwachung bei Bedarf angehalten, die Route gespeichert und die bereits laufende Überwachung fortgesetzt. Die Erfassung wird niemals in einem zuvor inaktiven Konto gestartet. Historische Downloads bleiben angehalten und können separat fortgesetzt werden. Halten Sie aktive Exporte vor dem Wechsel an. Bei Gruppenänderungen behalten Konten standardmäßig ihre eigene Route bei. Deaktivieren Sie diese Option erst, wenn die Vorschau die von Ihnen beabsichtigten Änderungen anzeigt. Die Anwendung meldet das Ergebnis für jedes einzelne Konto; es handelt sich nicht um eine „Alles-oder-Nichts“-Transaktion über alle Datenbanken hinweg. Bei einem fehlgeschlagenen Wechsel werden die vorherigen Einstellungen des jeweiligen Kontos wiederhergestellt. Ein Fehlschlag bei der Wiederaufnahme wird ausdrücklich angezeigt. Vorschauen verfallen nach zehn Minuten, und Änderungen an den Verbindungseinstellungen oder der Gruppenmitgliedschaft erfordern eine neue Überprüfung. „Apply“ verwendet ein erfolgreiches Preflight-Ergebnis bis zu 90 Sekunden lang wieder, sofern die Route, der Modus und die Richtlinie unverändert bleiben. Bei einem verwalteten Tunnel muss weiterhin derselbe laufende Prozess vorhanden sein. Ältere Ergebnisse, geänderte Tunnelprozesse und automatische MTProxy-Pool-Routen werden erneut überprüft. Der signierte Anwendungsdatensatz behält den ursprünglichen Prüfzeitpunkt bei und protokolliert die Wiederverwendung sowie deren Alter. Jeder Preflight schließt seinen temporären, nicht authentifizierten Client; der Collector stellt die Verbindung über seine eigene autorisierte Sitzung her. | Route | Was „TgWitness“ verwaltet | | --- | --- | | Direkt | Verbindungen vom Host; ein VPN eines externen Hosts wird nicht erkannt oder erzwungen. | | VPN | Ein WireGuard-Profil mit Volltunnel pro Konto, das von einem lokalen SOCKS5-Prozess im Userspace ausgeführt wird. Es wird keine Host-Schnittstelle und kein Treiber installiert. | | Mein Proxy | SOCKS5, HTTP CONNECT oder MTProxy-Anmeldedaten. Eine URL kann die Felder SOCKS5/HTTP ausfüllen. Bei Auswahl mehrerer Konten wird dieser eingegebene Proxy gemeinsam genutzt. | | Öffentliches MTProto | Der bestehende Pool weist „Telegram“-Routen zu. Externe Anfragen sind deaktiviert, bis in den erweiterten Einstellungen ein separater geeigneter Proxy konfiguriert wurde. | | WARP | Ein separater lokaler Tunnel für jedes ausgewählte Konto, mit WARP-Registrierung und einem WireGuard-Profil, das im Tresor dieses Kontos gespeichert ist. | Die Überprüfung der aktuellen Route nutzt eine neue, nicht authentifizierte Telegram-Transportverbindung und nicht die Sitzung des Kontos. Dabei wird eine Transportverbindung über die Route zum Rechenzentrum des Kontos hergestellt und ein nicht authentifizierter MTProto-Roundtrip durchgeführt (`req_pq_multi`); dabei wird kein Autorisierungsschlüssel erstellt und kein Konto verwendet. Die gemeldete Latenz setzt sich aus der Verbindungszeit und dem Roundtrip zusammen, und die Prüfung erfasst beide Teile separat. Bei HTTP-fähigen Routen wird zusätzlich den HTTPS-Trace von Cloudflare über diese Route an und zeigt die gemeldete Ausgangs-IP, das Land, den WARP-Status und den Prüfzeitpunkt an. Die WARP-Vorbereitung schlägt fehl, sofern der Trace nicht „WARP aktiv“ meldet. Diese Vorabprüfungen melden die Routenkonnektivität und den beobachteten Ausgang. Überprüfen Sie die erfassten Datensätze anhand der Erfassungs- und Verifizierungsergebnisse des Archivs. Ein laufender lokaler Prozess allein stellt noch keine erfolgreiche Ausgangsprüfung dar. Das Panel berechnet einen gleitenden Durchschnitt der letzten fünf Überprüfungen. Eine Route gilt als **langsam,** wenn der Durchschnitt 5 Sekunden überschreitet oder drei Überprüfungen in Folge diesen Wert überschreiten, und **als nicht verfügbar,** nachdem zwei Überprüfungen in Folge fehlgeschlagen sind; `network.slow_route` und `network.route_recovered` die Änderungen werden protokolliert. Bei einer langsamen WARP-Route startet **Re-roll WARP** den Tunnel des Kontos über andere Cloudflare-WARP-Endpunkte neu, behält den schnellsten bei und protokolliert `network.warp_rerolled` die Zeiten davor und danach auf; **New WARP Identity** registriert ein neues WARP-Gerät und behält es nur bei, wenn es schneller ist. Die lokale Proxy-Adresse, das Telegram-Konto und dessen Sitzung bleiben unverändert; Telegram-Verbindungen werden über den neu gestarteten Tunnel wiederhergestellt. Eine langsame WARP- Route wird automatisch höchstens einmal alle 30 Minuten neu generiert; wenn das nicht hilft, warten weitere Neugenerierungen auf den Betreiber. ### Portables WARP und WireGuard Dies ist eine inoffizielle WARP-Integration **** unter Verwendung von [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) und [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3). Der Administrator stimmt der Einrichtung vor dem ersten Download oder der WARP- Registrierung ausdrücklich zu. Diese Einrichtungsverbindungen laufen direkt über GitHub und Cloudflare und geben die IP-Adresse des Rechners preis. Der normale Datenverkehr des Kontos behält seine bestehende Route bis zur Anwendung bei. Cloudflare wählt die Ausgangsadresse und das Land aus; separate Tunnel können sich eine Ausgangsadresse teilen. Die Länderauswahl, die periodische IP-Rotation und ein hostweiter VPN-Kill-Switch werden von dieser Funktion nicht bereitgestellt. Unterstützte Helper-Downloads: Linux und macOS x86-64/ARM64 sowie Windows x86-64. Die Artefakte werden anhand der im geprüften Quellcode enthaltenen „SHA-256“-Hashes überprüft, und zwischengespeicherte ausführbare Dateien werden vor dem Start erneut überprüft. Es wird kein Hilfsprogramm zum PATH hinzugefügt, als Systemdienst installiert oder mit einem öffentlichen Listener versehen. Alle Dateien befinden sich im Verzeichnis „`portable-routes/`“ des Arbeitsbereichs und in verschlüsselten Tresoreinträgen. Der Loopback-Listener „SOCKS5“ erfordert unabhängig generierte Anmeldedaten. Private Profile und WARP-Kontodaten werden mit dem vorhandenen Workspace-Tresor verschlüsselt. Während des Betriebs benötigt der Helper eine nur für den Eigentümer zugängliche Konfigurationsdatei im Klartext; diese wird bei einem normalen Beenden entfernt. Bei einem Host-Absturz kann diese Datei im nur für den Eigentümer zugänglichen Datenordner zurückbleiben. Dies verschlüsselt weder die Festplatte noch schützt es vor dem Administrator. Der Supervisor schließt den Tunnel, wenn die übergeordnete Pipe des Panels verschwindet. Ein fehlgeschlagener Tunnel ermöglicht niemals einen direkten Fallback. Ein Neustart des Panels stellt einen ausgewählten Tunnel wieder her; fehlgeschlagene Starts werden mit einer begrenzten Verzögerung erneut versucht. **„Stop tunnel** “ pausiert ebenfalls die Überwachung und behält den gestoppten Zustand bei. **„Start tunnel** “ startet den Tunnel; die Überwachung separat fortsetzen, sobald bereit. Hochgeladene WireGuard-Profile müssen eine Schnittstelle und einen Peer sowie vollständige IPv4- und IPv6-Routen enthalten und dürfen keine Hooks, Includes, Umgebungsersetzungen oder zusätzliche Listener enthalten. Öffentliche Endpunktadressen werden vor dem Start aufgelöst und festgelegt. Verwenden Sie ein externes VPN oder das SOCKS5-Gateway für OpenVPN/IPsec und private Endpunkte. ## Authentifizierungsmethoden **Die API-ID und der API-Hash identifizieren eine Anwendung; sie ersetzen nicht die Kontoanmeldung.** Sie sind in TgWitness optional. Prioritätsreihenfolge: ein im Formular eingegebenes Paar, dann eines aus einer importierten Konto-JSON-Datei, dann das im Arbeitsbereich gespeicherte Paar, dann der integrierte Pool von 50 öffentlichen Paare, die in zufälliger Reihenfolge ausprobiert werden, mit automatischer Rotation, wenn Telegram eines ablehnt. Nur das Telegram-Desktop-Paar (2040) wird zusammen mit einer passenden Beschreibung des Telegram-Desktop-Clients gesendet. Ihr eigenes Paar aus den API-Entwicklungstools unter [my.telegram.org](https://my.telegram.org) kann für alle Ihre Konten verwendet werden; jedes Konto verfügt weiterhin über eine eigene Autorisierung. | Vorgehensweise | Anforderungen | TgWitness-Support | | --- | --- | --- | | Telefonnummer, Code, optionale 2FA | Zugriff auf das Konto; API-Paar optional | Anmeldung im Panel | | Authentifizierungsschlüssel (HEX) + DC-ID | Vollständiger 512-Zeichen-Schlüssel und DC 1–5 | Registerkarte „Direct **Auth Key“**; optionale Benutzer-ID wird vor dem Speichern der Autorisierung überprüft | | Telethon StringSession | Eine gültige Sitzungs-Zeichenkette | Anmeldung im Panel | | Telethon SQLite `.session` | Abgeschlossener, konsistenter Text | Direkter Import von Schemata über das Bedienfeld 7/8; optionale Offline-Befehlszeilenschnittstelle (CLI) | | Pyrogram SQLite `.session` | Geschlossene Produktionssitzung | Direkter Import von Schemata über das Bedienfeld 2/3 | | Telegram Desktop TData ZIP | Ein modernes Konto; lokaler Passcode, falls geschützt | In-Memory-Konvertierung mit Prüfsummen- und Entschlüsselungsprüfungen | | JSON-Datei für das Konto | Unterstützte API-/Sitzungs-/Schlüssel-Felder | Die Metadaten allein reichen nicht aus, um die API-Anmeldedaten zu füllen; eine Anmeldung per Sitzung/Schlüssel oder per Telefon/QR-Code ist weiterhin erforderlich. | | QR-Anmeldung | Bestätigung durch eine autorisierte Telegram-App | Lokale QR-Code-Generierung, Ablauf/Wiederholungsversuch, optionale 2FA | | TDLib / Pyrogram StringSession | Weitere bibliotheksspezifische Formate | Nicht unterstützt | | Bot-Token | Ein Bot mit eigenem Zugriffs- und Aktualisierungsmodell | Wird von diesem Sammler nicht verwendet | Telegram wählt die Art der Codeübermittlung, einschließlich der Entscheidung, ob eine SMS gesendet wird. Ein API-Hash kann keine widerrufene Sitzung wiederherstellen oder ein vergessenes 2FA-Passwort ersetzen. TgWitness speichert weder Anmeldecodes noch das Telegram-2FA-Passwort auf der Festplatte. Bei einer privaten Quelle muss das Konto bereits über Zugriffsrechte verfügen. Ein Gruppennutzername ist nicht erforderlich. Ein Proxy oder ein Sitzungsimport gewährt weder Mitgliedschafts- noch Administratorrechte. Die Chat-Einstellungen legen fest, ob Mitglieder den Verlauf aus der Zeit vor ihrem Beitritt sehen können. ## Eine Telethon-Sitzungsdatei importieren Telethon SQLite, Pyrogram SQLite und Telegram Desktop TData verwenden unterschiedliche Formate. Das Fenster erkennt die unterstützten Strukturen und konvertiert sie; das Umbenennen einer Datei gilt nicht als Konvertierung. Wählen Sie unter **Dateien** eine Sitzung und die dazugehörige JSON-Datei aus, klicken Sie auf **Dateien prüfen** und anschließend auf**Konto verbinden**. Es werden bis zu vier übereinstimmende Dateien mit einer Gesamtgröße von 8 MiB akzeptiert. Einzelheiten zu TData/JSON finden Sie unter [Formatbeschränkungen](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). Es gibt keine Passwortwiederherstellung. Die Anmeldung per Telefon/2FA oder QR-Code erstellt eine separate Autorisierung. Der optionale, ausschließlich für Telethon vorgesehene Befehlszeilenpfad steht weiterhin zur Verfügung: 1. Beenden Sie den Client unter Verwendung der ursprünglichen Sitzung und erstellen Sie eine konsistente Kopie. Der Konverter lehnt Dateien mit einem unvollständigen WAL/Journal ab. Schließen Sie den ursprünglichen Client ordnungsgemäß, anstatt diese Dateien zu löschen, um die Überprüfung zu umgehen. 2. Führen Sie in der TgWitness-Umgebung folgenden Befehl aus: ``` python -m tgwitness.sessions account.session --out account.tgwitness-session ``` 1. Laden Sie unter **„Konto hinzufügen“ → „Dateien**“ das Ergebnis hoch oder fügen Sie den entsprechenden Text ein und fahren Sie fort. 2. Überprüfen Sie die angezeigte numerische Konto-ID, wählen Sie die Quellen aus und beginnen Sie mit der Beobachtung. **Die konvertierte Datei ist ein unverschlüsseltes Passwort für den Kontozugang.** Bewahren Sie ihn an einem geschützten Ort auf und übertragen Sie ihn niemals in ein Repository oder senden Sie ihn an einen externen Konvertierungsdienst. TgWitness speichert die autorisierte Sitzung in seinem verschlüsselten Tresor. Das Kopieren einer Sitzung führt nicht zur Erstellung einer separaten Autorisierung: Führen Sie keine parallelen Clients mit geklonten Authentifizierungsschlüsseln aus und gehen Sie nicht davon aus, dass Aktualisierungen unabhängig voneinander bereitgestellt werden. Die Konvertierung überträgt die Autorisierung, nicht jedoch die Originalnachrichten, den Entity-Cache oder einen dauerhaften Aktualisierungszeiger. Sie gewährleistet keine Wiederherstellung von Aktualisierungen über Prozessneustarts hinweg. ## MTProto, Telethon und Proxys MTProto ist das Protokoll von Telegram. Telethon ist die Python-Client-Bibliothek, die TgWitness verwendet. MTProxy ist ein Telegram-Transport-Proxy; SOCKS5 und HTTP CONNECT stellen allgemeine Tunnel bereit. Keines dieser Verfahren ersetzt die Kontoauthentifizierung. Speichern Sie die Route für jeden Arbeitsbereich unter **Weitere Tools → Konto → Einstellungen → Verbindungseinstellungen → Verbindungsroute ändern,** bevor Sie sich anmelden. Für neue Arbeitsbereiche ist standardmäßig **Automatischer MTProxy eingestellt – öffentliche Listen** mit **der Option Adresse verbergen**. Bestehende Arbeitsbereiche, die explizit Direkt verwendet haben, behalten einen Modus bei, der dies zulässt. Dateien werden über separate Verbindungen gelesen, die sich von der Verbindung zum Lesen von Nachrichten unterscheiden, so wie es auch bei den offiziellen Apps der Fall ist. Im eigenen Rechenzentrum des Kontos wird der Autorisierungsschlüssel des Kontos für eine neue MTProto-Sitzung wiederverwendet; für ein anderes Rechenzentrum wird ein Schlüssel erstellt und autorisiert, während das Konto verbunden ist, und dieser wird ausschließlich im Arbeitsspeicher gehalten. Jede Dateiverbindung nutzt denselben Weg wie das Konto. Ihre Anzahl pro Rechenzentrum wird durch **„Parameter → Leistung → Dateiverbindungen pro Telegram-Rechenzentrum**; bei 0 werden Dateien ausschließlich über die Hauptverbindung des Kontos gelesen. Es werden höchstens fünf Telegram-Verbindungen gleichzeitig über alle Konten einer Installation hinweg aufgebaut. ## IP-Modi Die Route bestimmt die Verbindung. Der IP-Modus, **der IP-Schutz** im Abschnitt „Konto“ des Panels, legt fest, wann die Adresse des Servers offengelegt werden darf. Diese Einstellungen führen nicht zur Installation eines VPNs und leiten auch nicht den gesamten Datenverkehr des Computers um. | Modus | Telegram | Externe Anfragen | | --- | --- | --- | | Adresse ausblenden (`hide`) | Verwenden Sie einen Proxy; warten Sie, falls keiner funktioniert. Es gibt keine direkte Ausweichmöglichkeit. | SOCKS5/HTTP ist erforderlich; Anfragen ohne entsprechenden Proxy werden abgelehnt. | | Direkt als letztes Mittel (`fallback`) | Der automatische MTProxy kann nach Ablauf der konfigurierten Verzögerung „Direct“ verwenden und anschließend wieder zu einem funktionierenden Proxy zurückkehren. | Bevorzugen Sie einen konfigurierten externen Proxy oder die SOCKS5/HTTP-Route des Kontos; andernfalls ist „Direct“ zulässig. | | Server hinter einem Tunnel oder VPN (`tunnel`) | Direkte Zugriffe und ein sofortiger automatischer Fallback auf den Pool sind zulässig. | Eine direkte Verbindung ist zulässig, wenn kein entsprechender Proxy konfiguriert ist. | Der Tunnel- oder VPN-Modus setzt voraus, dass Sie dieses Netzwerk separat verwalten. Ohne einen funktionierenden Tunnel können die Empfänger die eigene Adresse des Servers sehen. Wählen Sie den Modus entsprechend Ihrer tatsächlichen Netzwerkkonfiguration aus, nicht anhand des Namens der Option. ### Wählen Sie einen Pfad | Route | Einstellungen | Grenze | | --- | --- | --- | | Automatischer MTProxy | Integrierte Listen oder ein Operator-Katalog | Unterhält eine funktionierende Telegram-Verbindung; der direkte Fallback hängt vom IP-Modus ab | | Direkt | Tunnel- oder VPN-Modus | Telethon nutzt die Netzwerkroute des Hosts | | SOCKS5 | Host, Port, optionaler Benutzername/Passwort | python-socks, Remote-Destination-DNS aktiviert | | HTTP CONNECT | Host, Port, optionaler Benutzername/Passwort | Einfaches HTTP-CONNECT; TLS zum Proxy selbst ist nicht implementiert | | MTProxy | Host, Port, Geheimnis | Experimenteller Telethon-Transport; 32 Hexadezimalziffern oder „`dd`“ + 32 Hexadezimalziffern | Gefälschte TLS-`ee`-Geheimnisse werden abgelehnt. Die Normalisierung von Telethon 1.45 kann ein Präfix und eine Domain entfernen, implementiert jedoch kein Fake TLS. Fügen Sie `tg://proxy?server=…&port=…&secret=…` oder `https://t.me/proxy?server=…&port=…&secret=…` ein und wählen Sie **„Felder aus Link ausfüllen**“. Dadurch werden die Felder validiert und ausgefüllt, ohne dass eine Verbindung hergestellt oder gespeichert wird; überprüfen und speichern Sie die Route separat. Manuelle Felder bleiben verfügbar. Siehe [Telegram-Proxy-Links](https://core.telegram.org/api/links#proxy-links). ### Öffentliche Proxys, die von Ihrer Installation bereitgestellt werden Die integrierte Liste vereint sieben Quellen: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto), [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro), [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector), [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector), [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST), [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) und [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list). Der gebündelte Snapshot enthält Endpunktdaten, Quellenangaben und Download-Daten. Die Einträge dienen als Eingaben; die nachfolgenden Konnektivitätsprüfungen entscheiden, welche Proxys verwendet werden. **MTProxy überprüft automatisch** die Telegram-Transportverbindung, hält einen funktionierenden Proxy bereit und wechselt zu einem anderen, wenn dieser ausfällt. Arbeitsbereiche bevorzugen unterschiedliche Proxys, wenn genügend funktionierende Einträge verfügbar sind; Proxys können sich eine Ausgangsadresse teilen. Ausgefallene Proxys ruhen, bevor ein weiterer Versuch unternommen wird. Wenn keiner funktioniert, bestimmt der IP-Modus, ob die Erfassung warten muss oder eine direkte Verbindung nutzen darf. Ein Wechsel des Proxys hat keine Auswirkungen auf das Konto und löscht dessen Journal nicht. Routenauswahlen und -änderungen werden im signierten Journal aufgezeichnet. Solange automatische Routen aktiv sind, werden die Listen stündlich aktualisiert und Transportprüfungen standardmäßig alle zehn Minuten durchgeführt. Diese Intervalle sind konfigurierbar. **Das Aktualisieren öffentlicher Listen** löst eine Aktualisierung aus; das bloße Anzeigen der Liste ändert nichts an einer gespeicherten manuellen Route. **Telegram-Datenverkehr und HTTPS-Anfragen nutzen unterschiedliche Routen.** Listen-Downloads verwenden eine separate HTTPS-Verbindung sowie die bereitgestellte Route für externe Anfragen. „`TGWITNESS_PROXY_FEED_PROXY`“ überschreibt diese Route explizit durch einen HTTP/SOCKS5-Proxy; beide „Compose“-Varianten des Collectors leiten diese weiter. Der Hintergrundpool folgt dem Hauptarbeitsbereich. Es werden keine Telegram-Sitzungen, API-Zugangsdaten, Panel-Token oder Bot-Token an Feed-Anbieter gesendet. Anbieternamen, Erfassungsdaten und die Download-Route werden unter **„Woher die Liste stammt“** angezeigt. Ein MTProxy überträgt ausschließlich Telegram-Datenverkehr. HTTP-Vorgänge des Arbeitsbereichs wie Zeitstempel, Benachrichtigungen, externe Kopien und Quellprüfungen nutzen einen separaten SOCKS5/HTTP-Proxy, sofern konfiguriert, andernfalls die SOCKS5/HTTP-Route des Kontos. Fehlt beides, lehnt „Hide the address“ die Anfrage ab; die anderen Modi erlauben „Direct“. Externe Anfragen können deaktiviert werden. Ein explizit konfigurierter Feed-Download-Proxy bleibt eine separate Operator-Übersteuerung. Der unabhängige Witness-Dienst behält seine eigene Route bei. Bei vom Betreiber verwalteten privaten Diensten erlaubt die vorhandene Serverumgebungseinstellung „ `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1`“ private Ziele und behält die Hostnamenauflösung auf Proxy-Seite bei. Sie kann nicht über das Panel aktiviert werden. Der „Nur-öffentlich“-Modus lehnt „`.onion`“-Ziele ab, bevor der öffentliche Resolver abgefragt wird; Tor-Onion-Dienste erfordern diese explizite Einstellung für private Ziele sowie einen geeigneten Proxy. Dieses DNS-Verhalten gilt für externe HTTP-Vorgänge, nicht für den Telegram-Transport. Cloudflare dokumentiert den [JSON-DNS-Endpunkt](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/). ****Automatische Pool-Parameter**** Konfigurieren Sie unter **Weitere Tools → Parameter → Automatischer MTProxy** die Fehlerschwelle, die Abkühlphase, die geplante Rotation, die Proxy-Freigabe und die zulässige Fallback-Verzögerung. | Kontrolle | Standard | | --- | --- | | Trennt die Verbindung vor dem Austausch | 3 innerhalb von 10 Minuten | | Proxy-Server, die pro Verbindungsversuch ausprobiert wurden | 3 | | Erste / maximale Pause nach einem Fehler | 10 Minuten / 6 Stunden | | Geplante Rotation | Deaktiviert; bei Fehler aktivieren | | Konten pro Proxy | 0: Bevorzuge separate Einträge, füge sie bei Bedarf zusammen. Setze 1 auf Warten auf einen exklusiven Eintrag. | | Verzögerung vor zulässigem direktem Fallback | 10-Minuten; Das Ausblenden der Adresse wird weiterhin abgelehnt Direct | | Feed-Aktualisierung / Transportprüfungen | 60-/10-Minuten; die Werte des Hauptarbeitsbereichs gelten für den gemeinsamen Pool | Verschiedene Proxys können sich eine Ausgangsadresse teilen. Die Beschränkungen von Telegram gelten für jede Route. Um die öffentliche Liste durch Ihren eigenen Betreiberkatalog zu ersetzen, konfigurieren Sie die folgende Überschreibung. Dadurch werden externe Abonnements vollständig deaktiviert, auch wenn das Array „`proxies`“ leer ist. Kopieren Sie [den leeren Katalog](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example) nach „`proxy-config/proxies.json` “ und fügen Sie Ihre bereitgestellten öffentlichen Endpunkte hinzu: ``` {"format": "tgwitness-proxy-catalog-v1", "proxies": [ {"id": "project-eu", "label": "Project EU", "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"} ]} ``` Die Beispielwerte müssen ersetzt werden. Es werden bis zu 32 unterschiedliche Einträge akzeptiert. Die authentifizierte Auflistung gibt Labels/Hosts/Ports ohne gemeinsame Geheimnisse zurück; bei Auswahl eines Eintrags werden dessen Anmeldedaten im Workspace-Tresor gespeichert. Die Verfügbarkeit bleibt bis zu einem expliziten Transporttest ungeprüft. Bei einem fehlerhaften Katalog ist eine manuelle Konfiguration möglich. Native Ausführung: Legen Sie „`TGWITNESS_PROXY_CATALOG`“ als lokalen JSON-Pfad fest. Docker: ``` docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build ``` Das Overlay wird schreibgeschützt unter dem Namen „`proxy-config`“ eingebunden; die Dateien müssen für die Container-UID 10001 lesbar sein. Dieses Verzeichnis ist von Git, dem Docker-Build-Kontext und den Quellarchiven ausgeschlossen. Dieser Katalog konfiguriert die Erfassungskonten; [der Witness-Bot](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) verwendet seine eigene HTTP/SOCKS5-Route, nicht MTProxy. Der direkte Fallback unterliegt dem oben beschriebenen IP-Modus. Unterbrechen Sie die Überwachung, bevor Sie eine Route ändern. Durch das Speichern werden alte Clients getrennt und unvollendete Anmeldungen abgebrochen; ein neuer Client verwendet die gespeicherte Route. Die Verknüpfung zwischen Konto und Protokoll/Sitzung bleibt bestehen. Einstellungen ersetzen die vorherige Route: Geben Sie die Proxy-Anmeldedaten bei der Bearbeitung erneut ein. Anmeldedaten werden mit `network.enc` verschlüsselt. Die API gibt weder den Benutzernamen, noch das Passwort oder den geheimen Schlüssel zurück. Signierte Datensätze enthalten den Routentyp und die Angabe, ob Anmeldedaten vorhanden sind, wobei der Endpunkt und geheime Schlüssel ausgeschlossen sind. Der Betreiber kann den Endpunkt im Bedienfeld einsehen. Geheime Felder werden nach dem Speichern, Sperren oder Wechseln von Arbeitsbereichen gelöscht. **Die Telegram-Verbindungsprüfung**, **die** auch vor der Anmeldung verfügbar ist, öffnet und schließt eine temporäre, nicht autorisierte Telegram-Verbindung über die Route. Es wird keine Verbindung zu einer IP-Prüfungs- Website hergestellt. Ein erfolgreicher Test stellt lediglich die Transportverbindung her, nicht jedoch den Zugriff auf Gruppen, die vollständige Zustellung oder Anonymität. Der Proxy gilt für die Verbindungen des Telegram-Clients, einschließlich der Medien-Downloads von Telegram-DCs. Browser, pip, SSH und manuell aufgerufene TSA-Tools verfügen über separate Routen. Der Proxy-Hostname kann lokal aufgelöst werden. „`rdns`“ wirkt sich auf Ziel-Hostnamen aus; Telegram stellt häufig numerische DC-IP-Adressen bereit. SOCKS5 und einfaches HTTP CONNECT verschlüsseln an sich weder die Proxy-Anmeldedaten noch den Tunnel zwischen Client und Proxy. MTProto schützt den Telegram-Datenverkehr separat. Verwenden Sie einen geeigneten sicheren Kanal zum Proxy in einem nicht vertrauenswürdigen Netzwerk. Private Gruppen sind Cloud-Chats, die während der Übertragung durch MTProto geschützt sind; End-to-End-Secret-Chats sind ein separater Chat-Typ, der vom [Secret-Chat-Modul](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/) aufgezeichnet wird. ## Verschlüsselung und Signaturen | Ebene | Umsgesetzt | Verantwortung des Betreibers | | --- | --- | --- | | Telegram-Datenverkehr | Telethon MTProto | Vertrauen in die Plattform, Übertragungsweg und Verfügbarkeit | | Web-Panel | Bearer-Token, Standard-Loopback, Anforderungslimits | HTTPS oder SSH-Tunnel für den Fernzugriff | | Geheimnisse | Fernet für API-Zugangsdaten, Sitzungsdaten, Proxy-Zugangsdaten und den privaten Signaturschlüssel | Schützen Sie den Entschlüsselungsschlüssel und den laufenden Host | | Tresorschlüssel | Lokaler Schlüssel oder externer Hauptschlüssel für eine Neuinstallation | Getrennter, geschützter Speicher und Schlüssel-Backup | | Nachrichten und Anhänge | Speicherung der Anwendung im Klartext | Verschlüsselte Festplatte/Datenträger | | ZIP/JSONL/CSV/HTML | Integritätsprüfungen, keine Verschlüsselung der Inhalte | Schützen Sie exportierte Kopien und Übertragungen | | Herkunft und Zeitpunkt | Signiertes Protokoll, Prozessbeleg, RFC 3161-Tools | Vertrauenswürdiger Schlüssel, unabhängige Kontrollpunkte/TSA und Aufbewahrungsverfahren | **Der Speicherschutz** im Konto zeigt diese Zustände an. Das Panel-Token ist ein Zugriffsgeheimnis, kein Verschlüsselungspasswort. Es gewährt Administratorzugriff; [ausgestellte Token](https://phishdestroy.io/tgwitness/de/docs/reference/access/) können auf Konten und Chats beschränkt werden. Arbeitsbereiche teilen sich den Host-Prozess und sind keine isolierten Mandanten. BitLocker, LUKS, FileVault oder ein verwaltetes verschlüsseltes Volume können Speichermedien im Rahmen ihrer jeweiligen Bedrohungsmodelle schützen. Ein Administrator eines entsperrten, laufenden Rechners kann die Daten weiterhin lesen. Berücksichtigen Sie SQLite-WAL/SHM, Medien, temporäre Exporte, Auslagerungsspeicher, Backups sowie Browser-Downloads bei der Speicherplanung. Ein Docker-Volume ist nicht allein deshalb verschlüsselt, weil es sich um ein Volume handelt. ## Externer Hauptschlüssel Bei einer Neuinstallation legen Sie den Hauptschlüssel außerhalb des Datenverzeichnisses ab. Dadurch wird ein bestehender Tresor mit lokalem Schlüssel nicht automatisch migriert. Richten Sie ein Schlüsselverzeichnis ein, auf das nur die Dienstidentität Zugriff hat, und führen Sie anschließend folgenden Befehl aus: ``` python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key python -m tgwitness --data-dir /private/observations/new-case ``` PowerShell unter Verwendung der installierten Projektumgebung: ``` python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key $env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key' python -m tgwitness --data-dir E:\PrivateData\new-case ``` Binden Sie die Datei in Docker schreibgeschützt außerhalb von „`/data`“ ein, beispielsweise unter „ `/run/secrets/tgwitness-master.key`“, und setzen Sie die Umgebungsvariable auf diesen Pfad. Die UID des Dienstes muss Lesezugriff darauf haben. Übergeben Sie den Pfad – nicht die Schlüsselbytes – über Umgebungs- bzw. Konfigurationsdateien. Jeder Arbeitsbereich erhält ein zufälliges öffentliches Salt sowie einen eigenen Fernet-Schlüssel, der mittels HKDF-SHA256 abgeleitet wird. „`vault.external.json`“ speichert die Metadaten der Ableitung, nicht den Hauptschlüssel. Ein fehlender oder falscher Schlüssel führt zum Fehlschlagen des Startvorgangs, ohne dass dieser stillschweigend ersetzt wird. Bewahren Sie sowohl die Salt-Metadaten als auch den Hauptschlüssel zur Wiederherstellung auf. Alle Arbeitsbereiche leiten sich vom selben Hauptschlüssel ab; dessen Kompromittierung wirkt sich auf die gesamte Installation aus. Der laufende Prozess kann Geheimnisse entschlüsseln. Es handelt sich hierbei nicht um ein HSM oder ein Passwort-KDF. Beliebige, von Menschen festgelegte Passwörter werden nicht anstelle eines Zufallsschlüssels akzeptiert. Behalten Sie den bestehenden Schlüssel für bestehende Installationen bei, bis eine gezielte Migration durchgeführt und verifiziert wurde. Das Löschen von „`vault.key`“ oder das Ersetzen eines Hauptschlüssels kann den Zugriff auf Sitzungen/Signaturschlüssel zunichte machen. Bewahren Sie verschlüsselte Sicherungskopien und Schlüssel getrennt auf und testen Sie die Wiederherstellung in einer isolierten Instanz. --- # Telegram · Bereitstellung Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/deployment/ Führen Sie TgWitness als Dienst unter Windows, Linux, macOS oder Docker hinter einer HTTPS-Verbindung aus, einschließlich Backups und Updates. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Führen Sie TgWitness als Dienst unter Windows, Linux, macOS oder Docker hinter einer HTTPS-Verbindung aus, einschließlich Backups und Updates. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **Englisch** · [Russisch](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [Ukrainisch](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [Português (Brasil)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [Farsi](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [Urdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [Hindi](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [Bahasa Indonesia](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [Vereinfachtes Chinesisch](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md) ## Wählen Sie eine Installationsvariante Für das portable Paket entpacken Sie bitte „`TgWitness--windows-amd64-portable.zip`“ von GitHub Releases. Für die anderen Methoden laden Sie bitte die Quell-ZIP-Datei herunter und entpacken Sie diese oder klonen Sie das Repository und führen Sie anschließend im Projektverzeichnis Folgendes aus: | Installation | Start | Läuft es im Hintergrund? | | --- | --- | --- | | Portables Windows-Paket | `TgWitness.cmd` | Nein; lassen Sie das Fenster geöffnet. | | Native Windows-Version | `Start.cmd` | Nein; nutzen Sie die optionale Anmeldeaufgabe für den Hintergrundbetrieb. | | Native Linux-/macOS-Version | `sh start.sh` | Nein; verwenden Sie systemd/launchd für den Betrieb im Hintergrund. | | Docker auf jedem unterstützten Host | `docker compose up -d --build --wait` | Ja, solange der Docker-Daemon läuft. | | Docker-Hilfsprogramm unter Windows | `scripts\Docker.cmd` | Ja; der Helper wartet auf den Betriebszustand des Webservers. | | Docker-Hilfsprogramm unter Linux/macOS | `sh scripts/docker-start.sh` | Ja; der Helper wartet auf den Betriebszustand des Webservers. | Für einen Cloud-Server, der von Dritten überprüft werden können sollte – erstellt über die API des Anbieters, ohne SSH, ausschließlich über einen Cloudflare-Tunnel erreichbar – siehe [„High-Assurance-Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/)“. Beim nativen Start wird ein privates „`.venv`“ erstellt und die festgelegten Abhängigkeiten installiert. Docker erstellt diese innerhalb des Images, ohne dass Python auf dem Host erforderlich ist. Für die erstmalige Einrichtung ist ein Internetzugang erforderlich. Wird kein Python 3.11+ gefunden, fragt „`Start.cmd`“ vor der Installation von Python 3.12 für den aktuellen Windows-Benutzer nach (winget, andernfalls der python.org- Installer nach Überprüfung der Signatur der Python Software Foundation); es werden niemals Administratorrechte angefordert. Docker und Betriebssystemdienste bleiben weiterhin Voraussetzungen. Native und portable Installationen verwenden „`data/live`“ innerhalb ihres Ordners. Docker verwendet das Volume mit dem Namen „`tgwitness-data`“ unter „`/data`“. Dabei handelt es sich um separate Installationen, bis Sie das gesamte Datenverzeichnis bewusst migrieren. Erwarten Sie nicht, dass ein neuer Docker-Container native Konten automatisch erkennt. ## Installationsvoraussetzungen Für die native Installation sind Python 3.11 oder höher mit „`venv`“ und „`ensurepip`“, ein Internetzugang für die Installation der ersten Abhängigkeiten sowie ein beschreibbares Projektverzeichnis für „ `.venv`“ erforderlich. Das mitgelieferte Panel benötigt weder Node.js noch eine Frontend-Erstellung. Führen Sie den Launcher von Ihrem normalen Betriebssystem-Konto aus; Administrator- oder Root-Rechte werden von TgWitness nicht benötigt. - **Windows:** `Start.cmd` überprüft zunächst `py -3`, dann `python`, anschließend die standardmäßigen benutzerspezifischen und „Program Files“-Installationsordner und erfordert Version 3.11 oder höher. Sollte keine dieser Optionen funktionieren, bietet das Programm die oben beschriebene automatische benutzerspezifische Installation an. `py -3 start.py` funktioniert ebenfalls. Das portable Paket benötigt überhaupt kein Python. - **Linux:** `start.sh` probiert `python3.13`, `python3.12`, `python3.11`, `python3` und `python` aus und gibt den Installationsbefehl für apt, dnf, pacman, zypper, apk oder Homebrew aus, sofern keiner davon geeignet ist. Bei Debian-/Ubuntu-Installationen ist möglicherweise das `python3-venv`-Paket erforderlich, das zum ausgewählten Interpreter passt. Die ältere Standard-Python-Version einer Distribution muss durch Python 3.11+ ersetzt oder ergänzt werden. - **macOS:** Installieren Sie eine aktuelle Python-3.11-Distribution; gehen Sie nicht davon aus, dass ein vom Betriebssystem bereitgestellter Interpreter die Anforderungen erfüllt. Verwenden Sie „`python3 start.py`“ aus dem Projektverzeichnis. - **Docker:** Verwenden Sie Docker Engine/Desktop mit Compose v2.20 oder neuer. Docker Desktop muss unter Windows Linux-Container verwenden. Der Container installiert seine eigenen Python-Abhängigkeiten; auf dem Host ist keine separate Python-Installation erforderlich. ## Lokaler Computer Verwenden Sie „`Start.cmd`“ unter Windows oder „`sh start.sh`“ unter Linux/macOS. „`scripts\Setup.cmd`“ oder „`sh start.sh --setup-only`“ bereitet die Umgebung vor. Der Launcher installiert bei der ersten Verwendung die erforderlichen Abhängigkeiten; bei späteren Starts wird die Umgebung wiederverwendet. Für die Einrichtung und die Telegram-Erfassung ist ein Internetzugang erforderlich, das Durchsuchen bestehender Datensätze und das Erstellen von Exporten funktionieren jedoch offline. Führen Sie nach der Einrichtung „`python start.py --check`“ aus, um lokale Abhängigkeiten, Ed25519, den Speicher, die Schlüsselkonfiguration und die Empfangsadresse zu überprüfen, ohne einen Collector zu starten. Verwenden Sie „`--json`“ für eine strukturierte Ausgabe. Übergeben Sie die vorgesehenen Befehle „`--data-dir`“, „`--host`“ und „`--port`“. Die Überprüfung installiert keine Pakete, erstellt kein Protokoll und stellt keine Verbindung zu Telegram her; es handelt sich nicht um eine Integritäts- oder Abdeckungsprüfung. Der Startvorgang überprüft separat vorhandene Protokolle. „`python start.py --help`“ vermeidet ebenfalls eine Installation. Führen Sie nach dem Ausführen von „start.py“ die Zusatzbefehle mit „`.venv\Scripts\python.exe`“ unter Windows oder „`.venv/bin/python`“ unter Linux/macOS aus, oder aktivieren Sie diese Umgebung zunächst. Die folgenden „`python -m ...`“-Beispiele setzen voraus, dass die Umgebung aktiv ist. ``` python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787 ``` Umgebungsvariablen: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE wählt den Modus mit externem Schlüssel für eine Neuinstallation aus; siehe [Externer Hauptschlüssel](https://phishdestroy.io/tgwitness/de/docs/reference/security/#external-master-key). TGWITNESS_TOKEN muss, falls angegeben, mindestens 24 Zeichen enthalten; verwenden Sie einen kryptografisch zufälligen Wert. Ohne diese Angabe generiert die App ein 256-Bit-Zufallstoken in der Datei panel-token.txt. Die Umgehung über die Umgebungsvariablen überschreibt diese Datei nicht. Starten Sie die Anwendung neu, um die Anmeldedaten zu rotieren. Ein Datenverzeichnis darf genau einem Prozess gehören. Eine plattformübergreifende Dateisperre des Betriebssystems verhindert versehentliche gleichzeitige Schreibvorgänge. Verwenden Sie einen Uvicorn-Worker. Das Panel kann eine beliebige Anzahl von Arbeitsbereichen verwalten, wobei zusätzliche Arbeitsbereichsverzeichnisse unter „profiles//“ liegen. Verwenden Sie für separate Service-Instanzen separate Verzeichnisse und Ports. SQLite-WAL-Dateien gehören in einen lokalen persistenten Speicher, nicht in ein Netzwerkdateisystem. Teilen Sie kein Volume zwischen Replikaten. ## Portables Windows-Paket Jede GitHub-Veröffentlichung enthält `TgWitness--windows-amd64-portable.zip` und dessen `.sha256`. Sie umfasst die offizielle, einbettbare Python-3.12-Laufzeitumgebung von python.org (Prüfsumme in `tools/build_portable.py` festgehalten), TgWitness und dessen festgelegte Abhängigkeiten sowie drei Startprogramme: | Datei | Zweck | | --- | --- | | `TgWitness.cmd` | Starten Sie das Panel; zusätzliche Optionen werden weitergeleitet, z. B. `TgWitness.cmd --port 8790` | | `TgWitness-Demo.cmd` | Starten Sie die synthetische Demo unter `data\demo` | | `TgWitness-Check.cmd` | Führen Sie die Bereitschaftsprüfung durch, ohne das Programm zu starten | Das angeheftete russische Morphologie-Wörterbuch und die PDF-Farbprofile sind für die Offline-Nutzung gebündelt. Die Paketierung erlaubt nur ihre bekannten Dateipfade innerhalb der Verzeichnisse der Abhängigkeit `data`; unerwartete Dateien in diesen Verzeichnissen führen zum Fehlschlagen des Builds. Entpacken Sie das gesamte Archiv in einen beschreibbaren Ordner wie beispielsweise „`Documents\TgWitness`“; führen Sie das Programm nicht direkt aus der ZIP-Datei oder aus dem Ordner „Programme“ aus. Die Laufzeitumgebung verwendet einen isolierten Modulpfad, sodass andere Python-Installationen und „`PYTHONPATH`“ keinen Einfluss darauf haben. Die Daten verbleiben im `data`-Ordner des Pakets. Um ein Update durchzuführen, beenden Sie TgWitness, entpacken Sie die neue Version in einen neuen Ordner und kopieren Sie den `data`-Ordner dorthin. Stellen Sie es selbst unter 64-Bit-Windows mit Python 3.12 zusammen: ``` python tools/build_portable.py ``` ## Container ``` docker compose up -d --build --wait ``` Dadurch wird ein benanntes persistentes Volume für /data erstellt. Der Web-Port wird auf 127.0.0.1:8787 abgebildet. Der Prozess läuft unter der UID 10001 mit eingeschränkten Rechten, einem schreibgeschützten Root-Dateisystem sowie beschreibbaren Verzeichnissen /data und /tmp. `--wait` überprüft den Zustand des Webservers, bevor die Rückgabe erfolgt; die Telegram-Autorisierung und -Zustellung werden im Panel angezeigt. Die bereitgestellten Hilfsprogramme verwenden nach dem Erstellen ein180-Sekunden-Timeout für die Betriebsbereitschaft . Das anfängliche Herunterladen von Abhängigkeiten kann länger dauern. Beide Basis-„Compose“-Dateien verwenden den Projektnamen „`tgwitness`“, sodass beim Entpacken einer neuen Version in ein anderes Verzeichnis nicht automatisch ein neues Datenvolume ausgewählt wird. Halten Sie nur eine Bereitstellung für dieses Projekt aktiv. Verwenden Sie für unabhängige Installationen einen eindeutigen Namen „ `docker compose -p NAME ...`“ und einen anderen Host-Port und behalten Sie bei Updates beide bei. Bei einer älteren Bereitstellung mit einem anderen Projektnamen verwenden Sie weiterhin deren ursprünglichen Namen zusammen mit „`-p`“; „`docker compose ls`“ listet vorhandene Projekte auf. Kopieren Sie `deploy/env.example` nach `.env` und ändern Sie `TGWITNESS_PORT` so, dass ein anderer Loopback-Port verwendet wird. Beispielsweise macht `TGWITNESS_PORT=8788` das Panel unter `http://127.0.0.1:8788` zugänglich; der Container lauscht weiterhin auf Port 8787. `.env` wird von Git ignoriert. Das anfängliche Token abrufen: ``` docker compose exec tgwitness cat /data/panel-token.txt ``` Nützliche Befehle: ``` docker compose ps docker compose logs --tail 100 -f docker compose stop docker compose up -d --wait ``` `restart: unless-stopped` startet den Collector nach einem Absturz oder einem Neustart des Docker-Daemons neu. Aktivieren Sie auf einem Linux-Server Docker beim Systemstart über den Dienstmanager Ihrer Distribution, in der Regel `sudo systemctl enable --now docker`. Unter Windows/macOS aktivieren Sie die Einstellung „Beim Anmelden starten“ in Docker Desktop. Das Abmelden vom Desktop, der Ruhezustand oder ein angehaltener Docker-Daemon die Datenerfassung unterbrechen. Ein explizit angehaltener Container bleibt angehalten, bis Sie ihn erneut starten. Das /tmp-Volume ist in der Beispielkonfiguration auf 512 MiB begrenzt. Die Export-Konstruktion nutzt stattdessen den Ordner `temporary-exports/` jedes Arbeitsbereichs auf dem persistenten Verzeichnis /data. Reservieren Sie dort Speicherplatz für gleichzeitige Exporte, das Wachstum von Journal/WAL, Medien und Backups. Der Launcher verwendet die Datei „deploy/constraints.txt“, um qualifizierte Versionen von Laufzeitabhängigkeiten festzulegen. Docker- und High-Assurance-Server werden anhand von `deploy/requirements.lock` und `deploy/build.lock` mit `pip --require-hashes` installiert: Jede Paketdatei muss mit einem im Commit gespeicherten SHA-256-Hash übereinstimmen, sodass eine auf PyPI oder einem Mirror ersetzte Datei abgelehnt wird. Pakete, die nur Quellcode enthalten (jieba, pyaes), werden mit den in „deploy/build.lock“ festgelegten setuptools (`--no-build-isolation`) vom Launcher, dem portablen Windows-Builder und der Dockerfile erstellt, sodass pip keine separate, nicht festgelegte Build-Umgebung auflöst. Das Python-Basis-Image und die Betriebssystempakete erfordern weiterhin eine unabhängige Release-Qualifizierung. Verwenden Sie den Befehl „docker compose down -v“ nur, wenn Sie beabsichtigen, das Protokoll und die Schlüssel zu löschen. Der Container-Statusbericht gibt Auskunft über die Verfügbarkeit des Webservers, nicht über die erfolgreiche Erfassung von Telegram-Nachrichten. Überprüfen Sie den Status des Collectors, den Heartbeat, Fehler und Abdeckungsereignisse im Dashboard. ### Profil eines unabhängigen Zeugen Der optionale Dienst `witness` führt einen [unabhängigen Witness](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) in einem eigenen Container aus, mit eigenem Schlüssel und eigenem Journal im Volume `witness-data` sowie einem ausschließlich schreibgeschützten Witness-Token für den Collector. Erstellen Sie das Token im Panel unter **Weitere Tools → Extras → Unabhängiger Witness**, fügen Sie es zusammen mit einem Bot-Token und einem Kanal zu `.env` hinzu und starten Sie dann das Profil: ``` docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag docker compose logs witness # witness key fingerprint ``` Der Dienst erreicht den Collector innerhalb des Compose-Netzwerks unter `http://tgwitness:8787` (`TGWITNESS_WITNESS_COLLECTOR` überschreibt diesen, beispielsweise `/profiles/` für einen anderen Arbeitsbereich). Für einen Witness auf einem separaten Server, der von einer anderen Person betrieben wird, verwenden Sie dort `deploy/compose/compose.witness.yaml` , wobei `TGWITNESS_WITNESS_COLLECTOR` auf die HTTPS-Adresse des Collectors gesetzt ist; diese Datei enthält ausschließlich den Witness. ## Installieren Sie ein veröffentlichtes Image Kopieren Sie `deploy/env.example` nach `.env`. Setzen Sie `TGWITNESS_IMAGE` auf die veröffentlichte Version, wobei Sie den Repository-Pfad **in Kleinbuchstaben** verwenden, zum Beispiel: ``` TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3 TGWITNESS_PORT=8787 ``` Führen Sie diese Datei separat aus, anstelle von „`compose.yaml`“: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt ``` Auf dem Host sind weder eine Quellcode-Kompilierung noch Python oder ein Compiler erforderlich. Der Release-Workflow ist auf Linux-AMD64- und ARM64-Container ausgerichtet, einschließlich der Linux-VM von Docker Desktop. Verwenden Sie ein Versions-Tag oder „`ghcr.io/owner/repository@sha256:...`“ aus der Workflow-Zusammenfassung. Es ist weder ein bewegliches „`latest`“-Tag noch ein unbeaufsichtigtes Anwendungs-Upgrade konfiguriert. Die Image- und Quellvarianten nutzen dasselbe Datenvolumen, sofern ihre Projektnamen übereinstimmen. ## Automatisches HTTPS auf einem Server Verwenden Sie einen Server mit Docker, eine von Ihnen verwaltete Domain und einen dauerhaften lokalen Speicher. Richten Sie die A-/AAAA-Einträge der Domain auf den Server aus; veröffentlichen Sie AAAA nur, wenn der Server über IPv6 erreichbar ist. Erlauben Sie eingehenden TCP-Verkehr auf den Ports 80 und 443 sowie ausgehenden DNS-/HTTPS-Verkehr für die Zertifikatsausstellung. Diese Ports dürfen nicht bereits von anderen Diensten belegt sein. Kopieren Sie `deploy/env.example` nach `.env` und legen Sie einen Hostnamen fest, ohne Schema oder Pfad: ``` TGWITNESS_DOMAIN=watch.your-domain.org ``` Starten Sie den Quellcode-Build mit dem HTTPS-Overlay: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt ``` ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait ``` Verwenden Sie für ein veröffentlichtes Bild stattdessen „`deploy/compose/compose.image.yaml`“ als erste Datei. Behalten Sie beide „`-f`“-Argumente für spätere Status-, Protokoll-, Aktualisierungs- und Stoppbefehle bei. Caddy bezieht und erneuert ein Zertifikat, leitet HTTP-Anfragen auf HTTPS um und leitet Anfragen an den Collector im privaten Compose-Netzwerk weiter. Der Zertifikatsstatus verfügt über ein eigenes persistentes Volume. Der direkte Host-Port des Collectors bleibt ausschließlich für Loopback-Verbindungen reserviert. Die bereitgestellte Caddy-Konfiguration aktiviert keine Zugriffsprotokollierung. Öffnen Sie `https://watch.your-domain.org` und geben Sie das Panel-Token ein. Die Bereitschaftsprüfung umfasst die Container; die Zertifikatsausstellung und die Erreichbarkeit von externen Systemen hängen vom DNS und der Firewall ab. Wenn HTTPS nicht bereit ist, überprüfen Sie DNS, Firewall-Regeln und: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy ``` Das bereitgestellte Caddy-Image folgt dem Tag „`2-alpine`“. Durch einen „Pull“ wird dieses Image aktualisiert; binden Sie einen getesteten Digest in Ihre Bereitstellung ein, falls Sie feste Infrastrukturversionen benötigen. ## Aktualisierungen und Sicherungen Behalten Sie den Namen des „Compose“-Projekts und das Datenvolumen bei allen Aktualisierungen bei. Stoppen Sie zunächst den Collector und erstellen Sie eine vollständige Sicherung. Für die standardmäßige, quellbasierte Bereitstellung: ``` docker compose stop docker compose cp tgwitness:/data ../tgwitness-backup-before-update ``` Verwenden Sie jedes Mal ein neues Sicherungsziel außerhalb des Repositorys und schützen Sie dieses als Material mit Kontozugriff. Der Beispielpfad dient nur zur Veranschaulichung; verwenden Sie Ihren privaten Speicherort für die Sicherung. Kopieren Sie das gesamte Verzeichnis, einschließlich versteckter Dateien, aller Arbeitsbereiche, Schlüssel, Protokolle und Medien. Sichern Sie einen externen Tresor-Hauptschlüssel separat, falls dieser konfiguriert ist. Eine ZIP-Datei mit Beweismaterial ist kein wiederherstellbares Anwendungs-Backup. Bei HTTPS bewahren Sie bitte auch die Caddy-Volumes auf, falls Sie den Status des Zertifikats bzw. des Kontos beibehalten müssen. Für eine Installation aus dem Quellcode laden Sie bitte die Dateien der neuen Version herunter und führen Sie folgenden Befehl aus: ``` docker compose up -d --build --wait ``` Für die Installation der Image-Version ändern Sie bitte „`TGWITNESS_IMAGE`“ in die gewünschte Version und führen Sie anschließend folgenden Befehl aus: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait ``` Verwenden Sie die „Compose“-Datei(en) Ihrer Installation auch für die vorangehenden „stop“- und „copy“-Befehle. Behalten Sie „`.env`“, die benutzerdefinierte Konfiguration und denselben Projektnamen bei. „`down`“ behält benannte Volumes bei; „**`down -v`**“**löscht diese**. Kopieren Sie „`.venv`“ nicht zwischen Betriebssystemen oder Python-Versionen. Für native Updates stoppen Sie TgWitness, sichern Sie das gesamte Datenverzeichnis, ersetzen Sie die Quelldateien und führen Sie „`python start.py --setup-only`“ vor dem Start aus. Überprüfen Sie nach einem Update den Zugriff auf das Panel, die Kontoidentität, den Beobachtungsstatus und die Abdeckung. Nach dem Neustart setzt TgWitness die gespeicherte Telegram-Update-Position fort und fordert die während des Updates verpassten Updates an. Ein Rollback erfordert möglicherweise die Sicherung vor dem Update, falls eine zukünftige Version die Speicherformate ändert. ## Entfernungsserver Beschränken Sie den Dienst auf Loopback und verwenden Sie einen SSH-Tunnel oder lassen Sie HTTPS an einem Reverse-Proxy enden. Die Basis-„Compose“-Datei ist ausschließlich lokal; das optionale „ `deploy/compose/compose.https.yaml`“-Overlay stellt Caddy für eine konfigurierte Domain bereit. Vermeiden Sie es, das Bearer-Token in URLs und Proxy-Protokollen offenzulegen. Ein Reverse-Proxy sollte die Anforderungsgröße und die Verbindungsraten begrenzen. Setzen Sie das Internet keinem unverschlüsselten HTTP aus. Beispiele für systemd, eine Windows-Anmeldeaufgabe, einen macOS-User-Agent und Caddy finden Sie im Verzeichnis [„deploy/“](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Überprüfen und passen Sie deren Pfade vor der Installation an. Es handelt sich hierbei um bereitgestellte Vorlagen, nicht um lokal ausgeführte Plattformkonfigurationen. Es wird kein Hintergrunddienst oder keine Hintergrundaufgabe durch den normalen Launcher registriert. Unter Windows speichert ein fensterloser `pythonw.exe`-Startvorgang die Start- und Serverdiagnosedaten in `logs/server.log` im Datenverzeichnis (5 MiB pro Datei, zwei rotierende Sicherungskopien). Bei Konsolenstarts werden die Konsolenprotokolle beibehalten. Die Protokollierung des HTTP-Zugriffs ist in beiden Modi deaktiviert. Schützen Sie die Protokolle zusammen mit dem Datenverzeichnis und überprüfen Sie diese, bevor Sie sie weitergeben. ## Neustart und Lücken Der zuletzt angeforderte Beobachtungsstatus wird beibehalten. War die Beobachtung aktiv, versucht das Programm beim Start, die Verbindung wiederherzustellen und ausgewählte Quellen fortzusetzen. Durch manuelles Anhalten wird diese Absicht aufgehoben. Ein fehlgeschlagener Neustart wird protokolliert und im Bedienfeld angezeigt. TgWitness speichert die Aktualisierungsposition von Telegram für das Konto und für jeden Kanal (pts, qts, seq und date) im Workspace-Tresor und stellt sie beim nächsten Start wieder her. Der Client fordert dann die Aktualisierungen an, die während des Stillstands des Prozesses verpasst wurden, und die regelmäßige Nachprüfung stellt verpasste Nachrichten wieder her und protokolliert gespeicherte Nachrichten, die Telegram nicht mehr zurückgibt. Dialoge werden beim Start neu geladen. Bei jedem Start werden der vorherige Journal-Anfang, die Offline-Grenze und die Aktualisierungsposition, an der die Wiederaufnahme erfolgte, aufgezeichnet. Der Monitor überprüft alle 10 Sekunden die Konnektivität und fügt jede Minute einen Heartbeat hinzu (**Weitere Tools → Parameter → Liveness-Aufzeichnung alle**). Verbindungsabbrüche und stillstehende Zeiträume werden als Abdeckungslücken mit Angabe des Grundes aufgezeichnet. Verlaufs-Snapshots werden als separate Beobachtungen des aktuellen Verlaufs neben den Live-Aufzeichnungen gespeichert. Die Medienwarteschlange wird in der SQLite-Datenbank jedes Arbeitsbereichs gespeichert. Eine Nachricht und ihr Auftrag werden atomar festgeschrieben. Unterbrochene laufende Aufträge werden wiederhergestellt und beim Start erneut versucht. Jeder Download hat ein Basis-Timeout von 120 Sekunden zuzüglich der Zeit bei 256 KiB/s, die für seine Größe benötigt wird, sowie eine 1–2,000 MiB-Limit pro Anhangstyp; Timeout, Geschwindigkeit und Wiederholungsversuche sind unter **Weitere Tools → Parameter** einstellbar. Der Collector überspringt Dateien, deren Größe unbekannt ist. Beim Anhalten bleiben die in der Warteschlange befindlichen Aufgaben erhalten. Bei Wiederholungsversuchen wird der ursprüngliche beobachtete Dateideskriptor verwendet, niemals die neueste Version einer nachträglich bearbeiteten Nachricht. Vorübergehende Fehler haben eine begrenzte Anzahl von Wiederholungsversuchen; Pausen bei Media FloodWait bleiben nach einem Neustart erhalten. Die Medienwiederherstellung ist unabhängig von der Telegram-Update-Wiederherstellung und kann verschwundene Dateien nicht wiederherstellen. ## Sicherung, Wiederherstellung und Speicherkapazität `tgwitness backup FOLDER` kopiert das Datenverzeichnis, während das Panel weiterläuft: zuerst die Checkpoints, dann die SQLite-Dateien über die Online-Backup-API, anschließend Schlüssel, Medien und Profile, sodass kein kopierter Checkpoint neuer ist als das kopierte Journal. `backup-manifest.json` listet den SHA-256-Hash jeder Datei sowie die Journal-Header auf. Zur Wiederherstellung stoppen Sie TgWitness und ersetzen Sie das gesamte Datenverzeichnis durch diesen Ordner. Beim nächsten Start wird protokolliert, dass das Journal aus einer älteren Kopie wiederhergestellt wurde. Dieser Eintrag vergleicht das Journal mit dem Kopf, der in `TGWITNESS_STATE_DIR` gespeichert ist, einem Ordner außerhalb des Datenverzeichnisses: dem `tgwitness-state` -Volume in Compose, unter `/var/lib/tgwitness-state` in den systemd-Einheiten und ansonsten im lokalen Statusordner des Benutzers . Ohne einen beschreibbaren Statusordner wird die Wiederherstellung nicht erkannt und dies wird einmalig im Protokoll vermerkt. Ohne diesen Befehl müssen Sie den Prozess anhalten, bevor Sie das **gesamte Datenverzeichnis** kopieren, einschließlich „vault.key“, „signing.enc“, „credentials.enc“, der SQLite-Datenbank- und WAL-Dateien, der Medien, des Tokens, der Checkpoints sowie aller Unterverzeichnisse von „profiles/“. Stellen Sie die vollständige Kopie wieder her, während der Zieldienst angehalten ist. Fehlende Vault-Schlüssel oder eine Nichtübereinstimmung der Signaturschlüssel führen zu einem Fehlschlag beim Start; generieren Sie keine Schlüssel neu, um den Zugriff zu erzwingen. Bewahren Sie geheime Backups verschlüsselt und mit Zugriffskontrolle auf. Die ZIP-Dateien mit den Beweismitteln sind portable Prüfartefakte, keine Anwendungs-Backups oder Backups von Telegram-Sitzungen. Es erfolgt keine automatische Löschung nach einer bestimmten Aufbewahrungsfrist. Planen Sie Speicherplatz für alle Nachrichten, Rohdaten, Metadaten, Medien, temporäre Exporte und Backups ein. Starten Sie die Verifizierung und exportieren Sie Stream-Datensätze, anstatt das gesamte Journal zu laden. Ein Export fixiert einen Lese-Snapshot, während neue WAL-Schreibvorgänge fortgesetzt werden können; lang andauernde Exporte können WAL-Seiten zurückhalten, sodass die Festplattenkapazität weiterhin eine Rolle spielt. ZIP-Dateien sind auf 4 GiB (unkomprimiert) begrenzt, um der Standardeinstellung des unabhängigen Verifizierers zu entsprechen; **Weitere Tools → Parameter → Größte signierte ZIP-Datei** erhöht die Obergrenze, und solche Archive werden mit `verify.py --max-gib N` verifiziert. Andere Formate haben keine Begrenzung der Ereignisanzahl. Unterstützte Browser streamen Antwortblöcke in eine vom Benutzer ausgewählte Datei. Andere Browser puffern höchstens 128 MiB und leiten größere Übertragungen an die authentifizierte CLI weiter: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Verwenden Sie `--profile ID` aus **„Exports“ → „Workspace ID“** für einen anderen Arbeitsbereich, `--format zip|jsonl|csv|html` oder `--url https://your-server` für einen Remote-Server oder `--max-mib`, um das Übertragungslimit von 5 GiB zu ändern. Einfaches HTTP ist nur für Loopback zulässig. Token werden in Headern übertragen, Weiterleitungen werden abgelehnt, vorhandene Dateien werden nicht überschrieben und unvollständige Downloads werden nicht als abgeschlossene Dateien veröffentlicht. Falls TGWITNESS_TOKEN das generierte Token überschreibt, verwenden Sie eine separat geschützte Datei, die diesen aktiven Wert enthält: panel-token.txt wird durch die Überschreibung nicht überschrieben. Der SHA-256-Wert des Befehls dient lediglich als Übertragungsprüfsumme; überprüfen Sie die signierte ZIP-Datei unabhängig davon. Das Dashboard zeigt Medien in der Warteschlange bzw. fehlgeschlagene Medien, die ältesten ausstehenden Medien, freien Speicherplatz, Pausen bei Telegram- Anfragen sowie Quellen an, deren Zugriff noch nicht bestätigt ist. Diese Diagnosedaten stellen keine vollständige End-to-End-Überwachung der Datenübertragung dar. Arbeitsbereiche teilen sich einen Prozess; ein „lautes“ Konto kann daher dennoch andere beeinträchtigen. Separate Arbeitsprozesse, Aufbewahrung/Rotation, dauerhafte Wiederherstellung von Aktualisierungen sowie die vollständige Qualifizierung der Bereitstellung bleiben bestehen. Der bereichsbezogene Zugriff auf das Dashboard ist unter [„Zugriff und Berechtigungen“](https://phishdestroy.io/tgwitness/de/docs/reference/access/) dokumentiert; unabhängige Kontrollpunkte werden im [Zeugenleitfaden](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) behandelt. Detaillierte Anleitungen: [Verbindung/Sicherheit](https://phishdestroy.io/tgwitness/de/docs/reference/connection/) und [Betriebsmodi](https://phishdestroy.io/tgwitness/de/docs/reference/operations/). --- # Phala / Intel TDX · Hochsichere Bereitstellung Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/ Ein gesicherter 24/7-Server bei Hetzner oder Phala Cloud, Gateway-DNS und Überprüfungen, die von Dritten wiederholt werden können. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Ein gesicherter 24/7-Server bei Hetzner oder Phala Cloud, Gateway-DNS und Überprüfungen, die von Dritten wiederholt werden können. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) ![Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Eine hochsichere Bereitstellung ergänzt die Archivüberprüfung um unabhängige Prüfungen der Erfassungsumgebung. Der Prüfer fragt die vom Cloud-Anbieter und von Cloudflare geführten Bereitstellungs- und Zugriffsprotokolle ab, und eine Intel-TDX-Bereitstellung fügt eine Hardware-Attestierung der Umgebung des Erfassers hinzu. Die normale Nutzung lokal und mit Docker bleibt unverändert. Hier läuft nichts, es sei denn, Sie führen eine Bereitstellung mit `python -m tgwitness.cloud`, und der Collector liest seinen Host nur, wenn die Bereitstellung `TGWITNESS_ASSURANCE`. Ablaufdiagramm · Operator → Server, Firewall ohne Eingangsregeln (Anbieter-API); Operator → Tunnel und DNS (Cloudflare-API); Server, Firewall ohne Eingangsregeln → Tunnel und DNS (nur ausgehend); Server, Firewall ohne Eingangsregeln → Auf dem Server erstellter Signaturschlüssel; Verifier, schreibgeschützte Token → Anbieterprotokoll und Firewall; Verifier, schreibgeschützte Token → Adresse des Tunnel-Konnektors und Ingress; Verifier, schreibgeschützte Token → Signierte /api/assurance-Erklärung; Verifier, schreibgeschützte Token → Beweismaterial-ZIP · Operator · Verifier,schreibgeschützte Token · Server, Firewall ohneEingangsregeln · Anbieterprotokoll undFirewall · Adresse desTunnel-Konnektors undIngress · Signierte/api/assurance-Erklärung · Beweismaterial-ZIP · Tunnel und DNS · Auf dem Server erstellterSignaturschlüssel · Anbieter-API · Cloudflare-API · nur ausgehend **Diagramm als Text** 1. Operator → Server, Firewall ohne Eingangsregeln (Anbieter-API) 2. Operator → Tunnel und DNS (Cloudflare-API) 3. Server, Firewall ohne Eingangsregeln → Tunnel und DNS (nur ausgehend) 4. Server, Firewall ohne Eingangsregeln → Auf dem Server erstellter Signaturschlüssel 5. Verifier, schreibgeschützte Token → Anbieterprotokoll und Firewall 6. Verifier, schreibgeschützte Token → Adresse des Tunnel-Konnektors und Ingress 7. Verifier, schreibgeschützte Token → Signierte /api/assurance-Erklärung 8. Verifier, schreibgeschützte Token → Beweismaterial-ZIP **Auf dieser Seite** - [Was ein Verifizierer überprüfen kann](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#what-a-verifier-can-check) - [Anbieter](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#providers) - [Vertrauliche VM auf der Phala Cloud (Intel TDX)](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) - [Bevor Sie beginnen](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#before-you-start) - [Aus dem Panel](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#from-the-panel) - [Schneller Tunnel ohne Domain](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#quick-tunnel-without-a-domain) - [Bereitstellen](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#deploy) - [Debug-Bereitstellung und Sperre](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#debug-deployment-and-lock) - [Eine Bereitstellung entfernen](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#remove-a-deployment) - [Beliebiger Server (selbstzertifiziert)](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#any-server-self-attested) - [Überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#verify) - [Bericht zur Beweismittelübergabe](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#report-for-evidence-handover) - [Cloudflare als externer Zeuge](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#cloudflare-as-an-outside-witness) - [Auslesen des Bereitstellungsergebnisses](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#reading-the-deployment-result) ## Was ein Prüfer überprüfen kann | Behauptung | Wie dies überprüft wird | Verwaltet von | | --- | --- | --- | | Der Server wurde zu einem bekannten Zeitpunkt über die API des Anbieters erstellt. | Das Server-Objekt und dessen Erstellung im eigenen Protokoll des Anbieters | Anbieter | | Niemand hat die Zugriffspfade des Anbieters genutzt | Protokoll von Konsolenanfragen, Rettungsmaßnahmen, Passwortzurücksetzungen, Neuinstallationen, ISO-Dateien, Images und Backups | Anbieter | | Es konnte keine Verbindung hergestellt werden | Die Firewall des Anbieters hat keine Regeln für eingehenden Datenverkehr; SSH wird ab dem ersten Start ausgeblendet. | Anbieter (Firewall), Host (SSH) | | Das Panel ist ausschließlich über den Tunnel erreichbar | Der Tunnel-Ingress leitet ausschließlich an das Panel weiter; der Connector läuft von der Serveradresse aus. | Cloudflare | | Genau diese Software läuft | Der signierte Hash des Quellcode-Baums des Collectors entspricht einem Checkout des bereitgestellten Commits | Collector, abgeglichen mit Git | | Der Signaturschlüssel wurde auf diesem Server erstellt | Der Schlüssel signiert eine Erklärung, in der die Server-ID des Anbieters und der Hash des empfangenen „cloud-init“ angegeben sind. | Collector, vom Anbieter überprüft | | Das Journal gehört zu diesem Schlüssel und diesem Server | Jeder Prozessstart im Evidenz-ZIP enthält die Host-Messung für diesen Server | Beweismaterial ZIP | | Der Telegram-Schlüssel wurde im beglaubigten Durchlauf erstellt | `account.authorized` protokolliert `key_origin: "created"` | Beweismaterial ZIP | Der Collector zeichnet den SSH-Status, Sitzungen, den Anmeldeverlauf und Startinformationen in signierten process-start- und `host.state`-Datensätzen auf. Auf einer gewöhnlichen VM handelt es sich dabei um lokale Bestandsdatensätze, die der Prüfer mit den unabhängigen Aufzeichnungen des Anbieters vergleicht. Die unten beschriebene Intel-TDX-Bereitstellung überprüft zusätzlich hardwaregestützte Messwerte. Eine beglaubigte Bereitstellung sammelt keine Daten anhand eines importierten Sitzungsschlüssels. Melden Sie sich per Telefon oder QR-Code an oder verwenden Sie die Sitzungsdatei für eine unabhängige Anmeldung: In beiden Fällen wird der Telegram- Autorisierungsschlüssel innerhalb der beglaubigten Ausführung erstellt, das Journal protokolliert `key_origin: "created"` und `python -m tgwitness.cloud verify` gibt `account_key` zurück. Ein Journal mit einem importierten Schlüssel besteht diese Prüfung nicht. ## Anbieter | `--provider` | Anmeldedaten | Schreibgeschützter Zugriff für Verifier | Anbieterprotokoll für den Verifizierer | Aufbewahrt für | | --- | --- | --- | --- | --- | | `hetzner` | `HCLOUD_TOKEN` | Lese-Token desselben Projekts | Server- und Firewall-Maßnahmen | Solange die Ressourcen vorhanden sind | | `digitalocean` | `DIGITALOCEAN_TOKEN` | Schreibgeschütztes persönliches Zugriffstoken | Droplet-Aktionen | Solange das Droplet existiert | | `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` Schreibgeschützte Bereiche | Kontoereignisse, Versionen von Firewall-Regeln | 90 Tage | | `vultr` | `VULTR_API_KEY` | Benutzer mit Lesezugriff und der `activity_logs` Berechtigung | Aktivitätsprotokoll des Kontos (Methode, Pfad, Akteur) | 30 Tage, länger mit einem Abonnement für das Audit-Protokoll | | `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | CloudTrail-Ereignisverlauf | 90 Tage | | `phala` | `PHALA_CLOUD_API_KEY` | Ein API-Schlüssel desselben Arbeitsbereichs | Anwendungsrevisionen und CVM-Vorgänge: Änderungen an der Docker-Compose-Konfiguration und der Umgebung, Neustarts, Betriebssystem-Upgrades | Solange die Anwendung existiert | | `generic` | keine | keine | keine: **selbstbeglaubigt** | – | Verwenden Sie für jeden Fall ein eigenes Projekt, Team, Konto oder Unterkonto: Der schreibgeschützte Zugriff des Prüfers zeigt dann nur diese Bereitstellung an. Anmeldedaten werden aus `--provider-token-file` oder der oben genannten Variablen, niemals aus der Befehlszeile. Bei AWS enthält die Datei die Angabe `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`; die Region ist `--location`. Jeder Bericht gibt den Umfang der Aufzeichnungen der jeweiligen Anbieter an. Kurz gesagt: Hetzner protokolliert Konsolenanfragen; die Recovery-Konsole von DigitalOcean, Lish/Glish von Linode und die Webkonsole von Vultr werden als solche nicht protokolliert, sodass der Root-Zugang beim ersten Bootvorgang gesperrt ist und eine Konsolenanmeldung eine Passwortzurücksetzung oder eine Änderung der Boot-Einstellungen erfordern würde, die protokolliert werden. Vultr gibt die Konsolenadresse an jeden Schlüssel zurück, der die Instanz lesen kann; weder der Datensatz noch der Bericht speichert diese. ## Vertrauliche VM auf der Phala Cloud (Intel TDX) Der `--provider phala` läuft der Collector in einer vertraulichen Intel-TDX-Virtual-Machine auf [Phala Cloud](https://phala.com/), die von dstack verwaltet wird. Der Host und die Mitarbeiter von Phala können dessen Speicher nicht auslesen, und der Prozessor signiert eine Bescheinigung darüber, was die Maschine beim Booten geladen hat. Der Verifizierer verlässt sich nicht blind auf die Angaben von Phala: `tgwitness.tdx` er überprüft jede Bescheinigung selbst, bis hin zur festgesteckten Intel SGX Root CA, anhand der Sperrlisten von Intel und der von Intel signierten Plattformdaten und lehnt Maschinen ab, die debuggt oder migriert werden können. | Eintrag erstellen | Was es zeigt | | --- | --- | | `tdx_binding` | Die Bescheinigung umfasst die signierte Erklärung des Erfassers und den Zufallswert dieser Anfrage. | | `tdx_quote` | Intel bürgt für die Bescheinigung; sie wird nur erteilt, wenn Intel die Plattform als auf dem neuesten Stand bewertet. | | `tdx_compose_hash` | RTMR3, das aus dem dstack-Ereignisprotokoll wiedergegeben wird, misst die App-Composes, die der Collector meldet. | | `tdx_compose` | Dieser Code entspricht Byte für Byte dem Code, der aus dem bereitgestellten Commit erstellt wird: Quelldateien sind über ihren Hash-Wert, beide Bilder über ihren Digest-Wert festverknüpft; es gibt keinen weiteren Code. | | `tdx_identity` | Die Bescheinigung stammt von der bereitgestellten Anwendung und Instanz, wobei Schlüssel aus dem KMS von Phala und einer verschlüsselten Festplatte verwendet werden. | | `tdx_os` | MRTD und RTMR0-2 entsprechen den Werten, die der Verifizierer aus dem von Dstack-TEE veröffentlichten Dstack-OS-Image berechnet, das anhand des von der CVM gemeldeten OS-Image-Hashes ermittelt wird, sowie aus den ACPI-Tabellen, die QEMU für die Konfiguration der VM erstellt: Firmware, Kernel, initrd, Befehlszeile mit dem Hash des Root-Dateisystems, Arbeitsspeicher, vCPUs und Geräte. Ein Entwicklungsimage schlägt fehl | Das Betriebssystem-Image (ca. 180 MB, wovon 21 MB beibehalten werden) wird einmalig von [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) in den Ordner `dstack-images` neben dem Datensatz heruntergeladen; `--tdx-image FOLDER` verwendet einen anderen Ordner oder ein entpacktes Image, `--tdx-image none` überspringt den Vergleich. Die Messung folgt `dstack-mr` und der `qemu-acpi` -Crate von Dstack-TEE/dstack. Private Messregressionen vergleichen die QEMU-eigene ACPI- Ausgabe mit einem gespeicherten Phala-Cloud-Zitat; für die Live-Qualifizierung wird zudem das veröffentlichte Image benötigt. `--tdx-measurements` vergleicht weiterhin MRTD und RTMR0-2 , die stattdessen als JSON angegeben werden. Jeder im Protokoll erfasste Start des Collectors ist mit einer solchen Bescheinigung versehen, sodass `verify --evidence` jeden Start sowie das dabei gebootete Betriebssystem-Image überprüft. Die Anwendungsrevisionen von Phala und die Vorgänge des CVM dienen als Anbieterprotokoll: Eine nach der Bereitstellung geänderte Docker-Compose-Konfiguration führt zu einem Fehlschlag des Berichts, und Neustarts werden zur Überprüfung aufgelistet. Wählen Sie im Bedienfeld unter **Weitere Tools → Extras → „Server 24/7“ die Option** **Vertrauliche virtuelle Maschine · Phala Cloud** aus und fügen Sie einen Phala-Cloud-API-Schlüssel ein; der Quick-Tunnel funktioniert wie bei Hetzner. Über die Befehlszeile: ``` python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \ --ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \ --provider-token-file phala-key.txt python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \ --provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \ --source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY ``` `--tdx-collateral` Liest Intels Zertifikate und Sperrlisten aus einer Datei aus, anstatt sie von Intel herunterzuladen. Gateway-DNS ist hier nicht verfügbar: Phala verfügt über keine Provider-Firewall für ausgehenden Datenverkehr. Mit `verify --source` wird das Referenz-Installationsprogramm aus Ihrem Checkout erstellt, wodurch der Code dieses Checkouts auf diesem Computer ausgeführt wird. Bei einer Bereitstellung aus einem anderen Repository als dem offiziellen lehnt `verify` dies ab, es sei denn, Sie übergeben zusätzlich die Option `--trust-source`; tun Sie dies nur für ein Checkout, das Sie gelesen haben. ### Offline-Prüfung mit verify.py Ein Empfänger ohne Phala-Konto überprüft die Zitate offline mit dem eigenständigen Verifizierer: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT python verify.py phala-tdx-attestation.json ``` Für das Zitat jedes `process.started`-Eintrags in einem Beweisarchiv sowie für das Zitat einer signierten Collector-Erklärung (auch innerhalb eines Deployment-Eintrags oder eines veröffentlichten Attestierungs-Eintrags) überprüft `verify.py` die ECDSA-P256-Signatur des Zitats mit seinem Attestierungsschlüssel, die Signatur des Enclave-Berichts des zitierenden Enclave mit dem PCK-Zertifikat, dass dieser Bericht den Attestierungsschlüssel (SHA-256 des Schlüssels und der QE-Authentifizierungsdaten) enthält, dass er aus Intels TDX-Quoting- Enclave im Produktionsmodus stammt und die Kette PCK-Zertifikat → Intel SGX PCK-Plattform oder Prozessor CA → Intel SGX Root CA, deren SHA-256 in `verify.py` festgehalten ist. Es lehnt debuggbare oder migrierbare TDs ab, überprüft, ob REPORTDATA der SHA-512-Hash des Startdatensatzes (Journal-Schlüssel, Lauf, Quellbaum, Host) oder der signierten Anweisung ist, und gibt MRTD, RTMR0–3 und REPORTDATA aus. Der Collector speichert außerdem Intels Begleitdaten (TCB-Info, QE-Identität, Sperrlisten und deren Ausstellerketten) zusammen mit jedem Zitat, wenn Intels Dienst antwortet. Damit überprüft `verify.py` Intels Signaturen und Sperrlisten und berechnet den TCB-Status zum Zeitpunkt der Aufzeichnung oder zum Ausstellungsdatum der Begleitdaten, falls dieses später liegt. Ohne diese Informationen lautet das Ergebnis „TCB-Status nicht geprüft (keine Sicherheiten im Archiv)“. Welcher Code von der VM ausgeführt wurde (die von „compose“ gemessenen RTMR3-Werte, das Betriebssystem-Image hinter MRTD sowie RTMR0–2), das Anbieterprotokoll und Intels aktuelle Bewertung bleiben Prüfungen von `python -m tgwitness.cloud verify`; die Offline-Prüfung stuft den beglaubigten Erfassungslauf daher als unvollständig ein und erreicht für sich genommen weder die `sealed`-Stufe noch das `attested`-Profil. ### Attestierungszertifikat Bei einer Phala-Bereitstellung schreibt `verify --report certificate.md` zudem das Zertifikat: ein eigenständige Datei „`certificate.html`“ und eine A4-Datei „`certificate.pdf`“ mit dem Ergebnis, der Vertrauenskette von Intels Stammzertifikat bis zum Collector-Schlüssel, einem Vergleich mit gewöhnlichen und hochsicheren Servern, den Messwerten neben den aus dem veröffentlichten Image berechneten Werten, den Verantwortlichen für die einzelnen Teile, der Intel-Zertifikatskette, jeder Prüfung, dem Anbieterprotokoll sowie einer Anleitung zur Wiederholung der Überprüfung. Der JSON-Bericht bleibt die maßgebliche Aufzeichnung; die Seiten stellen ihn dar. Der Bericht ist mit Signaturen und Zeitstempeln digital versiegelt, und zwar in der Datei „`certificate.seal.json`“ sowie in den daneben liegenden Dateien „`.tsq`“ und „`.tsr`“: | Seal | Was es bietet | | --- | --- | | Qualifizierter elektronischer Zeitstempel, `http://tsa.belgium.be/connect` | RFC-3161-Zeitstempel über die exakten Bytes von `certificate.json` vom qualifizierten Vertrauensdienstleister der belgischen Föderalregierung (FPS Policy and Support, BOSA). Diese Stelle ist als qualifizierter Zeitstempeldienst mit dem Status „gewährt“ auf der EU-Vertrauensliste Belgiens aufgeführt; die Stammzertifizierungsstelle (Belgium Root CA6) und die Einträge der Liste, gemäß der am 20. Oktober 2026 veröffentlichten Liste, sind in `tgwitness/tsa_roots.py` festgehalten. Gemäß Artikel 41 der Verordnung (EU) Nr. 910/2014 gilt ein solcher Zeitstempel in jedem EU-Mitgliedstaat als hinsichtlich Datum und Uhrzeit sowie hinsichtlich der Integrität der Daten als korrekt. | | RFC 3161-Zeitstempel, FreeTSA | Ein zweiter, unabhängiger Zeitstempel | | Signatur des Verifizierers | Ed25519 über eine Anweisung, die den SHA-256-Wert des Berichts und jeden Zeitstempel mit dem eigenen Schlüssel des Verifizierers (`--sign-with FOLDER`, Standard: `~/.tgwitness/verifier`) angibt; das PDF trägt eine Signatur mit demselben Schlüssel | `--timestamp URL` (wiederholbar) wählt andere Zertifizierungsstellen aus, `--timestamp none` keine, `--sign-with none` lässt das Siegel ungesigniert. `check-report` überprüft den Hash des Berichts, die Signatur des Verifizierers, jeden Zeitstempel auf eine vertrauenswürdige Stammzertifizierungsstelle und deren qualifizierten Status sowie die Signatur der PDF-Datei. Die rechtliche Bedeutung eines qualifizierten Zeitstempels außerhalb der EU sowie des Berichts als Ganzes liegt im Ermessen des Gerichts oder der Behörde, die ihn erhält; das Siegel zeigt an, wann der Bericht existierte und dass er nicht verändert wurde. Die Bescheinigung stützt sich auf Intels TDX-Modul und -Mikrocode sowie auf die physische Integrität des Speicherbusses. Wer auch immer die Anwendung im Phala-Konto kontrolliert, kann ein weiteres Compose bereitstellen; dies erscheint als neue Revision mit einem neuen Compose-Hash. Der Host kontrolliert die Zeitquelle und das Netzwerk des Rechners. Die Bereitstellung, die Überprüfung mittels `--evidence`, Neustarts, der Betriebssystem-Image-Vergleich, das versiegelte Zertifikat und die Vernichtung wurden auf der Phala Cloud selbst ausgeführt; siehe [den Durchlauf vom 4. November 2026](https://phishdestroy.io/tgwitness/de/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026). Am 9. November erfolgte eine Bereitstellung anhand eines Live-Telegram-Kontos; bei einem Durchlauf wurde ein innerhalb der VM erstellter Sitzungsschlüssel verwendet. Siehe [den Durchlauf mit dem Live-Konto](https://phishdestroy.io/tgwitness/de/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026) und [den in der VM erstellten Schlüssel](https://phishdestroy.io/tgwitness/de/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026). ## Bevor Sie beginnen 1. Eine Cloudflare-Zone, deren Konto-ID sowie ein API-Token mit den Berechtigungen **„Cloudflare Tunnel Edit“**, **„Zone Read“** und **„DNS Edit“**, bereitgestellt mit `--cloudflare-token-file` oder `CLOUDFLARE_API_TOKEN`. Für den Prüfer: **„Cloudflare Tunnel Read“**, **„DNS Read“** und, für das Audit-Protokoll, **„Account Settings Read**“. Ohne Domain benötigt ein [Quick-Tunnel](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#quick-tunnel-without-a-domain) nichts davon. 2. Anmeldedaten eines Anbieters mit Schreibzugriff auf ein dediziertes Projekt; `lock` verwendet dasselbe: - Hetzner: API-Token mit Lese- und Schreibberechtigung; - DigitalOcean: persönliches Zugriffstoken mit Schreibzugriff; - Linode: persönliches Zugriffstoken mit `linodes`, `firewall` sowie `events` Lese-/Schreibberechtigungen; - Vultr: API-Schlüssel eines dedizierten Kontos oder Unterkontos; - AWS: IAM-Anmeldedaten zulässig `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` und `ec2:RevokeSecurityGroupIngress`. 3. Der auszuführende Commit. Ein Release-Tag wird einmalig auf seinen Commit aufgelöst mit `git ls-remote`; der Server erhält immer nur den 40-Zeichen-Commit. ## Aus dem Panel Auf Ihrem eigenen Computer führt **„Weitere Tools → Extras → Server 24/7“** denselben `deploy` -Vorgang für Hetzner in drei Schritten aus: Wählen Sie Europa oder die Vereinigten Staaten aus, fügen Sie ein Hetzner-Token (Lesen & Schreiben) ein und überprüfen Sie anschließend den Servertyp, den monatlichen Preis, die Adresse und die Version, die das Panel mit diesem Token ermittelt hat. Es wird nichts erstellt, bevor Sie bestätigen. Das Panel zeigt jeden Schritt so an, wie `deploy` ihn meldet, gefolgt von der Adresse, dem Panel-Token und dem Fingerabdruck des Signaturschlüssels. Ohne Domain erhält der Server einen [Quick-Tunnel](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#quick-tunnel-without-a-domain) ; **unter Ihre Server → Aktuelle Adresse suchen** wird diese nach einem Neustart erneut abgerufen. Für eine feste Adresse unter Ihrer eigenen Domain öffnen Sie **„Optional · Ihre eigene Domain** “ und fügen Sie ein Cloudflare-Token hinzu (der vorbereitete Link wählt Zone lesen, DNS bearbeiten und Cloudflare-Tunnel bearbeiten aus). Die Tokens werden bei jeder Anfrage vom Browser-Tab an TgWitness auf demselben Computer übertragen und nirgendwo gespeichert; der Bereitstellungsdatensatz, das redigierte „cloud-init“, das Panel-Token und, bei einem Schnell-Tunnel, der Adressschlüssel werden `deployments/NAME` im Datenverzeichnis gespeichert. Das Panel bietet dies nur dem Hauptadministrator über eine direkte Loopback-Verbindung an (`127.0.0.1`, keine Proxy- oder Tunnel-Header); ein über ein Netzwerk erreichbares Panel zeigt stattdessen die Befehle an . Die Version ist standardmäßig auf das Release-Tag des laufenden Panels gesetzt, das über die GitHub-API ermittelt wird. Standort, Servertyp und Preis stammen aus der Hetzner-API: `cpx22` sofern dort angeboten, andernfalls der günstigste x86-Typ mit mindestens 2 GB Arbeitsspeicher. ## Schneller Tunnel ohne Domain `--quick-tunnel` ersetzt `--zone`, `--cloudflare-account` und `--panel-host`; es ist kein Cloudflare- Konto oder -Token erforderlich: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token ``` Auf dem Server öffnet „cloudflared“ einen [schnellen Tunnel](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) zum Panel: eine zufällige `https://….trycloudflare.com` Adresse, die sich ändert, sobald „cloudflared“ oder der Server neu gestartet wird. Ein kleiner Dienst auf dem Server veröffentlicht jede Adresse in einem zufälligen „ntfy.sh“- Thema, signiert (HMAC-SHA256) mit einem Schlüssel, der ausschließlich im Deployment-Verzeichnis gespeichert ist (`address-key.txt`) und wiederholt dies alle drei Stunden, da ntfy.sh Beiträge 12 Stunden lang aufbewahrt. `deploy` und **„Find the current address“** akzeptieren nur signierte Beiträge, sodass ein gefälschter Beitrag dich und dein Panel-Token nicht an die Adresse einer anderen Person weiterleiten kann. Das Thema ist im Protokoll und im veröffentlichten cloud-init enthalten: Wer auch immer darüber verfügt, kann die aktuelle Adresse ablesen, die weiterhin nach dem Panel-Token fragt. Der Server hält in keinem Fall einen eingehenden Port offen. Ein Verifizierer verfügt über keinen Adressschlüssel, und jeder, der das Thema liest, kann dort Beiträge verfassen. Daher veröffentlicht der Collector auch die Adresse selbst, signiert mit seinem eigenen Ed25519-Schlüssel, und `verify` übernimmt den neuesten Beitrag, der mit dem Collector-Schlüssel im Bereitstellungsdatensatz signiert ist; Beiträge werden nach dem Zeitpunkt sortiert, zu dem ntfy.sh sie empfangen hat, nicht nach dem von ihnen angegebenen Zeitpunkt. Ein Collector aus der Zeit vor dieser Änderung signiert nichts, und `verify` übernimmt daraufhin den neuesten Beitrag und gibt dies in der `statement`-Prüfung an; ein gefälschter Beitrag kann diese Prüfung lediglich zum Scheitern bringen, da die Adresse weiterhin mit dem Schlüssel des Collectors antworten muss. Was es kostet: Kein Cloudflare-Konto führt Aufzeichnungen über einen Quick-Tunnel, daher meldet `verify` den Tunnel, den Connector und die DNS-Prüfung als nicht verfügbar, und das Ergebnis ist bestenfalls `incomplete` (auf Phala Cloud wird die Prüfung hingegen bestanden: Der Connector läuft innerhalb des gemessenen Compose); die Anbieteraufzeichnungen, die Firewall, die signierte Aussage, die Host-Messungen und der Installationsvergleich werden wie gewohnt geprüft. Der Byte-Vergleich mit dem Referenz-Installer erfordert einen bereitgestellten Commit, der `--quick-tunnel` bereits kennt; ein 0.7.0-Checkout erstellt den Domain-Installer und meldet die Differenz. Cloudflare bietet Quick Tunnels für Testzwecke an, erlaubt 200 Anfragen gleichzeitig und überträgt keine Server-Sent Events, sodass die Live-Updates des Panels (Versionen ab 0.7.0) möglicherweise nicht über einen Quick Tunnel ankommen und die Ansicht neu geladen werden muss; dieser Teil wurde noch nicht getestet. Für einen Fall, der dauerhaft funktionieren muss, verwenden Sie Ihre eigene Domain. ## Bereitstellen Sehen Sie sich zunächst alles an, was gesendet wird. `plan` Es werden keine Anfragen an Provider oder Cloudflare gestellt: ``` python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org ``` Stellen Sie das Tool anschließend mit denselben Optionen und den Anmeldedaten bereit: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \ --witness-host case-witness.example.org \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Servertypen für den Einstieg: `cpx22` (Hetzner), `s-1vcpu-2gb` (DigitalOcean), `g6-standard-1` (Linode), `vc2-1c-2gb` (Vultr), `t3.small` (AWS). `--location` und `--image` standardmäßig auf Ubuntu 24.04 des jeweiligen Anbieters in einer europäischen Region. `--repository` Übernimmt den Commit aus einem anderen https-Git-Repository, ohne Anmeldedaten in der URL (standardmäßig `https://github.com/phishdestroy/TgWitness.git`). `deploy` akzeptiert auch `--out` für ein anderes Bereitstellungsverzeichnis (Standard `deployments/NAME`; ein Verzeichnis, das bereits eine Bereitstellung enthält, wird abgelehnt) und `--wait`, die Anzahl der Minuten, die auf die signierte Bestätigung des Collectors gewartet werden soll: 1 bis 240, Standard 20 oder 60 für `generic`. Der Befehl: 1. Erstellt einen Cloudflare-Tunnel, dessen Ingress den Hostnamen des Panels an das Panel weiterleitet und, falls angegeben, den Hostnamen des Witness an `/api/witness/head` und `/api/assurance` nur; 2. Erstellt Proxy-CNAME-Einträge für diese Hostnamen und lehnt Namen ab, die bereits existieren; 3. Erstellt eine Provider-Firewall ohne eingehende Regeln und einen Server dahinter ohne SSH-Schlüssel, ohne Backups, ohne Konsolen-Agent und mit „cloud-init“, das SSH maskiert, Root sperrt, `cloudflared`, genau den Commit abruft, diesen überprüft und TgWitness als abgesicherten systemd-Dienst startet; 4. wartet auf die signierte Erklärung des Collectors und überprüft, ob darin dieser Server und der Hash dieses „cloud-init“ genannt werden. `deployments/case-2026-11/` Enthält dann: | Datei | Inhalt | Teilen? | | --- | --- | --- | | `deployment.json` | IDs, Hashes, die durchgeführten API-Aufrufe (Methode, Pfad, Status) und die erste signierte Aussage | Ja, mit dem Verifizierer | | `cloud-init.redacted.yaml` | Das genaue „cloud-init“-Skript, bei dem die beiden Geheimnisse durch `REDACTED` | Ja | | `panel-token.txt` | Das Panel-Token | Nein | Das Root-Passwort des Anbieters, das Tunnel-Token und das Panel-Token werden niemals gespeichert `deployment.json`. Veröffentlichen Sie den am Ende angezeigten Fingerabdruck des Collectors über einen Kanal, den Sie nicht allein kontrollieren, beispielsweise einen Witness-Kanal oder eine Nachricht an den Empfänger. Melden Sie sich bei Telegram unter `https://case.example.org` mit dem Panel-Token an, wie in der [Anleitung zum Konto beschrieben](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). Panel-Aktionen werden im signierten Protokoll aufgezeichnet; es handelt sich dabei nicht um SSH-Sitzungen. Ein [Witness](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) kann abfragen `https://case-witness.example.org`. Es gibt kein SSH: Wenn der Bootstrap-Vorgang fehlschlägt, antwortet der Collector nicht. Löschen Sie den Server und führen Sie die Bereitstellung erneut durch oder verwenden Sie eine Debug-Bereitstellung, um die Ursache zu ermitteln. ### Geheimnisse in den Benutzerdaten Das „cloud-init“ enthält zwei Geheimnisse: das Panel-Token und das Cloudflare-Tunnel-Token. Der Signaturschlüssel gehört nicht dazu; er wird auf dem Server erstellt. Hetzner, DigitalOcean und Linode geben keine Nutzerdaten über ihre API zurück. Vultr gibt sie an jeden Schlüssel zurück, der die Instanz lesen kann, und EC2 über `DescribeInstanceAttribute`. Bei AWS sollten Sie dem Verifizierer nur die drei Aktionen aus der Tabelle gewähren, niemals `ec2:Describe*`. Bei Vultr ist davon auszugehen, dass der Schlüssel des Verifizierers beide Token lesen kann. Ein Tunnel-Token ermöglicht es jemandem, einen zweiten Connector auszuführen: `verify` meldet jeden Connector, der sich nicht auf dem Server befindet, und die Aussagen des Collectors können auf diese Weise nicht gefälscht werden, da jede einzelne eine neue Challenge signiert. Bei `--quick-tunnel` dem zweiten Geheimnis handelt es sich stattdessen um den Adressschlüssel: Wer ihn liest, kann eine falsche Adresse posten, die das Panel akzeptieren würde. In der öffentlichen Erklärung des Erfassers werden die Serveradresse und die Quellen der Anmeldungen nicht genannt; beides verbleibt im signierten Protokoll. ## Debug-Bereitstellung und Sperre `--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` Verwaltet SSH für einen Schlüssel von einer Adresse oder einem kleinen Netzwerk, höchstens ein /24 für IPv4 oder ein /48 für IPv6. `KEY` ist bereits beim Anbieter registriert: der Name oder die ID eines SSH-Schlüssels im Hetzner-Projekt, die ID oder der Fingerabdruck eines SSH-Schlüssels im DigitalOcean-Team, ein Linode-Benutzername, dessen Profil-SSH-Schlüssel zu „root“ hinzugefügt wurden, die ID eines SSH-Schlüssels im Vultr-Konto oder der Name eines EC2-Schlüsselpaars in der Region. Diese Optionen gelten nicht für `generic`. Eine solche Bereitstellung wird als `debug` und wird **niemals** als „High-Assurance“ gemeldet. Wenn Sie fertig sind, führen Sie `sudo tgwitness-lock` als letzten Befehl der letzten SSH-Sitzung aus und gehen Sie anschließend wie folgt vor: ``` python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token ``` Die Firewall verliert jede eingehende Regel. Berichte zeigen dann an, wann SSH zugelassen war und wann es geschlossen wurde; dieses Fenster bleibt sichtbar. ## Bereitstellung entfernen `destroy` Löscht den Server und seine Firewall, die anhand des Labels der Bereitstellung identifiziert werden, sodass auch eine Bereitstellung, die auf halbem Weg fehlgeschlagen ist, entfernt wird, sowie anschließend die DNS-Einträge, die auf den Tunnel verweisen, und den Tunnel selbst. Das Journal und der Signaturschlüssel des Servers werden ebenfalls gelöscht: Exportieren Sie zuvor die Beweismittel. Der Datensatz bleibt erhalten und wird `removed`, mit den API-Aufrufen der Entfernung. ``` python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` Die Löschung über die API ist für Hetzner implementiert. Bei anderen Anbietern `destroy` wird vor dem Löschen angehalten und das zu löschende Label in der Konsole des Anbieters benannt. Ein manuell installierter Server (`generic`) verliert lediglich seinen Tunnel und seine DNS-Einträge. Eine schnelle Tunnel-Bereitstellung benötigt kein Cloudflare-Token: Der Tunnel endet beim Server, und die Beiträge verfallen bei ntfy.sh innerhalb von 12 Stunden. ## Beliebiger Server (selbstzertifiziert) `--provider generic` gilt für einen Server, der gekauft oder manuell installiert wurde. `deploy` Erstellt den Tunnel und die DNS-Einträge, schreibt `install.sh` (privat) und `install.redacted.sh` (zur Veröffentlichung) und wartet. Kopieren `install.sh` auf einen frisch installierten Ubuntu 24.04-Server und führen Sie es dort aus: ``` sudo bash install.sh ``` Es erfasst den Host in seinem ursprünglichen Zustand (Anmeldungen, Konten, `authorized_keys`, empfangende Sockets, Dienste, geplante Aufgaben, Pakete), installiert den Commit, aktiviert die Host-Firewall, löscht sich selbst, maskiert SSH und beendet die Sitzung. Der Bericht für einen solchen Server ist bestenfalls **SELBSTBESCHEINIGT**: Wer auch immer das Installationsprogramm ausgeführt hat, verfügte zuvor über Root-Rechte, und dem Prüfer steht kein Anbieterprotokoll zur Verfügung. Es ist dennoch besser als ein ungeklärter Server: Die Bestandsliste, der Hash des Installationsprogramms und jede spätere Anmeldung sind signiert. ## Überprüfen Der Prüfer benötigt `deployment.json`den veröffentlichten Installer, schreibgeschützte Zugangsdaten und, im Idealfall, einen Checkout des Commits sowie einen Nachweis ZIP: ``` git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout git -C checkout checkout 0123456789abcdef0123456789abcdef01234567 python -m tgwitness.cloud verify --record deployment.json \ --provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \ --fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \ --source checkout --evidence tgwitness-evidence.zip --report report.md ``` Jeder Anbieter und jeder Cloudflare-Wert wird vom Verifizierer zu diesem Zeitpunkt angefordert; der Datensatz liefert lediglich die IDs, nach denen gefragt werden soll. Der Exit-Code lautet 0 für **„PASS“**, 1 für **„FAIL“** und 2 für **„REVIEW“**, **„INCOMPLETE“** oder **„SELF-ATTESTED**“. `--fingerprint` sollte von einem unabhängigen Kanal stammen; ohne diesen wird der Schlüssel nur mit dem Datensatz des Betreibers verglichen. `python verify.py` überprüft den Nachweis ZIP weiterhin selbst, wie in [„Evidence“ beschrieben](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/). Anbieteraktionen werden klassifiziert: Erstellung und Start innerhalb von 30 Minuten nach der Erstellung werden akzeptiert; Konsole, Rettung, Passwortzurücksetzung, Neuinstallation, ISO, Images, Snapshots, Backups, Systems Manager, EC2 Instance Connect und Firewall-Öffnungen werden abgelehnt; Stromversorgungsaktionen und alles Unerwartete werden zur Überprüfung markiert. Eine unbekannte Aktion wird niemals unbemerkt durchgelassen. ## Bericht zur Übergabe von Beweismitteln `--report report.md` schreibt den Markdown-Bericht und `report.json` daneben: 1. Ergebnis, Fingerabdruck des Collector-Schlüssels, Bereitstellung, Anbieter, Commit, Server, Firewall, Tunnel; 2. jede Überprüfung mit ihrem Status und ihrer Quelle (Anbieter-API, Cloudflare-API, Collector-Auszug, Beweisjournal); 3. das Anbieterprotokoll mit der Bewertung jeder Aktion und, sofern vom Anbieter erfasst, dem Ausführenden; 4. die Cloudflare-Endpunkte, die die Verbindungen, die Konfiguration und das Audit-Protokoll des Tunnels enthalten; 5. die signierte Erklärung des Sammlers; 6. Was der Bericht abdeckt und was außerhalb seines Geltungsbereichs liegt; 7. Befehle zur Reproduktion sowie das SHA-256-Element jeder Datei, die ihm übergeben wurde. Übergeben Sie den Bericht, `report.json`, `deployment.json`, das veröffentlichte Installationsprogramm und die Beweismittel ZIP. Erstellen Sie den Bericht frühzeitig: Die Protokolle der Anbieter werden nur für einen begrenzten Zeitraum aufbewahrt. ## Cloudflare als externer Zeuge Alles hier ist optional. Auch ohne Cloudflare-Konto läuft der Server weiterhin, und zwei davon sind derzeit in Betrieb: | Was | Was es zeigt | In TgWitness | | --- | --- | --- | | Schnelltunnel oder der Tunnel Ihrer Domain | Das Panel ist ausschließlich über den Tunnel erreichbar. | Der Server-Assistent, siehe oben | | drand-Relay `drand.cloudflare.com` | Die Einträge nach einer „drand“-Runde sind neuer als dieser: Das Journal wurde fortlaufend geführt. | Beweismodus, **Weitere Zeugen**, kein Konto ([Format](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) | | Benachrichtigungen zum Tunnelstatus | wenn der Tunnel ausgefallen war, per E-Mail oder Webhook von Cloudflare | Richten Sie diese im Cloudflare-Dashboard ein | | Gateway-DNS (`--gateway-dns`oder **Cloudflare Gateway DNS** im Assistenten) | Jeder Name, den der Server abgefragt hat, wurde von Cloudflare über TLS beantwortet; die Hetzner-Firewall lässt keine anderen DNS-Zugriffe zu; ob eine Gateway-Richtlinie Antworten umschreiben könnte | Hetzner, kostenloser Zero-Trust-Tarif, keine Domain; `verify` überprüft die Firewall, den Standort, die Protokollierung, die Richtlinien, die Serverabfragen und das Audit-Protokoll; der „Evidence-Modus“ kopiert das Protokoll in das Journal | | Gateway zum Cloudflare One-Client auf dem Server, eine ausgehende Firewall, die nur Cloudflare zulässt | jede vom Server hergestellte Verbindung, nicht nur DNS | noch nicht implementiert | | Zugriff vor dem Panel | Wer hat sich wann im Panel angemeldet? | noch nicht implementiert: erfordert eine eigene Domain | | Protokollierung von SSH-Befehlen | Jeder Befehl in einer Debug-Sitzung | noch nicht implementiert | „Logpush“, das eine eigene Kopie von Cloudflare in R2 speichern würde, ist eine Enterprise-Funktion: Im kostenlosen Tarif antwortet Cloudflare `logpush is not enabled for this account`. Das Gateway-Protokoll bleibt dort 24 Stunden lang erhalten, sodass es im „Evidence Mode“ in das signierte Journal kopiert wird (**das Protokoll des Cloudflare Gateways über die DNS-Abfragen dieses Servers**, ein schreibgeschütztes Token mit „Account Analytics Read“). `--gateway-location ID` (zusammen mit `--gateway-dns`) verwendet einen vorhandenen Gateway-DNS-Standort, der durch seine 32-stellige ID angegeben wird, anstatt einen neuen zu erstellen; `destroy` lässt ihn unverändert bestehen. Ohne einen Zero-Trust-Plan hat ein Konto einen DNS-Standort. Wenn Cloudflare einen weiteren ablehnt, nutzt der Server den bestehenden, und seine Abfragen werden anhand ihrer Adresse unterschieden; dieser Filter benötigt ebenfalls „Zero Trust PII Read“ und `destroy` hinterlässt einen gemeinsam genutzten Standort. Eine Protokollabfrage erstreckt sich über höchstens drei Stunden, sodass das Kopieren und `verify` Lesen des Tages in Drei-Stunden-Fenstern. „Gateway DNS“ umfasst den System-Resolver. DNS über HTTPS auf Port 443 zu einem anderen Resolver sowie Verbindungen zu einer Adresse, die nirgendwo nachgeschlagen wird (zum Beispiel zu den Rechenzentren von Telegram), werden nicht im Protokoll erfasst. Cloudflare hat keinen Einblick in die Verschlüsselung von Telegram, in andere Geräte des Telegram-Kontos (die Geräteliste im „Evidence Mode“ erfasst diese von Telegram-Seite aus) oder in den Hypervisor des Anbieters. ## Auswerten des Bereitstellungsergebnisses Bei einer gewöhnlichen VM kontrolliert der Anbieter die Host-Infrastruktur, und der lokale Bestand wird zusammen mit den Aufzeichnungen des Anbieters überprüft. Bei Intel TDX überprüft der Prüfer zusätzlich die Hardware-Angaben, die Collector-Bindung, Compose sowie Betriebssystem-Messwerte. Lesen Sie die einzelnen Ergebnisse, um zu sehen, welche Prüfungen bestanden wurden oder nicht verfügbar waren. Historische Firewall-Details hängen vom Anbieter ab; Linode speichert Regelversionen. Der [-Validierungsdatensatz](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) listet getestete Bereitstellungen und verbleibende Live- Prüfungen auf, und der [-Verifizierungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) verknüpft diese Umgebungs- Prüfungen mit der Archivierung und Integrität. --- # Telegram · Anleitung zum Panel Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/panel/ Alle Bildschirme des Panels: Chats, Journal, Quellen, Exporte, Extras, Schutzmodi und die Code-Prüfung. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Translation coverage: this edition includes material from the English original. Alle Bildschirme des Panels: Chats, Journal, Quellen, Exporte, Extras, Schutzmodi und die Code-Prüfung. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Erste Schritte](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) ![Erste Schritte](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [Erste Einrichtung und Einstellungen](https://phishdestroy.io/tgwitness/de/docs/reference/settings/) · [Konten](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/) · [Exportieren und verifizieren](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) · [Fallberichte](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/) Was die einzelnen Bildschirme bewirken, was sie in das signierte Journal schreiben und wo sich die detaillierte Anleitung befindet. Das Panel zeigt jeweils einen Arbeitsbereich an: ein Telegram-Konto mit eigenen Quellen, Journal und Signaturschlüssel. Der Konto-Selektor in der oberen Leiste wechselt zwischen den Arbeitsbereichen. Die Adresse enthält den Arbeitsbereich (`?ws=…`); solange die Adresse, der Selektor und das geladene Konto nicht übereinstimmen, bleiben Aktionen gesperrt. Verwenden Sie die [Vergleichsmethoden](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md), um zwischen Live- Beobachtung, vollständigem Verlauf, Exporten neuer Konten/Chats und der Übergabe gespeicherter Datensätze zu wählen. Die Seite Exporte enthält denselben Vergleich oberhalb der Download-Steuerelemente. **Auf dieser Seite** - [Orientierung](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#find-your-way) - [Hier beginnen](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#start-here) - [Chats](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#chats) - [Journal](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#journal) - [Quellen](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#sources) - [Exporte](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#exports) - [Einstellungen, Konten und Verbindung](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#settings-accounts-and-connection) - [Extras](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#extras) - [Schutzmodi](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#protection-modes) - [Weitere Tools](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#more-tools) ## Finden Sie sich zurecht Die Seitenleiste fasst sechs tägliche Bereiche zusammen: **Startseite**, **Chats**, **Protokoll**, **Exporte**, **Konten** und **Einstellungen**. Bereiche, für die Sie keine Zugriffsberechtigung haben, werden ausgeblendet. **Weitere Tools** enthält Untersuchungs- und Verwaltungstools. Öffnen Sie **Darstellung** am unteren Rand der Seitenleiste, um die Sprache, das Design, die Zeitzone oder die Benutzeroberfläche anzupassen: | Ebene | Abschnitte in der Seitenleiste | | --- | --- | | Einfach | Die täglichen Abschnitte | | Standard | Außerdem Case Board, Quellen, Zugriff und Dokumentation unter Weitere Tools | | Experte | Außerdem: Systemkarte, Netzwerktopologie, Extras, Frage das Archiv, Parameter, Konto, Systemprotokoll und Integrationen unter Weitere Tools | Abschnittsnamen bleiben auf jeder Ebene gleich. Eine Ebene blendet lediglich Abschnitte aus. Eine ausgeblendete Funktion bleibt weiterhin aktiv, und der Server überprüft jede Berechtigung eigenständig. Ebene, Sprache, Design und Zeitzone werden pro Bediener und Arbeitsbereich gespeichert; siehe [Einstellungen](https://phishdestroy.io/tgwitness/de/docs/reference/settings/). Verwenden Sie **Zu einem Abschnitt springen** oben in der Seitenleiste (Strg+K oder ⌘K auf einem Mac), um einen Chat, einen Parameter oder einen Journal-Eintrag anhand von `#number` zu finden. Mit den Pfeiltasten navigieren Sie, mit Enter öffnen Sie, mit Esc schließen Sie. Die obere Leiste enthält: - **Benachrichtigungen**: Probleme und Änderungen im Chat, die aus dem Journal abgeleitet wurden. **Mit „Alle als gelesen markieren“** wird der Zähler zurückgesetzt, und **„Benachrichtigungsregeln“** öffnet die Regeln. Die Zustellung an Telegram, Discord oder per E-Mail wird unter [„Extras → Benachrichtigungen“](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#notifications) eingerichtet. - Ein Menü zum Sammlungsstatus mit Start-/Pause-Steuerung, Verbindungseinstellungen und Zustandsdiagnose für Telegram, Ereignisaufnahme, Quellen und die Anhangswarteschlange. Auf einem schmalen Bildschirm öffnen Sie es über das Aktivitätssymbol. - **„Lock**“: Schließt das Fenster in diesem Browser. Die Sammlung läuft auf dem Server weiter. Die Version und der Schutzmodus sind unter **Darstellung** zu finden; siehe [Schutzmodi](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#protection-modes). Bei einer Installation wird nach der Anmeldung **die Startseite** geöffnet; ein expliziter Link öffnet den gewünschten Bildschirm. Ein auf den Chat-Bereich beschränkter Prüfer öffnet **„Chats**“. Die Adressen `/home`, `/case-board`, `/pseudo-secret` und `/network-topology` öffnen ebenfalls die entsprechenden Bildschirme. Unbekannte Seitenadressen geben den HTTP-Fehler 404 mit Vorschlägen für ähnliche Seiten zurück. Der Demo-Arbeitsbereich enthält fiktive Nachrichten und stellt niemals eine Verbindung zu Telegram her. Aktionen, die einen echten Arbeitsbereich verändern würden, werden dort abgelehnt. [Die Systemübersicht](https://github.com/phishdestroy/TgWitness/blob/main/docs/SYSTEM-MAP.md) zeigt die Kontorouten, den Proxy-Status, die Socket-Endpunkte, verschlüsselte Tresore, Evidenzdienste und beobachtete Netzwerkanfragen dieser Installation an. Wählen Sie ein Konto aus, um dessen Pfad zu überprüfen. Verfügbare, aber deaktivierte Dienste bleiben sichtbar. ## Hier beginnen Die Übersicht löscht das kontospezifische Diagramm und die Zusammenfassung, wenn Sie das Konto wechseln oder sich erneut anmelden. Ladevorgänge, fehlgeschlagene Lesevorgänge und ein Zeitraum ohne gespeicherte Datensätze haben jeweils eigene Status. **Erneut versuchen** wiederholt den fehlgeschlagenen Lesevorgang; falls der Server eine Wartezeit anfordert, wird der Zeitpunkt des nächsten Versuchs angezeigt. Bei einer fehlgeschlagenen Aktualisierung werden die zuletzt erfolgreichen Daten für denselben Arbeitsbereich beibehalten und mit dem Zeitpunkt der letzten Aktualisierung gekennzeichnet. Für jedes verbundene Konto werden **der Collector-Heartbeat** und **das zuletzt empfangene Ereignis** separat angezeigt. Ersteres gibt Auskunft über die Aktivität des Collectors, letzteres über das zuletzt empfangene Telegram- Update. Bei einer inaktiven Quelle bleibt die zweite Zeitangabe unverändert, solange der Collector weiterläuft. Öffnen Sie das Menü „Collection-Status“, um Diagnosedaten zu Verbindung, Datenaufnahme, Quelle und Anhängen anzuzeigen. Wählen Sie eine Aufgabe aus. **Mein Konto exportieren** lädt herunter, was das Konto derzeit lesen kann. **Untersuchung verfolgen** protokolliert neue Nachrichten, beobachtete Bearbeitungen und Löschbenachrichtigungen aus den von Ihnen ausgewählten Chats. Während die Beobachtung pausiert ist, zeigen „Chats“, „Protokoll“ und „Quellen“ die Einrichtungskarte an: Konto verbinden, Quellen auswählen, Beobachtung starten. Mit dem Ziel **Beweismittel für einen Fall** oder im Modus „Beobachtet“, „Fallvorbereitung“, „GitHub-verifiziert“ oder „Maximaler [Schutz“](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#protection-modes) liest die Überwachung beim Start zunächst die Sitzungsliste von Telegram aus (nicht, wenn **Streng: Nur die ausgewählten Chats lesen** aktiviert ist). Sind andere Sitzungen angemeldet, zeigt das Fenster deren Anzahl an und bietet die Optionen **Trotzdem starten** oder **Sitzungen dieses Kontos öffnen** an. Andere Ziele und Modi starten ohne diese Abfrage. Die Zielabfrage bleibt auf dieser Seite, bis Sie sie beantworten oder überspringen. Stattdessen öffnet sich ein neuer Arbeitsbereich mit der [ersten Einrichtung](https://phishdestroy.io/tgwitness/de/docs/reference/settings/). ## Chats Gespeicherte Unterhaltungen, standardmäßig schreibgeschützt. Die Chat-Zeilen zeigen den Erfassungsstatus, ausstehende und fehlgeschlagene Dateidownloads, das anfängliche Laden des Verlaufs sowie Einschränkungen an, die in den Dialog-Metadaten von Telegram zurückgegeben werden. Ein verlorener oder unbestätigter Zugriffsstatus bedeutet nicht, dass der Inhalt gesperrt ist. Öffnen Sie **Filter,** um diese Status auszuwählen oder nach der Dateiwarteschlange zu sortieren; die Auswahl bleibt in der URL erhalten, wenn die Seite neu geladen wird. Der Filter **Wiederholen** findet erste Chat-Ladevorgänge, die nach einem Fehler ausstehen. Ihr Symbol zeigt den Fehlertyp und – während des Abrufs – den Zeitpunkt des nächsten Versuchs an. Auf der Startseite wird zusammengefasst, wie viele Ladevorgänge einen erneuten Versuch erfordern. Die angehaltene Erfassung behält die Aufträge bei, bis sie fortgesetzt wird. In **Simple** mode Home also shows **Can be handed to a court: yes** or **no · missing: …**. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs `verify.py` with `--tsa-ca` and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here. In den Journal-Einträgen mit beibehaltenen Zuordnungen werden der erkannte Typ, der Name und die Bytegröße angezeigt. Bei neuen Download-Ergebnissen werden auch der Medientyp und die Dauer beibehalten, sofern Telegram diese bereitstellt. Ältere signierte Datensätze bleiben unverändert; fehlende Metadaten werden nicht rekonstruiert. - Search the list by name or ID. Several words match in any order, including a name and part of an ID together. The **+** button opens **Add a chat or channel** (adds or removes watched chats), **Open Telegram link** and **Pseudo-secret · Start chat**. **Open Telegram link** takes a username or invite link and saves a preview to the journal; a search for an @username or t.me link with no match offers the same. **Join / open and observe** then joins the chat and adds it to your sources; opening a bot sends it `/start`. - Pseudo-geheime Chats werden in derselben Liste angezeigt – grün und mit einem Schloss – und im Modus „Pseudo-geheim“ geöffnet. Wenn die Beobachtung deaktiviert ist, wird in der Liste „Eine **Beobachtung offline**“ mit der Option **Beobachtung starten** angezeigt. - Die Schnellfilter sind Registerkarten in einer Reihe: **Alle**, **Pseudo-geheim**, **Priorität**, **Änderungen** (gespeicherte Bearbeitungen oder Löschhinweise) und **Erfordert Aufmerksamkeit** (verlorener oder unbestätigter Zugriff, bei erneuter Überprüfung nicht gefundene Nachrichten, fehlerhafte Medien, Wiederholungsversuche im Verlauf oder Telegram-Einschränkungen). Registerkarten ohne Inhalt sind ausgeblendet. Die Anzahlen berücksichtigen den Such- und Typfilter; ein Schnellfilter ersetzt den Statusfilter. Diese Auswahl bleibt in der URL erhalten, auch beim Neuladen und bei der Navigation mit „Zurück“/„Weiter“. **Erfordert Aufmerksamkeit** kennzeichnet eine Nachricht nicht als gelöscht. Typ, Status und benutzerdefinierte Sortierung bleiben als entfernbare Kacheln sichtbar, wenn **Filter** ausgeblendet ist. - In großen Listen werden jeweils 80 Treffer angezeigt; **mit Mehr anzeigen** werden die nächsten 80 hinzugefügt. Der geöffnete Chat und die markierte Zeile bleiben verfügbar, solange sie mit den Suchergebnissen übereinstimmen, auch außerhalb dieses Stapels. Der Zähler zeigt die angezeigten Chats im Verhältnis zu allen Treffern an. Die Suche umfasst die gesamte Liste, einschließlich der Chats, die noch nicht angezeigt wurden. - Von der Suche aus springt **↓** zum ersten Ergebnis, **↑** zum letzten angezeigten Ergebnis, und **die Eingabetaste** öffnet das erste Trefferergebnis. Innerhalb der Liste verschieben **↑/↓** und **Home/End** den Fokus; **die Eingabetaste** öffnet den Chat, auf dem der Fokus liegt. **Mit der Escape-Taste** kehrt man zur Suche zurück, wo ein erneutes Drücken die Suchanfrage löscht. **Filter löschen** setzt die Liste zurück, ohne die Sammlung oder die geöffnete Unterhaltung zu ändern. - Die Chat-Kopfzeile zählt Nachrichten als **gelöscht, Text beibehalten**, **vor dem Speichern gelöscht** und **bei erneuter Überprüfung nicht gefunden**. Jeder Zähler ist eine Schaltfläche, die nur diese Nachrichten zeigt; ein erneuter Klick zeigt wieder alle. **Gelöscht** und **Bei erneuter Überprüfung nicht gefunden** an einer Nachricht öffnen einen Hinweis mit der Uhrzeit und dem, was beobachtet wurde. Chatliste und Benachrichtigungen verwenden dieselben Definitionen. Eine gelöschte Nachricht ist rot und behält ihren gespeicherten Text; eine bearbeitete Nachricht behält jede gespeicherte Version. - **Die Suche nach gespeicherten Nachrichten** durchsucht den gesamten aufbewahrten Chat, einschließlich früherer Textversionen. Filter für gelöschte, bearbeitete Nachrichten, Medien und Autoren beziehen sich ebenfalls auf den gesamten aufbewahrten Chat. **Bei erneuter Überprüfung nicht gefunden** ist unabhängig von erhaltenen Löschbenachrichtigungen. Die Suche fordert keine Nachrichten von Telegram an; verwenden Sie **Verlauf laden,** um weitere Nachrichten abzurufen. Ein Treffer in einer früheren Version öffnet die gespeicherten Versionen mit ihren Journal-Links. **Die angezeigte Version** identifiziert den für die Nachricht verwendeten Datensatz und dessen Lesezeichen; eine spätere Antwort aus dem Verlauf kann eine neuere Live-Bearbeitung auf dem Bildschirm nicht ersetzen. - Zwischen Nachrichten zeigt der Chat zwei Arten von Lückenmarkierungen. **Nicht beobachtete Nachrichtennummern** listet Nummern auf, für die das Journal keinen Eintrag hat, nur in Kanälen und Supergruppen: Andere Chats teilen sich eine kontoweite Nummerierung, daher sagt ein Sprung dort nichts über den Chat aus. **Erfassungslücke** markiert einen Zeitraum zwischen einer aufgezeichneten Unterbrechung und der nächsten aufgezeichneten Wiederaufnahme, mit dem Grund, sofern das Journal einen enthält. Die Markierungen erscheinen, wenn alle Nachrichten angezeigt werden, und sind ausgeblendet, solange ein Nachrichtenfilter aktiv ist. - **Build-Bericht** Über den Nachrichten öffnet sich das Report Studio, wobei dieser Chat ausgewählt ist. Die gleiche Schaltfläche in der Profilkarte eines Autors wählt den Chat und diesen Autor aus. Beide Änderungen wirken sich nur auf den Entwurf aus; speichern Sie ihn vor dem Exportieren. - Durch Antippen des Namens eines Autors wird neben den Nachrichten eine Personenkarte geöffnet: gespeichertes Profil, Biografie, Profilfotos, Geschenke, Links, Nachrichtenanzahl und die Aktivitätszeitleiste mit ihren Tagebucheinträgen sowie **Profil aktualisieren** und **Bericht erstellen**. **Mit Schließen**, „Esc“ oder einem anderen Chat wird die Karte geschlossen; der Chat behält seine Position bei. **Rhythmus** in der Karte zählt die gespeicherten Nachrichten des Autors in diesem Chat in UTC: aktive Tage, beginnt nach 6 Stunden Stille, mittlere Zeit bis zur Antwort auf eine andere Person innerhalb von 24 Stunden, die längste Folge aufeinanderfolgender Nachrichten, der Anteil der zwischen 00:00 und 06:00 Uhr gesendeten Nachrichten sowie eine Heatmap nach Wochentag × Stunde. - **Auswählen** über den Nachrichten schaltet die Nachrichtenauswahl ein: Tippen Sie Nachrichten an, um sie zu markieren, mit Umschalt einen Bereich, oder verwenden Sie **Ausgewählte anzeigen** und dann **Bericht erstellen**. Das Berichtsstudio öffnet sich mit ausgefülltem Feld **Ausgewählte Nachrichten**. Der Bericht umfasst die Nachrichteneinträge dieser Nachrichten (Beobachtungen, Bearbeitungen, Löschhinweise), die die übrigen Filter passieren; ein Autorenfilter lässt Löschhinweise weg, da sie keinen Absender tragen. Bis zu 1.000 Nachrichten können ausgewählt werden; ein Chip im Studio entfernt eine Nachricht, und daneben lassen sich ganze Chats hinzufügen. Fehlende Nachrichtennummern werden nur für vollständig ausgewählte Chats ausgewiesen. - **Der Ladeverlauf** ruft die letzten 100, 250 oder 500 Nachrichten in diese Ansicht und in das Journal. Sie finden ihn unter **Chat-Aktionen**, neben den Aufzeichnungseinstellungen, den Optionen für den schreibgeschützten Modus und der Maskierung geheimer Inhalte. Das Menü wird mit der Escape-Taste oder durch einen Klick außerhalb des Menüs geschlossen. Beim Laden früherer Nachrichten bleibt die aktuelle Leseposition erhalten. Wenn sich die Abfrage oder die Seite ändert, während Telegram antwortet, wird das gespeicherte Journal nach Abschluss des Ladevorgangs aktualisiert, ohne dass die neuere Ansicht ersetzt wird. Bei einem fehlgeschlagenen automatischen Ladevorgang wird **Erneut versuchen** angeboten. Um alle aktivierten Quellen zu laden, verwenden Sie [Quellen → Vollständiger Verlauf](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#sources). - Mit **„Chat exportieren“** wird der gesamte sichtbare Verlauf als signierte `chat.json` und `chat.html`. Mehrere verbundene Konten können sich die Arbeit teilen: Jedes lädt seinen eigenen Bereich von Nachrichtennummern herunter und signiert seinen Teil, und das Konto, das den Export startet, signiert das Archiv. Siehe [„Einen Chat exportieren](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)“. - **Unter „Personen“** werden alle Personen aufgelistet, deren Nachrichten in diesem Chat gespeichert sind. Personenprofile sind standardmäßig deaktiviert, da es sich um personenbezogene Daten Dritter handelt. Sind sie für einen Chat aktiviert, zeigt ein Profil den Namen und den Verlauf der Benutzernamen, Telegram-Flags, Avatar-Hashes, Aktivitäten, wer wem antwortet, andere beobachtete Chats sowie erwähnte Wallets, Telefonnummern, Benutzernamen und Links an. Jede Angabe verweist auf den entsprechenden Datensatz. **Beim Exportieren von Profilen** wird eine signierte Datei gespeichert, optional in einem passwortgeschützten ZIP; beim Deaktivieren der Profile wird die Profildatei gelöscht. Siehe [Personenprofile](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#people-profiles). - **Alle Autoren anzeigen** Auf derselben Registerkarte werden bei Telegram das Profil, die Biografie, die Profilfotos, Geschenke und Biografie-Links aller Personen abgefragt, deren Nachrichten im Chat gespeichert sind. In einem Kanal oder einer Supergruppe können andere verbundene Konten die Arbeit teilen. Jedes ausgewählte Konto wird für die Sammlung reserviert, erfasst ganze Personen und erreicht einen Autor über eine der gespeicherten Nachrichten dieses Autors. Ein Konto, das gerade mit einer anderen Aufgabe beschäftigt ist, wird nicht berücksichtigt und schaltet sich ein, sobald es frei ist. Ein Autor, den es nicht erreichen kann, kehrt zum eigenen Konto des Chats zurück. Der Fortschritt wird in Prozent, der verbleibenden Zeit und dem Anteil jedes Kontos angezeigt; **Pause** gibt die Konten frei. Jeder gespeicherte Datensatz enthält den Namen des Kontos, das ihn gelesen hat, und das Journal protokolliert, wann jedes Konto hinzugefügt und entfernt wurde. - **Profil jetzt speichern** erstellt einen Schnappschuss des Chats oder des Bot-Profils: Beschreibung, Mitglieder, Einladungslink, Bot-Befehle. ### Schreibgeschützt, Senden und Geheimnisse Zwei Schalter oberhalb der Nachrichten schützen das Konto und den Leser: - **Der schreibgeschützte Modus** ist aktiviert, wenn ein Chat geöffnet wird. Deaktivieren Sie diese Option, um Nachrichten zu senden oder Bot-Schaltflächen anzuklicken. Bei jeder Aktion wird gefragt: **„Als @Konto senden?**“ oder **„Diese Bot-Schaltfläche als @Konto anklicken?**“, um Sie darauf hinzuweisen, dass Chat-Teilnehmer dies sehen und dass die Aktion in das signierte Protokoll aufgenommen wird. **Die Option „In diesem Chat 10 Minuten lang nicht erneut fragen“** überspringt die Frage für eine Weile. Das Senden ist für das Ziel **„Beweismaterial für einen Fall**“ deaktiviert, sowohl im Bedienfeld als auch in der API. - **„Mask Secrets“** verbirgt alles, was wie ein Passwort, ein Anmeldecode, ein API-Schlüssel oder Hash, ein Bot-Token, eine Sitzungs-String, ein privater Schlüssel, ein JWT oder eine Zahlungskartennummer aussieht (Kartennummern werden anhand der Luhn-Summe überprüft). **Mit „Show“** wird ein Wert angezeigt; die Anzeige wird im Journal protokolliert. Auch das Deaktivieren der Maskierung für diesen Browser wird protokolliert. Es ändert sich lediglich die Anzeige: Die ursprünglichen Datensätze und alle Exporte behalten den vollständigen Text bei. ### Ausgewählte Nachrichten als Bilder speichern Wählen Sie in einem Cloud-Chat **„Auswählen**“, markieren Sie die Nachrichten und wählen Sie anschließend **„Als Bild speichern**“. Um einen gesamten Chat zu speichern, wählen Sie im Menü „Chat-Tools“ die Option**Chat als Bilder speichern**; dabei werden bis zu den letzten 2.000 gespeicherten Nachrichten geladen und es wird angezeigt, wenn ältere Nachrichten nicht berücksichtigt werden. Die Vorschau bietet die Stile **Hell**, **Dunkel** und **Klassisch**; verwenden Sie „Zurück“ und „Weiter“, um längere Aufzeichnungen zu erstellen. **Beim Herunterladen der signierten ZIP-Datei** wird jede Seite als PNG-Datei zusammen mit `pages.sig.json` und `README.txt` ([signierte Chat-Bilder](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#signed-chat-images)). Es können bis zu 50 Nachrichten ausgewählt werden, die sich alle noch im geladenen Chat-Fenster befinden müssen. Das Fenster fordert Sie auf, eine zu große Auswahl zu verkleinern, anstatt Nachrichten stillschweigend auszulassen. Jede Seite endet mit einem Authentizitätsblock: den darin angezeigten Protokollnummern, dem Chat, der Renderzeit, dem Fingerabdruck des Arbeitsbereichsschlüssels, dem `verify.py` Befehl für diese Seite sowie einen QR-Code mit dem Chat, dem Schlüssel und der Renderzeit. Das Signieren erfordert die Exportberechtigung und fügt einen `export.image_attested` Eintrag zum Journal hinzu. Das Bild enthält den gespeicherten Text, den Autor, die Nachrichtennummer, die UTC-Zeit, die Antwortnummer, Anhangsbezeichnungen sowie den gespeicherten Bearbeitungs-/Löschstatus. Es verwendet den zuletzt gespeicherten Text mit der Anzahl der beibehaltenen Versionen; Anhangsinhalte, Inline-Schaltflächen, Reaktionen und frühere Textversionen werden nicht dargestellt. Eine lange Nachricht wird auf der nächsten Seite mit ihrer Nachrichtennummer und der Anzahl der Teile fortgesetzt. Jede Seite kennzeichnet sich als aus gespeicherten Nachrichten gerendert. Das PNG ist ein visueller Auszug; verwenden Sie das Archiv und dessen Verifizierungsfunktion bei der Übergabe der signierten Datensätze und Anhänge. Die Darstellung erfolgt im Browser, ohne dass eine Telegram-Anfrage gestellt wird; zum Signieren werden lediglich der SHA-256-Hash und die Datensatznummern der jeweiligen Seite an das Panel gesendet. Die vorhandene Geheimhaltungsfunktion schützt Text, Autorennamen und Anhangsbezeichnungen. Die Vorschau behält einen Schnappschuss bei, bis sie geschlossen wird, und wird beim Sperren des Panels oder bei einem Wechsel des Arbeitsbereichs bzw. Chats gelöscht. Die Auswahl der signierten Tagebücher und Berichte bleibt unverändert. Vollständige Berichtexporte finden Sie in [den Fallberichten](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/). ### Nachrichten weiterleiten Deaktivieren Sie **den Schreibschutz** für den Chat und wählen Sie dann unter einer Nachricht **Weiterleiten** oder **wählen Sie Auswählen**, markieren Sie bis zu 100 Nachrichten und wählen Sie **Weiterleiten**. Wählen Sie das Ziel nach Name aus: Die Liste enthält gespeicherte Chats sowie die Telegram-Chats des Kontos, in denen es Beiträge veröffentlichen kann (Gruppen, private Chats, Bots und Kanäle, die es verwaltet). Das Fenster fordert zur Bestätigung auf und leitet die Nachricht anschließend nativ über Telegram mit der für das Konto üblichen Nachrichtenrate weiter. Die Anfrage und ihr Ergebnis sind signierte Protokolleinträge, in denen der Quell-Chat, die Nachrichtennummern und das Ziel angegeben sind. Kopien werden nur dann im Ziel gespeichert, wenn dieser Chat beobachtet wird. Ein Chat, der das Weiterleiten verbietet, gibt eine Ablehnung zurück, und es wird nichts gesendet. ### Einen Chat an einen Kanal oder eine Gruppe weiterleiten The main administrator can open a saved cloud chat and choose **Forward chat** from its tools menu. Choose **New channel**, **New group**, or **Existing channel or group**. New destinations are private. For an existing destination, **Choose a chat** lists the account's groups and the channels it administers; search by name. The destination must allow this account to post. Forum destinations are not supported. Unterbrechen Sie die Beobachtung oder einen anderen aktiven Kontoauftrag und aktivieren Sie die Telegram-Aktionen, bevor Sie die Vorschau aufrufen. Schreibgeschützte Konten und das Ziel **Beweismittel für einen Fall** blockieren Übertragungen. **Die Vorschau** liest den zugänglichen Telegram-Verlauf aus und überprüft das Ziel. Es wird weder ein Ziel erstellt noch werden Nachrichten gesendet. **Mit Start** wird die Übertragung gestartet; die Vorschau läuft nach zehn Minuten ab. Pro Arbeitsbereich kann jeweils eine Übertragung aktiv sein. Die Übertragung liest den Telegram-Verlauf vom ältesten zum neuesten Eintrag, bis hin zur letzten Nachricht, die in der Vorschau angezeigt wird. Sie ist nicht auf die bereits in TgWitness gespeicherten Nachrichten beschränkt. Nachrichten, die jenseits dieser Grenze eintreffen, werden ausgeschlossen. Bei der nativen Weiterleitung bleiben die in Telegram verfügbaren Autorenangaben und Medien erhalten, ohne dass Kopien herunter- und hochgeladen werden müssen. Alben innerhalb dieser Grenze bleiben zusammen. Benachrichtigungen erfolgen im Hintergrund. Antworten, Themenstruktur, Reaktionen, Bearbeitungen sowie gelöschte oder nicht zugängliche Nachrichten werden nicht rekonstruiert. Geheime Chats sind von diesem Arbeitsablauf ausgeschlossen. Der Inhaltsschutz und die Veröffentlichungsbeschränkungen von Telegram bleiben weiterhin in Kraft. Das Fenster zeigt bestätigte Sendevorgänge, Überspringungen, den Status und den Zeitpunkt des nächsten zulässigen Versuchs an. Dienstmeldungen und individuell geschützte Nachrichten werden mit einem protokollierten Grund übersprungen. Die Abstände zwischen Nachrichten und die stündlichen Limits des Kontos gelten für jede Nachricht; ein Album wartet, bis seine reservierten Zeitfenster fällig sind. „FloodWait“- und „Slow-Mode“-Pausen aktualisieren den gemeinsamen RPC-Backoff des Kontos. Die bestehenden Standardwerte für die Übertragungsrate des Kontos bleiben unverändert. **Pause** unterbricht den Vorgang zwischen den Anfragen; **Abbrechen** beendet die verbleibenden Aufgaben, ohne bereits gesendete Nachrichten zu entfernen oder ein erstelltes Ziel zu löschen. Eine laufende Anfrage kann möglicherweise abgeschlossen werden, bevor eine der beiden Aktionen wirksam wird. Das Schließen des Dialogfelds bricht einen Auftrag nicht ab. Nach einem Neustart des Prozesses müssen unvollendete Aufträge explizit **fortgesetzt** werden. Eine fehlende oder unvollständige Sendeantwort hält den Auftrag zur Überprüfung an: Überprüfen Sie das Ziel, bevor Sie den Auftrag fortsetzen. Bei einem erneuten Versuch bleiben die gespeicherten zufälligen Telegram-IDs und die Anzahl der Bestätigungen erhalten; dies ist jedoch keine Garantie für eine unbefristete Deduplizierung durch Telegram. Ein unbekanntes Erstellungsergebnis kann nicht automatisch fortgesetzt werden: Überprüfen Sie Telegram und brechen Sie den alten Auftrag ab, bevor Sie eine neue Übertragung an das gegebenenfalls erstellte Ziel starten. Wenn das Speichern eines Auftrags oder seines Journal-Eintrags fehlschlägt, stellt der Worker den zuletzt gespeicherten Zustand wieder her und gibt das Konto frei. Ein Sendevorgang oder eine Erstellung, die möglicherweise bereits Telegram erreicht hat, bleibt zur Überprüfung markiert. Ein fehlgeschlagener Start oder eine Fortsetzung sollte erneut versucht werden, sobald Speicherplatz wieder verfügbar ist; der bestätigte Fortschritt schreitet nur mit dem entsprechenden Journal-Eintrag voran. Signiert `interaction.forward.*` Journal-Einträge erfassen die Grenze, das Ziel, die bestätigten Quell- und Ziel-Nachrichten-IDs sowie Überspringungen. Sie dokumentieren die Übertragung; sie ersetzen jedoch nicht die ursprünglichen signierten Beobachtungen und Exporte. ## Protokoll Alle vom Arbeitsbereich signierten Aufzeichnungen, sortiert nach dem neuesten Datum zuerst. - **Die Übersicht** zählt die beobachteten Nachrichten, aufgezeichneten Bearbeitungen, Löschmeldungen und ausgewählte Quellen. - **Ereigniszeitleiste** filtert nach Ereignistyp (alle, Bearbeitungen, Löschungen, Reaktionen, Mitgliedschaft, Berichterstattung), nach Text und nach Quelle. **Frühere Ereignisse laden** blättert zurück. - Öffnen Sie einen Datensatz, um dessen Details, Hash und Nutzdaten anzuzeigen. **Der Link zu diesem Datensatz** ist eine Adresse, über die derselbe Datensatz geöffnet wird. Mögliche vertrauliche Informationen werden in dieser Vorschau maskiert; bei Exporten bleibt das Original erhalten. - Das Protokoll ist schreibgeschützt: Im Bedienfeld kann kein Datensatz bearbeitet oder gelöscht werden. Überprüfen Sie dies unter **„Exporte“ → „Protokoll überprüfen“** oder `python -m tgwitness.verify`; siehe [„Exportieren und Überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/)“. ## Quellen Welche Unterhaltungen dieser Arbeitsbereich aufzeichnet und welche Inhalte daraus gespeichert werden. Änderungen gelten für zukünftige Aktivitäten; gespeicherte Aufzeichnungen bleiben erhalten. **„Chatliste aktualisieren“** liest die Chats und Ordner des Kontos aus. Es werden keine Nachrichten heruntergeladen. ### Geltungsbereich - **Was dieses Konto aufzeichnet** : **Ausgewählte Chats** (nur die Chats, die Sie hinzufügen), **Telegram-Ordner** (einer der Ordner des Kontos, einschließlich der Chats, die später hinzugefügt werden) oder **Gesamter Beitrag** (jeder Chat sowie jeder neue Chat, jede neue Gruppe, jeder neue private Chat oder jeder neue Bot, sobald er erscheint). **Untersuchungsmodus** ist für ein dediziertes Konto vorgesehen: Es zeichnet alles auf, was das Konto sieht, seine eigenen Nachrichten und Tastendrücke, und speichert das Profil jedes neuen Chats sowie die zuvor sichtbaren Nachrichten sofort. Das [Spezieller Leitfaden für Konten](https://phishdestroy.io/tgwitness/docs/dedicated-account/) erklärt, warum du niemals dein Hauptkonto verwenden solltest. - **Streng: Nur ausgewählte Chats lesen** (Standardmäßig deaktiviert) unterbindet das Einlesen von Telegram-Dienstbenachrichtigungen, der Sitzungsliste und älterer Nachrichten eines Chats, lässt die Einstellung für sensible Inhalte unverändert und überspringt Aktualisierungen zu Telefonanrufen. Siehe [Streng: Ausgewählte Chats](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#strict-chosen-chats). - **Quellentypen** beschränken den Ordner- und den Gesamtkonto-Modus auf Kanäle, Gruppen, private Chats und Bots. **„Eigene Aktionen“** fügt die eigenen Nachrichten, Bearbeitungen und Tastenanschläge bei Antworten des Kontos hinzu. - **Wenn ein neuer Chat oder Bot erscheint**: Speichere dessen Profil und bis zu der gewählten Anzahl seiner zuletzt sichtbaren Nachrichten. - **Ausgewählte Chats** ist als Empfehlung markiert. Mit **Änderungen verwerfen** kehrt das Formular zum gespeicherten Bereich zurück, bis Sie auf **Bereich speichern** klicken. [Pseudo-Secret](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/) ist die integrierte „Secret Chat“-Oberfläche, die pro Konto nach der Installation des entsprechenden Protokollmoduls mit einem Klick aktiviert wird. Die Cloud-Überwachung und der Verlauf verwenden eigene Einstellungen. Solange TgWitness nicht läuft, wird nichts aufgezeichnet; nach einem Neustart erfasst es nur noch das, was Telegram noch zurückgibt, und der Bericht zeigt die Lücke an. Chats, die über das Limit der Chat-Liste hinausgehen (1.000 Dialoge, sofern nicht in den Einstellungen geändert), werden hinzugefügt, sobald sie das nächste Mal aktiv werden. Inline-Bot-Schaltflächen, die in einer anderen App gedrückt werden, sind unsichtbar; die Antwort des Bots wird jedoch aufgezeichnet. ### Betroffene Chats Filtern Sie nach Status (**Aktiviert**, **Pausiert**, **Priorität**, **Ausgeschlossen**, **Unbestätigter Zugriff**, **Ignoriert**) und Typ und führen Sie dann Aktionen für eine Auswahl durch: aktivieren, pausieren, Priorität setzen oder entfernen, aus dem Umfang ausschließen oder entfernen. Das Status-Symbol zeigt nur den Status an; Aktionen befinden sich im Menü jeder Zeile mit einer Beschreibung ihrer Funktion. Das Pausieren und Ausschließen erfordert eine Bestätigung, auch bei Massenaktionen. Beim Entfernen einer Quelle wird nach deren Namen gefragt und die zugehörigen Personenprofile gelöscht; die gespeicherten Einträge verbleiben im Journal. Eine Quelle, die nicht in der Chat-Liste des Kontos angezeigt wird, ist **Empfang von Updates, die nicht in der Chat-Liste erscheinen**, während weiterhin Aufzeichnungen eingehen; andernfalls **Zugriff unbestätigt**. **Verfügbare Chats** fügt Chats mit **Ausgewählte hinzufügen** oder **Alle Treffer hinzufügen** hinzu. ### Vollständiger Verlauf Lädt den verfügbaren Verlauf jeder aktivierten Quelle in „Chats“ und das Journal. Der Fortschritt bleibt nach einem Neustart erhalten; Anhänge richten sich nach Ihren Medieneinstellungen. Siehe [Quellenverlauf](https://phishdestroy.io/tgwitness/de/docs/reference/history/). ### Aufzeichnung - **Wählen Sie aus, welche Änderungen beibehalten werden sollen**: neue Nachrichten, Bearbeitungen, Löschbenachrichtigungen, sichtbare Reaktionen, Beitritte und Austritte. Eine Voreinstellung ändert das Formular; **mit „Aufzeichnungseinstellungen speichern“** wird sie übernommen. Das erneute Aktivieren einer Kategorie stellt verpasste Ereignisse nicht wieder her. - **Medien nach Möglichkeit sichern**: Anhänge bis zu einer bestimmten Dateigröße herunterladen, pro Typ zwischen 1 und 2.000 MiB festlegen und die Videolänge in Sekunden begrenzen (0 bedeutet keine Begrenzung). Jeder Download-Versuch wird mit einem Ergebnis protokolliert. - **Überprüfung**: Prioritätschats alle paar Minuten, andere Chats selten, damit das Konto die „FloodWait“-Grenzen von Telegram nicht überschreitet. Mit „0“ wird eine Gruppe deaktiviert. Markieren Sie Prioritätschats in der Liste mit dem Stern; die Anzahl der Chats pro Durchlauf und die Pause zwischen den Chats finden Sie unter „Parameter“. Siehe [Sammlung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/). - Die Speicherleiste zeigt an, ob diese Einstellungen mit den empfohlenen übereinstimmen. **Mit Zurück zu den Empfehlungen** werden die empfohlenen Werte übernommen; **mit Aufnahmeeinstellungen speichern** werden sie angewendet und mit **Änderungen verwerfen** werden die gespeicherten Einstellungen wiederhergestellt. ## Exporte **Unter „Downloads“** werden Dateien vorbereitet; unter **„Build-Bericht“** wird festgelegt, wie die Berichte aussehen sollen. | Was | Verwenden Sie es für | Anleitung | | --- | --- | --- | | Kontoexport | Ein aktueller Überblick darüber, was das Konto derzeit lesen kann | [Kontoexport](https://phishdestroy.io/tgwitness/de/docs/reference/account-export/) | | Kopie teilen | Eine vereinfachte Version eines fertigen Kontoexports | [Offenlegung](https://phishdestroy.io/tgwitness/de/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) | | Signiert ZIP | Journal, Bericht, Anhänge und Verifizierungstools innerhalb einer festen Journalgrenze | [Exportieren und überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) | | Bericht im HTML-, PDF- und JSON-Format | Ein versiegelter, lesbarer Bericht | [Fallberichte](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/) | | JSONL, CSV | Originalaufzeichnungen mit Signaturen; eine formelsichere Tabellenkalkulation | [Exportieren und überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) | | Auszug aus der Übergabe | Nur die Chats, Zeiträume und Personen, die ein Empfänger benötigt | [Beweismittel](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#investigation-handoff) | | Chat-Export | Ein Chat als signierte Datei `chat.json` und `chat.html` | [Einen Chat exportieren](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) | - **Die Verschlüsselung der oben genannten Downloads mit einem Passwort** (mindestens 12 Zeichen) speichert eine AES-256-Datei ZIP, die mit 7-Zip oder WinRAR geöffnet werden kann. Die darin enthaltene signierte Datei bleibt unverändert. Das Passwort wird nicht gespeichert. - Beim Import des Sitzungsschlüssels dieses Arbeitsbereichs weisen die Dialogfelder Konto exportieren und Chat exportieren in einer Zeile darauf hin: Kopien dieses Schlüssels können außerhalb der Sitzungsliste von Telegram existieren. In derselben Zeile wird die**Option Unabhängige Autorisierung erstellen** angeboten, die die Anmeldeseite mit dieser Option vorgewählt öffnet. Siehe [Konten](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#create-an-independent-authorization). - Ein Chat-Export, der fehlschlägt oder abgebrochen wird, behält den gespeicherten Bereich bei. Bei **der Erfassung oder dem Export eines Chats** werden anschließend die Optionen **Export fortsetzen** und **Von vorne beginnen** angeboten; siehe [Einen Chat exportieren](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md). - Während beim Chat-Export unter **Bisher gelesene Nachrichten herunterladen** eine ZIP-Datei gespeichert wird, deren Seiten beim Schreiben signiert werden; die Zeile darunter gibt die Anzahl der signierten Nachrichten an. - **Vorbereitete Exporte** speichern bis zu 20 Dateien mit einer Gesamtgröße von bis zu 2 GiB sowie die aktuellste Datei für wiederholte Downloads, jeweils mit dem entsprechenden SHA-256-Hash, den der Empfänger zum Abgleich nutzen kann. Jede Karte gibt an, was die Datei enthält: **Signiertes Archiv** (vollständiges Protokoll und dessen Datensatzanzahl), **Bericht**, **Protokolldatensätze** oder **Übergabeauszug**, den Falltitel und die Fall-ID sowie die Berichtsauswahl, auf deren Grundlage es erstellt wurde (Chats, ausgewählte Nachrichten, Daten). **Mit Anzeigen** wird die Liste auf einen Typ eingegrenzt, wenn sie mehr als einen enthält. - Wenn der Browser den Speicherdialog ablehnt, weicht das Panel auf einen normalen Download aus. - **Ihre Signaturidentität** zeigt den Schlüssel-Fingerabdruck an. **Checkpoint speichern** und **Signierte Ausführungsbestätigung herunterladen** liefern Ihnen Aufzeichnungen, die Sie außerhalb des Collectors aufbewahren können. **Anfrage für Zeitstempel vorbereiten** erstellt eine RFC-3161-Anfrage, ohne einen Dienst zu kontaktieren. ## Einstellungen, Konten und Verbindung - **Einstellungen**: Ziel, Verbindung, Aufzeichnungsumfang und Benutzeroberfläche. Siehe [„Erste Einrichtung und Einstellungen](https://phishdestroy.io/tgwitness/de/docs/reference/settings/)“. - **Konten**: Jeder Arbeitsbereich mit seinem Status, seinen Quellen, Ereignissen und der Anhangswarteschlange. Filtern nach **„Erfordert Aufmerksamkeit“**, **„Wird gesammelt“**, **„Offline“ oder „Pausiert“** oder **„Nicht verbunden“**, eine Auswahl pausieren oder fortsetzen, Kontodateien in großen Mengen importieren und Gruppen verwalten. Siehe [Konten](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). - **Konto**: Anmeldung und Verbindungsroute dieses Kontos. Direkt, ein WireGuard- Profil, Ihr eigener Proxy, der öffentliche MTProto-Pool oder WARP; bereiten Sie eine Route vor und prüfen Sie sie, wenden Sie sie dann auf dieses Konto, eine Gruppe oder alle Konten an. Siehe [Verbindung und Proxys](https://phishdestroy.io/tgwitness/de/docs/reference/connection/) sowie [Proxys](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md). **Kontosicherheit → Sitzungen dieses Kontos** listet die Sitzungen von Telegram auf, beendet eine oder alle davon und bietet – für einen in diesem Arbeitsbereich erstellten Schlüssel – die Option**Dies zur einzigen Sitzung machen, sofern Telegram dies zulässt**; diese Aktion wird nach Ablauf der 24-Stunden-Frist von Telegram vorgeschriebenen 24 Stunden wiederholt und das einmalig festgelegte Zwei-Schritt-Passwort anzeigt. Siehe [Kontosicherheit](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#create-an-independent-authorization). Unter **Kontosicherheit → Witness Probe** wird ein zweiter Arbeitsbereich verwendet, um zu überprüfen, ob diese Sitzung Aktualisierungen in Echtzeit erhält; siehe [Witness Probe](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#witness-probe). Beim Anhalten und Fortsetzen mehrerer Befehle bleibt die bestätigte Auswahl innerhalb der Sitzung erhalten, in der sie geöffnet wurde. Die Steuerelemente bleiben deaktiviert, solange die Bestätigung oder Ausführung aussteht; ein Wechsel des Arbeitsbereichs oder das Sperren des Fensters bricht die verbleibenden Befehle ab. Nach der Ausführung aktualisiert das Fenster den Kontostatus. Eine fehlgeschlagene Anfrage wird als Fehlschlag gemeldet, da der Server den Befehl möglicherweise bereits ausgeführt hat. Befehle werden nicht automatisch wiederholt. ## Extras Optional: Ein Konto und Quellen reichen aus, um mit dem Sammeln zu beginnen. Nur die von Ihnen gewählte Option öffnet ihre Einstellungen, und es wird nichts automatisch verbunden. Die Karte **„Schutzstufe“** oben zeigt den [Schutzmodus](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#protection-modes) an. | Karte | Was es bietet | Anleitung | | --- | --- | --- | | Speicher & Speicherplatz | Backups, das Verschieben älterer Dateien in Ihre Cloud, eine Beweiskopie, die nicht gelöscht werden kann | [Speicher](https://phishdestroy.io/tgwitness/de/docs/reference/storage/) | | Ziel & Schutzstufe | Empfohlene Einstellungen für Ihr Ziel und zwei Skalen | [unten](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#goal-and-protection-level) | | Benachrichtigungen | Probleme, geänderte Nachrichten und eine tägliche Zusammenfassung; dein eigener Kontrollbot | [unten](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#notifications) | | Beweismaterial & Backups | Zeitstempel, weitere Zeugen und eine verschlüsselte externe Kopie | [unten](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#evidence-and-backups) | | Server rund um die Uhr | Ein Cloud-Server ohne SSH, der über das Panel erstellt und gelöscht wird | [Hohe Sicherheit](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#from-the-panel) | | Unabhängiger Zeuge | Signierte Checks, die in Ihrem Telegram-Kanal oder auf Discord veröffentlicht werden | [Zeuge](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) | | Code-Prüfung | Vergleicht das laufende Programm mit einem öffentlichen GitHub-Commit | [unten](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#code-check) | ### Ziel und Schutzstufe Vier Fragen: 1. **Wozu dient es? Als** persönliches Protokoll, für Ermittlungen oder als Beweismaterial für einen Fall. 2. **Wie viel möchten Sie beobachten?** Einige Chats (bis zu etwa 50), viele Chats (bis zu etwa 500) oder ganze Konten. Dadurch wird die Obergrenze für die Chat-Liste auf 1.000, 3.000 oder 20.000 festgelegt. 3. **Fotos und Dateien?** Nur Text, Fotos und kurze Medien (Fotos 20 MB, Videos 100 MB) oder alles (Videos und Dokumente mit jeweils bis zu 1 GB). Bei der Option „Alles“ mit ganzen Konten bleiben zudem 4 GiB Speicherplatz frei. 4. **Wo läuft es? Auf** diesem Computer oder auf einem Server, der ständig in Betrieb ist. Der Vorschlag listet unabhängige Zeitstempel, „drand“ und die Geräteliste von Telegram auf, jeweils mit einer Zeile dazu, was hinzugefügt wird. Zeitstempel werden alle 60, 30 oder 10 Minuten für eine persönliche Aufzeichnung, eine Untersuchung oder Beweismittel gesetzt; „drand“ und die Geräteliste benötigen Zeitstempel. **Anwenden** ändert nur diese, die Anhangsrichtlinie und die beiden oben genannten Parameter. Jede Änderung ist ein Journaleintrag, dazu `setup.applied`. Benachrichtigungen, eine externe Kopie, ein Server, Gateway-DNS, die Codeüberprüfung und ein Zeuge werden als nächste Schritte mit eigenen Formularen angeboten. Zwei Skalen werden anhand der festgelegten Werte berechnet, nicht anhand des Ziels: | Umfang | Punkte | | --- | --- | | Glaubwürdigkeit | Signiertes Journal 1, Zeitstempel 3, drand 1, Geräteliste 1, Code-Prüfung, die übereinstimmt 1, Witness-Abfrage 1, beglaubigter Server 2, Gateway-DNS-Protokoll 1 | | Zuverlässigkeit | Ständig aktiver Server 3, externe Kopie 3, Object Lock 1, Problembenachrichtigungen 1 | **Maximal** 80 % Lesezugriffe, 50 % **hoch**, 25 % **mittel**, darunter **grundlegend**. Die Zuverlässigkeit berücksichtigt derzeit einen stets aktiven Server gemäß der Antwort auf Frage 4, bevor ein Server überprüft wird. ### Benachrichtigungen Benachrichtigungen werden über Apprise an Telegram, Discord, Slack, ntfy, E-Mail, Matrix und über 100 weitere Dienste gesendet. Wählen Sie einen Dienst aus, füllen Sie ein oder zwei Felder aus und senden Sie einen Test, oder fügen Sie Apprise-Adressen direkt ein. - **Probleme**: Festplatte fast voll, Konto abgemeldet, Fehler bei der Erfassung, beim Kopieren oder beim Zeitstempel, eine neue Sitzung, die mit dem Gerät, der Anwendung und den Telegram-Ländern des Kontos angemeldet ist, ein Anmeldecode oder eine neue Anmeldung, die Telegram während der Beobachtung meldet, sowie eine weitere Sitzung, nachdem **Mache dies zur einzigen Sitzung ausgewählt wurde**. Auf einem versiegelten Server stellen ein geöffneter SSH-Port oder eine Anmeldung ebenfalls ein Problem dar. - **Änderungen**: gelöschte, bearbeitete und fehlende Nachrichten in beobachteten Chats, zusammengefasst in einer Benachrichtigung pro Überprüfung (jede Minute, sofern in den Parametern nicht anders festgelegt). - **Abgeschlossene Aufgaben**: Verlauf, Exporte und Sicherungskopien. - **Treffer in der Beobachtungsliste**: Übereinstimmungen aus Beobachtungslisten, für die eine Benachrichtigung eingerichtet wurde. - **Tägliche Zusammenfassung** zur gewählten Uhrzeit (Serverzeit). Benachrichtigungen enthalten Chat-Namen und Anzahlangaben. Nachrichtenauszüge sind standardmäßig deaktiviert; wenn sie aktiviert sind, verlässt der Nachrichtentext diesen Rechner. **Dein Operator-Bot** ist ein eigener Bot von @BotFather, der `/status` und `/stats`und optional `/pause`, `/resume` und `/copy`. Nur die aufgeführten Chats und Telegram-Benutzer-IDs können ihn nutzen; der Gesprächstext verbleibt im Arbeitsbereich. Verwenden Sie einen separaten Bot, wenn eine andere Anwendung dessen Befehle bereits empfängt. Siehe [Benachrichtigungen](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md) und [Operator-Bot](https://phishdestroy.io/tgwitness/de/docs/reference/storage/#operator-bot-and-completion-notices). ### Beweismaterial und Backups - **Unabhängige Zeitstempel** senden nur den SHA-256-Hash jedes signierten Checkpoints an RFC-3161- Autoritäten und OpenTimestamps-Kalender, alle 5 bis 1,440 Minuten. Ein Empfänger benötigt diese Zeitangaben von Drittanbietern als Mindestvoraussetzung für den Nachweis. **Anchor führt derzeit** einen Durchlauf durch. Siehe [Zeitstempel](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/). - **Weitere Zeugen**, die jeweils deaktiviert sind, bis sie ausgewählt werden: die neueste „drand“-Runde, Telegrams Liste der angemeldeten Geräte ohne IP-Adressen und das Protokoll der Cloudflare Gateway-DNS-Abfragen des Servers . Siehe [optionale Aufzeichnungen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices). - **Die verschlüsselte Sicherung** kopiert das Journal, die Dateien, die Checkpoints und die Chat-Exporte in einen S3-kompatiblen Speicher (Wasabi, Amazon S3, Backblaze B2, Cloudflare R2, MinIO). Alles wird zunächst auf diesem Rechner verschlüsselt. **Laden Sie den Verschlüsselungsschlüssel herunter** und bewahren Sie ihn getrennt auf: Ohne ihn kann die Kopie nicht gelesen werden. „Object Lock“ im Governance- oder Compliance-Modus verhindert das Löschen von Objekten für eine festgelegte Anzahl von Tagen. Siehe [externe Kopie](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md). ### Code-Prüfung Prüft, ob das installierte Programm mit einer veröffentlichten Version übereinstimmt. 1. Geben Sie ein GitHub-Repository (das offizielle ist bereits eingetragen) sowie ein Tag, einen Branch oder einen Commit ein. 2. **Jetzt prüfen** fragt über die Route dieses Arbeitsbereichs für externe Anfragen die GitHub-API ab, um die Dateiliste dieses Commits abzurufen. Es vergleicht die Git-Blob-ID jeder gemessenen Programmdatei mit dem Commit. Ein Windows-Checkout mit konvertierten Zeilenenden passt weiterhin. 3. Das Ergebnis listet geänderte, zusätzliche und fehlende Dateien auf (jeweils bis zu 50) und wird als ein `source.checked` Protokoll. Das Ergebnis gilt nur so lange als aktuell, wie die ausgeführten Programmdateien unverändert bleiben: Überprüfen Sie dies nach einem Update erneut. Es wird kein Token benötigt und es funktionieren nur öffentliche Repositorys; Chats und Anmeldedaten werden nicht hochgeladen. Eine Übereinstimmung identifiziert den Code auf der Festplatte. Es handelt sich nicht um eine Hardware-Attestierung; dazu siehe [Phala Cloud](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx). ## Schutzmodi Der Umschalter neben der Versionsnummer zeigt den gewählten Modus an und wie viele der 18 Schutzebenen aktiv sind, zum Beispiel `🟠 Witnessed 9/18`. **Das Ändern des Modus** unter **„Extras“ → „Schutzstufe“** öffnet die Auswahl. Ein Modus beschreibt ein Ziel und listet auf, was noch fehlt; Aufzeichnung, Signierung und gespeicherte Einstellungen sind in jedem Modus identisch. | Modus | Für | Fügt hinzu | | --- | --- | --- | | 🟢 Einfach | Einen Chat beobachten und eine Kopie aufbewahren | Chats, das Journal und Chat-Exporte; die Signierung läuft im Hintergrund | | 🟡 Signiert | Meldungen an eine Plattform, einen Host oder eine Missbrauchsstelle | Signiertes Archiv, Journalprüfung, Checkpoints, Übergabeauszug | | 🟠 Beglaubigt | Fälle, in denen jemand behaupten könnte, der Datensatz sei verändert worden | Ein unabhängiger Zeuge, der signierte Journal-Köpfe veröffentlicht | | 🔴 Gerichtsfähig | Beweismaterial für einen Anwalt, die Polizei oder ein Gericht | Zeitstempel, eine verschlüsselte externe Kopie, Falldetails in Berichten | | 🟣 Von GitHub verifiziert | Aufzeichnungen, deren Software jeder überprüfen können muss | Code-Prüfung und Erfassung von GitHub Actions | | ⚫ Maximal | Fälle mit hohem Einsatz gegen einen finanzstarken Gegner | Ein abgeschotteter 24/7-Server, eine versteckte IP-Adresse, alle 18 Ebenen | Die Ebenen: jeder Datensatz wird signiert und verkettet; eine signierte Ausführungsbestätigung; Anhänge, die mit SHA-256 gespeichert werden; signierte Checkpoints; Nachprüfungen; Problemwarnungen; schreibgeschützter Witness-Zugriff; ein Witness, der planmäßig überprüft; RFC-3161-Zeitstempel; OpenTimestamps-Nachweise; ein verifizierter aktueller Zeitstempel; eine verschlüsselte externe Kopie; Fall-Details in Berichten; eine Code-Übereinstimmungsprüfung ; Telegram sieht die IP-Adresse dieses Geräts niemals; externe Anfragen über einen Proxy; Object Lock auf der Kopie; ein versiegelter Server mit Anbieterdaten. Eine deaktivierte Ebene verfügt über **„Einrichten“**, wodurch das entsprechende Formular geöffnet wird. Die Auswahl eines niedrigeren Modus erfordert eine Bestätigung und löscht nichts. ## Weitere Tools **Extras → Unabhängige Erfassung**: Schließen Sie einen separaten Browser oder einen AyuGram-Recorder an, hinterlegen Sie dessen Signaturschlüssel, wählen Sie die Erfassungsoptionen aus, starten/pausieren Sie die Erfassung, erstellen Sie Momentaufnahmen und laden Sie verifizierte, signierte Archive herunter. Jeder Recorder verfügt über eine eigene manuelle Anmeldung, Route, ein eigenes Protokoll und einen eigenen Schlüssel. Beide Verbindungen sind zunächst deaktiviert. Siehe die englische [Anleitung zur unabhängigen Erfassung](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md). - **Das Archiv abfragen**: Gespeicherte Beobachtungen durchsuchen, die Quellen prüfen und dann entscheiden, ob sie an ein KI-Modell gesendet werden sollen. Siehe [Archivanalyse](https://phishdestroy.io/tgwitness/de/docs/reference/analysis/) sowie [lokale OCR und Transkription](https://phishdestroy.io/tgwitness/de/docs/reference/media-analysis/). - **Parameter**: Begrenzungen und Tempo der Datenerfassung, erneute Überprüfungen, Downloads, Profile, Benachrichtigungen und Exporte. Suche nach Namen, Anzeige von **„Nur geänderte** Werte“ und Vorbereitung der Standardeinstellungen als Entwurf mit **„Standardeinstellungen wiederherstellen…“.** Mit**„Parameter speichern“** werden die Werte ab der nächsten Verwendung übernommen, und jede Änderung wird in einem Protokoll vermerkt. - **Zugriff**: separate Tokens für Prüfer, Analysten und Betreiber, beschränkt auf ausgewählte Arbeitsbereiche, Chats und Berechtigungen. Siehe [„Zugriff](https://phishdestroy.io/tgwitness/de/docs/reference/access/)“. - **Systemprotokoll** : Was dieser Prozess seit seinem Start getan hat (Verbindungen, Proxy-Änderungen, Anmeldungen, Ablehnungen, Einstellungsänderungen), wobei die IP-Adressen verborgen bleiben. **„Follow new lines“** sorgt dafür, dass die neueste Zeile im Blickfeld bleibt. Nachrichten verbleiben ausschließlich im Journal. - **Integrationen**: der KI-Anbieter, [schreibgeschützte MCP-Verbindungen](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/) und [signierte Webhooks](https://phishdestroy.io/tgwitness/de/docs/reference/webhooks/). - **Case Board**: private Teamnotizen, Lesezeichen und Ausschnitte neben den Beweismitteln. Siehe [Case Board](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/). - **Dokumentation**: die Schublade [Untersuchungsmodus](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md). Während eine dokumentierte Sitzung aufgezeichnet wird, wird sie in die Hauptseitenleiste verschoben. - **GitHub Actions-Erfassung** unter „Exports“: ein aus Ihrem Fork erfasster Chat. Siehe [„Sealed Capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)“. --- # Telegram · So funktioniert die Datenerfassung Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/collection/ Beobachtungsumfang, Live-Aktualisierungen, Nachprüfungen, Anhänge, eigene Aktionen und die Bedeutung von Lücken – Eintrag für Eintrag. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Translation coverage: this edition includes material from the English original. Beobachtungsumfang, Live-Aktualisierungen, Nachprüfungen, Anhänge, eigene Aktionen und die Bedeutung von Lücken – Eintrag für Eintrag. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Sammlung](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Sammlung](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) TgWitness zeichnet auf, was ein verbundenes Telegram-Konto beobachtet. Die Live-Überwachung speichert Nachrichten, erfasste Bearbeitungen, Löschbenachrichtigungen und Anhänge mit ihren Beobachtungszeitpunkten und ihrem Quellkontext. Historische Lesevorgänge, Nachprüfungen und verfügbare Admin-Log-Einträge fügen diesem Datensatz separat identifizierte Beobachtungen hinzu. **Auf dieser Seite** - [Von der Anmeldung bis zum Journal](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#from-login-to-a-journal) - [Beobachtungsumfang: ausgewählte Chats, ein Ordner oder das gesamte Konto](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account) - [Umfang und Ereignisauswahl](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#scope-and-event-selection) - [Eigene Aktionen](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#own-actions) - [Ermittlungsmodus: Teams beitreten und mit Bots kommunizieren](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots) - [-Überprüfungsstufen](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#recheck-tiers) - [Nachrichtenverlauf und Zuordnung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#message-history-and-attribution) - [Historische Momentaufnahmen](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#history-snapshots) - [Verarbeitung von Anhängen](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#attachment-handling) - [Anhalten, sperren, Verbindung trennen und neu starten](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#pause-lock-disconnect-and-restart) - [Kontenisolierung und -überprüfung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#account-isolation-and-verification) ## Von der Anmeldung bis zum Protokoll Informationen zu selbstzerstörenden Fotos und Dateien finden Sie unter „[Selbstzerstörende Medien](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md)“. Dort werden der Prioritäts-Worker, gespeicherte und nicht verfügbare Ergebnisse sowie die Grenzen der Blockierung von Lesebestätigungen im API-Collector erläutert. Ablaufdiagramm · Ein Benutzerkonto autorisieren → Wählen Sie zugängliche Gruppen und Kanäle aus; Wählen Sie zugängliche Gruppen und Kanäle aus → Einstellungen für Ereignisse und Anhänge speichern; Einstellungen für Ereignisse und Anhänge speichern → Beobachtung starten; Beobachtung starten → Erhalten Sie Updates vom aktiven Client; Erhalten Sie Updates vom aktiven Client → Richtlinien zu Quellen und Ereignissen anwenden; Richtlinien zu Quellen und Ereignissen anwenden → Eine signierte Beobachtung anhängen; Eine signierte Beobachtung anhängen → Das Protokoll einsehen oder exportieren; Eine signierte Beobachtung anhängen → Alle in der Warteschlange befindlichen Anhänge verarbeiten; Alle in der Warteschlange befindlichen Anhänge verarbeiten → Fügen Sie das Ergebnis des Downloads hinzu · Ein Benutzerkontoautorisieren · Wählen Sie zugänglicheGruppen und Kanäle aus · Einstellungen fürEreignisse und Anhängespeichern · Beobachtung starten · Erhalten Sie Updatesvom aktiven Client · Richtlinien zu Quellenund Ereignissenanwenden · Eine signierteBeobachtung anhängen · Das Protokoll einsehenoder exportieren · Alle in derWarteschlangebefindlichen Anhängeverarbeiten · Fügen Sie das Ergebnisdes Downloads hinzu **Diagramm als Text** 1. Ein Benutzerkonto autorisieren → Wählen Sie zugängliche Gruppen und Kanäle aus 2. Wählen Sie zugängliche Gruppen und Kanäle aus → Einstellungen für Ereignisse und Anhänge speichern 3. Einstellungen für Ereignisse und Anhänge speichern → Beobachtung starten 4. Beobachtung starten → Erhalten Sie Updates vom aktiven Client 5. Erhalten Sie Updates vom aktiven Client → Richtlinien zu Quellen und Ereignissen anwenden 6. Richtlinien zu Quellen und Ereignissen anwenden → Eine signierte Beobachtung anhängen 7. Eine signierte Beobachtung anhängen → Das Protokoll einsehen oder exportieren 8. Eine signierte Beobachtung anhängen → Alle in der Warteschlange befindlichen Anhänge verarbeiten 9. Alle in der Warteschlange befindlichen Anhänge verarbeiten → Fügen Sie das Ergebnis des Downloads hinzu Autorisierung, Zugriff auf eine Quelle, einen laufenden Collector und die vollständige Übermittlung sind unterschiedliche Aspekte. Eine erfolgreiche Anmeldung gewährt nicht den Zugriff auf jede Gruppe. Die Übermittlung wird separat nachverfolgt: Abdeckungsaufzeichnungen, die Wiederherstellung von Aktualisierungslücken und Nachprüfungen zeigen, was angekommen ist. ## Beobachtungsumfang: ausgewählte Chats, ein Ordner oder das gesamte Konto **Weitere Tools → Quellen → Der Geltungsbereich** legt fest, welche Chats ein Arbeitsbereich aufzeichnet. Die neue Einrichtung beginnt mit **Chats auswählen**. Bereits gespeicherte Einstellungen bleiben erhalten. Wenn Sie im Einrichtungsassistenten **Alle Chats** auswählen, werden Sie um Bestätigung gebeten, sobald die geladene Liste mehr als 50 Chats enthält; die Schätzung der Dateigröße erfolgt weiterhin separat auf der Grundlage einer Stichprobe. | Modus | Aufzeichnungen | Neue Chats | | --- | --- | --- | | Ausgewählte Chats (Standard) | Nur die Chats, die Sie manuell hinzufügen | Wird niemals automatisch hinzugefügt | | Telegram-Ordner | Chats in einem der Ordner des Kontos: Chats, die namentlich aufgeführt sind, zuzüglich der Kategorien des Ordners (Kontakte, Nicht-Kontakte, Gruppen, Kanäle, Bots), abzüglich der ausgeschlossenen Chats und, sofern im Ordner angegeben, der archivierten Chats | Entsprechende Chats werden hinzugefügt, sobald sie aktiv werden; Chats, die Sie in Telegram zum Ordner hinzufügen, werden innerhalb einer Stunde erfasst. | | Gesamter Bericht | Jeder Chat, den das Konto sieht | Jeder neue Chat, jede neue Gruppe, jeder neue private Chat und jeder neue Bot wird in dem Moment hinzugefügt, in dem die erste Aktualisierung eintrifft. | - **Quellentypen** (Kanäle, Gruppen, private Chats, Bots) schränken den Ordner- und den „Gesamtes Konto“-Modus ein. Ausgewählte Chats können beliebigen Typs sein, einschließlich privater Chats und Bots; Quellentypen verhindern niemals, dass ein Chat, den Sie manuell hinzugefügt haben, berücksichtigt wird. Ein deaktivierter Typ, ein Ausschluss oder eine Umstellung auf ausgewählte Chats stoppt automatisch hinzugefügte Quellen, sobald die Änderung gespeichert wird – noch bevor die Quellenliste neu berechnet wird und auch dann, wenn Telegram nicht erreichbar ist: ihre neuen Nachrichten, der Verlauf, der Verlauf neuer Chats, Peer-Einstellungen und Profilbeobachtungen. - **Chats, die Sie manuell hinzufügen,** bleiben im Ordner- und im Konto-Modus gespeichert, auch wenn sie sich außerhalb des Ordners befinden; nur *die Funktionen Ausschließen*, *Entfernen* oder eine Pause unterbrechen diese Speicherung. Chats, die *automatisch* hinzugefügt wurden, folgen dem Ordner: Ein Chat, der den Ordner verlässt, wird bei der nächsten Neuberechnung pausiert. - **Ausgeschlossene Chats** werden in keinem Modus aufgezeichnet. Im Ordner- und im Gesamtkonto-Modus wird ein Chat durch *Ausschließen* oder *Entfernen* in einer Quelle in diese Liste aufgenommen, sodass er vom Scope nicht erneut hinzugefügt wird. Wird der Chat erneut manuell ausgewählt (unter „Quellen“, bei „Chats“ oder unter „Einstellungen“ → **Welche Chats?**), wird er aus der Liste entfernt. Die Liste fasst bis zu 5.000 Chats; wird diese Grenze überschritten, wird *die Funktion Entfernen* abgelehnt und der Chat kann stattdessen pausiert werden. - **Eigene Aktionen** (standardmäßig aktiviert): Nachrichten, die dieses Konto versendet, dessen Bearbeitungen sowie die Tastenanschläge auf der Antworttastatur. Bei Deaktivierung werden ausgehende Nachrichten und Bearbeitungen übersprungen. - Beim Wechsel zu einem Ordner oder zum gesamten Konto wird eine Bestätigung abgefragt: Diese Modi zeichnen private Chats und Nachrichten von Dritten auf und gehören ausschließlich in ein dafür vorgesehenes Konto. Die Bestätigung und jede Änderung des Erfassungsbereichs werden in `scope.changed`-Datensätzen protokolliert. Bei einem Konto, das als Hauptkonto eingerichtet ist, lehnen das Erfassungsbereichsformular und die Untersuchung die Auswahl eines Ordners oder des gesamten Kontos ab, ebenso wie die Funktion „Start“; diese können nur für eine einmalige Kopie ohne Aufzeichnung verwendet werden. - Vom Scope hinzugefügte Chats erscheinen als Quellen mit der Kennzeichnung *auto* und werden als `scope.applied` (zu Beginn und stündlich) oder `source.discovered` (ein neuer Chat während der Beobachtung) aufgezeichnet. Beim Zurückwechseln zu ausgewählten Chats werden alle automatisch hinzugefügten Quellen gleichzeitig angehalten, ohne dass die Chat-Liste des Kontos erneut gelesen wird. Ein ausgeschlossener Chat wird nicht mehr aufgezeichnet, sobald der Umfang gespeichert wird, und seine Quelle wird angehalten, auch wenn Telegram die Chat-Liste nicht zurückgibt. Während der Beobachtung wird der Umfang durch das Speichern erneut angewendet, auch wenn sich die Werte nicht geändert haben. Geltungsbereich dieser Modi: - **Geheime Chats** nutzen die integrierte [Pseudo-Secret-Funktion](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/), wobei ein Protokollmodul über das Bedienfeld installiert und ein Aktivierungsschalter pro Konto verwendet wird. Der Cloud-Verlauf und „Takeout“ nutzen einen separaten Erfassungspfad. - **Offline-Zeiträume.** Nach einem Neustart setzt TgWitness die gespeicherte Aktualisierungsposition fort, fragt bei Telegram nach verpassten Aktualisierungen und überprüft die Chats erneut. Telegram verwaltet einen begrenzten Rückstand, sodass nach einem längeren Ausfall Berichte und `verify.py` das verbleibende Intervall als Lücke ausweisen (siehe [Abdeckung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)). - Zu Beginn werden nur die ersten 1,000 Dialoge aufgelistet (die Begrenzung ist unter **Weitere Tools → Parameter** zu finden); ältere Chats werden hinzugefügt, sobald sie wieder aktiv werden. Der frühere Verlauf eines hinzugefügten Chats wird nicht abgerufen – erstellen Sie bei Bedarf einen Verlaufs-Snapshot oder einen vollständigen Chat-Export. - Sich ständig ändernde Ordnerstatus (stummgeschaltet, gelesen) werden nicht berücksichtigt: Solche Chats bleiben weiterhin im Beobachtungsbereich. - **Inline-Bot-Schaltflächen (Callback), die** in einer anderen App betätigt werden, sind für eine zweite Sitzung nicht sichtbar; die Antwort oder Bearbeitung des Bots wird aufgezeichnet. Tastatureingaben zur Beantwortung werden als ausgehende Nachrichten gesendet und mit „`button_press`“ gekennzeichnet. - Mehr Chats bedeuten mehr Anfragen. Telegram schränkt Konten bei einem als übermäßig erachteten Volumen ein, was ein weiterer Grund für die Verwendung dedizierter Konten ist. ### Sorgfältig ausgewählte Chats **Streng: Nur die ausgewählten Chats** werden unter **Ausgewählte Chats** angezeigt; diese Option ist standardmäßig deaktiviert. Sie ist für eine Berechtigung vorgesehen, die sich ausschließlich auf die ausgewählten Chats bezieht. Wenn sie aktiviert ist: - Die Service-Benachrichtigungen von Telegram (777000) werden nicht gelesen: weder zu Beginn noch am Ende der Beobachtung und auch nicht jede Minute während der Beobachtung. Es werden keine `session.security_baseline`- oder `account.security_event`-Datensätze geschrieben. - Die Sitzungsliste des Kontos wird nicht gelesen: weder zu Beginn noch am Ende der Beobachtung (die Frage des Panels zu anderen Sitzungen für **„Beweismittel für einen Fall“** und die Beweismittelschutzmodi wird ebenfalls übersprungen), noch alle zwei Minuten während der Beobachtung, noch beim Aufbau einer Verbindung und auch nicht bei der Verbindungsprüfung, deren *Eintrag „Current Autorisierungs-Eintrag* als „übersprungen“ angezeigt wird. Der von der Übernahmeprüfung verwendete Status der zweistufigen Authentifizierung wird ebenfalls nicht ausgelesen. Daher werden `account.sessions`, `session.concurrent_at_start` und `session.takeover_risk` nicht geschrieben, und eine von einem anderen Gerät beendete Sitzung wird nicht als `session_revoked_externally` gemeldet. - While this is the only session of the account (**Make this the only session** or its automatic version), the session list is still read every two minutes while observing and when a connection opens, so that `session.exclusive_ended` is recorded when another session appears. 777000 stays unread in that period, although the `session.exclusive_from` record says Telegram's sign-in notices keep being recorded. - Deletion notices are compared with a session check only if one ran in the last 10 minutes (while this is the only session, or after opening **Sessions of this account**). Otherwise, unless the last rights check shows that this account could not delete the message (never so in private chats and ordinary groups), they read: *Who deleted it is not known: this account itself, from another session or device, could also have deleted it.* - Bei einem importierten Sitzungsschlüssel enthält das Protokoll keine Angaben zum Zeitpunkt der Anmeldung dieser Sitzung, bis die Sitzungsliste gelesen wird (beispielsweise unter **Sitzungen dieses Kontos**). Bis dahin verwenden Chat-Exporte und **automatische** Kontoexporte die reguläre Sitzung anstelle von „Takeout“ mit der Begründung `session_age_unknown`. - Turning a chat on does not read its earlier messages. Without the switch, each chat turned on (in Sources, in Chats, by joining from the panel or in the setup wizard) gets one `baseline` snapshot of its latest messages, up to **More tools → Parameters → Largest history snapshot** (500 by default), when observation next runs. A waiting snapshot that comes due while the switch is on is dropped. A chat joined from the panel does not get its latest messages read as a new chat either (the **When a new chat or bot appears** count, 100 by default), and opening a chosen chat with no saved messages in Chats does not load its last 100 messages by itself. **Load history** and snapshots you start yourself still read history. - Die Einstellung für sensible Inhalte des Kontos wird weder gelesen noch geändert. Ohne den Schalter wird sie bei der Anmeldung und bei jeder neuen Verbindung aktiviert, wenn sie deaktiviert ist, und Telegram lässt die Änderung zu (``account.content_settings``); die Einstellung gehört zum Konto und gilt in jeder Telegram-App. Inhalte, die Telegram als sensibel markiert, bleiben möglicherweise verborgen. - Aktualisierungen zu Telefonanrufen werden nicht unter `account.phone_call` erfasst. - Beim Beenden der Beobachtung wird lediglich der Fingerabdruck des Sitzungsschlüssels geschrieben; die Sitzungsliste oder 777000 werden nicht gelesen. Es schränkt nicht ein, was Telegram sendet: Aktualisierungen aller Chats gelangen weiterhin in diese Sitzung, und nur die ausgewählten Chats werden aufgezeichnet. Die Chat-Liste des Kontos (bis zu **den aus der Kontoliste gelesenen Chats**) und deren Ordner werden weiterhin beim Start gelesen sowie erneut, wenn der Umfang während der Beobachtung gespeichert wird, um die ausgewählten Chats zu finden. Löschbenachrichtigungen ohne zugehörigen Chat (`deletion.unscoped`) werden weiterhin aufgezeichnet: Sie enthalten lediglich Nachrichten-IDs und können zu einem ausgewählten privaten Chat oder einer gewöhnlichen Gruppe gehören. Die Überprüfung auf gesperrte Konten (`help.getAppConfig`), die anderen Verbindungsprüfungen sowie Funktionen, die Sie selbst aktivieren (automatisches Beenden anderer Sitzungen, die Witness-Probe, pseudo-geheime Chats, **„Sitzungen dieses Kontos**“ und Telegrams Liste der angemeldeten Geräte unter **„Mehr Zeugen**, die bei jedem Zeitstempel-Durchlauf die Sitzungsliste ausliest und die für die Ziele **„Chats verfolgen“** und **„Beweismittel für einen Fall“** Ticks setzt), funktionieren weiterhin. Aktivieren Sie diese Funktion, bevor Sie sich anmelden; andernfalls überprüft die Anmeldung selbst die aktuelle Berechtigung und schaltet sensible Inhalte frei. Jede Änderung wird als signierter `scope.changed`-Datensatz erfasst, und `observation.started` enthält den Wert als `scope.strict`. Durch den Wechsel zu einem Ordner oder zum gesamten Konto wird diese Funktion deaktiviert. ## Umfang und Auswahl der Ereignisse Jeder Arbeitsbereich verfügt über eigene Quellen. TgWitness tritt keinen Gruppen bei, nimmt keine Einladungen an und listet nicht automatisch jedes Mitglied auf. Die Quellen müssen bereits für das Konto zugänglich sein. Beim Start gleicht der Collector ausgewählte Quellen mit den sichtbaren Dialogen des Kontos ab; die ersten 1,000 Dialoge werden überprüft, sofern **unter Weitere Tools → Parameter → Aus der Liste des Kontos gelesene Chats** nichts anderes angegeben ist. Eine fehlende Quelle wird als **Zugriff unbestätigt** markiert; es wird nicht davon ausgegangen, dass Sie entfernt wurden. | Einleitung | Erfasst | Auswirkung bei Deaktivierung | | --- | --- | --- | | Neue Nachrichten | Normale zugestellte Nachrichten | Bei späteren Bearbeitungen oder Löschungen steht möglicherweise kein zuvor erfasster Text zum Vergleich zur Verfügung. | | Bearbeitungen | Bereitgestellte bearbeitete Versionen der Nachrichten | Zwischenzeitliche Änderungen werden später nicht rekonstruiert. | | Löschungen | Löschhinweise mit festgelegter Geltungsbereich und Hinweise auf Kontoebene ohne festgelegten Geltungsbereich | Löschmeldungen werden nicht in das Protokoll aufgenommen. | | Reaktionen | Bereitgestellte Momentaufnahmen der Reaktionen | Separate Aktualisierungen zu Reaktionen werden nicht hinzugefügt. | | Mitgliedschaft | Versendung von Mitteilungen zum Mitgliederservice und Aktualisierungen für Teilnehmer | Diese Beobachtungen von Mitgliedern werden nicht hinzugefügt. | Die Einstellungen gelten für alle ausgewählten Quellen im Arbeitsbereich. Speichern Sie das Formular, um die Änderungen zu übernehmen; Änderungen werden mit signierten Vorher-Nachher-Werten protokolliert. Das Deaktivieren einer Kategorie führt nicht zur Löschung früherer Datensätze. Das erneute Aktivieren führt nicht zur nachträglichen Ergänzung versäumter Aktualisierungen. Betriebliche Protokolle und andere Ereignisse des Gruppendienstes bleiben von diesen Einstellungen unberührt. Nachrichten des Mitgliederservices können Nachrichtenprotokolle erstellen, wenn die Mitgliedschaft aktiviert ist, selbst wenn die normale Erfassung neuer Nachrichten deaktiviert ist. Erfasste Telegram- Objekte behalten eingebettete Metadaten bei; eine Einstellung ist keine Schwärzungsregel. **Löschungen in privaten Chats und normalen Gruppen** gehen als Nachrichten-IDs ohne zugehörigen Chat ein. Diese Chats teilen sich eine kontoweite Nachrichten-ID-Sequenz; wenn also eine Nachricht mit dieser ID zuvor gespeichert wurde, ist ihr Chat bekannt: Die Löschung wird in diesem Chat aufgezeichnet, wobei ``chat_resolution`` erklärt, wie. Nie gespeicherte IDs bleiben eine **nicht zugeordnete Löschung** mit einem explizit ungelösten Chat. Dies sind Telegram-Löschbenachrichtigungen, die auch dann erhalten bleiben, wenn ihr Chat noch nicht zugeordnet werden kann. Das Schema der Benachrichtigung enthält IDs; das Journal fügt den Empfangszeitpunkt und den Kontext gespeicherter Nachrichten hinzu, einschließlich ``deleted_message_was_outgoing``. Verfügbare Einträge im Admin-Protokoll bieten eine separate Quelle für die Aktion, den Ausführenden und den Zeitpunkt der Quelle. ## Eigene Maßnahmen Vom beobachteten Konto gesendete Nachrichten werden mit „`outgoing`“ gekennzeichnet. Bei der Bearbeitung einer ausgehenden Nachricht wird darauf hingewiesen, dass in privaten Chats und Gruppen nur der Verfasser die Nachricht bearbeiten kann, während Beiträge in Kanälen auch von anderen Administratoren bearbeitet werden können. Wenn eine ausgehende Nachricht den Text einer Schaltfläche aus der zuletzt gespeicherten Antworttastatur in diesem Chat wiederholt, wird sie mit „`button_press`“ gekennzeichnet und enthält einen Link zu dem Datensatz der Tastatur. Der Ausschluss eigener Aktionen gilt auch für Hintergrundüberprüfungen und den automatischen Verlauf neuer Chats. Übersprungene ausgehende Nachrichten verschieben die Position der Überprüfung nach vorne, sodass sie spätere eingehende Nachrichten nicht blockieren können. Explizite Aktionen über das Bedienfeld und manuell angeforderte Verlaufs-Snapshots bleiben weiterhin aufgezeichnet. ## Ermittlungsmodus: Beitritt zu Teams und Kommunikation mit Bots **Weitere Tools → Quellen → Umfang → Der Untersuchungsmodus** bereitet den Umfang für ein dediziertes Konto vor, das Team-Chats beitritt, Bots startet und in diese schreibt: das gesamte Konto, jeden Quellentyp, eigene Aktionen sowie für jeden Chat oder Bot, der erscheint, dessen Profil und die letzten 200en sichtbaren Nachrichten. Überprüfen Sie das Formular und klicken Sie auf **Umfang speichern**; die Umschaltung auf das gesamte Konto erfordert die übliche Bestätigung. - **Schaltflächen.** Schaltflächen unter einer Nachricht bleiben mit dieser erhalten und werden in **Chats** angezeigt: Links, Web- Apps, Anmeldelinks, zu kopierende Texte, Rückrufdaten, Inline-Abfragen, Anfragen nach einer Telefonnummer oder einem Standort. Links werden als Text angezeigt und vom Panel niemals geöffnet. Wenn ein Bot nur die Schaltflächen ändert (z. B. einen neuen Zahlungslink), handelt es sich um eine neue Version der Nachricht, sowohl bei Live-Updates als auch bei erneuten Überprüfungen. - **Neue Chats und Bots.** Im Ordner- und im Gesamtkonto-Modus **werden neue Chats oder Bots** unmittelbar nach ihrem **Erscheinen** gespeichert: - sein Profil als `source.profile`-Datensatz: Bot-Beschreibung und Befehle, der „Über“-Text eines Nutzers, einer Gruppe oder eines Kanals, Mitglieder, verknüpfter Chat und Einladungslink, sofern Telegram einen zurückgibt; - seine zuletzt sichtbaren Nachrichten (bis zu 1.000) als Verlaufs-Snapshot mit der Kennzeichnung „`new_chat`“: die früheren Nachrichten eines gerade betretenen Team-Chats oder das, was ein Bot gesagt hat, bevor die Beobachtung den Chat registriert hat. Bereits live gespeicherte Nachrichten werden nicht erneut aufgezeichnet. Neu ausgewählte Chats verwenden diese Einstellungen, sobald der Geltungsbereich angewendet wird, einschließlich Chats, die bereits in der Dialogliste des Kontos vorhanden sind. Das anfängliche Laden von Profil und Verlauf erfolgt für bis zu drei Chats gleichzeitig; die Vorgänge für denselben Chat bleiben in der richtigen Reihenfolge. Jede Verlaufs-/Profilphase verwendet das konfigurierte Zeitlimit für den Vorgang, sodass ins Stocken geratene Anfragen ihren Worker freigeben. Der Verlauf wird vor dem optionalen Einlesen des Profils gespeichert; ein Fehler beim Einlesen des Profils verhindert diese Verlaufserfassung nicht. Fehlgeschlagene Phasen werden nach 5 Sekunden erneut versucht, wobei sich die Wartezeit auf maximal 5 Minuten verdoppelt, ohne dass während dieser Zeit ein Worker belegt ist. Ausstehende IDs, Wiederholungsfristen und abgeschlossene Phasen werden lokal gespeichert. Bei einem Neustart werden nur unvollendete Phasen fortgesetzt; bei einem erneuten Profilversuch wird ein bereits abgeschlossener Verlaufslesevorgang nicht wiederholt. Quellen, die vor ihrem Zug deaktiviert wurden, werden übersprungen. Die Übersicht zeigt aktive, ausstehende und erneut versuchte Chat-Ladevorgänge getrennt von Anhang-Downloads an. Ein „FloodWait“ unterbricht diese Arbeit vorübergehend, die anschließend fortgesetzt wird; Fehler werden protokolliert und die Live- Aufzeichnung des Chats wird fortgesetzt. Dies umfasst Wartezeiten während der Ermittlung der Identität des neuen Chats: Die ausstehende Profil-/Verlaufsaufgabe wird für einen erneuten Versuch beibehalten, und eine bereits bestehende, längere, kontoweite Wartezeit wird nicht verkürzt. Die Worker teilen sich diese Wartezeit; die Parallelität umgeht die Anforderungslimits von Telegram nicht. - **Profile auf Anfrage.** **Chats → Profil → Profil jetzt speichern** Speichert das aktuelle Profil einer beliebigen Quelle; das aktuellste wird oberhalb der Nachrichten angezeigt. - **Momentaufnahmen des Chat-Status (Vorschau).** Änderungen außerhalb des Nachrichtenstroms ohne Nachricht: Das Entpinnen jeder Nachricht hinterlässt keine Spur auf Nachrichtenebene; ein Administrator verliert seine Rechte; ein Geschenk wird ausgeblendet, umgewandelt, aufgewertet oder erstattet. Während der Überwachung wird jede aktivierte Quelle regelmäßig ausgelesen und als signierte `chat.state` Datensatz: Titel, Benutzernamen, Beschreibung, Anzahl der Mitglieder und Administratoren, verknüpfter Chat, Slow-Modus, IDs der angehefteten Nachrichten (bis zu 100), Administratoren mit ihren Rechten und Titeln sowie Geschenke, die in Kanälen und Benutzerprofilen angezeigt werden (bis zu 100). Jeder Datensatz listet die Unterschiede zum vorherigen Snapshot auf: geänderte Felder mit Vorher- und Nachher-Angaben, hinzugefügte oder entfernte angeheftete Nachrichten, Administratoren und Geschenke, die hinzugefügt, geändert oder nicht mehr aufgeführt sind. – Ein Teil, den Telegram zurückweist (zum Beispiel die Administratorliste eines Kanals für ein Mitglied, das kein Administrator ist), wird in `errors`; sein vorheriger Wert wird beibehalten und in `carried_forward`, wurde nie als entfernt gemeldet. - Ein Datensatz, bei dem sich lediglich die Zählwerte geändert haben, sowie eine Überprüfung, bei der keine Änderung festgestellt wurde, beziehen sich auf den letzten vollständigen Zustand mit `state_seq` und kumulativ `state_overrides`. Ein vollständiger Status wird mindestens alle sieben Tage und immer dann geschrieben, wenn sich etwas anderes als eine Zählung ändert. - `parts_complete` Kennzeichnet begrenzte Listen. Für Hinzufügungen ist eine vollständige frühere Liste erforderlich, für Entfernungen eine vollständige aktuelle Liste, und explizite leere Werte kennzeichnen das Löschen. - **Weitere Tools → Parameter → Chat-Status** Legt das Intervall fest (standardmäßig 12 Stunden, 0 deaktiviert Snapshots ), die Pause zwischen den Quellen, welche Teile gelesen werden und ob Überprüfungen, bei denen keine Änderungen festgestellt wurden, protokolliert werden. `FLOOD_WAIT` und `FLOOD_PREMIUM_WAIT` Die verbleibenden Snapshot-Anfragen stoppen, etwaige noch geltende kontoweite Fristen beibehalten und den unterbrochenen Chat nach dieser Wartezeit für einen weiteren Versuch freigeben. - **Nicht sichtbar.** Inline-Schaltflächen (Callback-Schaltflächen), die in einer anderen Telegram-App gedrückt werden, das Popup oder der Link, mit dem ein Bot auf einen solchen Klick reagiert, sowie Einladungslinks, die in einer anderen App verwendet werden, werden nicht an TgWitness übermittelt. Was der Bot anschließend sendet oder bearbeitet, wird jedoch aufgezeichnet. ### Maßnahme aus der Podiumsdiskussion **„Chats“** enthält nun einen Mini-Client, der das Telegram-Konto des ausgewählten Arbeitsbereichs nutzt: - Verfassen Sie eine Klartextnachricht oder wählen Sie **„Antworten“** unter einer gespeicherten Nachricht. Die zurückgesendete ausgehende Nachricht wird auch dann aufgezeichnet, wenn der Erfassungsbereich ausgehende Aktualisierungen ausschließt. - Drücken Sie **die Schaltfläche „Press“** unter einem aktuellen Callback oder einer Text-Schaltfläche. Der Server ruft die Nachricht erneut ab und lehnt die Aktion ab, wenn die Eingabe von der gespeicherten Version abweicht. Callback-Bestätigungen behalten den Popup-Text, die Warnmarkierung und die URL von Telegram bei; die Antwort wird zudem unterhalb der Unterhaltung angezeigt. URLs bleiben als auswählbarer Text erhalten und werden nicht automatisch geöffnet. - Drücken Sie **+** → **Telegram-Link öffnen**, geben Sie `@username`, einen öffentlichen `https://t.me/name`-Link, `https://t.me/+invite` / `joinchat/invite` oder einen Bot-Link mit `?start=parameter` ein und klicken Sie auf **Vorschau speichern**. Der ursprüngliche Link und die Telegram-Vorschau werden vor dem Beitritt signiert. **Beitreten / Öffnen und Beobachten** führt dann zum Beitritt zur Gruppe/zum Kanal oder zum Öffnen des Nutzers/Bots, fügt den Chat als aktivierte Quelle hinzu und sendet `/start` an einen Bot, einschließlich dessen Startparameters. Eine Beitrittsanfrage, die auf die Genehmigung durch den Administrator wartet, wird als „ausstehend“ und nicht als Mitgliedschaft erfasst. Aktivieren Sie **Beobachtung starten**, um eingehende Antworten live zu erfassen. Panel-Aktionen funktionieren, während die Beobachtung pausiert ist; das Panel speichert dann seine direkten Antworten, und die Live- Beobachtung erfasst den Rest der Konversation. Neu hinzugefügte Quellen verwenden die konfigurierte Profil-/Verlaufsübernahme, wenn die Beobachtung läuft. Wenn eine Quelle pausiert ist, aktivieren Sie sie unter **Weitere Tools → Quellen,** bevor Sie etwas senden oder deren Schaltflächen betätigen. `interaction.preview`, `interaction.requested` und `interaction.result` sind gewöhnliche signierte Protokollereignisse, die in den Beweismittelexporten enthalten sind. Anfragen identifizieren das Konto, die Nachricht/Schaltfläche oder den Vorschau-Datensatz sowie, ob die Überwachung aktiv war. Empfangsbestätigungen unterscheiden zwischen Erfolg, Ablehnung, ausstehender Genehmigung und einem unbekannten Ergebnis. Eine unterbrochene Anfrage könnte Telegram erreicht haben: Überprüfen Sie den Chat, bevor Sie eine neue Aktion starten. Durch die Wiederverwendung einer Anfrage-ID wird die gespeicherte Bestätigung abgerufen, ohne die Aktion zu wiederholen – auch nach einem Neustart. Das Fenster behält die ID bei, wenn während der aktuellen Seitensitzung eine mehrdeutige Antwort für dieselbe Aktion erfolgt. Es behält diese ID auch bei, wenn die Aktualisierung der Ansicht nach einer erfolgreichen Aktion fehlschlägt: Die Bestätigung bleibt sichtbar, und durch erneutes Klicken wird sie abgerufen. RPCs für Rückrufe und Beitritte verfügen über einen einzigen Versuchsversuch; wiederholbare Lesevorgänge behalten ihre konfigurierte Wiederholungsrichtlinie bei. Ein sofortiger Wechsel des Chats löscht den Entwurf und das Antwortziel und deaktiviert das Senden, bis die neue Konversation geladen ist. This mini-client handles text and callback buttons. Mini application buttons get **Open mini app**, which records the application in an isolated browser ([Mini applications](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Login, phone and location requests, payments, inline queries and attachments still require a Telegram client; their saved button metadata remains visible. The new controls use English text. ## Stufen erneut überprüfen Bei der erneuten Überprüfung fragt Telegram erneut nach verpassten Nachrichten, Bearbeitungen und Nachrichten, die nicht mehr zurückgegeben werden. Mit einem Stern markierte Quellen sind **Priorität** Quellen, die alle 15 Minuten (Standard); alle anderen Quellen alle 6 Stunden. Ausgewählte Chats werden als prioritäre Quellen behandelt, Chats, die über einen Ordner oder das gesamte Konto hinzugefügt wurden, als reguläre Quellen. Maximal 30 Quellen werden pro Durchlauf erneut überprüft und der Rest wartet auf die nächste Minute; nach einer erneuten Verbindung werden prioritäre Quellen zuerst behandelt. Beide Intervalle werden unter **Weitere Tools → Quellen → Aufzeichnung → Erneute Überprüfung** (0 deaktiviert eine Stufe) und werden als `recheck.changed`. Verpasste Nachrichten werden ab der Stelle abgerufen, an der der vorherige Durchlauf aufgehört hat, und zwar höchstens so viele, wie unter **Weitere Tools → Parameter → Pro Chat und Durchlauf wiederhergestellte verpasste Nachrichten** festgelegt ist (standardmäßig 1,000). Nach einer längeren Unterbrechung füllt die Nachprüfung daher die gesamte Lücke, selbst wenn Live-Nachrichten, die neuer sind als die Lücke, zuerst gespeichert wurden . Ein Chat, der noch dabei ist, den Rückstand aufzuholen, wird in der nächsten Minute erneut überprüft, anstatt auf sein Tier-Intervall zu warten; `recheck.completed` zeigt `continues_after` an, bis der Vorgang abgeschlossen ist. Vergleiche umfassen Nachrichtentexte, Entitäten, Tastatureingaben (einschließlich Löschvorgänge) sowie den Inhalt und die Identität von Anhängen. Das bloße Ändern von Datei-Zugriffshashes oder Dateiverweisen stellt keine Bearbeitung dar, ebenso wenig wie das, was Telegram von sich aus einträgt: das Laden einer Link-Vorschau, Aufrufe von Stories, durch dieses Konto freigeschaltete kostenpflichtige Medien sowie der Erhalt einer Rechnung. Jede gespeicherte Version in „Chats“ ist mit ihrem vollständigen Protokoll-Eintrag verknüpft, einschließlich der Medien-Metadaten. ## Nachrichtenverlauf und Zuordnung Angenommen, der Datensammler registriert „Besprechung um 10:00 Uhr“, sieht später „Besprechung um 11:00 Uhr“ und erhält anschließend eine Löschmeldung. Es werden drei unterschiedliche Einträge angefügt. Der ursprüngliche Text bleibt erhalten, die Bearbeitung wird als separate Version gespeichert, und die Meldung dokumentiert, dass eine Löschung festgestellt wurde. Sollte die Erfassung erst nach dem Verschwinden der ersten Version begonnen haben, ist dieser Text nicht mehr verfügbar. Sollten während der Offline-Phase mehrere Bearbeitungen stattgefunden haben, können nur die anschließend erfassten Versionen gespeichert werden. Eine Löschmeldung kann Inhalte, die nie erfasst wurden, nicht wiederherstellen. Der Datensatz vereint mehrere Quellen: | Quelle | Erhaltene Informationen | | --- | --- | | Live-Nachricht oder Bearbeitungsaktualisierung | Nachrichten-ID, Metadaten des Absenders, erfasste Version, Empfangszeit und angegebenes Datum der Telegram-Nachricht bzw. der Bearbeitung. | | Benachrichtigung bei Live-Löschung | Gemeldete Nachrichten-IDs, Empfangszeit, Rohbenachrichtigung und Links zu zuvor gespeicherten Inhalten. | | Verfügbares Administratorprotokoll | Aktion, Akteur, Quelldatum und übermittelter Nachrichteninhalt, gelesen von einem Konto mit den erforderlichen Rechten. | | Interaktion mit dem Bedienfeld | Die angeforderte Aktion und ihr aufgezeichnetes Ergebnis unter dem ausgewählten Konto. | | Erneut prüfen | Die aktuelle Antwort von Telegram im Vergleich zur zuvor gespeicherten Nachricht. | `observed_at` ist der Zeitpunkt, zu dem der Datensatz in der Sammleruhr geschrieben wurde, und erhöht sich mit `seq`. Datensätze, die während der Verarbeitung einer Live-Aktualisierung geschrieben werden, enthalten zudem `received_at`, den Zeitpunkt, zu dem die Aktualisierung den Collector erreichte, sowie `processing_delay_ms`, die Zeit vom Empfang bis zum Schreiben; Aktualisierungen, die während des Beginns einer Beobachtung zurückgehalten wurden, werden in der Reihenfolge ihres Eintreffens vor späteren verarbeitet. `source_at` behält ein Quelldatum bei, sofern dieses Ereignis eines liefert. Beobachtungen zum Telegramm-Uhr-Offset, Datensätze zu Uhrdiskontinuitäten und [externe Zeitprüfungen](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/) liefern den zugehörigen zeitlichen Kontext. Die Felder einer gewöhnlichen Nachrichtenbenachrichtigung beschreiben diese Benachrichtigung; Admin-Log- und Interaktionsdatensätze behalten ihre eigene Zuordnung bei. ## Momentaufnahmen der Historie Ein Snapshot fordert die neuesten sichtbaren Nachrichten von einer aktivierten Quelle an, bis zu 500 pro Anfrage. Die Ergebnisse werden als Verlaufsbeobachtungen gekennzeichnet. Manuelle Snapshots laufen parallel zur Beobachtung. Wiederholte Beobachtungen werden als separate Datensätze gespeichert. Beim Aktivieren einer Quelle wird außerdem ein `baseline`-Snapshot davon erstellt, es sei denn, [die Option Strict Chats](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#strict-chosen-chats) ist aktiviert. Snapshots werden unterbrochen, wenn die Quelle während des Lesevorgangs deaktiviert wird. Antworten müssen zum angeforderten Chat gehören und streng absteigende positive Nachrichten-IDs unterhalb der angeforderten Grenze enthalten. Eine ungültige Antwort unterbricht den Snapshot, bevor diese Nachricht gespeichert wird; bereits gespeicherte Nachrichten verbleiben im signierten Journal zusammen mit dem Unterbrechungsprotokoll. Die Momentaufnahmen entsprechen den Richtlinien für Anhänge, bleiben jedoch von den Schaltvorgängen bei Live-Ereignissen getrennt. Sie rekonstruieren keine gelöschten Nachrichten oder fehlenden Zwischenversionen. Sie können eine Momentaufnahme anfordern, während der Vorgang angehalten ist; alle darin enthaltenen Anhänge werden in die Warteschlange gestellt und warten, bis die Beobachtung beginnt und der Download-Prozess abläuft. Der Lauf **Verlauf** ist eine eigene exklusive Aufgabe: Er liest die ausgewählten Quellen und lädt deren vorgemerkte Anhänge nacheinander herunter, ohne die Überwachung zu starten. Pausieren gibt das Konto frei; Fortsetzen führt den gespeicherten Lauf weiter. Datums-, Sprach- und Antwortfilter über mehrere freie Konten beschreibt [Verteilter Chat-Export](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md). ## Umgang mit Anhängen Der Download von Anhängen ist standardmäßig aktiviert und wird angehalten, sobald weniger als 1 GiB freier Speicherplatz verfügbar ist. Der Collector führt die Beobachtung der Nachrichten und den Download-Auftrag gemeinsam aus. Der Auftrag behält den ursprünglichen Medien-Deskriptor und die Größenrichtlinie bei, sodass ein später bearbeiteter Anhang nicht unbemerkt ersetzt wird. Downloads werden nach der Nachrichtenerfassung ausgeführt. Ein abgeschlossener Download erstellt einen `media.saved` -Eintrag mit dessen SHA-256 -Wert und Byteanzahl. Übersprungene, fehlgeschlagene, erneut versuchte und unterbrochene Vorgänge haben unterschiedliche Ergebnisse; eine Datei gilt als gesichert, wenn ihr `media.saved` -Eintrag vorhanden ist. Die fertige Datei muss zudem mit der Byteanzahl im ursprünglichen Deskriptor des beobachteten Anhangs übereinstimmen. Eine zu kurze oder unerwartet lange Antwort wird nicht als gesichertes Medium erfasst. Die Datei und ihr Ordnereintrag werden auf die Festplatte geschrieben, bevor `media.saved` geschrieben wird. Wenn der vorherige Collector-Prozess ohne ordnungsgemäßen Abbruch beendet wurde, liest der nächste Start jeden Datensatz, der während dieses Durchlaufs als gespeichert vermerkt wurde. Eine Datei, die fehlt oder deren Bytes vom aufgezeichneten SHA-256 abweichen, erhält einen `media.missing_after_restart`-Eintrag, ihr Download wird erneut in die Warteschlange gestellt, und abweichende Bytes werden in den Ordner `media-damaged/` verschoben. Dateien, die in einen externen Speicher verschoben wurden, werden nicht gelesen. Innerhalb eines Arbeitsbereichs warten parallel in der Warteschlange stehende Aufträge für dieselbe Anhangsdarstellung auf die aktive Übertragung und überprüfen anschließend die gespeicherten Bytes erneut, bevor sie wiederverwendet werden. Jeder Auftrag verwaltet sein eigenes Ergebnis mit Vorzeichen sowie einen Verweis auf den zuvor gespeicherten Dateieintrag. Das Abbrechen eines wartenden Auftrags führt nicht zum Abbruch der aktiven Übertragung; sollte diese Übertragung fehlschlagen oder abgebrochen werden, kann der nächste Auftrag einen erneuten Versuch unternehmen. Verschiedene Anhänge können gleichzeitig heruntergeladen werden. Aufträge mit identischem Konto, identischer Darstellung, identischer erwarteter Größe und identischer Erfassungsaktion verbleiben in der Warteschlange, solange ein passender Auftrag ausgeführt wird. Sie belegen keine Download-Slots, sodass andere Dateien gestartet werden können, selbst wenn die Warteschlange zunächst viele Kopien einer langsamen Datei enthält. Der Abschluss eines Versuchs aktiviert die Warteschlange wieder. Prioritätsspuren, gespeicherte Wiederholungsverzögerungen und die Zuordnung zum Verlauf gelten weiterhin; jede Beobachtung erhält ihr eigenes Ergebnis. Auch beim Chat-Export erfolgt eine aktive Übertragung für wiederholte Dateidarstellungen innerhalb desselben Exportverzeichnisses. Jede Nachricht behält ihre Anhangsreferenz bei, und für die Wiederverwendung sind eine neue Größenangabe und eine SHA-256-Prüfung erforderlich. Verschiedene Dateien können parallel geprüft werden, ohne dass eine gemeinsame Übertragungssperre gehalten wird. Temporäre Download- und Kopierpfade sind für jeden Vorgang eindeutig; bei einer Abbruchaktion wird vor der Bereinigung auf alle aktiven lokalen Dateileser gewartet. Der Exportdatei-Index serialisiert nur den Zugriff auf Metadaten, nicht jedoch das Hashen von Dateien oder Downloads. Auch Server-Hash-Lesevorgänge für verschiedene Anhänge laufen parallel und teilen sich die drei Datei-Anforderungs-Slots des Clients mit Byte-Downloads. Bei wiederholten Lesevorgängen derselben Darstellung wird lediglich ein vollständiges zwischengespeichertes Ergebnis wiederverwendet. Dateilesevorgänge lassen die normale Anforderungswarteschlange frei; gespeicherte FloodWait-Fristen werden erneut überprüft, sobald eine Anforderung einen Slot erhält. Die Speichergrenzen werden **pro Dateityp** festgelegt: Fotos, Videos, GIFs und Animationen, Rund-Video-Nachrichten, Sprachnachrichten, Musik und Audiodateien, Sticker sowie Dateien. Jeder Typ kann deaktiviert werden und verfügt über ein eigenes Größenlimit von 1 bis 2.000 MiB; neue Arbeitsbereiche beginnen mit 20 MiB für Fotos, 100 MiB für Videos, 50 MiB für Dateien, Audio und Rundvideos, 20 MiB für Sprachnachrichten und GIFs sowie 5 MiB für Sticker. In neuen Arbeitsbereichen sind GIFs und Sticker deaktiviert, bis sie aktiviert werden. Arbeitsbereiche mit Richtlinien, die vor der Einführung der typbezogenen Begrenzungen gespeichert wurden, behalten alle Typen aktiviert und behalten ihre einheitliche Obergrenze für jeden Typ bei. *Die maximale Dateigröße* gilt für alle Typen gleichzeitig. Ein deaktivierter Typ erzeugt einen „`media.skipped`“-Datensatz; Dateien mit unbekannter Größe oder übergroße Dateien werden nicht heruntergeladen. Große Dateien erhalten zusätzliche Download-Zeit, basierend auf ihrer Größe und einer Basisgeschwindigkeit von 256 KiB/s. Aufträge bleiben nach einem Neustart erhalten, doch abgelaufene Verweise, verlorener Zugriff oder gelöschte Dateien können die Wiederherstellung dennoch verhindern. Wartende Aufträge behalten das für sie gespeicherte Limit bei, sodass eine Anhebung des Limits nur für neue Dateien gilt. Das Deaktivieren eines Typs oder das Herabsetzen seines Limits überspringt auch die davon ausgeschlossenen wartenden Dateien, für die jeweils ein „`media.skipped`“-Datensatz erstellt wird; das Deaktivieren von Downloads hält die Warteschlange an, bis sie wieder aktiviert werden. ## Anhalten, sperren, Verbindung trennen und neu starten | Handlung oder Zustand | Wirkung | | --- | --- | | Arbeitsbereich wechseln | Ändert die Ansicht des Panels; andere Collector-Instanzen behalten ihren Status bei. | | Das Fenster sperren oder einen Tab schließen | Der Server und die Überwachung bleiben dabei in Betrieb. | | Beobachtung unterbrechen | Hält diesen Collector an und bewahrt die in der Warteschlange befindlichen Anhänge auf. | | Eine Quelle deaktivieren | Verhindert künftige gezielte Erfassung; dafür in der Warteschlange befindliche Medienaufträge werden angehalten, solange die Funktion deaktiviert ist. | | Eine Quelle entfernen | Es ignoriert diese Quelle und löscht die zugehörigen Benutzerprofile; bereits gespeicherte Einträge verbleiben im Protokoll, das nur nachträglich ergänzt werden kann. Noch ausstehende Anhänge werden als fehlgeschlagen (`source_removed`) erfasst. Im Ordner- und im Gesamtkonto-Modus werden sie ebenfalls ausgeschlossen. | | Ändern Sie die Verbindungsroute | Erfordert eine Pause, schließt alte Clients und bricht unvollständige Anmeldungen ab. | | Beenden Sie den Python-Prozess | Alle Arbeitsbereiche werden angehalten; während der Offline-Zeit werden keine Beobachtungen vorgenommen. | | Neustart nach aktiver Beobachtung | Es wird versucht, den gespeicherten Umfang mithilfe der gespeicherten Sitzung fortzusetzen. Eine manuelle Unterbrechung hebt diese Absicht auf. | Der Collector protokolliert erkannte Verbindungsabbrüche, Wiederholungsversuche, Fehler, Starts/Stops und Heartbeats. Kurze Unterbrechungen können bei periodischen Verbindungstests übersehen werden. Nach einem Neustart werden versäumte Aktualisierungen ab der gespeicherten Aktualisierungsposition angefordert und beobachtete Chats werden periodisch erneut überprüft; siehe [Nachweisformat](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#durable-collection-and-process-receipts-02). Ein Snapshot fügt den aktuellen Zustand als Kontext hinzu, und die Lücke bleibt protokolliert. ## Kontoisolierung und -überprüfung Jeder Arbeitsbereich verfügt über ein eigenes Protokoll, eigene Berechtigungen, einen eigenen Signaturschlüssel, eigene Richtlinien und eine eigene Warteschlange. Nur der aktive Client dieses Arbeitsbereichs kann Live-Beobachtungen einbringen. Abgelehnte, ausstehende, ersetzte und Verbindungstest-Clients können keine Live-Aktualisierungen in das Protokoll dieses Arbeitsbereichs schreiben. Verschiedene Konten können dieselbe Gruppe beobachten, ihre Protokolle bleiben jedoch getrennt. Jedes Ereignis enthält den vorherigen Hashwert und eine Ed25519-Signatur. Die Exporte umfassen das gesamte Arbeitsbereichsprotokoll anhand einer festen Sequenznummer. Panel-Filter filtern den Export nicht; die Erfassung kann über dessen Grenzen hinaus fortgesetzt werden, während der Export vorbereitet wird. **„Verify Journal“** überprüft die Ereigniskette und die Signaturen anhand des angezeigten Grenzwerts. Das Ergebnis wird gelöscht, sobald sich der Arbeitsbereich ändert, und das Bedienfeld identifiziert neue Datensätze, die nach der Überprüfung hinzugefügt wurden. Der ZIP-Export überprüft zudem die gesammelten Medien. Fingerabdrücke und Checkpoints sind unabhängig voneinander beizubehalten. Siehe den Abschnitt „ [Verifizierungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope)“ für Erfassungsprüfungen in jedem Modus sowie „[Täglicher Betrieb](https://phishdestroy.io/tgwitness/de/docs/reference/operations/)“ für die routinemäßige Datenerfassung. --- # Telegram · Geheime Chats: Einrichtung und Aufzeichnung Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/ Installieren Sie das Protokoll-Extra für geheime Chats, aktivieren Sie es pro Konto und zeichnen Sie die Chats auf, die TgWitness erstellt oder annimmt. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Installieren Sie das Protokoll-Extra für geheime Chats, aktivieren Sie es pro Konto und zeichnen Sie die Chats auf, die TgWitness erstellt oder annimmt. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) Die veröffentlichte Anwendung umfasst das Backend für den geheimen Chat, die Collector-Integration, API-Routen und **die Pseudo-Secret-Schnittstelle**. Die Protokollbibliothek ist ein separates Modul: Öffnen Sie **Pseudo-Secret**, klicken Sie auf **Installieren und aktivieren Sie die Funktion**. Die automatische Annahme eingehender Nachrichten bleibt deaktiviert, bis Sie sie aktivieren. ## Protokollmodul | | | | --- | --- | | Modul | `kiaro-telethon-secret-chat` 0.2.0 | | Autor | KiaroSama | | Lizenz | GPL-3.0-oder-später; deren `LICENSE` und `NOTICE` im gespeicherten Archiv verbleiben | | Quelle | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) bei commit `d87bf037b90060383c7b704d8a06ebb98c621c6f` | | Prüfpunkt | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` über die Liste der Paketdateien und deren SHA-256-Werte | **Die Funktion Installieren und aktivieren** steht dem Hauptadministrator zur Verfügung. TgWitness lädt das Quellarchiv dieses Commits von GitHub über die Route des Arbeitsbereichs für Anfragen außerhalb von Telegram herunter, vergleicht jede Datei des Pakets mit dem in der TgWitness-Version festgelegten Wert, speichert das Archiv als `modules/telethon-secret-chat-.zip` im Datenverzeichnis und lädt den Code aus dem Speicher. Ein Neustart ist nicht erforderlich. Die Prüfung wird bei jedem Start erneut durchgeführt; ein abweichendes Archiv wird nicht geladen, und die Seite weist darauf hin. Eine geänderte, fehlende oder hinzugefügte Paketdatei führt zum Fehlschlagen der Prüfung. Das Modul ist ein eigenständiges Werk unter einer eigenen Lizenz. TgWitness liefert es nicht mit: Bei jeder Installation wird es aus dem Repository des Autors heruntergeladen. Auf der Seite werden **Details** zum geladenen Modul, seinem Autor, der Lizenz, dem Commit und dem SHA-256-Hash angezeigt. Ein Host ohne Zugriff auf GitHub kann denselben Commit stattdessen in der Python- Umgebung installieren; das Panel verwendet dann diese Kopie: ``` python -m pip install ".[secret-chats]" ``` TgWitness wird zum Endpunkt für die Chats, die es erstellt oder akzeptiert. Es zeichnet Nachrichten, verfügbare Anhänge, Timer-Änderungen und Löschbenachrichtigungen im signierten Journal auf. Zuvor gespeicherte Inhalte bleiben auch nach einer späteren Löschbenachrichtigung verfügbar. ## Verfügbarkeit des Pakets Am 8 . November 2026 wurde das veröffentlichte Installationspaket an der Quelle [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , Release `b35f8e18f3d1-1ff85ec98bb2` , Version 0.9.1 Preview, überprüft. Das [unveränderliche Wheel](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) und sein Abhängigkeits-Lock bestanden die SHA-256 - und RSA-Release-Signatur-Überprüfung. Das gepackte Backend und die Schnittstelle stimmten Byte für Byte mit dieser Quellrevision überein. Das Paket enthält außerdem die API-Registrierung und die Collector-Hooks. Dieses Paket enthielt die Protokollbibliothek nicht, und sie ist auch nicht im Dependency-Lock enthalten. Der `secret-chats` „extra“ in [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) fixiert denselben Commit wie die Schaltfläche im Panel. Diese Paketprüfung ermittelt, welche Dateien und Abhängigkeitsdeklarationen ausgeliefert werden. Der [Validierungsdatensatz](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) identifiziert die einzelnen Laufzeitprüfungen. Der frühere Leitfaden vom 6. November beschrieb einen Entwicklungs-Snapshot; er beschreibt nicht mehr das oben genannte Paket. ## Verwenden Sie die Schnittstelle Öffnen Sie **Pseudo-Secret**, installieren Sie das Modul, falls es auf der Seite angeboten wird, aktivieren Sie es für das Konto und stellen Sie eine Verbindung her. Eingehende Anfragen warten auf eine Bestätigung, sofern die automatische Bestätigung nicht aktiviert ist. Das Starten, Bestätigen, Senden und Schließen erfolgt unter Berücksichtigung der Interaktionsberechtigungen und des Lese-Schutzes des Kontos. | Maßnahme | Beibehaltenes Ergebnis | | --- | --- | | Starte einen Chat anhand des Benutzernamens oder der Benutzer-ID | Ausgehende Anfrage; der Peer nimmt sie auf seinem Gerät entgegen. | | Anfrage annehmen | TgWitness wird zum empfangenden Endpunkt. | | Eine Nachricht senden oder empfangen | `secret_chat.message` mit Richtung, Inhalt und angegebenem Timer. | | Datei empfangen | Entschlüsselte Bytes, gespeichert mittels SHA-256, sowie eine Quittung für `secret_chat.file`; im Beweismittelexport enthalten. | | Erhalten Sie eine Zeitangabe oder eine Löschbenachrichtigung | Ein separater Aktionsdatensatz neben aufbewahrten Nachrichten und Dateien. | | Überprüfen Sie den Chat | Konversation, Dateibestätigungen, Benachrichtigungen und Schlüsselvisualisierung. | Bestehende geheime Chats auf einem anderen Gerät behalten ihre gerätespezifischen Schlüssel bei. Bei einer importierten Cloud-Sitzung werden diese Schlüssel nicht übertragen. Schlüsselmaterial und Zähler für geheime Chats nutzen den Workspace-Tresor; gespeicherte Nachrichten und entschlüsselte Dateien nutzen die normalen Schutzmaßnahmen des Workspace-Speichers. ## Gespeicherte Nachrichten suchen Verwenden Sie **die Suchfunktion** in einem geöffneten Chat, um nach einer bestimmten Wortgruppe zu suchen, wobei die Groß-/Kleinschreibung ignoriert wird. Mit **Zurück** und **Weiter** oder mit „Enter“ und „Umschalt+Enter“ im Suchfeld können Sie zwischen den übereinstimmenden Nachrichten wechseln. Der Zähler zählt die Nachrichten; die erste übereinstimmende Wortgruppe in jeder Nachricht wird hervorgehoben. Mit „Esc“ wird die Suche gelöscht. Die Suchfunktion lässt die umgebenden Unterhaltungen, gespeicherten Dateien und Löschhinweise sichtbar. Sie durchsucht die bereits im Fenster geladenen Datensätze. Wenn frühere Datensätze vorhanden sind, wird dies im Fenster angezeigt; **mit Ältere Datensätze laden** wird der Verlauf erweitert und die Suchergebnisse werden aktualisiert, während die aktuelle Nachricht an ihrer Stelle bleibt. Jeder Chat behält seine Suche bei, während Sie innerhalb desselben Arbeitsbereichs wechseln. Durch das Sperren des Fensters oder das Wechseln des Arbeitsbereichs werden diese Suchanfragen gelöscht. Suchbegriffe verbleiben im Arbeitsspeicher der Seite und werden weder im Browserspeicher abgelegt noch als API-Abfragen gesendet. Bei der Suche werden keine Telegram-Nachrichten oder Eingabe-/Lesebenachrichtigungen gesendet. Die bestehenden Sichtbarkeitseinstellungen gelten weiterhin für das Öffnen eines Chats und andere Aktionen. **Der Erstellungsbericht** behält den Berichtsumfang des ausgewählten Chats bei; eine Suche in der Anzeige schränkt die exportierten Datensätze nicht automatisch ein. Sehen Sie sich die Auswahl des Berichts vor dem Herunterladen in der Vorschau an. ## Kontrollen zur Persistenz und Interaktion Die integrierte Implementierung nutzt die dauerhafte Journalabfrage zur Duplikaterkennung, hält Anhangsaufträge nach einem fehlgeschlagenen Download in der Warteschlange und leitet das Schließen über denselben Interaktionswächter wie andere Remote-Aktionen weiter. Diese ersetzen die drei Pfade, die im historischen Audit des Entwicklungs-Snapshots vom 6. November gemeldet wurden. Entschlüsselte Nachrichten, bei denen das Schreiben in das Journal fehlschlägt, werden im Tresor für einen erneuten Versuch gespeichert. Prüfungen der Anhangsgröße und des freien Speicherplatzes verzögern das Herunterladen, wobei die entsprechenden Aufgaben jedoch erhalten bleiben. Das Modul nutzt die bestehende Verbindung des Kontos weiter. Lese- und Tippbenachrichtigungen werden nur gemäß der Auswahl unter [Was die andere Seite sieht](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees) gesendet; Screenshot-Benachrichtigungen werden niemals gesendet. Siehe [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [API-Routen](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) und [Zugriffsrichtlinien](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py). Die [historische Prüfung](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) behält ihre ursprünglichen Snapshot-Ergebnisse bei. Die aktuelle Verfügbarkeit und Implementierung sind der oben angegebenen Paketversion und den [aktuellen Funktionen](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md) zu entnehmen. ## Demonstration der Benutzeroberfläche Das Website-Szenario verwendet fiktive Anfragen, Nachrichten und Dateien, um den Arbeitsablauf des Panels zu veranschaulichen. Es handelt sich um ein Beispiel für eine Benutzeroberfläche; Protokoll- und Erfassungsprüfungen weisen im Validierungsprotokoll eigene, datierte Ergebnisse auf. --- # Telegram · Quellhistorie laden Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/history/ Laden Sie vergangene Nachrichten aus aktivierten Quellen, halten Sie den Vorgang an und setzen Sie ihn fort, und überprüfen Sie einen signierten Fortschrittsbericht. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Laden Sie vergangene Nachrichten aus aktivierten Quellen, halten Sie den Vorgang an und setzen Sie ihn fort, und überprüfen Sie einen signierten Fortschrittsbericht. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Sammlung](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md) ![Sammlung](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69) Über **Weitere Tools → Quellen → Betroffene Chats** können Sie die aktivierten Chats überprüfen, „Standard-API“ oder „Takeout-Export“ auswählen und anschließend **Gesamten Verlauf laden** wählen. Der Vorgang korrigiert diese Liste der Quellen und liest die verfügbaren historischen Nachrichten in „Chats“ und das signierte Beobachtungsprotokoll ein. „Medien“ verwendet die vorhandenen Einstellungen für Anhänge und die dauerhafte Download-Warteschlange. Dies ist unabhängig vom signierten JSON/HTML-Export pro Chat. Für eine kontoweite Erfassung wählen Sie **„Gesamtes Konto** “ aus und speichern Sie den Umfang. „Verlauf“ aktualisiert alle zugänglichen Dialoge, einschließlich archivierter Chats, bevor die Quellenliste signiert wird. Diese Erfassung unterliegt nicht der Listenbegrenzung der Chat-Auswahl. Später erfasste Chats werden überwacht und erhalten ihren konfigurierten Anfangs-Snapshot; ein weiterer vollständiger Durchlauf kann ihren früheren Verlauf laden. Lassen Sie **die Option Beobachtung während und nach dem Laden des Verlaufs beibehalten** aktiviert, um neue Nachrichten, Bearbeitungen und Löschbenachrichtigungen während des Ladens des Verlaufs aufzuzeichnen. Ein Verlaufsdurchlauf oder -export belegt den Erfassungs-Slot; die Live-Beobachtung läuft parallel dazu. Wählen Sie ein bis drei gleichzeitige Chats, ein bis fünf Bearbeiter für Anhänge und legen Sie fest, ob verfügbare „Zuletzt ausgeführte Aktionen“ beibehalten und zuvor gespeicherte Versionen verglichen werden sollen. Für das „Takeout“ ist möglicherweise eine Genehmigung in Telegram sowie eine vom Server festgelegte Wartezeit erforderlich. Diese Optionen bleiben bei der Wiederaufnahme unverändert. Weitere Informationen zu Transport, Wiederholungsversuchen und Vertrauensmechanismen finden Sie unter [Backfill-Verhalten und im Evidence Contract](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md). ## Pause, Neustart und Teilergebnisse - **Verlauf anhalten** unterbricht das Einlesen. **Verlauf fortsetzen** setzt den Ablauf ab der zuletzt gespeicherten Nachricht in jeder Quelle fort; beim Neustart der App bleibt der Ablauf ebenfalls angehalten, bis er fortgesetzt wird. Zur Fortsetzung ist dasselbe inaktive Telegram-Konto erforderlich. - Die Nachrichtenbeobachtung, die Anhangsverarbeitung und die Cursor-Festschreibung erfolgen in einer einzigen Transaktion. Bei einem fortgesetzten Lauf werden bereits festgeschriebene Beobachtungen nicht wiederholt. Bei einer Live-Erfassung oder einem separaten, explizit gestarteten Lauf kann dieselbe Nachricht unabhängig davon beobachtet werden. - Jede Quelle (jeder Telegram-Split-Bereich in Takeout) legt beim ersten Lesen eine obere Nachrichten-ID fest. Neuere Nachrichten gehören zur Live-Beobachtung und nicht zu den verbleibenden historischen Seiten dieser Quelle. - Nicht zugängliche Quellen und Quellen, die während der Erfassung deaktiviert wurden, bleiben als fehlgeschlagen oder übersprungen sichtbar. Andere Quellen werden weiterverarbeitet; das Gesamtergebnis ist unvollständig. - Telegram zeigt das Admin-Protokoll eines Chats nur dessen Administratoren an. Für ein normales Mitglied wird das Lesen des Admin-Protokolls als `history.admin_log.unavailable` mit dem `reason: not_admin`“ protokolliert und führt nicht dazu, dass der Verlauf unvollständig wird; ein fehlgeschlagenes Lesen des Admin-Protokolls durch einen Administrator hingegen schon. - FloodWait-Verzögerungen berücksichtigen die gespeicherte Backoff-Zeit des Kontos. Bei vorübergehenden Fehlern werden bis zu fünf Wiederholungsversuche unternommen; bei Erschöpfung der Kontingente und geringem Speicherplatz wird die Ausführung mit erhaltenem Cursor unterbrochen. - **Beendet diesen Verlaufslauf.** bewahrt gespeicherte Beobachtungen. Es entfernt diese nicht und bricht keine Anhangsaufträge der Standard-API ab. Das Beenden von Takeout markiert die verbleibenden Takeout-Dateien als übersprungen; beim Anhalten bleiben sie wiederherstellbar. Ein neuer Lauf liest aktivierte Quellen erneut ein. Die Vervollständigung des Verlaufs bezieht sich ausschließlich auf das Auslesen des Verlaufs. Anhänge können noch ausstehen, fehlschlagen oder durch die konfigurierte Richtlinie ausgeschlossen werden. Überprüfen Sie Medienbestätigungen im Protokoll und in der Anhangswarteschlange; nur eine abgeschlossene Bestätigung mit erhaltenen Bytes gilt als gespeicherter Anhang. Der Verlaufsvorgang ist eine explizite Snapshot-Anfrage und unterscheidet sich von Schaltern, die Kategorien zukünftiger Live-Ereignisse auswählen. ## Übertragen und überprüfen Speichern Sie den **signierten Fortschrittsbericht** und verwenden Sie anschließend **„Beweismaterial exportieren“**, um das Protokoll und die gespeicherten Anhänge herunterzuladen. Ein späterer Export des Beweismaterials kann zusätzliche Datensätze enthalten; der Bericht bindet seine Zähler an das Protokollpräfix zum Zeitpunkt seiner Erstellung. Führen Sie den Verifizierer aus einem vertrauenswürdigen Checkout dieser Version aus: ``` python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT ``` Behalten Sie den erwarteten Fingerabdruck des Signaturschlüssels separat bei. Der Verifizierer überprüft die Berichtsignatur, das Beweisarchiv, den Bericht-Checkpoint, den Quellplan, das Konto sowie die Anzahl der gespeicherten bzw. nicht verfügbaren Nachrichten. Neue Durchläufe binden zudem den Quellfortschritt und Optionen an signierte Cursor-Ereignisse. Ohne `--evidence` werden nur der signierte Bericht und dessen interne Konsistenz geprüft. Ältere Fortschrittsfelder und Anhangszusammenfassungen bleiben signierte Aussagen des Sammlers. Der Beweisprüfer überprüft archivierte Medienbytes. Lesen Sie den verifizierten Verlauf zusammen mit seinen Erfassungsintervallen, der Abdeckung und den verfügbaren Jüngsten Aktionen. Dieser Workflow liest den aktuell zugänglichen Verlauf; [die Live-Überwachung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#message-history-and-attribution) bewahrt Versionen und Benachrichtigungen bei ihrem Eintreffen auf, während [geheime Chats](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/) die aktivierte Endpunktintegration nutzen. Verwenden Sie zur Verifizierung die aufbewahrten Checkpoints, Zeugenaufzeichnungen und anwendbaren Erfassungsbescheinigungen, die in den [Verifizierungsmodi](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) beschrieben sind. Der Erfassungscursor entspricht dem lokalen Arbeitsbereichszustand. Das Wiederherstellen einer Beweismittel-ZIP-Datei allein stellt keinen ausstehenden Erfassungsauftrag oder eine Telegram-Sitzung wieder her. Bewahren Sie die Arbeitsbereichssicherung auf, falls eine Fortsetzung des ursprünglichen Auftrags erforderlich ist. --- # Telegram · Arbeitsabläufe und Funktionen Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/operations/ Täglicher Betrieb des Dashboards: Betriebsmodi, Überwachungskategorien, Parameter, Benachrichtigungen, Exporte, Datensicherung und Kapazität. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Translation coverage: this edition includes material from the English original. Täglicher Betrieb des Dashboards: Betriebsmodi, Überwachungskategorien, Parameter, Benachrichtigungen, Exporte, Datensicherung und Kapazität. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) ![Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) Verwenden Sie für Ihre erste Verbindung [Konten und Sitzungsformate](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/). Eine Erläuterung zu gespeicherten Versionen, Ereignisrichtlinien und Lücken finden Sie unter [„So funktioniert die Erfassung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/)“. Dieser Leitfaden behandelt den täglichen Betrieb und die Wiederherstellung. Eine verwaltete Installation umfasst **, START-HERE.html,** und **, START-HERE.txt sowie** neben dem Startprogramm, wobei der Repository-Link und die Befehle auf den jeweiligen Installationspfad zugeschnitten sind. Führen Sie `tgwitness guide --print` über SSH aus oder `tgwitness paths`, um das tatsächliche Datenverzeichnis zu ermitteln. Bei einer Root-Installation über systemd werden private Zustandsdaten unter `/var/lib/tgwitness-…` gespeichert; `/opt/tgwitness` enthält das Programm. Bei einem verwalteten temporären Cloudflare-Tunnel sperrt „`tgwitness tunnel off`“ den öffentlichen Zugriff, während das lokale Panel und die Datenerfassung weiterlaufen. „`tgwitness tunnel on`“ aktiviert ihn; „`tgwitness tunnel restart`“ erstellt eine neue Tunnelverbindung. Verwenden Sie „`tgwitness open`“, um die aktuelle Adresse anzuzeigen. Eine explizite Deaktivierung bleibt auch nach einem Neustart des Dienstes bestehen. „`tgwitness stop`“ stoppt sowohl das Panel als auch die Datenerfassung. **Auf dieser Seite** - [Ablauf für den Operator](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#operator-workflow) - [Arbeit teilen, ohne den Hauptschlüssel weiterzugeben](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#share-work-without-sharing-the-main-key) - [Laufzeitmodi](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#runtime-modes) - [Überwachungskategorien](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#monitoring-categories) - [Benachrichtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#notifications) - [Anordnung der Bedienelemente](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#panel-layout) - [Bereitstellungsumgebungen](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#deployment-environments) - [Startprüfungen und Exporte](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#startup-checks-and-exports) - [Sicherung, Wiederherstellung und Unterbrechungen](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#backup-restore-and-interruptions) - [Kapazität und Aufbewahrungsdauer](https://phishdestroy.io/tgwitness/de/docs/reference/operations/#capacity-and-retention) ## Arbeitsablauf für Bediener Ablaufdiagramm · Wählen Sie Speicherort und Schlüsselschutz → Öffnen Sie das Fenster mit dem entsprechenden Token; Öffnen Sie das Fenster mit dem entsprechenden Token → Wählen Sie einen Arbeitsbereich aus; Wählen Sie einen Arbeitsbereich aus → Direkte oder Proxy-Route konfigurieren; Direkte oder Proxy-Route konfigurieren → Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus; Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus → Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus; Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus → Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung; Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung → Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen; Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen → Unabhängige Kontrollpunkte beibehalten; Unabhängige Kontrollpunkte beibehalten → Material exportieren und verifizieren · Wählen Sie Speicherortund Schlüsselschutz · Öffnen Sie das Fenstermit dem entsprechendenToken · Wählen Sie einenArbeitsbereich aus · Direkte oderProxy-Routekonfigurieren · Geben Sie IhreTelefonnummer ein oderwählen Sie Dateien /QR-Code aus · Überprüfen Sie dieKontoidentität undwählen Sie zugänglicheGruppen aus · Richten SieRichtlinien fürEreignisse und Anhängeein und beginnen Sieanschließend mit derÜberwachung · Fehler, Zugriff,Warteschlangen undFestplattenspeicherüberwachen · UnabhängigeKontrollpunktebeibehalten · Material exportierenund verifizieren **Diagramm als Text** 1. Wählen Sie Speicherort und Schlüsselschutz → Öffnen Sie das Fenster mit dem entsprechenden Token 2. Öffnen Sie das Fenster mit dem entsprechenden Token → Wählen Sie einen Arbeitsbereich aus 3. Wählen Sie einen Arbeitsbereich aus → Direkte oder Proxy-Route konfigurieren 4. Direkte oder Proxy-Route konfigurieren → Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus 5. Geben Sie Ihre Telefonnummer ein oder wählen Sie Dateien / QR-Code aus → Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus 6. Überprüfen Sie die Kontoidentität und wählen Sie zugängliche Gruppen aus → Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung 7. Richten Sie Richtlinien für Ereignisse und Anhänge ein und beginnen Sie anschließend mit der Überwachung → Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen 8. Fehler, Zugriff, Warteschlangen und Festplattenspeicher überwachen → Unabhängige Kontrollpunkte beibehalten 9. Unabhängige Kontrollpunkte beibehalten → Material exportieren und verifizieren Authentifizierung, Transportverbindung, Zugriff auf eine Gruppe und Vollständigkeit der Übermittlung sind unterschiedliche Eigenschaften. Ein grüner Verbindungsstatus bedeutet nicht, dass alle Ereignisse erfasst wurden. ## Arbeiten teilen, ohne den Hauptschlüssel weiterzugeben Öffnen Sie **Weitere Tools → Zugriff**, um einem Prüfer oder Analysten ein eigenes Token zuzuweisen. Wählen Sie die Konten und Chats aus, die diese Personen öffnen dürfen, und erteilen Sie ihnen anschließend Berechtigungen zum Anzeigen, Exportieren oder Ausführen von Aktionen. Ein Operator, der die Erfassung startet oder stoppt, benötigt Zugriff auf den gesamten Arbeitsbereich; ein Prüfer kann auf einen einzelnen Chat beschränkt werden. Sitzungslimits, Ablaufzeiten und IP-Regeln sind unabhängig von der Telegram-Kontoautorisierung. Siehe [Zugriff und Berechtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/access/). Verwenden Sie **„Offene Sitzungen“,** um eine Verbindung zu beenden, oder widerrufen Sie den Zugriff, um alle zugehörigen Sitzungen zu beenden. Die Administratorkonsole fasst die Aktivitäten der laufenden Prozesse über alle Arbeitsbereiche hinweg zusammen. Beim Schließen einer Sitzung läuft die Erfassung weiter. ## Ausführungsmodi | Modus | Maßnahme | Verhalten | | --- | --- | --- | | Demo | scripts\Demo.cmd oder `--demo` | Synthetische Daten; Verknüpfungen zu echten Konten deaktiviert | | Anmerkung | Beobachtung starten | Erfassung der bereitgestellten Aktualisierungen für ausgewählte Quellen | | Historischer Überblick | Chats → Chat-Aktionen → Verlauf laden | Bis zu 500 aktuelle Nachrichten; keine Rekonstruktion aller vergangenen Änderungen | | Pause | Beobachtung unterbrechen | Erfassung unterbrechen, dabei Daten und Aufträge in der Warteschlange beibehalten | | Überprüfung/Übergabe | Exporte | ZIP, JSONL/CSV/HTML, Checkpoint, Prozessbestätigung und Zeitstempelanforderung | | Mehrere Konten | Arbeitsbereiche oder die oberste Schaltfläche „**+**“ | Beliebig viele separate Arbeitsbereiche in einem Prozess | Der lokale Demo-Zugriff wird automatisch ohne manuelle Token-Eingabe freigeschaltet. Dabei kommt eine auf die Prozesslaufzeit begrenzte Funktion zum Einsatz, die ausschließlich für den direkten Loopback-Zugriff auf eine isolierte synthetische Demo gilt; das Token für das Hauptpanel wird nicht offengelegt. Bei echten Arbeitsbereichen sowie beim Remote- oder Proxy-Zugriff auf die Demo bleibt die Token-Authentifizierung bestehen. Der Demo-Zugang gewährt keine Telegram-Berechtigung. ## Überwachungskategorien ![Überwachungseinstellungen pro Konto mit synthetischen Quelldaten](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c) Wählen Sie unter **Weitere Tools → Quellen → Aufzeichnung → Zu beibehaltende Änderungen auswählen** neue Nachrichten, Bearbeitungen, Löschhinweise, Reaktionsaktualisierungen und Mitgliedschaftsereignisse separat aus. Die Standardeinstellung behält alle Kategorien bei. **Nachrichten, Bearbeitungen & Löschungen** behält den ursprünglichen Kontext bei, während separate Reaktions- und Mitgliederaktualisierungen deaktiviert werden. **Alle sichtbaren Aktivitäten** stellt alle fünf wieder her. Voreinstellungen ändern das Formular; klicken Sie auf**Aufzeichnungseinstellungen speichern,** um sie anzuwenden. Die gespeicherte Richtlinie gilt für alle ausgewählten Quellen in diesem Arbeitsbereich. Andere Arbeitsbereiche behalten ihre eigenen Einstellungen bei. Bei jeder tatsächlichen Änderung werden signierte Vorher-Nachher-Werte aufgezeichnet; die aktuelle Richtlinie wird zudem in Prozessbelegen und Beobachtungsstartprotokollen erfasst. Das Deaktivieren einer Kategorie löscht frühere Beobachtungen nicht. Durch erneutes Aktivieren werden versäumte Änderungen nicht nachträglich erfasst. In dieser Version gibt es keine gruppenspezifische Übersteuerung von Kategorien. Behalten Sie die Erfassung neuer Nachrichten bei, wenn frühere Inhalte von Bedeutung sind: Eine Löschmeldung kann keinen Text wiederherstellen, der nie erfasst wurde. Betriebs- und Erfassungsprotokolle sowie andere Ereignisse im Zusammenhang mit Gruppendiensten werden stets beibehalten. Explizite Verlaufs-Snapshots sind unabhängig von der Auswahl der Live-Kategorien und können Dienstmeldungen enthalten. Diese Einstellungen führen nicht zur Schwärzung von Reaktions- oder Mitglieder-Metadaten, die in einem ansonsten erfassten Telegram-Objekt eingebettet sind. Ein Verlaufs-Snapshot kann Anhänge in die Warteschlange stellen, während er angehalten ist. Starten Sie die Beobachtung, um diese zu verarbeiten. „In der Warteschlange“ bedeutet nicht „heruntergeladen“. Eine nicht verfügbare Originaldatei wird nicht durch eine neuere bearbeitete Version ersetzt; die Ergebnisse werden separat aufgezeichnet. **Mit „Lock“** werden der Browserzugriff und geheime Felder gelöscht, die Erfassung läuft jedoch weiter. Auch beim Schließen eines Tabs läuft der Prozess weiter. Das Beenden des Python-Prozesses oder -Dienstes stoppt die Erfassung unabhängig vom Status des Browsers. Ein zusätzlicher Arbeitsbereich kann gelöscht werden, sobald ein signierter ZIP- oder ASiC-E-Container, der das Journal und die Case-Board-Notizen enthält, vollständig heruntergeladen wurde. Das Vorbereiten des Archivs reicht nicht aus: Ein Eintrag außerhalb der Einrichtungsereignisse oder eine nach dem Herunterladen hinzugefügte Notiz verhindert, dass **die Option Löschen** verfügbar ist. Wenn das Panel die Datei selbst empfängt, zählt es den Export erst, nachdem es jedes einzelne Byte empfangen hat, und meldet dann die Größe an `POST /api/exports/{id}/received`; ein abgebrochener Download wird nicht gezählt. Bei Verwendung eines Browser-Speicherauswahlfensters (Dateisystemzugriff) meldet das Panel den Vorgang, nachdem die Datei geschrieben und geschlossen wurde. Ohne diesen übergibt das Panel die empfangene Datei an die Downloads des Browsers und kann nicht erkennen, ob der Browser sie beibehalten hat, beispielsweise wenn der Speicherdialog abgebrochen wird; das Panel meldet dann, dass der Download gestartet wurde, nicht jedoch, dass die Datei gespeichert wurde. Eine Datei, die der Browser eigenständig herunterlädt (ein Export, der größer ist als der Browser-Puffer des Panels), sowie ein Download durch einen anderen HTTP-Client werden gezählt, sobald der Server die gesamte Antwort gesendet hat. Das Betriebssystem und ein Reverse-Proxy puffern mehrere Megabyte einer Antwort, sodass der Server bei diesen Downloads eine Unterbrechung kurz vor dem Ende nicht erkennen kann. Sofern das Panel nicht anzeigt, dass die Datei gespeichert wurde, überprüfen Sie die heruntergeladene Datei, bevor Sie sie löschen. Ein Gruppenexport wird für die betreffenden Konten gezählt, wenn er unmittelbar nach seiner Erstellung heruntergeladen wird; ein erneutes Herunterladen aus **den vorbereiteten Exporten** zählt nicht. Vor dem Löschen zeigt das Fenster das Format, die Größe, die Erstellungszeit und den SHA-256-Hash des zuletzt heruntergeladenen signierten Archivs an und fordert zur Bestätigung auf, dass dieses Archiv außerhalb des Arbeitsbereichs gespeichert ist. Der Server lehnt den Befehl `DELETE /api/profiles/{id}` ab, wenn `kept_copy` nicht auf diesen SHA-256-Wert gesetzt ist (oder auf `confirmed` für ein Archiv, das vor der Erfassung des Fingerabdrucks heruntergeladen wurde). Das Löschen eines zusätzlichen Arbeitsbereichs stoppt dessen Datenerfassung und entfernt dessen lokale Daten. Sollte eine gesperrte Datei oder ein Dateisystemfehler den Löschvorgang unterbrechen, meldet das Bedienfeld den Fehler und führt den Arbeitsbereich weiterhin als nicht verfügbar (`DeletionPending`) auf. Schließen Sie Programme, die dessen Dateien öffnen, und versuchen Sie **den Löschvorgang** erneut. Ein Neustart von TgWitness belässt diesen Arbeitsbereich im angehaltenen Zustand und stellt das teilweise entfernte Protokoll oder die Schlüssel nicht wieder her. Eine erfolgreiche Löschung wird erst dann protokolliert, wenn das Verzeichnis entfernt wurde; separat exportierte oder gesicherte Kopien unterliegen weiterhin ihrer eigenen Aufbewahrungsrichtlinie. ## Benachrichtigungen Öffnen Sie **Einstellungen → Benachrichtigungen und externe Kopie → Benachrichtigungsziele** oder **Weitere Tools → Extras → Benachrichtigungen → Konfigurieren**. TgWitness nutzt Apprise, um Benachrichtigungen an Matrix, Telegram, Discord, Slack, ntfy, E-Mail und andere unterstützte Dienste zu senden. Sie können einem Arbeitsbereich mehrere Ziele hinzufügen. 1. Geben Sie pro Zeile eine Apprise-Ziel-URL ein. Verwenden Sie den [Servicekatalog und die URL-Formate](https://appriseit.com/services/) für Ihren Dienst. 2. Aktivieren Sie die Option **„Benachrichtigungen senden**“ und wählen Sie anschließend Problemwarnungen, Änderungen in beobachteten Chats sowie eine tägliche Zusammenfassung aus. Die Uhrzeit in der Zusammenfassung richtet sich nach der Serverzeit. 3. Aktivieren Sie die Option**„Kurze Auszüge einbeziehen“,** wenn Sie möchten, dass Text aus gelöschten und bearbeiteten Nachrichten in den Benachrichtigungen gespeichert wird. 4. Klicken Sie auf **„Benachrichtigungen speichern**“ und anschließend auf **„Test senden“**, um die Zustellung zu überprüfen. Verwenden Sie für Ihren eigenen Empfänger [den JSON-Webhook](https://appriseit.com/services/json/) von Apprise. Beispielsweise sendet „`jsons://notify.example.org/tgwitness`“ JSON über HTTPS an diesen Endpunkt. Dies ist ein fiktives Beispiel; ersetzen Sie es durch Ihr eigenes Ziel. Ziele und Einstellungen gehören zum ausgewählten Arbeitsbereich. Änderungsbenachrichtigungen umfassen die überwachten Quellen, einschließlich neu hinzugefügter Chats. Die Glocke in der oberen Leiste listet zudem aktuelle Probleme und Änderungen in Chats auf. In der Demo sind die Benachrichtigungssteuerelemente sichtbar, das Versenden ist jedoch deaktiviert. Konfigurieren Sie die Zustellung in einem realen Arbeitsbereich. Benachrichtigungen nutzen die Direct-, SOCKS5- oder HTTP-Route dieses Arbeitsbereichs; MTProxy kann sie nicht weiterleiten. Nicht-HTTP-Ziele wie SMTP erfordern eine direkte Route. ## Layout der Seiten ![Arbeitsbereich für die Anbindung unter Verwendung synthetischer Daten](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29) **Das Protokoll** zeigt Beobachtungen, Suchfunktionen und Filter an. Bei einer Bearbeitung werden die erfassten Versionen angezeigt; bei einer Löschung wird der vorherige Inhalt angezeigt, sofern verfügbar. Unbekannte Quellenangaben bleiben ausdrücklich gekennzeichnet. Zahlenangaben sind unter **„Übersicht“** verfügbar; Details zur Erfassung verbleiben im lokalen Leitfaden. Öffnen Sie eine bearbeitete Nachricht, um ihre Versionen über **Änderungen im Text** oder **Nebeneinander** zu vergleichen; **Rohdaten** zeigt die gespeicherten Felder an. Änderungen an versteckten Links und Bot-Schaltflächen werden separat angezeigt. Öffnen Sie eine Anhangsvorschau, um gespeicherte Bilder, Audio- oder Videodateien zu prüfen; über die Download-Schaltfläche bleibt das gesicherte Original verfügbar. **Live** aktualisiert das Journal und die Chats, sobald Datensätze eintreffen. Pausieren Sie es während der Überprüfung oder nutzen Sie die Schaltfläche für neue Ereignisse, wenn Sie bereit sind; die Erfassung läuft im Hintergrund weiter. **Ctrl/Cmd+K** findet Panel-Aktionen und durchsucht das Journal. **Weitere Tools → Quellen** enthält den Beobachtungsumfang (ausgewählte Chats, einen Telegram-Ordner oder das gesamte Konto), zugängliche Chats aller Art, ausgewählte Quellen mit Prioritätssternen, Einstellungen für Anhänge und Nachprüfungen sowie Verlaufs-Snapshots. Private Quellen werden über Dialog/ID ohne öffentlichen Link ausgewählt. Der Zugriffsstatus beschreibt die letzte Überprüfung, nicht dauerhafte Berechtigungen. Filtern Sie Quellen, aktivieren Sie deren Kontrollkästchen und aktivieren, pausieren oder markieren Sie sie anschließend gemeinsam als prioritär. In der Liste der verfügbaren Chats verwendet **Ausgewählte hinzufügen** Ihre Auswahl; **Alle Treffer hinzufügen** nutzt die aktuelle Suche und den Typfilter. Unter **„Chats → Personen“** werden alle Personen mit gespeicherten Nachrichten aufgelistet; sind die Personenprofile für den Chat aktiviert, öffnet ein Klick das Profil der jeweiligen Person mit Links zu den Protokollen. **Weitere Tools → Extras → Independent Witness** erstellt schreibgeschützte Witness-Token, zeigt an, wann jeder Witness zuletzt eine Überprüfung durchgeführt hat, und stellt die Befehle und Optionen zur Ausführung eines [Independent Witness](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) bereit. **Weitere Tools → Parameter** enthält alle Grenzwerte und Raten des Arbeitsbereichs, die nicht auf einer anderen Seite aufgeführt sind: wie viele Dialoge gelesen werden, wie oft die Chat-Liste neu gelesen wird, Heartbeat- und Checkpoint- Intervalle, den Startpuffer, wie Nachprüfungen ihre Anfragen verteilen (erste Verzögerung, Chats pro Durchlauf, Pause zwischen Chats, wiederhergestellte und erneut angeforderte Nachrichten), Festplattenreserve, Timeouts und Wiederholungsversuche bei Downloads, wonach Benutzerprofile suchen (einschließlich Ihrer eigenen regulären Ausdrücke), Größe und Häufigkeit von Benachrichtigungen, Snapshot-, ZIP- und Browser-Download-Limits sowie Telegram- Client-Timeouts und Wiederholungsversuche. Jedes Feld zeigt seinen Bereich und seinen Standardwert an; geänderte Felder sind markiert und können einzeln oder alle zusammen wiederhergestellt werden. Jede Änderung wird als ``parameters.changed`` mit den Werten vor und nach der Änderung protokolliert, und die Aufzeichnungen zum Beginn der Beobachtung nennen die geltenden Werte. Die Werte gelten ab ihrer nächsten Verwendung; Client-Timeouts und Wiederholungsversuche ab der nächsten Verbindung. Intervalle für erneute Überprüfungen, Anhangstypen und -größen, Nachweise sowie Intervalle für externe Kopien bleiben auf ihren eigenen Seiten und können beliebige Werte innerhalb ihres Bereichs annehmen, nicht nur voreingestellte Werte. Die Glocke in der oberen Leiste listet aktuelle Probleme und Änderungen in den überwachten Chats auf; ungelesene Einträge werden gezählt, bis sie als gelesen markiert werden. Änderungen werden nach Chat und Stunde gruppiert („12 gelöscht, 1 bearbeitet, 0 nicht gefunden“), und Probleme wie eine Abmeldung oder ein voller Speicherplatz bleiben in der Liste, unabhängig davon, wie aktiv die Chats sind. **Weitere Tools → Die Kontoerstellung** beginnt im Feld für die Telefonnummer. **Weiter** führt direkt zur Codeeingabe, wobei API-Anmeldedaten nur abgefragt werden, wenn sie fehlen. QR-Code und Dateiimport sind alternative Registerkarten. Gespeicherte API-Anmeldedaten werden nur innerhalb des eigenen Arbeitsbereichs wiederverwendet. Der Eingabebildschirm verfügt über keine Seitenleiste, Statistiken oder Einrichtungsabschnitte. Das Symbol **Einstellungen** öffnet die Steuerelemente für API, Proxy, Speicher und zusätzliche Konten. Ein neuer Arbeitsbereich öffnet [die Ersteinrichtung](https://phishdestroy.io/tgwitness/de/docs/reference/settings/) ; nach der Anmeldung öffnet sich ein Arbeitsbereich mit gespeicherten Quellen und Datensätzen sowie **dem Bereich „Chats** “. Das Ändern der Route erfordert die Unterbrechung der Beobachtung und bricht eine noch nicht abgeschlossene Anmeldung ab. Ein bestehendes Journal kann nicht im Hintergrund mit einem anderen Telegram-Konto neu verknüpft werden. **Der Export** überprüft die Integrität des Journals und erzeugt portable Dateien. Seine Arbeitsbereichs-ID kann an die Download-Befehlszeilenschnittstelle übergeben werden. Jeder Export fixiert ein vollständiges Journal-Präfix; spätere Ereignisse fließen in einen nachfolgenden Export ein. Suchfilter ändern den Paketbereich nicht. Detaillierte Informationen zu Signatur und Abdeckung finden Sie unter **Verifizierung und Nachweis**. Das Dashboard zeigt unter „Collector**-Status“** den Status des Collectors, Medien in der Warteschlange bzw. fehlgeschlagene Medien, die ältesten ausstehenden Medien, freien Speicherplatz, angehaltene Anfragen sowie Quellen an, deren Zugriff unter **„Collector-Status“**noch nicht bestätigt ist. Diese Details sind zunächst ausgeblendet und auf der Registerkarte „Konto“ verborgen. Eine Einrichtungskarte zeigt den nächsten Schritt an: ein Konto verbinden, Quellen auswählen oder die Überwachung starten. Die Konto-Liste ist eine Momentaufnahme zum Zeitpunkt des Ladens; der ausgewählte Arbeitsbereich wird regelmäßig aktualisiert. Es handelt sich hierbei nicht um einen SLA-Monitor mit mehreren Prozessen. Die Oberfläche nutzt lokale Assets und Textdarstellung für Quellinhalte. Desktop- und schmale Chromium-Layouts sind getestet. ## Bereitstellungsumgebungen | Umfeld | Installation | Verifizierungsstatus | | --- | --- | --- | | Windows-PC/Server | Python 3.11+, Skripte: „Setup.cmd/Start.cmd“, Verzeichnis für private Daten | Lokal getestet unter Windows/Python 3.12 | | Linux-Server/VPS | Python-venv, dedizierter Service-Benutzer, HTTPS/SSH | Beispiele für Code, CI und systemd werden bereitgestellt; die Ausführung erfolgt nicht auf diesem Host | | macOS | Python-venv, Vordergrundprozess oder User-Agent | Beispiel für „launchd“ bereitgestellt; separate Installationsprüfung erforderlich | | Docker/Compose | Persistenter Speicher, ein Worker | Definition und CI-Laufzeitprüfung werden bereitgestellt; Docker ist lokal nicht verfügbar | | Mobilbrowser | Stellen Sie eine Verbindung zum geschützten Panel auf einem laufenden Server her | Getestet mit schmalem Chromium-Layout; der Collector läuft nicht unter iOS/Android | Portabilität bedeutet, dass kein Cloud-Dienst und kein Frontend-Build zwingend erforderlich sind. Jedes Zielsystem benötigt jedoch weiterhin kompatible Python-/Krypto-Abhängigkeiten sowie lokalen Festplatten- und Netzwerkzugriff. Siehe [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) und [die Service-Vorlagen](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Arbeitsbereiche teilen sich CPU, Arbeitsspeicher und eine Ereignisschleife. Verwenden Sie zur Prozessisolierung unterschiedliche Instanzen, Ports, Datenverzeichnisse und Kontoberechtigungen. Es gibt kein einheitliches Kontrollpanel für separate Instanzen. Richten Sie niemals mehrere Worker auf eine einzige Datenbank aus. ## Startvorgänge und Exporte Führen Sie `python start.py --check` aus, bevor Sie eine vorbereitete Umgebung starten. Fügen Sie `--json` hinzu für maschinenlesbare Prüfungen oder übergeben Sie die gewünschten Parameter `--data-dir`, `--host` und `--port`. Der Befehl prüft die Voraussetzungen, ohne sich bei Telegram anzumelden oder ein Journal anzulegen. Die Journalüberprüfung läuft während des Anwendungsstarts ab, und die Erfassungsbereitschaft wird im Panel angezeigt. Ein belegter Port kann einfach eine bereits vorhandene Instanz sein. Browser, die die File System Access API unterstützen, speichern Exporte über einen beschreibbaren Stream. Andere Browser puffern maximal 128 MiB. Verwenden Sie die Streaming-CLI für größere Exporte oder für Browser ohne Datei-Streaming: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` Fügen Sie „`--profile ID` “ aus „Exports“ für einen untergeordneten Arbeitsbereich hinzu. Verwenden Sie „`--url https://server` “ für den Fernzugriff. Einfaches HTTP wird nur für Loopback-Ziele akzeptiert. Das Token wird aus einer Datei gelesen und in einem Header gesendet; es wird weder ausgegeben noch in eine URL eingefügt. Weiterleitungen werden abgelehnt. Vorhandene Ziele werden nicht überschrieben. Bei fehlgeschlagenen Übertragungen wird die temporäre Teil-Datei entfernt. Der gemeldete SHA-256-Wert ist eine Übertragungsprüfsumme; überprüfen Sie die signierte ZIP-Datei separat anhand eines vertrauenswürdigen Fingerabdrucks/Checkpoints. ## Sicherung, Wiederherstellung und Unterbrechungen 1. Die Überwachung unterbrechen und den Vorgang ordnungsgemäß beenden. 2. Kopieren Sie das gesamte Datenverzeichnis: Datenbanken, WAL/SHM (falls vorhanden), Medien, `credentials.enc`, `signing.enc`, `network.enc`, Tresorschlüssel/Metadaten, Token, Checkpoints und jedes `profiles/`-Verzeichnis. 3. Im Modus mit externem Schlüssel sind der Hauptschlüssel separat aufzubewahren und jeder „ `vault.external.json`“-Wert zu sichern. Durch die Generierung eines neuen Schlüssels lassen sich die alten Geheimnisse nicht wiederherstellen. 4. Führen Sie die Wiederherstellung durch, während das Zielsystem angehalten ist; konfigurieren Sie den ursprünglichen Schlüssel, beschränken Sie den Zugriff und überprüfen Sie die Integrität, bevor Sie den Vorgang fortsetzen. 5. Erfassen Sie Ausfallzeiten und Verifizierungsergebnisse. Die Ausfallzeit bleibt als aufgezeichnete Lücke bestehen; ein Verlaufs-Snapshot fügt den Zustand danach hinzu. Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/#updates-and-backups). Four things are protected differently: | Was | Schutz | | --- | --- | | Dateien ohne Passwort exportieren (Standardeinstellung) | Signiert, sodass Änderungen nachweisbar sind; legen Sie ein Passwort fest, um den Export zu verschlüsseln | | Dateien mit einem Passwort exportieren | Wenn Sie ein Passwort festlegen, wird der fertige Export unverändert in eine WinZip-ZIP-Datei mit AES-256-Verschlüsselung gespeichert, die sich mit 7-Zip und WinRAR öffnen lässt; das Passwort wird nicht gespeichert ([Beweismittelbehandlung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/)). | | Die Protokoll-Datenbank und die auf der Festplatte gespeicherten Anhänge | Eine verschlüsselte Festplatte oder ein verschlüsseltes Volume und Ordnerberechtigungen | | Telegram-Sitzungen und Signaturschlüssel | Verschlüsselt im Datenverzeichnis (`credentials.enc`, `signing.enc`, `network.enc`) | Ein Vollsicherungs-Backup ist das oben beschriebene Verzeichnis mit den gesicherten Daten, kein Export. Verwenden Sie für beides einen geschützten Speicher und einen kontrollierten Übertragungsmechanismus. Vorläufige Server-Exporte werden im Verzeichnis „ `temporary-exports/`“ des jeweiligen Arbeitsbereichs gespeichert; abgeschlossene Antworten werden bereinigt, und unterbrochene Exportdateien werden beim nächsten Start entfernt, solange die Instanzsperre dieses Arbeitsbereichs aufrechterhalten wird. Nach einem Ereignis zur Wiederherstellung der Verbindung fordert der Collector versäumte Aktualisierungen ab der gespeicherten Aktualisierungsposition an. Persistente Medienaufträge und die Telegram-Aktualisierungsposition bleiben nach einem Neustart erhalten; siehe [Nachweisformat](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#durable-collection-and-process-receipts-02). ## Kapazität und Aufbewahrungsdauer Standardgrenzwerte, die alle unter **Weitere Tools → Parameter** geändert werden können: die ersten 1,000 Dialoge, 500 Nachrichten pro Snapshot, 4 GiB unkomprimierter signierter ZIP-Inhalt (größere Archive erfordern `verify.py --max-gib N`) und ein 128-MiB-Browser-Fallback. Anhänge beanspruchen 1–2,000 MiB pro Typ unter **Weitere Tools → Quellen → Aufzeichnung → Anhänge**. Die Download-CLI ist standardmäßig auf 5 GiB übertragen eingestellt. Der verfügbare Speicherplatz kann eine untere Grenze darstellen. Reservieren Sie Speicherplatz für Journale, Medien, WAL, temporäre Exporte und Backups. Exporte nutzen das Datenvolumen anstelle des 512-MiB-Verzeichnisses `/tmp` von Compose. Messen Sie Ereignisse pro Sekunde, das Alter der Warteschlange, Medienbytes und die Festplattenlatenz, anstatt nur Gruppen zu zählen. Die Live-Übertragung wird auf dem laufenden Collector gemessen. Es gibt keine automatische Löschung bei Ablauf der Aufbewahrungsfrist. Das Entfernen des Endes eines Journals macht dessen Beziehung zu aufbewahrten Checkpoints ungültig. Priorisierte Nachprüfungen gibt es bereits: Mit Stern markierte Quellen werden standardmäßig alle 15 Minuten nachgeprüft, andere alle 6 Stunden (siehe [Nachprüfungsstufen](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#recheck-tiers)). Passwortgeschützte Exporte funktionieren wie oben beschrieben. Eingeschränkter Zugriff ist unter [Zugriff und Berechtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/access/) dokumentiert. Siehe [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) und [VERIFICATION.md](https://phishdestroy.io/tgwitness/de/docs/reference/verification/). --- # Telegram · Untersuchungsmodus Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/investigation/ Umfassende Untersuchungen ganzer Konten über Kanäle, Gruppen, private Chats und Bots hinweg – vom Untersuchungsumfang bis hin zu einem verifizierten Fallpaket. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Umfassende Untersuchungen ganzer Konten über Kanäle, Gruppen, private Chats und Bots hinweg – vom Untersuchungsumfang bis hin zu einem verifizierten Fallpaket. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Untersuchung](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Verfolgen Sie einen Fall über Kanäle, Gruppen, private Chats und Bots hinweg, von der ersten Erfassung bis hin zu einer zitierfähigen Zeitleiste und einer überprüfbaren Übergabe. Die interaktive Website-Version finden Sie unter `/docs/cases/`; [Anweisungen zur Vorschau](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally). **Auf dieser Seite** - [Beispielfall: Ein Ziel ändert sich über vier Unterhaltungen hinweg](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#worked-case-a-destination-changes-across-four-conversations) - [1. Den Sachverhalt definieren und den gesamten Bericht zusammenstellen](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#1-define-the-case-and-collect-the-whole-account) - [2. Alle Quellen erfassen und den historischen Kontext ermitteln](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#2-inventory-every-source-and-acquire-historical-context) - [3. Behalten Sie den sich entwickelnden Fall und die bewussten Interaktionen bei.](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#3-preserve-the-evolving-case-and-deliberate-interactions) - [4. Beobachtungen über Chats hinweg verknüpfen](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#4-connect-observations-across-chats) - [5. Erstellen der chatübergreifenden Zeitleiste](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#5-build-the-cross-chat-timeline) - [6. Fügen Sie Konto-Perspektiven hinzu, ohne deren Herkunft zu verlieren.](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#6-add-account-perspectives-without-losing-their-origin) - [7. Fallübergabe zusammenstellen und überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#7-assemble-and-verify-the-case-handoff) - [Untersuchung anpassen](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/#adapt-the-investigation) ## Beispielfall: Eine Änderung des Zielortes über vier Unterhaltungen hinweg Eine Ankündigung verweist auf einen Bot. Eine Einsatzgruppe bespricht ein neues Zahlungsziel, und die Tastatur des Bots zeigt dieses an. Die Ankündigung wird bearbeitet, in einer privaten Folgenachricht wird das Ziel wiederholt, und eine Gruppennachricht verschwindet. Die Fragen lauten: Was wurde vor und nach der Änderung beobachtet, welche Telegram- Konten haben die einzelnen Einträge gepostet, wo erschien das Ziel, welche Bytes der Anhänge wurden erhalten und welche Zeitintervalle bleiben unbekannt? Alle Namen, IDs, Zeitangaben und Verweise auf das Protokoll in diesem Beispiel sind fiktiv. Der Arbeitsablauf nutzt aktuelle Funktionen; die Fallübersicht dient lediglich der Veranschaulichung und ist kein automatischer , von der Anwendung generierter Graph. Ablaufdiagramm · Kanäle → Arbeitsbereichsprotokoll; Gruppen → Arbeitsbereichsprotokoll; Private Chats → Arbeitsbereichsprotokoll; Bots → Arbeitsbereichsprotokoll; Arbeitsbereichsprotokoll → Alle Quellen durchsuchen; Arbeitsbereichsprotokoll → Personenprofile mit Verweisen auf die entsprechenden Aufzeichnungen; Arbeitsbereichsprotokoll → Gespeicherte Versionen und Empfangsbestätigungen für Anhänge; Alle Quellen durchsuchen → Chronologie der Analysten und Quellenverzeichnis; Personenprofile mit Verweisen auf die entsprechenden Aufzeichnungen → Chronologie der Analysten und Quellenverzeichnis; Gespeicherte Versionen und Empfangsbestätigungen für Anhänge → Chronologie der Analysten und Quellenverzeichnis; Arbeitsbereichsprotokoll → Signierte Beweisdatei im ZIP-Format; Chronologie der Analysten und Quellenverzeichnis → Fallübergabe mit separat verifizierten Beweismitteln; Signierte Beweisdatei im ZIP-Format → Fallübergabe mit separat verifizierten Beweismitteln · Kanäle · Gruppen · Private Chats · Bots · Arbeitsbereichsprotokoll · Alle Quellen durchsuchen · Personenprofile mitVerweisen auf dieentsprechendenAufzeichnungen · Gespeicherte Versionen undEmpfangsbestätigungen fürAnhänge · Signierte Beweisdatei imZIP-Format · Chronologie der Analystenund Quellenverzeichnis · Fallübergabe mit separatverifiziertenBeweismitteln **Diagramm als Text** 1. Kanäle → Arbeitsbereichsprotokoll 2. Gruppen → Arbeitsbereichsprotokoll 3. Private Chats → Arbeitsbereichsprotokoll 4. Bots → Arbeitsbereichsprotokoll 5. Arbeitsbereichsprotokoll → Alle Quellen durchsuchen 6. Arbeitsbereichsprotokoll → Personenprofile mit Verweisen auf die entsprechenden Aufzeichnungen 7. Arbeitsbereichsprotokoll → Gespeicherte Versionen und Empfangsbestätigungen für Anhänge 8. Alle Quellen durchsuchen → Chronologie der Analysten und Quellenverzeichnis 9. Personenprofile mit Verweisen auf die entsprechenden Aufzeichnungen → Chronologie der Analysten und Quellenverzeichnis 10. Gespeicherte Versionen und Empfangsbestätigungen für Anhänge → Chronologie der Analysten und Quellenverzeichnis 11. Arbeitsbereichsprotokoll → Signierte Beweisdatei im ZIP-Format 12. Chronologie der Analysten und Quellenverzeichnis → Fallübergabe mit separat verifizierten Beweismitteln 13. Signierte Beweisdatei im ZIP-Format → Fallübergabe mit separat verifizierten Beweismitteln ## 1. Definieren Sie den Fall und erfassen Sie den gesamten Sachverhalt 1. Verbinden Sie das Erfassungskonto in einem eigenen Arbeitsbereich. Erfassen Sie im [Case Board](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/) oder in Ihrem Fallregister die Fallreferenz, die Konto-ID, den Arbeitsbereich und den Beginn der Beobachtung. Bewahren Sie den Fingerabdruck des vertrauenswürdigen Signaturschlüssels separat auf. 2. Für ein spezielles Erfassungskonto öffnen Sie **Weitere Tools → Quellen → Umfang → Untersuchungsmodus**. Die Voreinstellung wählt **Gesamtes Konto**, Kanäle/Gruppen/private Chats/Bots, eigene Aktionen, Quellenprofile sowie die letzten 200 sichtbaren Nachrichten für neu entdeckte Quellen aus. Überprüfen Sie die Auswahl, klicken Sie auf **Umfang speichern** und schließen Sie die Bestätigung des Umfangs ab. Hauptkonten verwenden ausgewählte Chats oder einen Ordner; die Erfassung des gesamten Kontos steht Konten zur Verfügung, die für Untersuchungen markiert sind. 3. **Laden Sie Chats** und vergleichen Sie die Quellen mit der Dialogliste des Kontos. Überprüfen Sie Ausschlüsse. **Weitere Tools → Parameter → Die Anzahl der aus der Kontoliste gelesenen Chats** ist standardmäßig auf 1,000 gesetzt und erlaubt bis zu 20,000. Quellen, die über das Listenlimit hinausgehen, werden hinzugefügt, sobald sie aktiv werden. Zeichnen Sie auf, was tatsächlich aufgelistet wurde. 4. Wählen Sie unter **Weitere Tools → Quellen → Aufzeichnung** **die Option Alle sichtbaren Aktivitäten** aus und speichern Sie die Überwachungseinstellungen. Überprüfen Sie die Anhangstypen/Limits und den freien Speicherplatz. 5. Beobachtung starten. Überprüfen Sie eine kontrollierte neue Nachricht, eine Bearbeitung und eine Löschung und speichern Sie anschließend die Testreferenzen sowie etwaige Fehler. Der Umfang Gesamtes Konto erfasst für das Konto sichtbare Aktivitäten innerhalb der gespeicherten Einstellungen in den Chats, denen das Konto beigetreten ist. Geheime Chats werden vom [Modul Geheimer Chat](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/) aufgezeichnet, und bestehende Unterhaltungen werden über [den Verlauf](https://phishdestroy.io/tgwitness/de/docs/reference/history/) nachträglich erfasst. Siehe [Erfassungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account). ## 2. Erfassen Sie alle Quellen und ermitteln Sie den historischen Kontext Führen Sie ein Quellenverzeichnis mit einer Zeile pro Chat: | Fachgebiet | Aufzeichnen | | --- | --- | | Identität | Arbeitsbereich, Konto-ID, numerische Chat-ID, Titel und Typ | | Sichtbarkeit | Mitgliedschaft/Rolle, bestätigter oder unbestätigter Zugriff, Ausschlüsse | | Live-Erfassung | Startzeitpunkt, ausgewählte Ereignistypen und spätere Richtlinienänderungen | | Verlauf des Protokolls | Angeforderte/fertiggestellte Momentaufnahmen, Begrenzung, Zeitangaben und Verweise auf Aufzeichnungen | | Vollständiger Verlauf | Signierter Dateiname für den Export pro Chat, Begrenzung sowie Abschluss/Fehlschlag | | Anhänge | Vollständige Medienbelege, Hashes, Dateigrößen sowie Ergebnisse zu übersprungenen bzw. fehlgeschlagenen Vorgängen | | Umfang | Ausfälle, unvollständige Erfassung, „FloodWait“, nicht verfügbare Nachrichten und andere Lücken | Verwenden Sie für jede Quelle die geeignete Erfassungsmethode: - **Das Laden des vollständigen Verlaufs** unter **Weitere Tools → Quellen → Chats im Umfang** lädt verfügbare vergangene Nachrichten aus aktivierten Quellen in das Arbeitsbereichsjournal. Es unterstützt das Anhalten/Fortsetzen sowie einen signierten Fortschrittsbericht. Siehe [Verlaufserfassung](https://phishdestroy.io/tgwitness/de/docs/reference/history/). - **Der Verlaufs-Snapshot** speichert die zuletzt sichtbaren Nachrichten im Beobachtungsprotokoll. Der Standardwert liegt bei 500; unter **Weitere Tools → Parameter → Größter Verlaufs-Snapshot** kann dieser Wert auf 10,000 erhöht werden. Dabei handelt es sich um aktuelle Verlaufsbeobachtungen, nicht um rekonstruierte Bearbeitungen. - **Exporte → Einen Chat erfassen oder exportieren → Gesamten Chat exportieren** oder **Chats → Chat exportieren** ruft den derzeit sichtbaren Verlauf eines Chats in ein separates, signiertes `chat.json`-/ `chat.html`-Paket ab. Wiederholen Sie dies für die Quellen des Falls und bewahren Sie jedes Ergebnis auf. - **Wenn ein neuer Chat oder Bot erscheint,** können dessen Profil und bis zu 1.000 der letzten Nachrichten gespeichert werden; im Untersuchungsmodus werden 200 ausgewählt. Bestehende Chats erhalten diese Aufzeichnung nicht rückwirkend, wenn der Modus aktiviert wird. - **Das Herunterladen sichtbarer Anhänge** bewahrt die Byte-Anzahl gemäß der konfigurierten Richtlinie. Erforderlich ist eine vollständige „`media.saved`“-Quittung mit SHA-256 und Byte-Angabe. Ein in der Warteschlange befindlicher Auftrag, eine Miniaturansicht oder ein Dateiname gilt nicht als bewahrter Anhang. Ein vollständiger Chat-Export füllt das Protokoll oder die Personenprofile **nicht** mit allen darin enthaltenen Nachrichten. Verwenden Sie**„Vollständigen Verlauf laden“** oder begrenzte Protokoll-Snapshots für den Verlauf, den Sie innerhalb von TgWitness analysieren möchten. Überprüfen Sie die Liste der aktivierten Quellen, bevor Sie einen Verlaufslauf starten. Keine der beiden Methoden stellt Material wieder her, das Telegram nicht mehr zurückgibt. ## 3. Erfassung des sich entwickelnden Sachverhalts und der bewussten Interaktionen Markieren Sie Chats zu aktiven Fällen als vorrangige Quellen. Überprüfen Sie die Intervalle für erneute Überprüfungen, die fortlaufende Nachverfolgung und die Ergebnisse der Medienauswertung. Lassen Sie den Collector während der Nutzung des Kontos weiter beobachten. Verwenden Sie **„Chats“ → „Profil“ → „Profil jetzt speichern“,** um Metadaten der Quelle wie Beschreibungen und Bot-Befehle zu erhalten. Dies ist unabhängig von Personenprofilen, die aus gespeicherten Nachrichten abgeleitet werden. Wenn es in dem Fall darum geht, einer Quelle zu folgen oder mit einem Bot zu interagieren: 1. **Telegram-Link öffnen → „Vorschau speichern“** zeichnet den angegebenen Link und die angezeigte Vorschau vor einer Aktion auf. 2. **„Join / open and observe“** führt den Beitritt/das Öffnen durch und sendet den Startparameter eines Bots, sofern dieser angegeben wurde. Eine zur Genehmigung anstehende Beitrittsanfrage wird als „pending“ (ausstehend) protokolliert. 3. Vom Bedienfeld ausgegebene Textantworten und unterstützte Tastenbetätigungen behalten „ `interaction.requested`“ und „`interaction.result`“ bei. Rückrufbestätigungen können den zurückgegebenen Popup-Text, den Alarmstatus und die URL beibehalten. Es handelt sich hierbei um echte Kontoaktivitäten. Callback-Aufrufe in einer anderen Telegram-App sind für den Erfasser nicht sichtbar, obwohl die daraus resultierenden Nachrichten oder Bearbeitungen möglicherweise sichtbar sind. Der Mini-Client führt keine Web-App-, Zahlungs-, Telefon- oder Standort-Workflows durch. Das genaue Verhalten entnehmen Sie bitte [den Panel-Interaktionen](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#act-from-the-panel). ## 4. Verknüpfung von Beobachtungen über verschiedene Chats hinweg Wählen Sie im **Protokoll „Alle Quellen**“ aus und durchsuchen Sie die aufgezeichneten Inhalte. Öffnen Sie die entsprechenden Einträge und notieren Sie sich den Arbeitsbereich, den Chat, die Nachrichten-ID, die Reihenfolge und den Datensatz-Hash. Öffnen Sie in einem entsprechenden Chat **„Personen**“**→ „Profile aktivieren**“ und überprüfen Sie eine Person: - Im Laufe der Zeit erfasste Namen/Benutzernamen sowie die numerische Telegram-ID. - Antwortbeziehungen mit Verweisen auf die Quelldatensätze. - **Ebenfalls enthalten sind …** andere Chats in diesem Arbeitsbereichsprotokoll, in denen diese ID geschrieben hat. - Aktivitäten, Bearbeitungen/Löschungen sowie erwähnte Wallets, Telefone, Benutzernamen und Links. - Gespeicherte Avatar-Metadaten und ähnliche zwischengespeicherte Avatare mit Angabe ihrer jeweiligen Herkunft. Öffnen Sie die zitierten Datensätze, bevor Sie ein abgeleitetes Profil in einer Feststellung verwenden. Profile umfassen Personen mit gespeicherten Nachrichten, nicht jedes Mitglied der Gruppe. **Weitere Tools → Parameter → Pro Fakt zitierte Datensätze**begrenzt die Referenzliste, nicht die zugrunde liegende Anzahl der Aktivitäten. Erwähnungen und Avatar-Ähnlichkeit sind Anhaltspunkte; Eigentumsverhältnisse und Identität beruhen auf numerischen IDs und zugeordneten Absendern. Das signierte Dossier trennt Encoder-Hinweise aus weitergeleiteten und wiederverwendeten Dateien in `clients.forwarded` und `clients.reused` auf. Solche Dateien fließen nicht in `clients.observed` oder die Liste `media_timing.pre_existing` ein. Eine wiederverwendete Datei bedeutet, dass dieselbe Telegram-Dokument-ID zuvor in einer anderen Nachricht in diesem Journal innerhalb der für den Leser zugelassenen Chats beobachtet wurde. Der erste beobachtete Eintrag wird angeführt; eine weitere Beobachtung oder Bearbeitung derselben Nachricht gilt nicht als Wiederverwendung. Der Abschnitt `paid_reactions` des Dossiers enthält die aktuellste verfügbare „Stars“-Rangliste für jede aufgeführte Nachricht, einschließlich Quelldatensätzen und Anonymitätskennzeichnungen. Es handelt sich hierbei um Momentaufnahmen der Zählstände, nicht um die Summe zusätzlicher Zahlungen oder eine vollständige Liste der Personen, die reagiert haben. Eine Momentaufnahme ohne Rangliste liefert keine Ersatzliste. Der Abschnitt meldet ausgelassene Nachrichten, wenn die Anzeigegrenze erreicht ist. Beobachtungslisten und Indikator-Exporte überprüfen Schaltflächenbeschriftungen, URLs, Kopiertexte, Inline- Abfragen und Callback-Bytes, die als gültiges UTF-8 dekodiert werden. Ungültige oder übergroße Callback-Kodierungen werden bei der Textextraktion übersprungen; die ursprünglichen Bytes verbleiben im gespeicherten Datensatz. Bestehende Beobachtungslisten müssen erneut gescannt werden, um ältere Datensätze mit diesen zusätzlichen Feldern zu überprüfen. Bei der Überprüfung wird die Schaltfläche nicht betätigt. Im Beispiel: | Link | Aufzeichnungen | Unterstützte Beobachtung | | --- | --- | --- | | Derselbe Absender-Account | Gruppe Nr. 146 und privater Folgebeitrag Nr. 205 | Beide geben die Telegram-Absender-ID 71001 an | | Gleiche Zieladresse | #146, Bot-Tastatur #173, Kanalbearbeitung #188, private Nachricht #205 | Alle enthalten `pay.example.invalid/new`; ein wiederholtes Ziel verlinkt das Material | | Dieselbe gespeicherte Datei | Medienbelege Nr. 151 und Nr. 209 fertiggestellt | Die vollständigen SHA-256-Werte stimmen für die gespeicherten Bytes überein | | Angabe der Kanalquelle | #101 und #188 | Ordnen Sie einen Kanalbeitrag nicht dem Nutzer 71001 zu, ohne dass ein Absender angegeben ist. | Vergleichen Sie die Hashes der Anhänge mit den zugehörigen Nachrichtenreferenzen und gruppieren Sie die Zeitleisten der Konten nach den in diesen Datensätzen angegebenen Telegram-IDs. Bewahren Sie die Arbeitsnotizen des Teams auf [dem](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/) [Case Board](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/) auf: Setzen Sie Lesezeichen für die Datensätze, auf die Sie sich stützen, wie z. B. #146, #188 und #205, markieren Sie die genaue Zielzeichenfolge und speichern Sie einen Ausschnitt jeder aufgezeichneten Aktion zwischen zwei Datensätzen oder in einem Zeitbereich. Notizen und Statusangaben bewahren die Überprüfung durch das Team in einem eigenen, signierten Verlauf auf, der von den Beobachtungen der Quelle getrennt identifizierbar ist. ## 5. Erstellen Sie die chatübergreifende Zeitleiste Verwenden Sie die gespeicherten Versionen in **Chats** und deren Links **zum Protokoll-Eintrag Nr. …** . Kombinieren Sie im **Protokoll alle Quellen** mit **Bearbeitungen**, **Löschungen** und **der Berichterstattung**. Behalten Sie sowohl `source_at`, sofern vorhanden, als auch `observed_at` bei. | Beispielhafte Beobachtungsdauer | Referenz | Anmerkung | | --- | --- | --- | | 09:00 | Kanal #101 | Ursprüngliches Ziel erfasst | | 09:12 | Gruppe #146; Medien #151 | Neues Ziel veröffentlicht; Dateidownload abgeschlossen | | 09:16 | Bot Nr. 173 | Die Tastatur zeigt auf das neue Ziel | | 09:20 | Kanal Nr. 188 | Ankündigung bearbeitet; beide gespeicherten Versionen bleiben erhalten | | 09:24 | Privat #205; Medien #209 | Die gleiche Absender-ID wiederholt sich im Empfängerfeld; die gleichen Dateibyte bleiben erhalten | | 09:28 | Gruppe Nr. 231 | Löschmeldung erhalten; Löschender und genauer Zeitpunkt der Löschung unbekannt | Zwischen diesen Beispielverweisen liegen weitere Aufzeichnungen vor. Sequenznummern ordnen Beobachtungen; Verlaufs-Snapshots können ältere Quelldaten enthalten und später eintreffen als Live-Ereignisse. Unterscheiden Sie zwischen Snapshots, wiederhergestellten Nachrichten, Löschmeldungen und Ergebnissen, bei denen bei einer erneuten Überprüfung keine Daten mehr vorhanden sind. Kennzeichnen Sie Lücken in der Erfassung als unbekannte Intervalle. Eine spätere Erfassung von Verlaufsdaten begründet nicht rückwirkend eine lückenlose Beobachtung. ## 6. Fügen Sie Konto-Perspektiven hinzu, ohne deren Herkunft zu verlieren Verwenden Sie für jedes einzelne Konto einen separaten Arbeitsbereich und wiederholen Sie dessen Bestandsaufnahme. Bewahren Sie bei jedem Vergleich die Konto-ID, die Rolle, den Fingerabdruck des Signaturschlüssels und die Quellenangaben auf. Nachrichtennummern sind keine globalen Identifikatoren, die über Chats und Konten hinweg gelten. „Case Board“ verwaltet quellverknüpfte Notizen und Sammlungen innerhalb jedes Arbeitsbereichs. Auf dem Gruppenbildschirm wird der Kontostatus gemeinsam überprüft, und es können separate Arbeitsbereichs-Exporte gebündelt werden. Korrelieren Sie diese Quellen in Ihren Fallnotizen oder Analyse-Tools; jedes Protokoll behält seine eigene Herkunft und seinen eigenen Signaturschlüssel bei. Eine globale Suche oder eine zusammengeführte, arbeitsbereichsübergreifende Zeitleiste wird nicht generiert. Der Export mehrerer Konten eines Kanals/einer Supergruppe erfasst den Verlauf dieses Chats unter Verwendung der berechtigten Konten. Bei umfangreicheren Projekten sollten Sie die Grenzen durch einen [unabhängigen Zeugen](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) wahren. Verwenden Sie kontrollierte Zustellungsprüfungen, um den Erfassungsweg und die Sichtbarkeit jedes Kontos zu überprüfen. ## Wiederveröffentlichung von Medien und Weiterleitungsquellen In den Auswertungsberichten werden Telegram-Dokument-IDs und SHA-256-Hashes aus den Datensätzen zu gespeicherten Dateien separat verglichen. Sie zeigen einzelne Nachrichten, Chats sowie das erste und letzte gespeicherte Vorkommen an, ergänzt durch eine erweiterbare Zeitleiste der Beobachtungen im HTML-Format. Wiederholte Momentaufnahmen oder Bearbeitungen derselben Nachricht erhöhen die Vorkommensanzahl für denselben Schlüssel nicht. Eine andere Datei in einer bearbeiteten Nachricht behält ihr eigenes Vorkommen bei. „Erstmals beobachtet“ folgt der Reihenfolge der Zeitschriften innerhalb der Berichtsauswahl. Es handelt sich dabei nicht um die früheste Veröffentlichung auf Telegram. Telegram-Dokumente werden anhand ihrer Dokument-IDs identifiziert; SHA-256 vergleicht gespeicherte Bytes. Übereinstimmende 64-Bit-dHashes verschiedener gespeicherter Bilder werden als visuelle Hinweise angezeigt; dieser Vergleich verwendet gleiche Hashes, keine Nächsten-Nachbar-Suche. Bildbytes müssen vor der dHash-Analyse mit ihrem gespeicherten SHA-256 übereinstimmen; Dateien über 64 MiB und Bilder mit mehr als 40 Millionen Pixeln werden übersprungen. Zusammenfassungen auf der Absenderseite zählen einzelne Zielnachrichten. Peer-IDs in den Headern, versteckte Namen, Signaturen der Verfasser und der Kontext der gespeicherten Nachrichten bleiben getrennt. Das JSON-Profil einer Person enthält die Quellen jedes Absenders; Kanalbeiträge erscheinen ebenfalls in der Zusammenfassung auf Chat-Ebene. Eine benannte Quelle ohne Peer-ID ist eine Textgruppe, keine identifizierte Person. Header importierter Chats bleiben als importiert gekennzeichnet. Zu den nicht kompakten Beweis-ZIP-Dateien gehören `media-repeats.json`, `forward-sources.json` und `observed-sources.gexf`, die durch das Archiv-Manifest geschützt sind. Der GEXF-1.3-Graph verfügt über typisierte `forwarded_from`- und `recommended`-Kanten. Die Pfeile verlaufen vom beobachteten Chat zum referenzierten Peer. Empfehlungsgewichte zählen gespeicherte Empfehlungsbeobachtungen; Weiterleitungsgewichte zählen eindeutige Nachrichten. Versteckte Namen und importierte Header erzeugen keine Identitätskanten. Keine Graphoperation löst Profile auf oder ruft Telegram auf. Zu den Metadaten der Kanten gehören Quellsequenzen und Hashes. Die Zusammenfassungen folgen der Auswahl des Berichts; die ZIP-Datei mit den Nachweisen enthält weiterhin das vollständige signierte Protokoll. Eine Auswahl, die ausschließlich Nachrichtenereignisse enthält, vergleicht Dokument-IDs; Vergleiche von gespeicherten Bytes und Bildern erfordern Ereignisse zum Speichern von Dateien im ausgewählten Datenstrom. Die aktuelle Auswahl der Cloud-Nachrichten schließt `media.saved` aus. Die Grenzwerte sind explizit festgelegt: 200.000 beibehaltene Schlüssel-/Nachrichten- Vorkommen pro Analyse, 100.000 Medienschlüssel, 20 Berichtsgruppen, 100 Chronologie- Verweise pro Gruppe und 1.000 exportierte Diagrammkanten. Wenn eine Vergleichsgrenze erreicht ist, zeigen die Ergebnisse ausgelassene Vorkommen an, und die Zählwerte werden zu unteren Grenzwerten. Grenzwerte für die Chronologie- und Diagrammdarstellung werden separat gemeldet. Kompakte ZIP-Dateien lassen diese abgeleiteten Zusammenfassungen weg. Die signierten Quelldatensätze bleiben unverändert. ## 7. Zusammenstellung und Überprüfung der Fallübergabe Fassen Sie diese Informationen in einem von einem Analysten zusammengestellten Fallverzeichnis zusammen: | Material | Zweck | | --- | --- | | Fallnotizen und Quellenverzeichnis | Fragen, Erfassungsrichtlinien, Zugriffsrechte/Rollen, Ergebnisse, alternative Erklärungen und Lücken | | Zeitleiste | Angaben zu Zeitpunkten sowie Verweise auf Arbeitsbereich, Chat, Nachricht und Sequenz für jeden Eintrag | | Case Board Export und Ausschnitte, falls verwendet | Quellenverknüpfte Lesezeichen, Zitate, Teamnotizen, Sammlungen, Revisionsverlauf und ausgewählte Datensätze, die mit der ZIP-Datei der Beweismittel abgeglichen wurden | | Signierte Beweisdatei im ZIP-Format pro Arbeitsbereich | Vollständiges Protokoll, Manifest und enthaltene, gesicherte Medien; Filterfelder schränken den Protokollexport nicht ein | | Separat signierte Personenprofil-Dateien | Abgeleitete Referenzen wurden anhand der entsprechenden Beweismittel im Arbeitsbereich überprüft | | Signierte vollständige Chat-Exporte | Erfassung des aktuell sichtbaren Verlaufs, getrennt vom Beobachtungsprotokoll | | Vertrauenswürdige Fingerabdrücke, TSA-Stammzertifikate und frühere Checkpoints | Schlüsselidentität, externe Zeit des letzten Datensatzes und beibehaltene Journalgrenzen | | Witness-Artefakte, sofern konfiguriert | Separates Protokoll, signierte Einträge und Witness-Fingerabdruck | | Verifizierungsergebnisse und Hashes der bereitgestellten Dateien | Was wurde überprüft, welche Bytes wurden übertragen und an wen? | Aus einer vertrauenswürdigen Installation, mit Dateinamen und dem tatsächlichen Fingerabdruck jedes Arbeitsbereichs: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` `--require evidence` beendet die Ausführung mit dem Code 2, es sei denn, der Fingerabdruck stimmt überein und die externe Zeitangabe eines Drittanbieters deckt den letzten Datensatz ab; der Checkpoint dient als unterstützende Überprüfung. Behalten Sie die tatsächlichen Verifizierungsergebnisse und Originalartefakte bei. Exportieren Sie Arbeitsbereichsnotizen aus dem Case Board zusammen mit dem zitierten Quellenmaterial. Stellen Sie arbeitsbereichsübergreifende Ergebnisse im obersten Fallverzeichnis zusammen; jedes TgWitness-Artefakt verfügt über eine eigene Signatur und ein eigenes Verifizierungsverfahren. ## Passen Sie die Untersuchung an | Fall | Trace | Liefern | | --- | --- | --- | | Bot-gesteuerte Streitigkeiten bezüglich Bestellungen/Zahlungen | Ankündigung des Eintrags → Vorschau des gespeicherten Links → Startparameter des Bots → Nachrichten- und Tastaturversionen → Rückmeldebestätigungen über das Panel → Nachverfolgung in privaten Chats und Gruppen | Beobachtete Zeitachse von Angebot und Antwort sowie verifizierte Quellen; die Zahlungsbestätigung stammt aus dem Zahlungsdatensatz | | Gelöschte Nachrichten nach einem Vorfall | Alle betroffenen Chats → gespeicherte Originale/Bearbeitungen → Ergebnisse bei Löschung oder Fehlen bei erneuter Überprüfung → erhaltene Medien → Berichterstattung und andere Perspektiven des Kontos | Gespeicherte Versionen und explizit angegebene unbekannte Zeitintervalle; keine fiktiven Löschakteure | | Ein Teilnehmer verwendet in verschiedenen Chats unterschiedliche Namen | Numerische Absender-ID → Name/Benutzername im Verlauf → Antworten → andere beobachtete Chats → zitierte Ziele/Dateien | Eine Zeitleiste der Aktivitäten eines Telegram-Kontos mit Links zu den entsprechenden Quelldatensätzen | [Referenz zur Sammlung](https://phishdestroy.io/tgwitness/de/docs/reference/collection/) · [Überprüfung von Personenprofilen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#people-profiles) · [Übergabe von Beweismitteln](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#investigation-handoff) · [Validierung abgeschlossen](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) --- # Telegram · Funktionen und Umfang Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/features/ Das aktuelle Erfassungsmodell, Workflows für mehrere Konten, Exporte und operative Grenzen von TgWitness. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Das aktuelle Erfassungsmodell, Workflows für mehrere Konten, Exporte und operative Grenzen von TgWitness. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Projektreferenz](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Projektreferenz](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561) TgWitness sichert Telegram-Konversationen, auf die verbundene Konten Zugriff haben, erfasst festgestellte Änderungen und erstellt überprüfbare Exporte. Diese Referenz beschreibt das Erfassungsmodell, aktuelle Arbeitsabläufe und deren Grenzen. **Auf dieser Seite** - [Standalone-Anwendung](https://phishdestroy.io/tgwitness/de/docs/reference/features/#standalone-application) - [Gemeinsame Untersuchungen](https://phishdestroy.io/tgwitness/de/docs/reference/features/#shared-investigations) - [Archivierungswerkzeuge](https://phishdestroy.io/tgwitness/de/docs/reference/features/#archive-tools) - [Optionale Extras](https://phishdestroy.io/tgwitness/de/docs/reference/features/#optional-extras) - [Protokoll und private Quellen](https://phishdestroy.io/tgwitness/de/docs/reference/features/#protocol-and-private-sources) - [Mehrere Konten](https://phishdestroy.io/tgwitness/de/docs/reference/features/#multiple-accounts) - [Erfassung und Zuordnung](https://phishdestroy.io/tgwitness/de/docs/reference/features/#capture-and-attribution) - [Kapazität und Telegram-Beschränkungen](https://phishdestroy.io/tgwitness/de/docs/reference/features/#capacity-and-telegram-limits) - [Zuverlässigkeit und Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/reference/features/#reliability-and-recovery) - [Beweismodell](https://phishdestroy.io/tgwitness/de/docs/reference/features/#evidence-model) - [Export, Bereitstellung und Übergabe](https://phishdestroy.io/tgwitness/de/docs/reference/features/#export-deployment-and-handoff) - [Kriterien für stabile Veröffentlichungen](https://phishdestroy.io/tgwitness/de/docs/reference/features/#stable-release-criteria) ## Eigenständige Anwendung TgWitness verfügt über eine eigene Installation, ein eigenes Datenverzeichnis und einen eigenen Release-Zyklus. Die mitgelieferte Weboberfläche übernimmt die Einrichtung und Überprüfung; exportierte Datensätze können eigenständig verwendet werden. Der Betreiber verbindet seine Konten, wählt die für jedes Konto sichtbaren Quellen aus und erhält ein gespeichertes Beobachtungsprotokoll. Das Dashboard zeigt Inhalte, gespeicherte Änderungen, die Herkunft der Beobachtungen sowie bekannte Lücken an. Ein anderer Ermittler kann das exportierte Material überprüfen. Das Panel unterscheidet zwischen Kontoautorisierung, Zugriff auf eine Quelle, Collector-Aktivität und erfasster Abdeckung. Überprüfen Sie diese Zustände gemeinsam, wenn Sie ein Intervall mit wenigen Nachrichten oder ein Verbindungsproblem bewerten. ## Gemeinsame Ermittlungen Ein Administrator kann [Zugriffstoken](https://phishdestroy.io/tgwitness/de/docs/reference/access/) ausstellen, [die](https://phishdestroy.io/tgwitness/de/docs/reference/access/) auf Arbeitsbereiche und einzelne Chats beschränkt sind, mit Berechtigungen pro Aktion, IP-Einschränkungen, Ablaufdaten, Anmeldebeschränkungen und Sitzungskontrolle. Ein Prüfer mit Lesezugriff kann einen Fall einsehen, ohne die Telegram-Autorisierung oder den Schlüssel für das Hauptfenster zu erhalten. Der auf Chats beschränkte Zugriff bleibt getrennt von kontoweiten Einstellungen und vollständigen Journal-Exporten. Automatic MTProxy unterhält funktionierende Telegram-Routen aus vier öffentlichen Quellen oder einem Betreiberkatalog. [IP-Modi](https://phishdestroy.io/tgwitness/de/docs/reference/connection/#ip-modes) legen fest, ob bei einem Ausfall auf einen anderen Proxy gewartet werden muss oder eine ausdrücklich zugelassene direkte Route genutzt werden darf. Externe HTTP-Anfragen verfügen über eine separate Route und einen Deaktivierungsschalter. ## Archivierungstools [Die Erfassung des Verlaufs](https://phishdestroy.io/tgwitness/de/docs/reference/history/), [die Archivsuche und -analyse](https://phishdestroy.io/tgwitness/de/docs/reference/analysis/), [ein schreibgeschütztes MCP](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/), [lokale OCR/Transkription](https://phishdestroy.io/tgwitness/de/docs/reference/media-analysis/) sowie [ausgehende Webhooks](https://phishdestroy.io/tgwitness/de/docs/reference/webhooks/) sind seit Version 0.7.1 enthalten. Analytische Berichte und erkannter Text bleiben getrennt von den erfassten Ereignissen. [„Case Board“](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/) fügt quellverknüpfte Lesezeichen, Zitate, Notizen und Sammlungen innerhalb eines Arbeitsbereichs hinzu. Der [Berichtskonstruktor](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/) wählt Material, Abschnitte und eines von acht Designs für unterstützte HTML-/PDF-Exporte aus. ## Optionale Zusatzfunktionen Die alltägliche Einrichtung erfolgt über Konto → Quellen → Beobachtung. **Weitere Tools → Extras** ist ein separater Bereich für unabhängige Erfassung, Speicherung, Ziel- und Schutzstufen, Benachrichtigungen, Beweismittel und Backups, einen ständig aktiven Server, einen Telegram-Zeugen-Bot und eine Code-Prüfung. Jedes Tool gibt seine Verfügbarkeit und Anforderungen an, bevor die Einstellungen angezeigt werden. Das Auswählen einer Karte öffnet Anweisungen; es erfolgt dadurch keine Registrierung oder Aktivierung eines Dienstes. Die Bot-Einrichtung umfasst drei Schritte: Erstellen eines Lesezugriffs, Auswählen der Veröffentlichungseinstellungen und Starten auf dem Witness-Host. Netzwerk- und Veröffentlichungsoptionen, bestehende Verbindungen und Verifizierungsbefehle werden auf Anfrage angezeigt. Die heruntergeladene Konfiguration unterscheidet sich von einem laufenden Witness. Beim Wechseln von Extras bleibt der Entwurf erhalten; Kontoänderungen und das Sperren löschen das temporäre Token und das Formular. Die integrierte Anleitung enthält Anweisungen zum Starten. [GitHub Actions Capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md), das über Exports geöffnet wird, startet einen angehefteten Collector aus Ihrem Fork, erfasst einen Chat und erzeugt eine verschlüsselte Übergabe mit Workflow-Herkunftsnachweis. ## Protokoll und private Quellen **MTProto ist das Protokoll von Telegram; Telethon ist die Python-Bibliothek, die TgWitness verwendet, um MTProto zu nutzen.** Es handelt sich dabei nicht um alternative Verbindungsmethoden. Die Datenerfassung erfolgt über MTProto; der optionale „Witness“ veröffentlicht signierte Prüfberichte über die Bot-API. Jeder Arbeitsbereich verfügt über einen eigenen autorisierten Client und einen eigenen Aktualisierungsstrom für das Konto. TgWitness wählt Beobachtungen aus konfigurierten Quellen aus und stellt separate, explizite Anfragen für Funktionen wie Verlaufs-Snapshots und Medien-Downloads. Eine private Quelle benötigt keinen öffentlichen Benutzernamen. Der Telegram-Peer-Typ und die numerische ID sind die Identifikatoren; Titel und Benutzernamen können sich ändern. Der Zugriff hängt von der bestehenden Mitgliedschaft und den Berechtigungen ab. TgWitness tritt Quellen nicht automatisch bei und umgeht auch nicht die Beitrittsgenehmigung. Ein Zugriffshash von einem anderen Konto ist kein universelles Zugriffstoken. Das Erfassungsmodell muss versteckte Verlaufsdaten vor dem Beitritt, Teilnehmer- und Administratorrollen, den Widerruf von Sitzungen, die Entfernung oder Änderung von Berechtigungen, die Migration von Gruppen zu Supergruppen, Themen und Foren, verknüpfte Diskussionen, Kanalidentitäten sowie nicht verfügbare Anhänge berücksichtigen. Nicht jede Kombination wurde bereits in der Praxis getestet. Die Sichtbarkeit der Quellen wird beim Start des Collectors überprüft. Fehlt eine Quelle aus dem begrenzten Dialogergebnis, bedeutet dies, dass **der Zugriff nicht bestätigt ist**, nicht jedoch, dass eine Entfernung nachgewiesen wurde. Eine nicht verfügbare Quelle verhindert nicht die Beobachtung anderer zugänglicher Quellen. Fügen Sie niemals Einladungslinks oder echte Sitzungen in öffentliche Fixtures ein. ## Mehrere Konten Das Panel unterstützt eine beliebige Anzahl von **Arbeitsbereichen**, von denen jeder über folgende Merkmale verfügt: - Autorisierung, verschlüsselter Speicher und Verbindungsweg. - SQLite-Protokoll und Ed25519-Signaturidentität. - Ausgewählte Quellen, Medienwarteschlange und Erfassungseinstellungen. - Überwachungsstatus, Fehler, Kontrollpunkte und Exporte. Das Wechseln des angezeigten Arbeitsbereichs stoppt keinen anderen Collector. Eine doppelte Kontoautorisierung über verschiedene Arbeitsbereiche hinweg wird abgelehnt. Ein Protokoll, das bereits an ein Telegram-Konto gebunden ist, kann keinem anderen Konto zugewiesen werden; eine erneute Verbindung desselben Kontos ist jedoch zulässig. Dadurch bleiben die Kontoidentität und der relevante Nachrichten-ID-Bereich erhalten. Die Anwendung legt keine feste Anzahl von Arbeitsbereichen fest. Jeder Arbeitsbereich führt seine eigenen Collector- Aufgaben zur Verbindungsüberwachung, zum Herunterladen von Medien, zu Nachprüfungen und zur Erfassung neuer Chats innerhalb eines gemeinsamen Python-Prozesses und einer gemeinsamen Ereignisschleife aus. Der Durchsatz hängt von der Arbeitslast ab. Zur Prozessisolierung sollten separate Installationen, Ports und Datenverzeichnisse verwendet werden. Weisen Sie jedem Konto die Quellen zu, auf die es zugreifen kann. Verschiedene Konten können dieselbe Gruppe beobachten, doch ihre Beobachtungen bleiben getrennt und behalten ihre Herkunft bei. Zwei Konten auf einem vom Betreiber kontrollierten Rechner gelten nicht als zwei unabhängige Zeugen. **Der Export „Group“** bündelt die separat signierten ZIP-Dateien der Arbeitsbereiche mit einer signierten Dateiliste, die deren Arbeitsbereichs-IDs, Hashes und Fingerabdrücke der Signaturschlüssel enthält. Jedes Protokoll behält seine eigene Abgrenzung bei. Erstellen Sie eine kombinierte, arbeitsbereichsübergreifende Zeitleiste in Fallnotizen oder Analysetools, wobei diese Quellenverweise erhalten bleiben. ## Erfassung und Zuordnung Unter „Quellen“ stehen pro Konto Schaltflächen für neue Nachrichten, Bearbeitungen, Löschungen, Reaktionen und Mitgliedschaften zur Verfügung. Voreinstellungen behalten entweder alle Kategorien oder Nachrichten/Bearbeitungen/Löschungen bei. Die Richtlinie gilt für die ausgewählten Gruppen des Arbeitsbereichs, bleibt auch nach einem Neustart erhalten und wird mit den Änderungen vor und nach der Anpassung signiert. Standardmäßig werden alle Kategorien beibehalten. Das Deaktivieren einer Kategorie führt nicht zum Löschen alter Datensätze; das erneute Aktivieren stellt verpasste Ereignisse nicht wieder her. Betriebliche Aufzeichnungen, andere Gruppen-Service-Ereignisse und explizite Verlaufs-Snapshots sind separat. Erfasste Telegram-Objekte können eingebettete Metadaten beibehalten, unabhängig von den Schaltflächen für separate Aktualisierungen. Es gibt noch keine gruppenspezifischen Kategorie-Überschreibungen. | Material | Jetzt erfasst | Grenze | | --- | --- | --- | | Nachricht | Text, Peer-/Nachrichten-IDs, Metadaten des Absenders, Antworten und ursprünglicher Update-Envelope | Wird als für das Konto sichtbare Beobachtung gespeichert, die vom Erfasser signiert wurde | | Bearbeiten | Neu beobachtete Version, zuvor erfasste Versionen, Empfangszeit und angegebenes Bearbeitungsdatum | Nachrichtenaktualisierungen und verfügbare Admin-Log-Einträge behalten ihre jeweiligen Zuordnungsfelder bei. | | Löschung | Telegram-Benachrichtigung, Empfangszeit und zuvor erfasste Inhalte | Akteurs- und Quellaktionszeit werden beibehalten, sofern sie durch einen separaten Admin-Log-Eintrag bereitgestellt werden. | | Löschhinweis auf Kontoebene | Ursprünglicher Hinweis; zu den abgeschlossenen Datensätzen gehören der gespeicherte Chat und die Korrelationsmethode | Es muss genau eine zuvor gespeicherte Übereinstimmung aus einem privaten Chat oder einer normalen Gruppe im Umfang vorhanden sein; andere IDs bleiben „`deletion.unscoped`“. Kanal- und Supergruppen-IDs sind von dieser Korrelation ausgeschlossen. | | Reaktion | Ausgegebene Zählerstände und sichtbare aktuelle Identitäten | Eine vollständige Liste der verfügbaren Reaktoren erfordert separate Abfragen; Kanäle können Identitäten verbergen | | Mitgliedschaft | Service-Meldungen und zugestellte Teilnehmer-Updates | Die Sichtbarkeit hängt von der Rolle und dem Chat-Typ ab; die Mitgliedschaft wird anhand der übermittelten Ereignisse gemeldet. | | Administratoraktionen | Relevante bereitgestellte Updates und eine Momentaufnahme des Admin-Logs in den Exporten von Kanal-/Supergruppen-Chats | Der Export liest das Protokoll, sofern es für das exportierende Administratorkonto verfügbar ist | | Anhang | Beschreibung der Originalversion, heruntergeladene Bytes/SHA-256 und Ergebnisse der Versuche | Die Originalversion bleibt erhalten; eine spätere Version ersetzt sie nie | | Geschichte | Eindeutige Momentaufnahme der aktuell sichtbaren Nachrichten | Die Live-Aufzeichnung behält frühere Versionen und Löschmeldungen | | Erfassungsprozess | Start/Stopp, Heartbeat, Fehler, Einstellungen, Umfang und signierte Ausführungsbestätigung | Lokales Inventar; GitHub und TDX fügen [-unabhängige Umgebungsprüfungen hinzu](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) | Die Benutzeroberfläche nennt das im Quellereignis angegebene Konto und behält beobachtete Namen und Benutzernamen bei. Wenn im Ereignis der Akteur fehlt, bleibt dieses Feld im Bericht unbesetzt. ## Kapazität und Telegram-Beschränkungen Die Kapazität wird pro Bereitstellung bemessen. Sie hängt von der Spitzenanzahl an Ereignissen pro Sekunde, dem Volumen und der Größe der Anhänge, zusätzlichen RPCs, aktiven Konten, Festplattenlatenz/freiem Speicherplatz, Netzwerkbedingungen, Telegram-Limits, akzeptabler Verzögerung und Warteschlangentiefe ab. Telegram unterscheidet zwischen passiver Zustellung und aktivem Short-Polling. In der aktualisierten Dokumentation werden zusätzliche `updates.getChannelDifference`-Aufrufe für offene Kanäle/Supergruppen beschrieben und maximal **zehn gleichzeitig per Short-Polling abgefragte Quellen** empfohlen. Dies gilt für das Short-Polling; die Anzahl der ausgewählten Gruppen wird separat festgelegt. | Modus | Zweck | Status | | --- | --- | --- | | Standardbeobachtung | Erfassung der von ausgewählten Quellen übermittelten Aktualisierungen | Umsgesetzt | | Prioritätsüberprüfungen | Mit einem Stern markierte Quellen verwenden ihr eigenes konfigurierbares Intervall und haben bei jedem begrenzten Überprüfungsprozess Vorrang. | Implementiert mit Verlaufs- und Nachrichtenabfragen | Der Prioritätsstern steuert diese Nachprüfungen. Zusätzliche „`updates.getChannelDifference` “-Short-Polling-Abfragen werden nicht als separater Benutzermodus bereitgestellt. Beliebig häufiges Abfragen unter Ignorierung von FloodWait oder unter der Annahme linearer Kapazität durch zusätzliche Konten ist kein gültiges Dimensionierungsmodell. Die Standardgrenzen sind die ersten 1,000 aufgeführten Dialoge, bis zu 500 Nachrichten pro Verlaufs-Snapshot, 1–2,000 MiB pro gesammelter Datei je nach Typ und 4 GiB unkomprimierter signierter ZIP-Inhalt; diese werden pro Arbeitsbereich angepasst, Dateigrößen unter **Weitere Tools → Quellen → Aufzeichnung** und die übrigen unter **Weitere Tools → Parameter**. Exporte haben keine feste Obergrenze für die Anzahl der Ereignisse. Der Browser-Fallback ist standardmäßig auf 128 MiB begrenzt; die Streaming-CLI verfügt über ein konfigurierbares Übertragungslimit, standardmäßig 5 GiB. ## Zuverlässigkeit und Wiederherstellung Zu den implementierten Funktionen gehören SQLite-WAL/synchrone Transaktionen; atomare Schreibvorgänge für Nachrichten und Medienaufträge; persistente Aufträge und Wiederholungsverzögerungen; Deskriptoren für Originalversionen; begrenzte Wiederholungsversuche; persistentes „FloodWait“ für Medien; Medien-Downloads außerhalb der Netzwerkwartezeit des Text-Ereignisses; Exporte mit stabilem Präfix, während spätere Schreibvorgänge fortgesetzt werden; atomare Einstellungen und Prüfprotokolle; Beibehaltung der gültigen Autorisierung nach fehlgeschlagener Ersatzanmeldung; Isolierung eines beschädigten zusätzlichen Arbeitsbereichs; explizite Wiederverbindungsversuche; eindeutige Meldung von Autorisierungsverlusten; sowie Erkennung von Änderungen der Wanduhrzeit mithilfe einer monotonen Uhr. Die PTS/QTS/SEQ-Werte von Konten und Kanälen werden gespeichert und nach einem Neustart wiederhergestellt, und die überwachten Chats werden regelmäßig erneut überprüft; siehe [Beweisformat](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#durable-collection-and-process-receipts-02). Das regelmäßige Speichern der Position stellt keine atomare, verlustfreie Bestätigung der Protokollakzeptanz dar. Zu Beginn jedes Vorgangs werden der vorherige Kopf und die Offline-Grenze aufgezeichnet. Der aktuelle Verlauf wird nicht zur Lückenbehebung herangezogen. Die Differenzspeicherung von Telegram ist begrenzt; `differenceTooLong` kann nicht alle verschwundenen Inhalte rekonstruieren. Unwiederherstellbare Lücken müssen ausdrücklich gekennzeichnet bleiben, selbst wenn ein späterer Verlaufs-Snapshot erfolgreich ist. ## Beweismodell Jedes Ereignis erfasst eine Sequenz, die lokale Beobachtungszeit in UTC, die Quellzeit (sofern angegeben), die Art des Ereignisses, die Quelle, den Akteur (sofern angegeben), die ursprüngliche Nutzlast, den vorherigen Hashwert und die Signatur. Bei der Erfassung von Nachrichten werden zudem das Konto des Erfassers und der Ausführungskontext gespeichert. Der signierte Prozessbeleg enthält eine zufällige Lauf-ID; TgWitness/Python/OS/Abhängigkeitsversionen; SHA-256-Werte der Quelldateien und einen aggregierten Fingerabdruck; das ursprüngliche Konto, den Umfang und die Einstellungen; UTC-/monotone Messwerte; sowie den vorhergehenden Protokollkopf. Einstellungsänderungen, Start-/Stoppvorgänge und Fehler werden in dasselbe Protokoll eingetragen. Kontrollpunkte werden beim Start, alle fünf Minuten während der Überwachung (einstellbar) sowie bei ordnungsgemäßem Beenden gespeichert. Ein gespeicherter lokaler Kontrollpunkt kann ein Zurücksetzen auf ein früheres Protokollpräfix erkennen. | Funktionsweise | Was damit erreicht wird | | --- | --- | | Datei-SHA-256 | Die Bytes stimmen mit einem bekannten Digest überein | | Ereignis-Hash-Kette | Aufzeichnung der Reihenfolge/Verknüpfung in Bezug auf eine bekannte Grenze | | Ed25519 | Signatur unter einem bestimmten Schlüssel | | Unabhängig gespeicherter Kontrollpunkt | Der nachfolgende Text entspricht den beibehaltenen Grenzen. | | Analyse der Programmdatei | Selbstbericht des Collectors über erfasste Dateien | | Gültige, unabhängige TSA-Antwort | Vorhandensein bestimmter Bytes zum TSA-Zeitpunkt unter expliziten Vertrauensannahmen | Die Vorbereitung von RFC-3161-Anfragen und die Prüfung der Antworten sind ohne OpenSSL umgesetzt. Im Beweismodus werden außerdem Checkpoint-Hashes an die konfigurierten Zeitstempeldienste gesendet. Bewahren Sie die Antwort der Zeitstempelstelle auf und prüfen Sie sie, um einen unabhängigen Zeitanker zu erhalten. Siehe [TIMESTAMP.md](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/). Behalten Sie Kontrollpunkte unabhängig bei, kontrollieren Sie den Zugriff auf Signaturschlüssel, führen Sie Übertragungsprotokolle und überprüfen Sie Exporte mit vertrauenswürdiger Software. Der [Überprüfungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) erläutert, wie sich diese Kontrollen gegenseitig ergänzen und welche Vertrauensannahmen gelten. ## Export, Bereitstellung und Übergabe Eine signierte ZIP-Datei enthält die Originaldateien im JSONL-, CSV- und HTML-Format sowie erhaltene Anhänge, Hashes, ein signiertes Manifest und ein praktisches Verifizierungswerkzeug. Sie umfasst einen Arbeitsbereich und ein festes, vollständiges Protokollpräfix. Suchfilter im Bedienfeld entfernen Datensätze nicht stillschweigend. Geheime Schlüssel, Token und Telegram-Sitzungen werden ausgeschlossen; die ursprünglichen Beobachtungen können dennoch personenbezogene Daten und Telegram-Metadaten enthalten. Speichern Sie den ZIP-Digest, den vertrauenswürdigen Fingerabdruck, den Checkpoint, die Prozessquittung und die Übergabe separat. Verwenden Sie ein Verifizierungsprogramm aus einer vertrauenswürdigen Installation, anstatt ausführbarem Code allein deshalb zu vertrauen, weil er in der untersuchten ZIP-Datei enthalten ist. Die Browser-Oberfläche wird lokal ohne Node.js, CDNs oder externe Schriftarten bereitgestellt. Ein Operator-Token steuert die Installation. Für den Fernzugriff sind HTTPS oder ein SSH-Tunnel erforderlich. Native Python- und Container-Definitionen werden bereitgestellt, zusammen mit Service-Beispielen im [Verzeichnis „deploy/“](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md); durchgeführte Plattformprüfungen sind separat aufgeführt. Der Standard-Arbeitsbereich verwendet das Datenstammverzeichnis; zusätzliche Arbeitsbereiche verwenden „`profiles//`“. Für die Datensicherung müssen der Prozess angehalten und der vollständige Daten-/Schlüsselsatz vorhanden sein. Die ZIP-Dateien mit den Beweismitteln sind keine Anwendungssicherungen. Für Geheimnisse kann ein externer Hauptschlüssel für ein neues Datenverzeichnis verwendet werden; die Verschlüsselung von Protokoll und Medien erfolgt über die Festplatte bzw. das Volume des Betreibers. Siehe [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/de/docs/reference/connection/) und [OPERATIONS.md](https://phishdestroy.io/tgwitness/de/docs/reference/operations/). ## Kriterien für stabile Veröffentlichungen Vor einer stabilen Veröffentlichung bitte folgenden Hinweis hinzufügen: 1. Echte private Gruppen, Supergruppen, Foren und Kanäle mit Mitglieder-/Administratorrollen sowie verborgenem/sichtbarem Verlauf, einschließlich Anmeldung/2FA, Widerruf und Zugriffsverlust. 2. Kontrollierte Bearbeitungen, Löschungen, Reaktionen, Mitgliedschaften und Medien im Zusammenhang mit bekannten Handlungen. 3. Prozess- oder Serverausfälle, Festplattenausfälle oder volle Festplatten, abgelaufene Dateiverweise, „FloodWait“, Netzwerkausfall, beschädigte Dateien und Datenbank-Rollback. 4. Dauerbetrieb mit mehreren Konten unter Berücksichtigung von Verzögerungen, Warteschlangen, Speicher- und Festplattenressourcen, einschließlich sowohl ruhiger als auch aktiver Quellen. 5. Unterbrechung zwischen dem Fortschreiten des MTProto-Status und der Annahme des Protokolls. 6. Saubere Installation auf der vorgesehenen Betriebssystem-/Container-Matrix und verifizierte Wiederherstellung aus dem Backup. 7. Unabhängige Überprüfung von Sicherheitsaspekten, Signaturen sowie Zuordnungs- und Beweisangaben. Der bereichsbezogene Zugriff auf das Panel wird unter [Zugriff und Berechtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/access/) beschrieben. Seit Version 0.6 unterstützt TgWitness den in [ACCOUNTS.md](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/) beschriebenen begrenzten Import von TData für einzelne Konten und von Kontodateien. Lesen Sie vor der Veröffentlichung die Nutzungsbedingungen der Telegram-API durch. Referenzen zur Forschung und Erkenntnisse zur Plattform finden Sie in [RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md). --- # Telegram · Case-Board-Referenz Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/case-board/ Lesezeichen, exakte Markierungen, Aktionsausschnitte, Diskussionen, bereichsbezogener Zugriff und der von Case Board verwendete Verlauf der signierten Anmerkungen. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Lesezeichen, exakte Markierungen, Aktionsausschnitte, Diskussionen, bereichsbezogener Zugriff und der von Case Board verwendete Verlauf der signierten Anmerkungen. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/) ![Untersuchung](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Case Board bietet einem Ermittlungsteam eine gemeinsame Arbeitsansicht des gespeicherten Materials. Setzen Sie ein Lesezeichen für eine Beobachtung, markieren Sie eine bestimmte Passage, speichern Sie eine Reihe von Aktionen und besprechen Sie diese mit Kollegen. Karten behalten ihre Quellenverweise und den signierten Revisionsverlauf bei. Team-Anmerkungen verbleiben im Arbeitsbereich und sind separat von den ursprünglichen Telegram-Beobachtungen erkennbar. [Beweismodell](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) · [Zugriff](https://phishdestroy.io/tgwitness/de/docs/reference/access/) · [Berichte](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/) ![Zusammenfassung der Ermittlungsergebnisse](https://phishdestroy.io/tgwitness/assets/case-board.png?v=da27ef9c5b51) **Auf dieser Seite** - [Arbeiten mit einem Fall](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/#work-with-a-case) - [Berechtigungen](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/#permissions) - [Gespeicherte Verträge](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/#stored-contracts) - [-API und Exporte](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/#api-and-exports) - [Betriebsgrenzen](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/#operating-limits) ## Arbeiten mit einem Fall Öffnen Sie **Weitere Tools → Case Board** im Standard- oder Expertenmodus. Die Sprache richtet sich nach dem Panel. Verwenden Sie **die Schaltfläche Zum Board hinzufügen** neben einem Journal-Eintrag oder einer gespeicherten Chat-Nachricht, oder markieren Sie diese und drücken Sie **B**. Das Lesezeichen wird mit einem Klick zum Posteingang hinzugefügt. Bearbeiten Sie dessen Titel, Labels und Notiz oder verschieben Sie es in eine Sammlung. Eine geänderte Karte fügt eine signierte Revision an; beim Entfernen bleibt der Verlauf erhalten. Wählen Sie für einen ersten Fall eine Erfassung aus und fügen Sie die Datensätze hinzu, die eine Frage beantworten. Verwenden Sie Kommentare, um die Interpretation zu überprüfen, und nutzen Sie anschließend **„Präsentation“**, um die Karten und den Quellenkontext durchzugehen. Wählen Sie das Material für das Case Board separat im [„Report Studio“](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/) aus, wenn Sie das Ergebnisdokument vorbereiten. Das Speichern eines Ausschnitts konfiguriert nicht automatisch die Datenfilter eines Berichts. Markieren Sie Text innerhalb einer gespeicherten Chat-Nachricht, um **„Highlight → Board“** anzuzeigen. Wählen Sie die Farbe aus und fügen Sie eine Notiz hinzu. Der Server überprüft das genaue Zitat und die gespeicherte Version, einschließlich Emojis, RTL-Text und Kombinationszeichen. Die Benutzeroberfläche bildet eine Auswahl nicht durch maskierten oder transformierten Text ab. Wählen Sie mit Umschalt-Klick zwei Datensätze in einem Chat aus, um **einen Ausschnitt dazwischen** zu erstellen, verwenden Sie **den Ausschnitt nach Zeit** oder speichern Sie die aktuellen Filter des Journals für Chat, Zeitraum und Ereignistyp. Ein gespeicherter Ausschnitt verfügt über ein eigenes maßgebliches Prädikat: Beim Öffnen im Journal werden auch mehrere Chats, Begrenzungen der Nachrichtenanzahl und Akteur-Filter angewendet. **„Seit Lesezeichen hinzugefügte Datensätze anzeigen“** isoliert die späteren Ergänzungen. Das Ändern von Journal-Filtern beendet den Ausschnitt. Unter „Personen“ verwendet **„Aktionen dieser Person ausschneiden“** die aufgezeichnete Akteur-ID; es wird nicht davon ausgegangen, dass der Verfasser einer Nachricht diese bearbeitet, gelöscht oder darauf reagiert hat. Der „Slice“-Dialog zeigt eine Vorschau der Anzahl an, bevor die Erstellung zugelassen wird. „`all`“ umfasst alle aufgezeichneten Arten, einschließlich Momentaufnahmen, Bearbeitungen, Löschungen, Reaktionen, Aktualisierungen von Mitgliedschaften/Diensten, eigener Aktionen, Schaltflächen, Medienausgaben, wiederhergestellter Nachrichten und zukünftiger Ereignistypen. Die Auswahl beschreibt gespeicherte Beobachtungen. Löschbenachrichtigungen für unbekannte Chats stellen einen separaten Kontext dar, der nur bei Zugriff auf den gesamten Arbeitsbereich verfügbar ist und niemals einem der ausgewählten Chats zugeordnet wird. Sammlungen haben einen festgelegten Chat-Umfang. Ein leerer Umfang bedeutet den gesamten Arbeitsbereich. Eine Sammlung kann keine Karten außerhalb ihres Umfangs enthalten; ein auf einen Chat beschränkter Teilnehmer kann keine umfassendere Sammlung einsehen. Der Posteingang ist eine virtuelle Sammlung für nicht zugewiesene Karten. Suche und Filter gelten nur für sichtbare Karten; Threads und Erwähnungen erben die Zugriffsrechte der übergeordneten Karte. Gelöschte Kommentare werden in der Diskussion als „Tombstone“ angezeigt. Es wird kein Verlauf der Betrachter aufgezeichnet. **Die Präsentationsansicht** öffnet alle Karten in der ausgewählten Sammlung und bietet die Ansichten „Karte“, „Quellenkontext“ und „Teamkommentare“ sowie die Tastaturbefehle „Zurück“ und „Weiter“. Sie bietet keine Bearbeitungsfunktionen. Der normale Feed ist paginiert; die Präsentationsansicht lädt die Liste seitenweise und ruft jeweils die Details einer einzelnen Karte ab. ## Berechtigungen Alle Vorgänge erfordern die Berechtigungen „`view`“, „workspace/chat scope“ und „`board.read`“. „`board.write`“ fügt Karten, Kommentare, Verschiebungen sowie den Status „offen“ oder „überprüft“ hinzu. „`board.manage`“ ermöglicht die Verwaltung der Sammlung, den Status „bestätigt“ oder „abgelehnt“ sowie die Überarbeitung oder Entfernung von Karten anderer Benutzer. Ein Status ist eine Teamentscheidung, kein Ergebnis einer kryptografischen Überprüfung. Zugriffsvoreinstellungen: Prüfer = Lesen; Analyst = Lesen/Schreiben; Operator = Lesen/Schreiben/Verwalten, zusätzlich zu ihren bestehenden Berechtigungen. Bestehende Berechtigungen führen nicht automatisch zur Erlangung neuer Rechte. Der Hauptadministrator verfügt über alle Rechte und veröffentlicht als **„Hauptadministrator**“. Verwenden Sie benannte Berechtigungen zur Zuordnung. In den Erwähnungen werden nur aktuelle Zugriffe aufgeführt, die die vollständige übergeordnete Karte lesen können. Ein Zugriffsrecht für Chat A kann keine Karte oder keinen Ausschnitt für A+B erhalten, selbst wenn die ID erraten oder eine falsche „`target.chat_id`“ angegeben wird. Die Metadaten des Ziels werden anhand des signierten Ereignis-Hashes auf dem Server ermittelt. Sammlungen, Diskussionszahlen, zugehörige Karten und Live-Benachrichtigungen werden vor der Antwort gefiltert. exports erfordern sowohl „`export`“ als auch „`board.read`“; ein bestehender Exporter ohne Board-Zugriff erhält das normale Beweismittelarchiv ohne Teamnotizen. SSE überprüft vor jedem Stapel die aktuellen Berechtigungen erneut. ## Gespeicherte Verträge Genau wie Beobachtungen werden Anmerkungen transaktional in eine nur-anfügen-fähige SQLite-Tabelle im Arbeitsbereich geschrieben. „`annotations.jsonl`“ ist der exakte kanonische Export aus demselben Lese-Snapshot wie „`events.jsonl`“. Es gibt keinen zweiten konkurrierenden Anmerkungsspeicher und kein „`board.activity`“-Journalereignis. Jede Zeile enthält genau: ``` { "seq": 1, "at": "2026-11-02T14:00:00.000+00:00", "access_id": "admin", "access_label": "Main administrator", "kind": "board.bookmark", "payload": {"id": "32 lowercase hex digits", "target": {"event_hash": "64 lowercase hex digits"}}, "previous_hash": "64 zeroes for the first record", "hash": "SHA-256 described below", "signature": "base64 Ed25519 signature" } ``` Das obige verkürzte Beispiel veranschaulicht den „Envelope“; tatsächliche Nutzdaten enthalten ihre Modell- Standardwerte und vom Server aufgelöste Zielfelder. API-Anfrageschemata befinden sich unter „ [`tgwitness/schemas`](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/schemas/board-bookmark.json)“ und werden aus den Laufzeit-Pydantic- Modellen durch das `python tools/build_board_schemas.py` generiert. Zusätzliche Anfragefelder werden abgelehnt. IDs werden serverseitig generiert, wenn sie weggelassen werden. Urheberschaft, Zeit, Snapshot und Signatur können nicht vom Aufrufer angegeben werden. Benannte Berechtigungs-IDs folgen dem bestehenden 16-Hex-Format von Access; Karten-IDs sind 32 Hex. Das kanonische JSON ist in UTF-8, mit sortierten Objektschlüsseln, ohne Leerzeichen zwischen den Tokens, mit unescaped Unicode und ohne NaN/Unendlichkeitswerte. Der Anmerkungs-Hash ist ein SHA-256 des kanonischen Objekts, das das `format: "tgwitness-annotations-v1"` sowie alle sieben Envelope-Felder bis einschließlich `previous_hash` enthält. Dieses Format-Tag trennt seine Hash-Domäne von den Beobachtungen. Die Signatur ist Ed25519 über die 32 Roh-Hash-Bytes. Die Sequenz beginnt bei 1. Revisionen behalten die Karten-ID bei und benennen den vorhergehenden Annotations-Hash in „`supersedes`“; sie können den Chat-Gültigkeitsbereich nicht ändern. Verschiebungen, Statusänderungen und Löschungen sind separate Datensätze. Die SQLite-Tabelle lehnt UPDATE- und DELETE-Befehle ab. `case-board.json` enthält `{statement, signature}`. Die kanonische Aussage wird durch den Workspace-Schlüssel signiert und enthält `format: "tgwitness-case-board-v1"`, `public_key`, `created_at`, `journal_head`, `meaning` und `state`. Der Status ist eine deterministische Wiedergabe: `annotations_head`, ein geordnetes Array `items` (Sammlungen, Karten, Kommentare einschließlich Tombstones) und `status_history`. Elemente behalten ihren letzten Annotations-Hash, ihre Sequenz, ihren Autor und ihre Zeit sowie den ursprünglichen Ersteller und den Erstellungszeitpunkt über alle Revisionen hinweg bei. Die Wiedergabe überprüft Revisionen, übergeordnete Elemente, Sammlungsverweise und doppelte Aktions-IDs. „`manifest.json`“ und neue Checkpoints binden ebenfalls „`annotations_head`“. Bewahren Sie einen Checkpoint unabhängig auf, um eine Verkürzung oder ein Überschreiben mit einem kopierten Signaturschlüssel zu erkennen. ### Textversionen „`range.start`“ ist ein nullbasierter Unicode-Codepunkt-Offset, „`length`“ ist eine positive Codepunktanzahl, und „`quote`“ muss genau der Teilzeichenfolge von „`payload.text`“ oder „`payload.caption`“ am Ziel- Ereignis entsprechen. Es wird keine NFC/NFKC, Groß-/Kleinschreibung oder Graphem-Normalisierung angewendet. Python-String-Slices und JavaScript-`Array.from(text)` implementieren dieselbe Indizierung. Die Kombination von Markierungen und ZWJ-Emojis kann mehrere Codepunkte einnehmen. „`range.version`“ ist der Hash des Zielereignisses, nicht die aktuelle Nachrichtenversion oder der UTF-16-Entity-Offset von Telegram. Spätere Bearbeitungen verschieben eine Markierung niemals automatisch. ### Identität und Zeit unterteilen „`query`“ akzeptiert genau eine „`chat_id`“ oder nicht leere „`chat_ids`“, optional inklusive „`from`“/„`to`“, inklusive „message-ID“-Grenzen (nur ein Chat), „`kinds: "all"`“ oder exakte/Präfix-Platzhalter-Arten, explizite „`actors`“, „`search`“, „`hide_system`“ und „`include_unscoped`“. „Journal“-Artengruppen werden zu ihren exakten Prädikaten erweitert. Die Suche nutzt die NFC-/Case-Folded-Payload-Suche des Journals, ohne den signierten Quelltext zu verändern. Datumsangaben erfordern eine Zeitzone und werden auf UTC normiert. Datumsangaben filtern **„observed_at**“. Telegrams „`source_at`“ wird separat angezeigt. Eine Löschung ohne Quellzeitstempel hat keinen fiktiven Löschzeitpunkt. Ein später Datensatz, der außerhalb eines Zeitintervalls beobachtet wird, wird nicht in dieses aufgenommen; ein Message-ID-Ausschnitt kann eine spätere Löschung für diese Message-IDs enthalten. „`snapshot`“ legt den Erstellungszeitpunkt, die Grenze zwischen Journalsequenz und Hash, die Anzahl der Übereinstimmungen sowie die erste und letzte Sequenz und den „`result_hash`“ fest. Letzterer ist der SHA-256-Hash des kanonischen UTF-8-JSON-Arrays der übereinstimmenden Ereignis-Hashes, lexikografisch sortiert, einschließlich `[]` für einen leeren Ausschnitt. Er enthält außerdem genaue Typanzahlen und eine 24-Bin-Miniatur der Beobachtungszeit. Ein „Slice“ speichert eine Abfrage, keine doppelten Quelldatensätze . Beim Export listet „`board/slices/.json`“ aktuelle Hashes sowie hinzugefügte/entfernte Sequenzen auf. Der Verifizierer rekonstruiert zunächst das ursprüngliche Ergebnis an der Erstellungsgrenze und anschließend das aktuelle Ergebnis. Hinzugefügte Datensätze werden als Änderungsfakt gemeldet. Das Entfernen eines ursprünglichen Ereignisses unterbricht die unveränderliche Beweiskette; es wird nicht stillschweigend als gewöhnliche Entfernung aus einem Slice akzeptiert. Reaktions-Snapshots weisen unvollständige Listen der jüngsten Akteure auf. Der Explorer vergleicht benachbarte Snapshots desselben Chats/derselben Nachricht, einschließlich eines Vorgängers außerhalb des Ausschnitts, und meldet aggregierte Zählungsdifferenzen **zwischen den Beobachtungen**. Bei fehlenden jüngsten Akteuren wird nicht behauptet, dass diese eine Reaktion entfernt hätten. Der erste Snapshot hat keinen abgeleiteten früheren Zustand. Akteurbeobachtungen bleiben dem Snapshot zugeordnet, in dem sie bereitgestellt wurden, und nicht einem fiktiven Aktionszeitpunkt. ## API und Exporte `GET /api/board` akzeptiert collection/chat/author/label/state/from/to/q/kind/comments, offset/limit sowie die Sortierreihenfolge „neueste“ und „älteste“. `GET /api/board/card/{id}` gibt eine Karte, eine Quellenvorschau, den Thread, den Statusverlauf und zugehörige Karten zurück. Die Unterroute „Teilnehmer“ gibt zulässige Erwähnungsoptionen zurück. `POST /api/board/{bookmark|highlight|slice|collection|comment|status|move|remove}` fügt einen Datensatz hinzu. `POST /api/board/slice-preview` berechnet eine Abfrage. Slice-Datensätze werden unter `GET /api/board/slice/{id}/records` paginiert; bei der Neuberechnung wird stets der aktuelle stabile Lese-Snapshot verwendet. Live `/api/stream` sendet payload-freie `board`-Benachrichtigungen, unabhängig von Journal-Cursorn. `GET /api/board/export` gibt ein signiertes Dokument zurück. Bei chatbegrenztem Zugriff wird eine eindeutig gekennzeichnete, signierte **Offenlegung** bereitgestellt, niemals die Anmerkungen eines anderen Chats oder die gesamte Kette. Vollständige Beweismittel-ZIPs enthalten „`annotations.jsonl`“, ein signiertes „`case-board.json`“ sowie „Slice“-JSON-Anhänge. HTML/PDF/JSON-Berichtseinstellungen ermöglichen die Auswahl „kein Board“, Lesezeichen/Ausschnitte ohne Diskussion oder Karten mit Kommentaren. Der Abschnitt trennt Teammeinungen ausdrücklich von Beobachtungen. Berichtsdatenfilter schränken auch die lesbaren Notizen ein; vollständige signierte Quelldateien im Beweismaterial-ZIP bleiben unverändert. `GET /api/board/slice/{id}/export` erzeugt einen signierten JSON-Auszug „`tgwitness-board-selection-v1`“; `?format=csv` erzeugt eine übersichtliche Tabelle ohne eigenständige Signatur. Behalten Sie das JSON und die ZIP-Datei bei: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_KEY_SHA256 --board python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 python -m tgwitness.verify case-board.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 ``` Die Auswahlprüfung authentifiziert die signierte Erklärung, die exakten Quelldatensätze und die Vollständigkeit der Abfrage an der angegebenen Grenze. Die Beweisdatei im ZIP-Format kann neuer sein, muss jedoch dieses Präfix enthalten. Ein fehlendes Ziel wird explizit gemeldet. Ein anderer ursprünglicher Slice-Snapshot, eine geänderte Anmerkung, ein nicht übereinstimmender Wiedergabestatus oder eine geänderte Quelle führen zum Fehlschlagen. Alte Archive ohne Anmerkungen behalten ihr bestehendes Verifizierungsverhalten bei. Die Übergabe ist standardmäßig auf **Nicht einbeziehen** gesetzt. Die explizite Einbeziehung projiziert Karten durch die bereits minimierten Datensätze, lässt unzugängliche/ausgelassene Ziele weg, unterdrückt Hervorhebungen, deren Quelltext minimiert wurde, bereinigt Teamtext nach denselben Erwähnungs-/Kontaktregeln und ersetzt optional Ermittler-Bezeichnungen durch R01, R02… in Metadaten und bekannten Vorkommen in Notizen. Es wird keine ursprüngliche `annotations.jsonl` offengelegt. Der signierte Sidecar `tgwitness-case-board-handover-v1` und der Bericht enthalten dasselbe minimierte Material. Die Slice-Zahlen beschreiben nur offengelegte Datensätze, wobei ursprüngliche Snapshot-/Abfrage-Akteur-Details zurückgehalten werden. Freitext-Namen, die dem Minimierer nicht bekannt sind, müssen weiterhin überprüft werden, wie dies auch bei gewöhnlichen Übergaben der Fall ist. Das Derivat trägt seine eigene Signatur; die ursprünglichen Anmerkungen behalten ihre Signatur im vollständigen Archiv. ## Anwendungsgrenzen Zu den Parametern gehören weiche Begrenzungen von 10.000 Karten und 50.000 Kommentaren, eine „Slice“-Seite mit bis zu 5.000 Datensätzen sowie die Steuerung der Medienvorschau. Weiche Begrenzungen lösen eine Warnung aus, ohne den Verlauf zu löschen. Feed-Seiten umfassen höchstens 200 Karten. Eigenständige JSON-Ausschnitte sind auf 64 MiB begrenzt; schränken Sie die Abfrage ein oder verwenden Sie die signierte ZIP-Datei für umfangreicheres Material. Der eigenständige Verifizierer begrenzt die Wiedergabe von Anmerkungen auf 256 MiB. Externe Benachrichtigungen zu Kommentaren sind in Case Board weder aktiviert noch implementiert. Die automatisierte Abnahme der Funktion nutzt fiktive Daten und einen simulierten Telegram-Transport, um Speicherung, Zugriff, Darstellung und Exporte zu überprüfen. Den Umfang der Beweismittelprüfungen entnehmen Sie bitte [dem Verifizierungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) . --- # Telegram · Archivanalyse Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/analysis/ Durchsuchen Sie gespeicherte Nachrichten, überprüfen Sie KI-Eingaben und erstellen Sie Analyseberichte mit Quellenangaben. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Durchsuchen Sie gespeicherte Nachrichten, überprüfen Sie KI-Eingaben und erstellen Sie Analyseberichte mit Quellenangaben. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/) ![Untersuchung](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Anleitung zum Arbeitsablauf](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Verwenden Sie **Journal** für die lokale Suche ohne KI; [die Volltextsuche](https://phishdestroy.io/tgwitness/de/docs/reference/search/) (Vorschau) erkennt Wortformen, Phrasen, Domänen und @Benutzernamen. Für **Weitere Tools → Das Archiv befragen** müssen Sie zunächst unter **Weitere Tools → Integrationen** einen Anbieter aktivieren und konfigurieren. Mit der Arbeitsbereichsauswahl wählen Sie das Konto aus; über das Formular wählen Sie Chats und den Beobachtungszeitraum aus. Die Suche läuft lokal. Eine exakte Phrase oder Domäne grenzt die Suche ein; eine Nachrichten-ID fordert gespeicherte Versionen an. Sehen Sie sich die Auszüge an und öffnen Sie deren Journaleinträge oder den Kontext. Es gibt keine Vektordatenbank und keine automatische Telegram-Aktion. ## Anbieter und Einwilligung Die KI ist in jedem Arbeitsbereich standardmäßig deaktiviert. Nur der Hauptadministrator kann das Modell, den Endpunkt, den verschlüsselten API-Schlüssel, Kontext-/Ausgabebegrenzungen, das Timeout und das tägliche Anfrage-Kontingent konfigurieren. Der Schlüssel wird niemals an den Browser zurückgegeben. Lassen Sie das Schlüsselfeld leer, um den aktuellen Schlüssel beizubehalten, oder entfernen Sie ihn explizit. Ollama verwendet seinen dokumentierten [`/api/chat`-Endpunkt](https://docs.ollama.com/api/chat) mit nicht-streamingbasierter JSON-Ausgabe. Die Standardadresse lautet `http://127.0.0.1:11434` auf dem TgWitness-Server. Der Betreiber kann sie mithilfe von `TGWITNESS_AI_LOCAL_ENDPOINT` ändern; hierbei handelt es sich nicht um eine modellgesteuerte Adresse. Installieren Sie das ausgewählte Modell selbst. TgWitness lädt es nicht automatisch herunter. Der kompatible Anbieter erwartet eine Basis-URL, die auf `/v1` endet, sowie das [„Chat Completions“-Protokoll](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create): `messages`, JSON-Antwortmodus, `max_completion_tokens` und `choices[0].message.content`. Dienste, bei denen diese Felder fehlen, werden nicht unterstützt. Bei Verbindungstests wird synthetischer Text gesendet, der auf das Anfragekontingent angerechnet wird. Jede Anfrage nutzt die im Arbeitsbereich konfigurierte externe Route. Eine blockierte Route oder ein ausschließlich für Telegram bestimmter MTProxy führt zu einem Fehler; es erfolgt kein direkter Wiederholungsversuch. Eine bewusst konfigurierte lokale Ollama-Adresse ermöglicht ein privates Ziel. Ein Loopback-AI- Endpunkt erfordert die externe „Direct“-Route des Arbeitsbereichs; Proxy-Routen werden vor der Übertragung abgelehnt. Für andere private Dienste gilt die bestehende Opt-in-Möglichkeit für private Ziele auf Serverebene. Die Vorschau zeigt den Endpunkt und die externe Route, einschließlich des Proxy-Hosts, sofern zutreffend. Eine Änderung dieser Route erfordert eine neue Vorschau. Vor der Generierung zeigen **die an das Modell gesendeten Daten** die Anfrage: Frage, geprüfte Auszüge, Ereignistypen, Beobachtungszeitpunkte und Abdeckungsmarker. Telegram- Sitzungen, Rohdatenfelder, Anbieterschlüssel, Anhangsbytes und das vollständige Protokoll sind nicht Teil dieses Kontexts. Deaktivieren Sie unerwünschte Quellen und genehmigen Sie dann ausdrücklich die Verarbeitung. Externe Anbieter können übermittelte Inhalte gemäß ihren eigenen Richtlinien aufbewahren. Lokale Ausführung bedeutet, dass der Endpunkt lokal ist; ein separat konfigurierter Dienst folgt seiner eigenen Konfiguration. Weltweit sind höchstens zwei gleichzeitige Anfragen an den Anbieter zulässig, eine pro Arbeitsbereich. Eine Vorschau läuft nach zehn Minuten ab und kann eine Antwort generieren. Die vom Anbieter gemeldeten Token-Zahlen werden angezeigt; eine Kostenschätzung erscheint erst, wenn sowohl Eingangs- als auch Ausgangstarife konfiguriert wurden. Fehlgeschlagene Versuche verbrauchen ebenfalls das tägliche Anfragedatenvolumen. Automatische Wiederholungsversuche verbrauchen kein zusätzliches Datenvolumen. ## Quellen und Einschränkungen Die Suche nutzt den [Volltextindex](https://phishdestroy.io/tgwitness/de/docs/reference/search/#ask-the-archive-and-mcp), sobald dieser vollständig ist: die besten Treffer aus den ausgewählten Chats, einschließlich Wortformen. Abfragen zu aktuellen Änderungen oder zu den Versionen einer einzelnen Nachricht sowie Suchvorgänge während der Erstellung des Indexes nutzen eine begrenzte lexikalische Suche in den neuesten Datensätzen. Die Vorschau nennt die Methode. Die Suche liefert bis zu 24 Quellen; lange Texte werden um den Treffer herum gekürzt. Abgekürzte Auszüge und unvollständige Ergebnismengen werden gekennzeichnet. Der Zeitraum bezieht sich auf **den Beobachtungszeitraum** und stellt keine Behauptung dar, dass der Telegram-Verlauf vollständig ist. Ereignisse, die den gesamten Arbeitsbereich betreffen, werden beim Zugriff auf Chat-Ebene zurückgehalten. Fehlende Daten werden als im verfügbaren Archiv nicht gefunden beschrieben. Das Modell erhält keine Werkzeuge. Seine Quellen-IDs werden anhand der ausgewählten Datensätze abgeglichen, Hashes werden erneut überprüft, und zitierte Zeichenfolgen müssen in diesen Datensätzen vorkommen. Unbekannte IDs, geänderte Zitate und nicht belegte Behauptungen führen zur Ablehnung der Antwort. Die Anwendung erstellt Links; vom Modell generierte URLs werden nicht als Quellenangaben verwendet. Diese Prüfungen stellen das Vorhandensein der Quellen und die Richtigkeit der Zitate sicher. Überprüfen Sie die Schlussfolgerungen anhand der Datensätze, bevor Sie sich auf sie verlassen. ## Berichte Speichern Sie eine geprüfte Antwort als separaten Analysebericht. Dieser enthält die Modellzusammenfassung, die beobachtete Chronologie, extrahierte Links und Handles, Bearbeitungs-/Löschprotokolle, Erfassungsgrenzen sowie Hash-Werte der Quellereignisse. Der Anbieter, das Modell, der Endpunkt, die Uhrzeit und die Version der Prompt-Vorlage werden ebenfalls angegeben. Es werden keine Identitäten automatisch zusammengeführt. Änderungen und Notizen der Analysten werden getrennt von der Modellzusammenfassung gespeichert. Berichte befinden sich in verschlüsselten abgeleiteten Dateien, mit einem Index außerhalb des signierten Ereignisstroms; die ursprünglichen Ereignisse und Medien bleiben unverändert. Nur der Eigentümer oder Administrator kann einen Bericht öffnen, und der Zugriff auf die Quelle wird erneut überprüft. Für den Download ist zudem eine Exportberechtigung erforderlich. Version 1 signiert keine Berichte und impliziert nicht, dass die Schlussfolgerungen des Modells verifizierte Beweise sind. Beschränkungen: 100 Berichte pro Arbeitsbereich und 100 Analystenüberarbeitungen pro Bericht. Informationen zu manueller OCR und Transkripten finden Sie unter [„Medienverarbeitung](https://phishdestroy.io/tgwitness/de/docs/reference/media-analysis/)“. Informationen zum Kundenzugang finden Sie unter [„MCP](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/)“. --- # Telegram · Volltextsuche Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/search/ Suche nach gespeicherten Nachrichten anhand von Wortformen, genauen Phrasen, Domains und @Benutzernamen, wobei die besten Treffer zuerst angezeigt werden und der Index mit dem signierten Protokoll verknüpft ist. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Suche nach gespeicherten Nachrichten anhand von Wortformen, genauen Phrasen, Domains und @Benutzernamen, wobei die besten Treffer zuerst angezeigt werden und der Index mit dem signierten Protokoll verknüpft ist. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/) ![Untersuchung](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Analyse des Archivs](https://phishdestroy.io/tgwitness/de/docs/reference/analysis/) · [Lokale OCR und Transkription](https://phishdestroy.io/tgwitness/de/docs/reference/media-analysis/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Vorschau.** Wählen Sie im **Protokoll** neben dem Suchfeld **„Beste Übereinstimmung · Wortformen“** aus. Die Ergebnisse werden nach BM25 sortiert und umfassen auch andere Formen desselben Wortes: *„перевод“* findet *„переводом“* und *„переводы“*, *„transfer“* findet *„transfers“*, eine chinesische Phrase wird ohne Leerzeichen gefunden. **„Neueste zuerst · exakter Text“** behält die vorherige Teilstring-Suche über den gesamten Datensatz bei. Der Index besteht aus abgeleiteten Daten. Er wird aus dem signierten Protokoll neu erstellt, ist selbst niemals signiert und wird niemals exportiert. Die ursprünglichen Datensätze bleiben unverändert. **Auf dieser Seite** - [Suchsyntax](https://phishdestroy.io/tgwitness/de/docs/reference/search/#search-syntax) - [Sprachen](https://phishdestroy.io/tgwitness/de/docs/reference/search/#languages) - [Speicherort des Index](https://phishdestroy.io/tgwitness/de/docs/reference/search/#where-the-index-lives) - [Ergebnisse und das signierte Journal](https://phishdestroy.io/tgwitness/de/docs/reference/search/#results-and-the-signed-journal) - [Erkannter Text](https://phishdestroy.io/tgwitness/de/docs/reference/search/#recognized-text) - [Zugriff](https://phishdestroy.io/tgwitness/de/docs/reference/search/#access) - [Das Archiv und MCP befragen](https://phishdestroy.io/tgwitness/de/docs/reference/search/#ask-the-archive-and-mcp) - [Abhängigkeiten](https://phishdestroy.io/tgwitness/de/docs/reference/search/#dependencies) - [Benchmark](https://phishdestroy.io/tgwitness/de/docs/reference/search/#benchmark) ## Suchsyntax | Schreiben | Ergebnisse | | --- | --- | | `перевод карта` | Einträge, die beide Wörter in beliebiger Form enthalten | | `"переводом на карту"` | Der genaue Wortlaut in dieser Reihenfolge | | `бонус OR подарок` | Beliebiges Wort | | `перевод -казино` | Einträge ohne das ausgeschlossene Wort | | `example.com` | Die Domain und ihre Subdomains, auch in versteckten Links und Button-URLs | | `@username`, `t.me/username` | Erwähnungen und Links des Kontos sowie die von ihm gesendeten Nachrichten | | `#tag` | Der Hashtag | | `+79991234567`, eine Wallet-Adresse, eine E-Mail-Adresse | Der gleiche Wert in Text oder Links | | `from:@username`, `from:123456` | Nachrichten von diesem Absender | | `chat:-1001234567890` | Ein Chat; er kann nur Ihren eigenen Zugriff einschränken | | `id:42` | Gespeicherte Versionen von Nachricht 42 | | `since:2026-01-01 until:2026-01-31` | Beobachtungszeitraum; ein Datum ohne Uhrzeit umfasst den gesamten Tag | | `kind:edited` | Nur Bearbeitungen (`new`, `snapshot`, `edited`, `recovered`) | | `source:ocr`, `source:transcription`, `source:all` | Erkannter Text anstelle von oder zusammen mit Nachrichten | Präpositionen und andere Funktionswörter werden ignoriert, wenn andere Wörter vorhanden sind. Ähnlich aussehende Buchstaben, die in einem Wort gemischt vorkommen (z. B. ein lateinisches *„a“* in einem kyrillischen Wort), Unicode-Buchstaben in voller Breite sowie dekorative Unicode-Buchstaben und unsichtbare Zeichen werden normalisiert. ## Sprachen Die Sprache wird für jeden Datensatz anhand des Skripts und der Buchstaben ermittelt: | Skript | Übereinstimmung | | --- | --- | | Kyrillisch | Russische und ukrainische Lemmata mit [pymorphy3](https://github.com/no-plagiarism/pymorphy3). Ohne das optionale ukrainische Wörterbuch wird ein einfacher ukrainischer Stemmer verwendet. | | Latein | Englischer Snowball-Stemmer; diakritische Zeichen werden ignoriert | | Chinesisch, Japanisch, Koreanisch, Thailändisch, Laotisch, Khmer, Myanmarisch | Überlappende Zeichenpaare: Jede Phrase wird ohne Leerzeichen gefunden. Chinesische Suchanfragen werden mit Jieba in Wörter aufgeteilt. | | Weitere Skripte | Wörtliche Übersetzung | Das ukrainische Wörterbuch (`pymorphy3-dicts-uk`) wird unter der GPL-3.0 vertrieben und ist daher standardmäßig nicht installiert. Installieren Sie es mit `pip install "tgwitness[uk-dictionary]"`; der Index erkennt den neuen Analysator und erstellt sich neu. ## Wo sich der Index befindet | Modus | Speicherung | Verwendung | | --- | --- | --- | | Auf Festplatte (Standard) | `search/fulltext.sqlite3` im Arbeitsverzeichnis | Große Archive; übersteht Neustarts | | Nur im Arbeitsspeicher | Keine Daten auf der Festplatte; wird bei jedem Start neu erstellt | Keine abgeleitete Kopie des Nachrichtentextes auf der Festplatte | | Aus | Kein Index; **Neueste zuerst · exakter Text** bleibt erhalten | Minimale Installationen | Der Hauptadministrator wählt den Modus unter **„Journal“ → „Filter“ → „Suchindex“** für jeden Arbeitsbereich aus. `TGWITNESS_FULLTEXT=disk|memory|off` Er legt die Standardeinstellung für Arbeitsbereiche fest, die keine eigene Auswahl haben. Durch Umschalten auf „Speicher“ oder „Aus“ wird die Datei gelöscht. Die Indexdatei verfügt über denselben Schutz wie das Protokoll: Sie befindet sich im Verzeichnis für private Daten . Backups und externe Kopien lassen sie aus. Neue Einträge werden innerhalb von Sekunden im Hintergrund indiziert; bei einer Suche wird zudem zunächst ein kurzer Rückstand indiziert, sodass ein gerade erst gespeicherter Eintrag gefunden wird. Ein bestehendes Protokoll wird nach der Aktualisierung indiziert, ohne das Panel zu blockieren; bis dahin umfassen die Ergebnisse die indizierten Einträge, und das Protokoll zeigt den Fortschritt an. **Der Neuaufbau des Index** beginnt erneut ab dem ersten Eintrag. ``` python -m tgwitness index status --data-dir data/live python -m tgwitness index rebuild --data-dir data/live --json ``` `rebuild` Das Panel muss beendet werden (ansonsten Exit-Code 3). Bei `--json`, enthält die Standardausgabe nur das Ergebnis; der Fortschritt wird an die Standardfehlerausgabe geleitet. ## Ergebnisse und das signierte Protokoll Der Index speichert die Sequenznummer und den Hash des letzten Protokoll-Eintrags, den er abdeckt, und gleicht diese beim Öffnen mit dem Protokoll ab. Ein ersetztes, wiederhergestelltes oder bearbeitetes Protokoll führt zu einer Neuerstellung. Jede Antwort meldet diese Position, und jeder Treffer wird anhand seiner Sequenznummer aus dem signierten Protokoll zurückgelesen: Der Index entscheidet, welche Einträge in welcher Reihenfolge angezeigt werden, niemals jedoch über deren Inhalt. Der Chat-Zugriff gilt für das eigene Chat-Feld des Protokolls, nicht für den Inhalt des Index. ## Erkannter Text OCR-Ergebnisse und Transkripte verbleiben in ihren verschlüsselten Artefakten. Ihr Index existiert nur im Arbeitsspeicher und wird nach Abschluss eines Erkennungsauftrags neu erstellt. Ein Treffer erscheint in seinem `media.saved` Datensatz, gekennzeichnet als maschinelle Erkennung mit Angabe der Engine, des Modells und eines Auszugs; er wird niemals als in Telegram gesendeter Text dargestellt. Derselbe Index dient der **Suche nach erkanntem Text**, die weiterhin auch einfache Teilzeichenfolgen abgleicht. ## Zugriff Der Chat-bezogene Zugriff findet nur Datensätze aus den jeweiligen Chats, einschließlich des erkannten Textes ihrer Anhänge. `chat:` und andere Filter können diese Menge lediglich eingrenzen. Der Indexstatus, der beim zugriffsbegrenzten Zugriff angezeigt wird, lässt die Gesamtzahlen des Protokolls außer Acht. Nur der Hauptadministrator kann den Modus ändern oder den Index neu erstellen. ## Fragen Sie das Archiv und MCP **Weitere Tools → Ask the Archive** ruft seine Quellen aus diesem Index ab, sobald dieser vollständig ist: die besten Übereinstimmungen aus den ausgewählten Chats, wobei ein gespeicherter Text nur einmal gezählt wird. Es werden bis zu 24 Quellen gesendet; lange Texte werden um ihre Übereinstimmung herum gekürzt und als abgeschnitten markiert. Anfragen zu den letzten Änderungen, gespeicherten Versionen einer Nachricht und Suchanfragen, während der Index noch erstellt wird, nutzen den bisherigen chronologischen Abruf. Die Vorschau zeigt an, welche Methode verwendet wurde. MCP-Clients können `search_messages` mit `ranked=true` aufrufen und mit `next_offset`. Verbindungen mit eingeschränktem Zugriff erhalten nur ihre eigenen Chats. Die nummerierte Paginierung umfasst unabhängig von der Seitengröße höchstens die ersten 1,000-Ergebnisse. Grenzen Sie die Suche, den Chat oder den Zeitraum ein, um weitere Treffer zu prüfen. Bei der Suche nach Neueste zuerst werden Nachrichten, OCR- und Transkriptionsergebnisse vor der Auswahl jeder Seite sortiert. ## Abhängigkeiten | Paket | Lizenz | Warum | | --- | --- | --- | | pymorphy3, pymorphy3-dicts-ru, DAWG2-Python | MIT | Russische und ukrainische Lemmata; Wörterbücher werden lokal geladen | | snowballstemmer | BSD-3-Klausel | Englische Wortstämme, reines Python | | jieba | MIT | Segmentierung chinesischer Suchanfragen, reines Python (nur Quellcode-Verteilung) | | pymorphy3-dicts-uk (optional) | GPL-3.0 | Vollständiges ukrainisches Wörterbuch | SQLite FTS5 benötigt den `unicode61` Tokenizer ist erforderlich; dieser ist Teil von SQLite in aktuellen Python-Builds. Ohne ihn meldet die Best-Match-Suche, dass er nicht verfügbar ist. ## Benchmark `python tools/bench_fulltext.py --messages 1000000 --work `Erstellt ein deterministisches, signiertes Protokoll aus gemischten russischen, ukrainischen, englischen, chinesischen und japanischen Nachrichten mit Links und Handles in 200 Chats, erstellt den Index und misst die Dauer typischer Suchvorgänge (50 Ergebnisse, Median aus 7 Durchläufen). Gemessen unter Windows 11, Intel Core i9-13900K, 128 GB RAM, Python 3.12.10, SQLite 3.49.1, Daten auf einem exFAT-Laufwerk, Analysator `fulltext-v1+pymorphy3-ru+light-uk+snowball-en`: | Maßnahme | Ergebnis | | --- | --- | | Signiertes Protokoll | 1.000.000 Nachrichten, 1,50 GiB, in 19 Minuten geschrieben | | Erstellung eines Indexes aus dem Protokoll | 71 s, etwa 14.141 Nachrichten pro Sekunde | | Indexdatei | 58 MiB, 3,8 % des Protokolls | | Suche direkt nach einem neuen Eintrag | Median 8 ms, P95 9 ms | | Vorherige Teilstringsuche, dasselbe Protokoll | `перевод` 3,2 s, `银行转账` 2,6 s, `verify-account.example` 2,6 s | | Suche | Übereinstimmende Datensätze | Beste Übereinstimmung, Median | S. 95 | Neueste zuerst, Median | | --- | --- | --- | --- | --- | | Allgemeine Wörter, Wortformen: `перевод` | 134,403 | 82 ms | 85 ms | 7 ms | | Zwei Wörter: `оплата карта` | 28,996 | 43 ms | 43 ms | 14 ms | | Seltenes Wort: `розыгрыш подарок` | 28,881 | 42 ms | 47 ms | 13 ms | | Genauer Wortlaut: `"переказ коштів на картку"` | wird nicht gezählt | 35 ms | 36 ms | 6 ms | | Domain mit Subdomains: `verify-account.example` | 12,435 | 17 ms | 17 ms | 3 ms | | @Benutzername: `@support_desk_bot` | 10,331 | 15 ms | 16 ms | 3 ms | | Chinesisch ohne Leerzeichen: `银行转账` | 17,691 | 23 ms | 24 ms | 3 ms | | Japanisch: `リンク` | 16,603 | 23 ms | 25 ms | 3 ms | | Englischer Stamm: `withdrawal` | 27,775 | 26 ms | 26 ms | 2 ms | | ODER und Ausschluss: `бонус OR подарок -казино` | 268,034 | 190 ms | 193 ms | 19 ms | | Chat-Filter: `chat:-1000000000007 перевод` | 652 | 9 ms | 9 ms | 6 ms | | Zeitraumfilter: `since:2026-01-01 until:2026-01-31 выплата` | 115,732 | 155 ms | 156 ms | 81 ms | Eine exakte Phrase wird wörtlich bei Kandidaten in der Rangfolge überprüft, bis die Seite voll ist; daher wird deren Gesamtzahl nicht mitgezählt. Die Bearbeitungszeiten steigen mit der Anzahl der übereinstimmenden Datensätze; durch Eingrenzung des Chats oder des Zeitraums lassen sich umfassende Suchen beschleunigen. Das synthetische Korpus wiederholt einen kleinen Wortschatz, sodass häufige Wörter weitaus mehr Datensätze treffen als in echten Chats. --- # Telegram · Schreibgeschütztes MCP Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/mcp/ Verbinden Sie einen MCP-Client mit ausgewählten Arbeitsbereichen und Chats mit zeitlich begrenztem, widerrufbarem Zugriff. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Verbinden Sie einen MCP-Client mit ausgewählten Arbeitsbereichen und Chats mit zeitlich begrenztem, widerrufbarem Zugriff. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Archiv-Integrationen](https://phishdestroy.io/tgwitness/de/docs/reference/cli/) ![Archiv-Integrationen](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) Verbinden Sie einen Analysten-Client mit ausgewählten Arbeitsbereichen und Chats. TgWitness stellt **im Panel-Prozess unter `/mcp` einen Streamable-HTTP-Dienst** bereit. Jede Verbindung verfügt über ein eigenes Token, eine eigene Ablaufzeit und zulässige Tools. MCP kann keine Telegram-Nachrichten versenden, keine Einstellungen ändern und das signierte Protokoll nicht modifizieren. Die gleichen Verbindungen funktionieren auch über die [Befehlszeile](https://phishdestroy.io/tgwitness/de/docs/reference/cli/). [Anleitung zum Arbeitsablauf](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Auf dieser Seite** - [Installieren und überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/#install-and-check) - [Verbindung herstellen](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/#issue-a-connection) - [Verbinden Sie Ihren Client](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/#connect-your-client) - [Cloudflare-Tunnel](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/#cloudflare-tunnel) - [Werkzeuge und Grenzen](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/#tools-and-boundaries) ## Installation und Prüfung Verwenden Sie die Python-Umgebung, in der das Panel ausgeführt wird. Aus einem Quellcode-Checkout: ``` # Windows PowerShell & .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' & .\.venv\Scripts\python.exe start.py --check ``` ``` # Linux / macOS .venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' .venv/bin/python start.py --check ``` Starten Sie das Panel nach der Installation mit dem üblichen Datenverzeichnis und den üblichen Startargumenten neu. Der Bereitschaftsstatus sollte `[PASS] mcp: streamable-http available` enthalten. Unter **Weitere Tools → Integrationen → MCP** werden der Laufzeitstatus und ein Installationsbefehl unter Verwendung der tatsächlichen Python-Ausführungsdatei dieses Servers angezeigt. **Durch Erneut prüfen** wird dieser Status aktualisiert, ohne die Seite neu zu laden; dabei werden keine Pakete installiert und der Server nicht neu gestartet. Das MCP-Extra nutzt das offizielle [MCP-Python-SDK](https://github.com/modelcontextprotocol/python-sdk).`deploy/constraints-mcp.txt` legt das getestete SDK und die Abhängigkeiten fest. ## Verbindung erstellen 1. Geben Sie eine Bezeichnung ein und wählen Sie die Workspaces und Chats aus, die der Client lesen darf. 2. Wählen Sie Tools einzeln aus oder nutzen Sie eine Voreinstellung. Es werden nur implementierte Tools angeboten. 3. Wählen Sie 1, 7, 30 oder 90 Tage oder eine benutzerdefinierte Gültigkeitsdauer zwischen einer Minute und 90 Tagen. 4. Klicken Sie auf **Create connection**. Das Token wird einmalig neben der Client-Konfiguration angezeigt. 5. Kopieren Sie das Token und die Konfiguration und führen Sie anschließend **Check connection** aus. Dadurch wird MCP initialisiert und die freigegebenen Tools werden aufgelistet; **es werden keine Nachrichten gelesen**. Das Ergebnis zeigt die Protokollversion, die Tool-Namen, deren Anzahl und die verstrichene Zeit. 6. Klicken Sie auf **Done**, sobald die Zugangsdaten gespeichert sind. Das Polling behält das Formular und die einmalig angezeigte Karte bei. Das Sperren des Panels löscht angezeigte Geheimnisse. Die Liste zeigt die letzte Nutzung, das zuletzt verwendete Tool, die Adresse und die Anfragen der letzten Minute. **Revoke** beendet den Zugriff. **Rotate token** widerruft die alten Zugangsdaten und stellt einen Ersatz mit demselben Geltungsbereich, denselben Tools und derselben Gültigkeitsdauer aus; kopieren Sie das Ersatz-Token sofort, da es nur einmalig angezeigt wird. Panel-Login-Tokens und Telegram-Zugangsdaten funktionieren nicht als MCP-Tokens. ## Client verbinden Wählen Sie den Client im Panel aus und kopieren Sie die generierte Konfiguration. Konfigurationen verwenden Secret-Referenzen oder explizite Platzhalter; das Token wird separat kopiert. | Client | Konfiguration | Zusammenhang | | --- | --- | --- | | Claude-Code | `.mcp.json` | HTTP, `type: "http"`, Bearer-Header | | Claude Desktop | `claude_desktop_config.json` | Lokale stdio-Bridge | | Cursor | `.cursor/mcp.json` | HTTP mit Umgebungsvariablen-Header | | VS Code Local | `.vscode/mcp.json` | HTTP mit Passwort-Eingabe über `promptString` | | Windsurf | `mcp_config.json` | HTTP mit Platzhalter für Bearer-Header | | Andere Clients | URL und Authorization-Header | Streamable HTTP | TgWitness verwendet Bearer-Tokens ohne OAuth-Discovery. Verwenden Sie die lokale stdio-Bridge für Clients, deren Remote-Connector OAuth voraussetzt. Bei VS Code gelten Eingabevariablen für die **Local**-Umgebung und werden nicht an Copilot-Sitzungen weitergeleitet. Konfigurationsreferenzen: [Claude Code](https://code.claude.com/docs/en/mcp), [Cursor](https://prod.cursor.com/docs/mcp), [VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration). Der kanonische Einstiegspunkt für eine lokale Bridge lautet: ``` python -m tgwitness.mcp_server --url https://your-panel.example/mcp ``` Verwenden Sie die lokale Python-Installation des Clients, in der das MCP-Extra installiert ist. Setzen Sie `TGWITNESS_MCP_TOKEN` in dessen geschützter Umgebung. Halten Sie Zugangsdaten aus Befehlsargumenten und URLs heraus. `tgwitness-mcp` ist derselbe Einstiegspunkt. Das alte Modul `tgwitness.mcp_bridge` und der Name `TGWITNESS_ARCHIVE_TOKEN` bleiben als Kompatibilitätspfade mit einer Warnung erhalten; neue Konfigurationen verwenden `mcp_server` und `TGWITNESS_MCP_TOKEN`. ## Cloudflare Tunnel Leiten Sie die Route `/mcp` des Panels weiter und behalten Sie den Bearer-Header bei. Das Öffnen der MCP-Einstellungen als Administrator registriert die aktuelle Origin des Panels für diesen Durchlauf. Für eine stabile Adresse, die sofort nach einem Neustart verfügbar ist, konfigurieren Sie `TGWITNESS_PUBLIC_URL` vor dem Starten des Panels mit der HTTPS-Origin des Panels. Beliebige Host- und Weiterleitungs-Header registrieren keine vertrauenswürdige Adresse. Host- und Origin-Prüfungen weisen fremde Browser-Origins ab. Antworten verwenden `Cache-Control: no-store`; Autorisierungswerte werden niemals protokolliert. Eine `*.trycloudflare.com`-Adresse ist temporär. Wenn ein Tunnel-Neustart den Hostnamen ändert, aktualisieren Sie die konfigurierte öffentliche URL sowie die MCP-URL jedes Clients. Verwenden Sie einen stabilen Hostnamen für gespeicherte Client-Konfigurationen. ## Tools und Systemgrenzen | Tool | Liest | | --- | --- | | `list_workspaces` | Freigegebene Workspaces | | `list_chats` | Freigegebene Chats | | `search_messages` | Gespeicherter Nachrichtentext innerhalb des ausgewählten Zeitraums; `ranked=true` nutzt [Volltextsuche](https://phishdestroy.io/tgwitness/de/docs/reference/search/) (Wortformen, beste Treffer zuerst, `next_offset` Seitenumschaltung) | | `get_message_versions` | Erfasste Versionen und Löschbeobachtungen | | `get_message_context` | Benachbarte erfasste Nachrichten-IDs | | `get_journal_event` | Einen bereinigten Datensatz mit seiner Quellreferenz | | `get_capture_status` | Erfassungsstatus, zulässige Erfassungsdatensätze und `gap_summary`: Nie beobachtete Nachrichtennummern, pro Kanal oder Supergruppe sowie für die kontoweite Sequenz ([Details](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#missing-message-numbers-gap_summary)); wählen Sie einen Chat aus, um dessen aufgelistete Lücken anzuzeigen | | `get_activity_stats` | Nachrichten nach UTC-Stunde und Wochentag, Tage mit Spitzenauslastung, Anteile an Bearbeitungen und Löschungen, Absender, Domains und `@handles`, mit Erfassungsbereich ([Details](https://phishdestroy.io/tgwitness/de/docs/reference/cli/#activity-statistics)) | | `get_messages_by_date` | Gespeicherte Nachrichten eines Kalendertags in einer benannten IANA-Zeitzone (`Europe/Kyiv`, `UTC`), gemäß der von Telegram gemeldeten Uhrzeit; `from_utc` und `until_utc` den berechneten Tag angeben, einschließlich Sommerzeit | | `get_pinned_messages` | Im aktuellen Chat-Status-Snapshot angeheftete Nachrichten mit ihren gespeicherten Versionen sowie die live beobachteten Benachrichtigungen zum Anheften und Lösen der Anheftung | | `get_chat_stats` | Einfache Zählung der gespeicherten Datensätze für einen Chat oder alle Chats im Erfassungsbereich, erste und letzte Beobachtung sowie `gap_summary`; nutzen Sie es vor einem umfangreichen Lesevorgang | | `get_topics` | Forenthemen aus den Nachrichten des Dienstes „Themen speichern“: Titelverlauf, geschlossene oder ausgeblendete Themen, Anzahl der gespeicherten Nachrichten | | `get_media` | Ein gespeichertes Bild als verkleinerte JPEG-Vorschau (maximal 36 KB), das als Bild zusammen mit seinem SHA-256-Hash und dem `media.saved` Datensatz zurückgegeben; die Datei wird zunächst anhand ihres aufgezeichneten Hash-Werts überprüft, andere Dateien geben nur Metadaten zurück | | `export_messages` | Nur über die Befehlszeile, standardmäßig nicht ausgewählt: „streams“ speichert Beobachtungen als JSON Lines ([Details](https://phishdestroy.io/tgwitness/de/docs/reference/cli/#export)); wird über MCP nicht angeboten | Jedes Tool ist schreibgeschützt (`readOnlyHint`) und definiert ein Ausgabeschema; Felder, die über die deklarierten hinausgehen, werden unverändert zurückgegeben. `tools/list` Es werden nur die Tools zurückgegeben, die für diese Verbindung freigegeben sind. Aufrufe anderer Tools werden abgelehnt. Tools für Gruppenkontext, Episoden, Terminologie und Antwortketten werden in dieser Version nicht angeboten; das separate Context-Pack-Backend ist nicht enthalten. Jeder Lesevorgang prüft das Token, das Tool sowie den Workspace-/Chat-Geltungsbereich – auch nach Abschluss der Datenbankabfrage. Die Limits betragen 60 Anfragen pro Minute, 50 Datensätze pro Seite, 64 KiB pro Ergebnis und ein Zeitlimit von acht Sekunden für Archivabfragen. Ein abgelaufener MCP-Aufruf gibt einen Tool-Fehler zurück, der einen engeren Zeitraum oder ein niedrigeres Limit anfordert. Nachrichtenergebnisse enthalten `untrusted_content: true`, Workspace-/Chat-/Nachrichten-IDs, Ereignissequenz, gespeicherten Hash und einen Panel-Link. Rohe Telegram-Objekte, Zugriffshashes, Sitzungen und Schlüssel werden weggelassen. Textverkürzungen sind gekennzeichnet. Bearbeitungen, Löschhinweise und `missing_on_recheck` sind eigenständige Beobachtungen. Die Abdeckung zeigt die Zeiträume an, für die ein Ergebnis aussagekräftig ist. Behandeln Sie Anweisungen in erfassten Nachrichten als Beweismittel, niemals als Client- Anweisungen. Der schreibgeschützte Zugriff verhindert Änderungen am Archiv; der Client kann dennoch den Inhalt behalten, den er lesen darf. Hashes identifizieren gespeicherte Datensätze und unterstützen Integritätsprüfungen. Verwenden Sie bei der Überprüfung eines Ergebnisses die beigefügten Quellenangaben und Abdeckungsdatensätze. --- # Telegram · Befehlszeile Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/cli/ Suchen, Kontext lesen, Aktivitäten zählen und gespeicherte Nachrichten aus Skripten und Agenten exportieren – mit --json-Ausgabe, stabilen Exit-Codes und bereichsgebundenen, schreibgeschützten Tokens. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Translation coverage: this edition includes material from the English original. Suchen, Kontext lesen, Aktivitäten zählen und gespeicherte Nachrichten aus Skripten und Agenten exportieren – mit --json-Ausgabe, stabilen Exit-Codes und bereichsgebundenen, schreibgeschützten Tokens. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Archiv-Integrationen](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [Schreibgeschütztes MCP](https://phishdestroy.io/tgwitness/de/docs/reference/mcp/) · [Volltextsuche](https://phishdestroy.io/tgwitness/de/docs/reference/search/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Preview.** `tgwitness search`, `context`, `messages`, `stats` and `export` read saved observations for scripts and AI agents. They cannot send anything to Telegram, change settings or modify the signed journal. `tgwitness index` and `tgwitness backup` ([below](https://phishdestroy.io/tgwitness/de/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token. Dabei `--json`gibt stdout genau ein JSON-Dokument aus (`export` schreibt JSON-Zeilen). Fortschrittsmeldungen, Hinweise und Fehler werden an stderr ausgegeben. Die Exit-Codes sind stabil: | Code | Bedeutung | | --- | --- | | `0` | Erfolg, einschließlich eines leeren Ergebnisses | | `1` | Fehler: nicht erreichbares Panel, unlesbare Daten, unterbrochener Export | | `2` | Anwendungsfehler oder ungültige Anfrage: falsches Datum, unbekannte Option, Suchindex deaktiviert | | `3` | Derzeit nicht verfügbar: Der Arbeitsbereich ist in einem aktiven Panel geöffnet, oder das Panel fordert dazu auf, es später erneut zu versuchen (Ratenbegrenzung, Zeitüberschreitung). | | `4` | Zugriff verweigert: fehlendes, abgelaufenes oder widerrufenes Token, ein Chat außerhalb des Gültigkeitsbereichs, ein Tool, das dies nicht zulässt | ## Zwei Lesemöglichkeiten **Über das Bedienfeld (`--url`).** Der Befehl verwendet dieselbe bereichsbezogene Archiv-API wie MCP. Erstellen Sie eine Verbindung unter **Weitere Tools → Integrationen → MCP**: Wählen Sie Arbeitsbereiche und Chats, Tools und eine Gültigkeitsdauer aus und kopieren Sie das Token einmal. Die Verbindung ist schreibgeschützt, beschränkt auf diese Chats, auf 60 Anfragen pro Minute begrenzt und kann jederzeit widerrufen oder erneuert werden. Panel-Anmeldetoken und Telegram-Anmeldedaten funktionieren hier nicht. ``` export TGWITNESS_URL=https://panel.example.org # default http://127.0.0.1:8787 export TGWITNESS_MCP_TOKEN=tgw_mcp_... # or --token-file path tgwitness search 'перевод карта' --json ``` Ein Remote-Panel benötigt HTTPS; einfaches HTTP wird nur für `127.0.0.1`, `localhost` und `::1`. Proxy-Umgebungsvariablen werden ignoriert und Weiterleitungen abgelehnt, sodass das Token ausschließlich die von Ihnen angegebene Adresse erreicht. **Direkt aus einem angehaltenen Arbeitsbereich (`--data-dir`).** Liest das Datenverzeichnis mit vollständigem lokalem Zugriff, ohne Token. Verwenden Sie es auf einer Kopie eines Datenverzeichnisses oder während die Erfassung angehalten ist. Signierte Datensätze werden niemals verändert; wie beim Panel kann das Öffnen eines Arbeitsbereichs dazu führen, dass die daraus abgeleiteten Indizes auf den aktuellen Stand gebracht werden. Wenn das Panel den Arbeitsbereich geöffnet hat, beendet sich der Befehl mit dem Code `3`; lesen Sie stattdessen über das Panel. Ohne `--data-dir`, `TGWITNESS_DATA`, `./data/live` oder das Datenverzeichnis der Installation, auf der der Befehl ausgeführt wird, wird verwendet. `--workspace ID` wählt einen Arbeitsbereich aus (Standard `default`). `tgwitness messages --workspaces` listet diejenigen auf, die Sie lesen dürfen. ## Befehle | Befehl | Ergebnis | | --- | --- | | `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | Die besten Treffer zuerst, mit Wortformen, exakten Phrasen in Anführungszeichen, Domains und `@username` ([Syntax](https://phishdestroy.io/tgwitness/de/docs/reference/search/#search-syntax)) | | `tgwitness search QUERY --exact [--before SEQ]` | Genauer Wortlaut, neueste Einträge zuerst, ohne Index | | `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | Gespeicherte Nachrichten innerhalb von zehn Nachrichten-IDs auf beiden Seiten | | `tgwitness messages [--limit N] [--offset N]` | Chats, die Sie lesen können | | `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | Gespeicherte Nachrichten des Chats, die neuesten zuerst | | `tgwitness messages CHAT_ID --message ID` | Jede gespeicherte Version und jeder Löschdatensatz einer Nachricht | | `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | Aktivitätsstatistiken, siehe unten | | `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | Gespeicherte Beobachtungen als JSON-Zeilen in der Reihenfolge des Protokolls | Datumsangaben erfolgen `2026-10-01` (UTC-Mitternacht) oder ISO-Zeiten mit Zeitzone `2026-10-01T09:00+03:00`. Für `search`, `messages` und `export` wählen sie den Beobachtungszeitpunkt. Seiten fassen bis zu 50 Datensätze: Befolgen Sie `next_offset` (`--offset`) für die rangierte Suche und `next_before` (`--before`) an anderer Stelle. Ranked search stops at 1,000 results. The final page may be shorter than `--limit`. When more observations match, the last page says so (`truncated: true` with `--json`); narrow the query, chat or period. Jedes Nachrichtenergebnis enthält `untrusted_content: true` , die Arbeitsbereichs-, Chat- und Nachrichten-IDs, die Journalsequenz, den Hash des gespeicherten Datensatzes und einen Panel-Link. Bearbeitungen, Löschhinweise und `missing_on_recheck` sind separate Datensätze. Die Abdeckung in `stats` zeigt die Zeiträume an, auf die sich ein Suchergebnis bezieht. ### Aktivitätsstatistiken `stats` Zählt die gespeicherten Beobachtungen für einen Chat, einen Absender oder alle Chats im Erfassungsbereich: - Nachrichten nach UTC-Stunde und nach Wochentag (Montag an erster Stelle), verkehrsreichste Stunden und Tage; - bearbeitet, gelöscht und `missing_on_recheck` Freigaben; - Absender mit Nachrichtenanzahl sowie Zeitangaben für die erste und letzte Nachricht; - die häufigsten Domains und `@handles`, einmal pro Nachricht über alle gespeicherten Versionen hinweg gezählt; - Erfassungsbereich: `coverage.gap` Aufzeichnungen sowie – für den Zugriff auf den gesamten Arbeitsbereich – Zeiträume ohne Heartbeat eines verbundenen Collectors (`collector_liveness`). Der Zeitraum umfasst **die von Telegram gemeldete Zeit der Nachricht**. Die Anzahl der Stunden und Wochentage hilft bei der Schätzung der Zeitzone eines Absenders. Die Zahlen werden auf Anfrage aus dem Journal berechnet und nicht gespeichert. Jedes Ergebnis nennt den Journal-Anfang, den es abdeckt, wenn Ihr Zugriff den gesamten Arbeitsbereich umfasst. Das Einlesen wird nach fünf Sekunden über das Panel oder nach `--timeout`-Sekunden lokal (Standard 30) beendet; dann ist `complete` falsch und `partial` bezeichnet den ersten Datensatz, der nicht gelesen wurde. In diesem Fall werden nur die neuesten Datensätze gezählt. ### Exportieren `export` Schreibt pro gespeicherter Beobachtung (neue Nachrichten, Snapshots, Bearbeitungen, wiederhergestellte Nachrichten, Löschbenachrichtigungen, `missing_on_recheck` und gespeicherte Mediendateien ) in der Reihenfolge des Protokolls. Jede Zeile enthält dieselben Felder wie die anderen Einträge, einschließlich des vollständigen Textes. Bei `--output`wird die Datei unter einem `.partial` Namen abgelegt und erst nach dem Abschlussprotokoll des Panels umbenannt; ein unterbrochener Export hinterlässt keine Datei und beendet den Vorgang mit dem Code `1`. `--output` überschreibt niemals eine vorhandene Datei. Mit `--output` und `--json`wird über stdout eine Zusammenfassung ausgegeben: Datensatzanzahl, letzte Journal- Sequenz und, bei Zugriff auf den gesamten Arbeitsbereich, der Journal-Anfang. Ein Export über das Panel erfordert eine Verbindung, die **Export-Nachrichten zulässt (nur über die Befehlszeile)** ; diese Option ist standardmäßig nicht ausgewählt. Diese Datei ist eine Arbeitskopie; für eine überprüfbare Übergabe verwenden Sie den signierten Export unter **Exports** , der mit `python -m tgwitness.verify` überprüft wird. Das Panel überprüft den Zugriff vor der Ausgabe jedes Datensatzes erneut, einschließlich des Abschlussdatensatzes. Ein widerrufener oder abgelaufener Zugriff führt zu einem unvollständigen Export. Lazy-Page-Lesevorgänge teilen sich das Limit der Archiv-Worker mit anderen Abfragen und unterliegen einer begrenzten Wartezeit. ### Index and backup These two commands read the data directory directly and take no token or `--url`. | Befehl | Ergebnis | | --- | --- | | `tgwitness index status [--workspace ID] [--data-dir DIR] [--json]` | Search index state of one workspace or, by default, every workspace: mode, `ready`, `building` or `not built`, indexed and journal head sequence. Works while the panel runs | | `tgwitness index rebuild [--workspace ID] [--data-dir DIR] [--json]` | Rebuilds the index from the first journal record. Rewrites only the derived index, never the signed journal. Exits with code `3` while the panel has the workspace open. Nothing is built when the workspace keeps its index in memory or has search off | | `tgwitness backup FOLDER [--data-dir DIR] [--json]` | Copies the whole data directory into a new or empty folder outside it while the panel keeps running, and writes `backup-manifest.json` with every file's SHA-256 and the journal heads | `index` accepts `--workspace default` or a workspace ID; the default is `all`. The backup skips temporary exports, SQLite sidecar files and lock files. The folder holds the Telegram session and signing keys, so keep it as private as the data directory. [Backup, restore, and capacity](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records. ## Agent-Fähigkeit [`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) erklärt einem Agenten, wie diese Befehle zu verwenden sind, wie Datensätze zu zitieren sind und wie mit erfasstem Text umzugehen ist. Agenten, die `.agents/skills` laden diese aus einem Repository-Checkout . Für Claude Code kopieren Sie den `tgwitness-cli` Ordner in `.claude/skills/` in Ihr Projekt oder `~/.claude/skills/`. ## MCP und die Befehlszeile Beide nutzen dieselben Verbindungen, Gültigkeitsprüfungen und Beschränkungen. MCP-Ergebnisse sind auf eine 64-KiB-Seite begrenzt, daher bietet MCP keinen Massenexport an; die Befehlszeile gibt die Daten per Stream aus. `get_activity_stats` ist für beide verfügbar. --- # Telegram · Lokale OCR und Transkription Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/media-analysis/ Erkennen Sie erfasste Bilder und Audiodateien mit einem lokalen Worker; verknüpfen Sie den abgeleiteten Text weiterhin mit der Quelldatei. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Erkennen Sie erfasste Bilder und Audiodateien mit einem lokalen Worker; verknüpfen Sie den abgeleiteten Text weiterhin mit der Quelldatei. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/) ![Untersuchung](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [Anleitung zum Arbeitsablauf](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Öffnen Sie einen Journal-Eintrag `media.saved` , wählen Sie **Anhang erkennen** und wählen Sie anschließend OCR oder Transkription unter **Weitere Tools → „Das Archiv fragen** “ (bezeichnet als **Maschinelle Erkennung,** wenn die Archiv-KI deaktiviert ist). Die Verarbeitung erfolgt manuell und lokal. Es gibt keinen Cloud-Medienmodus und keinen automatischen Upload. Die ursprünglichen Bytes des Anhangs und `media_sha256` bleiben unverändert; der erkannte Text wird ausdrücklich als maschinelle Erkennung gekennzeichnet und separat mit dem Quell-Hash, der Engine-/Modellversion, der Sprache, den Parametern und der Fertigstellungszeit gespeichert. Transkripte behalten die zurückgegebenen Zeitstempel bei. Durchsuchen Sie diese Ergebnisse mithilfe **der Suche nach erkanntem Text** und des OCR-/Transkript-Filters oder wählen Sie erkannten Text als Quelle für eine **„Journal** Best-Match“-Suche. Beide suchen nach Wortformen über einen [In-Memory-Index](https://phishdestroy.io/tgwitness/de/docs/reference/search/#recognized-text). Hierbei handelt es sich um eine separate Suche in abgeleiteten Daten; sie wandelt die maschinelle Erkennung nicht stillschweigend in den ursprünglichen Telegram-Text um und fügt ihn auch nicht zu signierten Ereignissen hinzu. ## Richten Sie den optionalen Worker ein Version 1 erfordert einen Linux-Host mit einem lokalen Docker-Daemon. Unter Windows kann TgWitness in einer Linux-VM/WSL-Umgebung mit einem eigenen lokalen Daemon ausgeführt werden. Das Panel entschlüsselt niemals selbst einen nicht vertrauenswürdigen Anhang. ``` docker build -f deploy/media-worker/Dockerfile -t tgwitness-media:local . export TGWITNESS_MEDIA_IMAGE=tgwitness-media:local ``` Setzen Sie diese Variablen in der TgWitness-Serviceumgebung und starten Sie den Dienst neu. Der Daemon-Socket ist standardmäßig auf „`/var/run/docker.sock`“ eingestellt; bei rootlosen Bereitstellungen kann „ `TGWITNESS_DOCKER_SOCKET`“ festgelegt werden. Der Worker nutzt explizit diesen Unix-Socket anstelle eines entfernten Docker-Kontexts. Geben Sie die Docker-API nicht für Panel-Benutzer frei und mounten Sie den Socket nicht innerhalb des Erkennungscontainers. Für die Transkription installieren Sie separat ein CTranslate2-kompatibles Whisper-Modell und legen Sie anschließend `TGWITNESS_WHISPER_MODEL_DIR` auf dessen Verzeichnis fest. Der Worker lädt es mit `local_files_only=True`; das ausgewählte Modell und die Eingabe werden schreibgeschützt eingebunden. Siehe die [Dokumentation zum Laden von Modellen](https://github.com/SYSTRAN/faster-whisper) der Engine. Das mitgelieferte OCR-Image enthält trainierte Daten für Englisch und Russisch. Integrieren Sie bei Bedarf eine weitere Sprache in Ihr Image; die Sprachcodes entsprechen [denen der Tesseract-Befehlszeilenschnittstelle](https://tesseract-ocr.github.io/tessdoc/Command-Line-Usage.html). Während der Verarbeitung wird kein Modell abgerufen. Die Erstellung/der Download des Setups kann eine Netzwerkverbindung erfordern; bei jedem einzelnen Erkennungscontainer ist die Netzwerkverbindung deaktiviert. Installieren Sie das Image, bevor Sie es aktivieren; die Laufzeitumgebung verwendet „`--pull=never`“. ## Grenzen und Wiederherstellung Der Container läuft als Benutzer ohne Sonderrechte mit einem schreibgeschützten Root-Zugang, reduzierten Rechten, `no-new-privileges` , einer CPU, 2 GiB Arbeitsspeicher, einer PID-Begrenzung und einem begrenzten temporären Dateisystem. Es werden nur eine verifizierte Kopie der ausgewählten Datei und ein optionales Modellverzeichnis eingebunden. Die Datenbank, der Tresor und die Sitzung des Collectors werden nicht eingebunden. Die [Docker-Laufzeit-Flags](https://docs.docker.com/reference/cli/docker/container/run/) erzwingen diese Beschränkungen; es handelt sich hierbei um eine Containergrenze, nicht um eine Hardware-Enklave. Dateien sind auf 50 MiB begrenzt, Bilder auf 20 Millionen Pixel, Audiodateien auf 30 Minuten mit bekannter Dauer und die Verarbeitung auf fünf Minuten. Es läuft jeweils nur ein Worker, mit maximal 20 Aufgaben in der Warteschlange bzw. in Ausführung und 100 gespeicherten Aufgaben pro Arbeitsbereich. „Cancel“ stoppt den Container; „Retry“ erstellt einen neuen Auftrag, der mit dem vorherigen Versuch verknüpft ist. Unterbrochene Aufträge werden nach dem Neustart entsprechend gekennzeichnet. Die Verarbeitung kann fehlschlagen, wenn ein Modell die konfigurierten Grenzen nicht einhalten kann; ohne Isolierung läuft es nicht im Hintergrund weiter. --- # Telegram · Ausgehende Webhooks Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/webhooks/ Sendet definierte Ereignisse mit HMAC-Signaturen, Wiederholungsversuchen und Zustellstatus an HTTPS-Empfänger. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Sendet definierte Ereignisse mit HMAC-Signaturen, Wiederholungsversuchen und Zustellstatus an HTTPS-Empfänger. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Archiv-Integrationen](https://phishdestroy.io/tgwitness/de/docs/reference/cli/) ![Archiv-Integrationen](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [Anleitung zum Arbeitsablauf](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) Öffnen Sie im ausgewählten Arbeitsbereich **Weitere Tools → Integrationen → Ausgehende Webhooks**. Fügen Sie einen HTTPS- Empfänger hinzu, wählen Sie Collector/Media/Export-Ereignisse und wählen Sie optional Chats für neue Beobachtungen und Änderungen aus. Der Nachrichtentext ist standardmäßig deaktiviert. Durch das Aktivieren von Auszügen werden den Ereignissen zu Nachrichtenänderungen maximal 1,000 Zeichen hinzugefügt; Telegram-Rohfelder und Anmeldedaten werden niemals gesendet. Kopieren Sie den HMAC-Schlüssel einmalig in die geschützte Konfiguration des Empfängers. Er wird im Tresor von TgWitness verschlüsselt und kann nicht über das Panel abgerufen werden. Löschen Sie ein Ziel und erstellen Sie es neu, um es zu rotieren. **Senden Sie synthetische**Testwarteschlangen einen Test ohne Chat-Inhalt; aktualisieren Sie den Zustellstatus, um das Ergebnis zu sehen. Die Bereitstellung erweitert den bestehenden Benachrichtigungskreislauf neben Apprise. Sie nutzt die externe Route des Arbeitsbereichs und bestehende Einschränkungen für private Ziele. Es findet keine direkte Ausweich- oder Weiterleitung statt. URLs dürfen keine Anmeldedaten, Abfragezeichenfolgen oder Fragmente enthalten; private Adressen erfordern die Netzwerk-Zustimmung auf Serverebene, keine Einstellung, die ein Panel-Benutzer umgehen kann. ## Nutzdaten und Signatur Schema: [`tgwitness.webhook/1`](https://github.com/phishdestroy/TgWitness/blob/main/integrations/webhook.schema.json). Jede Nutzlast enthält `event_id`, `timestamp`, `workspace`, `type`, `synthetic` und Zähler. Protokollbasierte Ereignisse enthalten ihre Reihenfolge und ihren Hashwert. Der Abschluss eines vollständigen Exports und synthetische Tests sind Übermittlungsereignisse ohne erfundenen Verweis auf ein signiertes Protokoll. Telegram-Löschbenachrichtigungen und `missing_on_recheck` bleiben eigenständige Typen. Der Header „`X-TgWitness-Signature`“ lautet „`t=UNIX_SECONDS,v1=HEX_HMAC_SHA256`“. Berechnen Sie den HMAC über die exakten Bytes „`timestamp + "." + raw_request_body`“, wobei das angezeigte Geheimnis als UTF-8-Bytes verwendet wird. Vergleichen Sie die Signaturen in konstanter Zeit, bevor Sie den Textkörper analysieren oder darauf reagieren. Verwerfen Sie Zeitstempel, die mehr als fünf Minuten von Ihrer Uhr abweichen. Der Zeitstempel wird bei jedem Zustellversuch aktualisiert. Verwenden Sie „`event_id`“ als Idempotenzschlüssel in einem dauerhaften Speicher mit einer atomaren Eindeutigkeitsbeschränkung vor Nebenwirkungen. Eine gültige Signatur allein verhindert nicht, dass eine kürzlich erfolgte Anfrage erneut abgespielt wird. Bewahren Sie verarbeitete IDs mindestens für die gesamte Wiederholungsdauer auf; bewahren Sie sie länger auf, wenn der Empfänger gespeicherte Ereignisse erneut verarbeiten kann. ## Wiederholungsversuche Übertragungen werden vor HTTP-Anfragen dauerhaft in eine Warteschlange gestellt. Sie verwenden eine At-Least-Once- Semantik: Eine verlorene Bestätigung oder ein Neustart kann dazu führen, dass ein Ereignis erneut mit derselben ID übermittelt wird. Es gibt acht Versuche mit exponentiellem Backoff, beginnend bei 15 Sekunden und begrenzt auf eine Stunde. Für einen Erfolg ist eine 2xx-Antwort erforderlich. Ein Job, der seine Wiederholungsversuche ausgeschöpft hat, bleibt mit seinem Fehler zur Überprüfung sichtbar. Die Warteschlange fasst 1.000 Zustellungen. Ist sie voll, wird das Scannen der Protokollereignisse unterbrochen und fortgesetzt, sobald wieder Speicherplatz verfügbar ist. Ein vollständiger Export, der nicht in die Warteschlange gestellt werden kann, löst einen sichtbaren Warteschlangenfehler aus. Pro Benachrichtigungsdurchlauf werden bis zu fünf Zustellversuche unternommen, und die letzten 100 Versuchsdatensätze werden gespeichert. Durch das Entfernen eines Ziels werden auch dessen ausstehende Zustellungen entfernt. ## n8n-Beispiel Importieren Sie [den Beispiel-Workflow](https://github.com/phishdestroy/TgWitness/blob/main/integrations/n8n-tgwitness.json). Er ist inaktiv und enthält keine vertraulichen Daten oder nachgelagerte Aktionen. Legen Sie „`TGWITNESS_WEBHOOK_SECRET`“ in der n8n-Worker-Umgebung fest, gewähren Sie dieser Umgebung Zugriff und aktivieren Sie die integrierte Funktion „`crypto`“ für den Code-Knoten. Das Beispiel nutzt die Option „raw-body“ des Webhook-Knotens, überprüft Signatur und Aktualität und bestätigt validierte Ereignisse. Dies entspricht der [dokumentierten Implementierung](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/Webhook/Webhook.node.ts) des Knotens. Bevor Sie SIEM-Einträge oder Benachrichtigungen hinzufügen, richten Sie einen dauerhaften, idempotenten Speicher ein, der mit `event_id` verschlüsselt ist. Beschränken Sie die Bearbeitung von n8n-Workflows und die Aufbewahrung von Ausführungsprotokollen entsprechend den Daten, die Sie zum Versand ausgewählt haben. TgWitness fügt keine eingehenden Befehle hinzu. --- # Telegram · Öffentliches Showcase Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/showcase/ Veröffentlichen Sie gespeicherte Nachrichten ausgewählter öffentlicher Kanäle und signierte Momentaufnahmen über zeitlich begrenzte, widerrufbare Links. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Veröffentlichen Sie gespeicherte Nachrichten ausgewählter öffentlicher Kanäle und signierte Momentaufnahmen über zeitlich begrenzte, widerrufbare Links. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/) ![Bereitstellung und Wiederherstellung](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **Weitere Tools → Zugriff → Public Showcase** erstellt eine separate, schreibgeschützte Seite unter Verwendung des bestehenden Zugriffstoken-Systems. Es liest die gespeicherten Beobachtungen der Installation aus. Es startet keinen Collector, meldet sich nicht bei Telegram an und richtet keinen Kanal für einen Besucher ein. ## Eine Seite veröffentlichen 1. Speichern Sie für jeden öffentlichen Kanal, den Sie anzeigen möchten, ein Quellprofil. Ein Kanal muss in seinem zuletzt gespeicherten Profil einen öffentlichen Benutzernamen haben; Gruppen und private Chats kommen nicht in Frage. 2. Öffnen Sie als Administrator **Weitere Tools → Zugriff → Öffentliche Präsentation** (oder `/showcase-manage.html`). 3. Wählen Sie Kanäle aus bis zu 16 Arbeitsbereichen aus, geben Sie den Titel der öffentlichen Seite ein und wählen Sie eine Gültigkeitsdauer des Links von 1, 7 oder 30 Tagen. Interne Arbeitsbereichsbezeichnungen werden nicht veröffentlicht. Es können bis zu 64 Kanäle einbezogen werden. 4. Überprüfen Sie den Text der ausgewählten Kanäle vor der Veröffentlichung und klicken Sie anschließend auf **„Vorschau der ausgewählten Datensätze**“. Die Vorschau verwendet dieselbe serverseitige Projektion wie die Besucherseite. 5. Klicken Sie auf **„Showcase-Link erstellen**“. Kopieren Sie den Link, solange er sichtbar ist. Öffnen Sie ihn in einem separaten Browser, um die Seite des Empfängers zu überprüfen, bevor Sie ihn weiterleiten. Der Link enthält ein Zugriffstoken im URL-Fragment. Die Seite entfernt das Fragment vor dem Absenden von API-Anfragen und tauscht es gegen eine Browsersitzung aus. Jeder, der den Link besitzt, kann das ausgewählte Material bis zum Ablauf oder zur Widerrufung öffnen. Neue Links erlauben 100 gleichzeitige Sitzungen, die jeweils höchstens eine Stunde dauern. Bestehende Zugriffskontrollen können über die Grant-API auch Adressbeschränkungen und Anmeldebegrenzungen durchsetzen. Der normale Prüferzugriff ist ein anderer Modus und umfasst weiterhin die ursprünglich zugelassenen Nachrichten und Dateien. ## Was Besucher sehen | Sichtbar | Privat gehalten | | --- | --- | | Ausgewählte Titel öffentlicher Kanäle, Benutzernamen und Daten der Profilbeobachtung | Kontoidentitäten, interne Arbeitsbereichsbezeichnungen und nicht ausgewählte Quellen | | Erfasster Text und jede gespeicherte Bearbeitung | Strukturierte Absender-IDs, Namen, Benutzernamen, Telefonnummern und Profilwerte | | Löschmeldungen mit dem zuvor gespeicherten Text, sofern verfügbar | Anhänge, Avatare, Miniaturansichten, Dateinamen und Originaldaten | | Markierungen, die anzeigen, dass ein Autor/Profil oder ein Anhang erfasst wurde | Metadaten zu Weiterleitungen und Antworten, Netzwerkwege, IP-Adressen und Anmeldedaten | | Ereignisanzahlen für ausgewählte Kanäle, aktuelle Sammlungsschalter, Heartbeat- und Checkpoint-Intervall | Steuerelemente für die Datenerfassung und gängige APIs zum Export von Beweismaterial | | Signatur-Fingerabdruck, Journal-Checkpoint und Konsistenznachweis | Signaturschlüssel und Telegram-Sitzungen | **Der Text öffentlicher Nachrichten wird nicht automatisch anonymisiert.** Ein Name, eine Erwähnung, eine Telefonnummer oder ein Link, die in der Nachricht enthalten sind, bleiben Teil dieses Textes. `Redacted`Dies gilt für die strukturierten Autoren-/Profilfelder. Überprüfen Sie den tatsächlich ausgewählten Inhalt vor der Veröffentlichung, einschließlich beibehaltener Bearbeitungen und Löschungen. Die Berechtigung spiegelt das **zuletzt gespeicherte Quellprofil** wider, nicht eine Live-Abfrage bei Telegram. Wenn ein nachfolgendes Profil keinen öffentlichen Kanal-Benutzernamen mehr enthält, schließen neue Anfragen den Kanal aus. Aktualisieren Sie die Quellprofile, wenn sich die öffentliche Sichtbarkeit ändert. Leser haben möglicherweise bereits Material gespeichert, das sie zuvor erhalten haben. Die ursprünglichen signierten Datensätze bleiben unverändert. Die angezeigte Projektion wird separat signiert und enthält Hashes, die auf die ursprünglichen Datensätze verweisen. Die Signatur der Projektion authentifiziert die angezeigte Aussage, und die referenzierten ursprünglichen Datensätze behalten ihre eigenen Signaturen bei. ## Signaturen und Kontinuität prüfen Erweitern Sie **„Fingerabdruck & signierter Checkpoint“** und laden Sie einen Snapshot herunter. Nach einer Seitenaktualisierung enthält der Download den vorherigen Browser-Snapshot und einen Merkle- Konsistenznachweis zwischen deren Journalgrenzen. Die automatische Aktualisierung erfolgt einmal pro Minute, solange die Seite sichtbar ist und ihre erste Seite mit Beobachtungen anzeigt. Nachdem Sie TgWitness installiert haben, überprüfen Sie die heruntergeladene Datei offline: ``` python -m tgwitness.showcase_verify showcase.json --fingerprint TRUSTED_COLLECTOR_SHA256 ``` Der Fingerabdruck muss von einer separat vertrauenswürdigen Referenz stammen. Um einen Vergleich mit einem von Ihnen selbst gespeicherten Snapshot durchzuführen, verwenden Sie `--previous earlier.json`; dies überschreibt den vorherigen Snapshot, der im Download enthalten ist. Der aktuelle Nachweis muss an dieser gespeicherten Grenze beginnen. Authentifizierte Clients können diesen Nachweis mit `GET /api/showcase/{workspace_id}?challenge=<32-hex-random>&from_count=`. Ein kürzeres Journal gibt einen HTTP-409-Fehler zurück, anstatt die Grenze stillschweigend zurückzusetzen. Der signierte Checkpoint wird für das **gesamte Collector-Journal** festgeschrieben, einschließlich seiner Datensatzanzahl und des undurchsichtigen Head-Hash. Die angezeigten Nachrichtenzahlen gelten nur für die ausgewählten öffentlichen Kanäle. Die Seite listet niemals den Inhalt des anderen Journals auf. Es handelt sich um Ereigniszahlen, nicht um die Anzahl eindeutiger Nachrichten. Die Einstellungen beschreiben die aktuelle Konfiguration, nicht jedes frühere Aufzeichnungsintervall. Die Signatur- und Konsistenzprüfung kann Änderungen relativ zu einer festgelegten Grenze erkennen. Zählen Sie die gemeldeten Ereignisse aus dem entsprechenden Archiv nach und überprüfen Sie die Erfassungsintervalle sowie die gespeicherten Zeugen-Checkpoints gemeinsam. Verwenden Sie den [Beweisprüfer](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md), [den unabhängigen Zeugen](https://phishdestroy.io/tgwitness/de/docs/reference/witness/) und [den Datensatz im getesteten Maßstab](https://phishdestroy.io/tgwitness/de/docs/reference/verification/). Synthetische Installationen sind sichtbar als synthetisch gekennzeichnet. ## Seite widerrufen oder hosten Verwenden Sie **„Revoke“** im Showcase-Manager oder im bestehenden Abschnitt **„Zugriff“,** um den Link zu schließen und alle zugehörigen Sitzungen zu beenden. Der Besucher löscht angezeigte Datensätze, sobald eine Anfrage feststellt, dass der Zugriff beendet wurde. Ablaufdatum und Berechtigungen werden bei jeder Anfrage überprüft. Showcase-Berechtigungen können nicht direkt in einen gewöhnlichen Panel-Zugriff umgewandelt werden; erstellen Sie eine neue Berechtigung, um den Modus zu ändern. Die Seite wird über die bestehende HTTPS-Adresse der Installation bereitgestellt. Das Veröffentlichen eines Links öffnet keinen neuen Port, erstellt keinen Tunnel und ändert keine DNS-Einstellungen. Der HTML-Code und die API bleiben auf der Installation des Nutzers. Ein Besucher der Demo kann mit diesem Zugriff die üblichen APIs für Nachrichten, Profile, Medien, Export oder Verwaltung nicht nutzen. --- # Telegram · So funktioniert das Beweismaterial Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/ Hash-Kette, Signaturen, Kontrollpunkte und Zeugen werden anhand der genauen Formeln erläutert, die der Verifizierer verwendet. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Hash-Kette, Signaturen, Kontrollpunkte und Zeugen werden anhand der genauen Formeln erläutert, die der Verifizierer verwendet. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Beweise und Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) ![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness bewahrt die Beobachtungen eines Sammelkontos auf, verknüpft diese Beobachtungen zu einem signierten Journal und ermöglicht es einer anderen Person, einen Export anhand eines vertrauenswürdigen Schlüssels, einer externen Zeitangabe eines Dritten und eines zuvor gespeicherten Checkpoints zu verifizieren. Die [lokale Dokumentationswebsite](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally) enthält zusätzlich interaktive Beispiele unter `/docs/concepts/`, einen Checkpoint-Entscheidungs-Explorer unter `/docs/witness/` sowie Anleitungen für [das Case Board](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/), [die Berichtsgestaltung](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/) und [Auszüge zur Übergabe](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#handover-extract). Alle Beispielnachrichten, Zahlenangaben und Verzögerungen sind fiktiv. Hashes in der Chain-Sandbox werden mit SHA-256 im Browser berechnet. Es werden keine Daten an Telegram gesendet. **Auf dieser Seite** - [Eine Nachricht ändert sich; Beobachtungen sammeln sich an](https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/#a-message-changes-observations-accumulate) - [Was ein Hash abdeckt](https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/#what-a-hash-covers) - [Was ein früherer Checkpoint hinzufügt](https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds) - [Wo ein Witness hingehört](https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/#where-a-witness-belongs) - [Testdurchführung anhand bekannter Aktionen](https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/#test-delivery-against-known-actions) - [Wählen Sie einen Arbeitsablauf aus](https://phishdestroy.io/tgwitness/de/docs/reference/how-it-works/#pick-a-workflow) ## Eine Nachricht ändert sich; Beobachtungen sammeln sich an Sequenzdiagramm · Telegram → Collector: Neue Nachricht: Treffen um 10:00 Uhr; Collector → Signiertes Protokoll: Nachricht.new anhängen; Telegram → Collector: Bearbeitet: Treffen um 11:00 Uhr; Collector → Signiertes Protokoll: Nachtrag: Nachricht.bearbeitet; Telegram → Collector: Hinweis zur Löschung; Collector → Signiertes Protokoll: Nachtrag: message.deleted; Anmerkung zu Signiertes Protokoll: Original + Bearbeitung + Löschvorgang bleiben erhalten · Telegram · Collector · Signiertes Protokoll · Neue Nachricht: Treffen um 10:00 Uhr · Nachricht.new anhängen · Bearbeitet: Treffen um 11:00 Uhr · Nachtrag: Nachricht.bearbeitet · Hinweis zur Löschung · Nachtrag: message.deleted · Original + Bearbeitung + Löschvorgang bleibenerhalten **Diagramm als Text** 1. Telegram → Collector: Neue Nachricht: Treffen um 10:00 Uhr 2. Collector → Signiertes Protokoll: Nachricht.new anhängen 3. Telegram → Collector: Bearbeitet: Treffen um 11:00 Uhr 4. Collector → Signiertes Protokoll: Nachtrag: Nachricht.bearbeitet 5. Telegram → Collector: Hinweis zur Löschung 6. Collector → Signiertes Protokoll: Nachtrag: message.deleted 7. Anmerkung zu Signiertes Protokoll: Original + Bearbeitung + Löschvorgang bleiben erhalten Diese vereinfachte Abfolge geht davon aus, dass Telegram jede Aktualisierung zugestellt hat und das ausgewählte Konto diese einsehen konnte. Auch operative Ereignisse werden im Protokoll erfasst. Eine Löschmeldung gibt weder den Löschenden noch einen genauen Löschzeitpunkt an. Wiederholte Zustellungen gelten als separate Beobachtungen; es erfolgt keine protokollweite Unterdrückung von Duplikaten. ## Was ein Hash abdeckt ![Beobachten, kodieren, hashen und signieren: Jedes neue Ereignis enthält den vorhergehenden Hashwert.](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c) Lesen Sie die Formel von innen nach außen: „**C**“ wandelt die neun Felder in exakte Bytes um; **„SHA-256“** erzeugt deren Digest; **„hex“** gibt an, wie dieser Digest gespeichert wird. Der vorherige Hash ist bereits im Ereignis enthalten. **„unhex“** wandelt den gespeicherten Hash wieder in die 32 Bytes um, die Ed25519 signiert. [Statisches Ketten-Diagramm](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg) Sei C(ei) das kanonische UTF-8-JSON der neun Ereignisfelder. Der erste Datensatz `previous_hash` besteht aus 64 Nullen. Jeder nachfolgende Datensatz enthält den hexadezimalen Hash des vorhergehenden Datensatzes: hi = hex(SHA256(C(ei))) σi = Ed25519.Sign(sk,unhex(hi)) Die Signatur umfasst die 32 Rohdaten-Byte des Digests. Die Hash-Eingabe enthält genau `seq`, `observed_at`, `source_at`, `kind`, `chat_id`, `message_id`, `actor_id`, `payload` und `previous_hash`. Objektschlüssel sind sortiert; Leerzeichen und ASCII- Escape-Zeichen werden weggelassen; NaN und Unendlich werden verworfen. Siehe die [genaue Kodierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#event-canonicalization). Ablaufdiagramm · 64 Nullen → Eintrag 1 / Hash h1; Eintrag 1 / Hash h1 → Eintrag 2 enthält h1 / Hash h2; Eintrag 2 enthält h1 / Hash h2 → Eintrag 3 enthält h2 / Hash h3; Eintrag 3 enthält h2 / Hash h3 → Signierter Checkpoint: Zählung 3, Überschrift h3 (an anderer Stelle aufbewahren) · 64 Nullen · Eintrag 1 / Hash h1 · Eintrag 2 enthält h1 /Hash h2 · Eintrag 3 enthält h2 /Hash h3 · Signierter Checkpoint:Zählung 3, Überschrifth3 · an anderer Stelle · aufbewahren **Diagramm als Text** 1. 64 Nullen → Eintrag 1 / Hash h1 2. Eintrag 1 / Hash h1 → Eintrag 2 enthält h1 / Hash h2 3. Eintrag 2 enthält h1 / Hash h2 → Eintrag 3 enthält h2 / Hash h3 4. Eintrag 3 enthält h2 / Hash h3 → Signierter Checkpoint: Zählung 3, Überschrift h3 (an anderer Stelle aufbewahren) | Wechseln Sie zum bereitgestellten Protokoll | Was erkennt es? | | --- | --- | | Ändern Sie Datensatz 2, ohne dessen gespeicherten Hash zu verändern | Der neu berechnete Ereignis-Hash weicht ab; seine Signatur deckt das geänderte Ereignis nicht mehr ab | | Rekonstruktion des veränderten Datensatzes und aller nachfolgenden Hash-Werte | Die ursprünglichen Signaturen sind ungültig; ein gespeicherter Prüfpunkt an der betroffenen Grenze weist ebenfalls Abweichungen auf | | Entfernen Sie den Anhang, behalten Sie jedoch das verbleibende Präfix bei | Ein früherer gespeicherter Kontrollpunkt jenseits des angegebenen Präfixes zeigt, dass der Export zu kurz ist | | Ein Ersatzprotokoll mit einem anderen Schlüssel neu signieren | Ein separat vertrauenswürdiger Schlüssel-Fingerabdruck weist die Ersatzidentität zurück | ![Das Ändern eines gespeicherten Feldes verändert dessen Digest; das Neuerstellen von Hashes stellt die ursprünglichen Signaturen nicht wieder her.](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5) **Probieren Sie die Logik bei Datensatz 2 aus:** Ändern Sie „`Meet at 11:00`“ in „`Meet at 12:00`“ im gespeicherten Ereignis. Der neu berechnete Hash stimmt nun nicht mehr überein. Durch die Neuberechnung der nachfolgenden Kette können deren Verknüpfungen zwar wiederhergestellt werden, doch die ursprünglichen Signaturen können die neuen Digests nicht mehr abdecken. Eine beobachtete Bearbeitung in Telegram wird hingegen zu einem neuen Protokoll-Eintrag. [Diagramm der statischen Änderungen](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg) Hash-Links allein verhindern nicht, dass jemand eine Ersatzkette neu berechnet. Vertrauen entsteht durch die Überprüfung von Signaturen unter einem unabhängig vertrauenswürdigen Schlüssel, durch externe Zeitstempel eines Dritten, der den Journalanfang festlegt, und durch Referenzen, die außerhalb des Collectors aufbewahrt werden. ## Was ein früherer Prüfpunkt hinzufügt ![Behalten Sie die Zählung 3 und die Überschrift h3 bei; ein späterer Export von 4 Datensätzen wird an Position 3 überprüft.](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9) **Der Referenzwert bleibt unverändert, während das Protokoll wächst.** Wenn der Prüfpunkt angibt: „3 Datensätze, Kopf h3“, kann ein Export mit vier Datensätzen erfolgreich sein, indem h3 an Position 3 abgeglichen wird. Der aktuellste Kopf ist h4, der sich voraussichtlich unterscheidet. Ein Export mit nur zwei Datensätzen schlägt fehl. [Statisches Checkpoint-Diagramm](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg) Nach Überprüfung der Checkpoint-Signatur ist Folgendes erforderlich: Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint Ein Export kann über einen Checkpoint hinausgehen. Er muss an der beibehaltenen Grenze übereinstimmen. Der Collector-Schlüssel signiert den Checkpoint, sodass der Collector einen weiteren signieren könnte. Er bindet die Datensätze nur dann, wenn der Empfänger sie vor der Archivierung über einen anderen Kanal erhalten hat; das Minimum für den Nachweis erfordert zudem eine externe Zeitangabe von einem Dritten. Der eigentliche Prüfer überprüft zudem die Reihenfolge jedes Ereignisses, den vorherigen Verweis, den Hash und die Signatur. Würde man nur den abschließend gespeicherten Kopf vergleichen, würde ein veränderter innerer Datensatz übersehen werden, dessen gespeicherter Hash nicht aktualisiert wurde. ## Wo ein Zeuge hingehört Ablaufdiagramm · Collector / Kontositzung / Schlüssel A → Endpunkt für schreibgeschützte Checkpoints; Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B → Separates, signiertes Zeugenprotokoll; Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B → Endpunkt für schreibgeschützte Checkpoints (Überprüfung anfordern); Endpunkt für schreibgeschützte Checkpoints → Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B (Signierte Antwort); Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B → Kanal mit signierten TGW1-Beiträgen (Bot-API / eigenes Token) · Host A · Host B · Collector / Kontositzung /Schlüssel A · Endpunkt fürschreibgeschützteCheckpoints · Witness / festgesteckterSammelschlüssel / eigenerSchlüssel B · Separates, signiertesZeugenprotokoll · Kanal mit signiertenTGW1-Beiträgen · Überprüfung anfordern · Signierte Antwort · Bot-API / eigenes Token **Diagramm als Text** 1. Collector / Kontositzung / Schlüssel A → Endpunkt für schreibgeschützte Checkpoints 2. Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B → Separates, signiertes Zeugenprotokoll 3. Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B → Endpunkt für schreibgeschützte Checkpoints (Überprüfung anfordern) 4. Endpunkt für schreibgeschützte Checkpoints → Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B (Signierte Antwort) 5. Witness / festgesteckter Sammelschlüssel / eigener Schlüssel B → Kanal mit signierten TGW1-Beiträgen (Bot-API / eigenes Token) Der Witness erfasst Rollbacks, einen anderen Kopf bei gleicher Anzahl, geänderte Schlüssel, ungültige Antworten und fehlende Rückmeldungen. Um zu bestätigen, dass jeder frühere Eintrag unverändert ist, vergleichen Sie den Export mit aufbewahrten Checkpoints. Ein Witness auf einem anderen Host teilt keinen Ausfall des Collector-Hosts; ein separater Betreiber bringt zusätzliche Unabhängigkeit. Der Verifier prüft, dass sich der Witness-Schlüssel vom Collector-Schlüssel unterscheidet; der Schlüsselkontrollnachweis des Verwahrers zeigt, wer ihn hält. Telegram datiert jeden Beitrag in einem öffentlichen Kanal, und `verify.py --channel https://t.me/s/…` liest diese Daten als externe Zeit. Der „Witness“ bestätigt den vom „Collector“ gemeldeten Journalstatus. Verwenden Sie einen kontrollierten Zustellungstest, um zu überprüfen, welche Telegram-Aktionen ein Erfassungskonto erreicht haben. Siehe [Einrichtung des „Witness](https://phishdestroy.io/tgwitness/de/docs/reference/witness/)“. ## Testdurchführung unter Berücksichtigung bekannter Maßnahmen Verwenden Sie eine Kontrollgruppe, separate Sammelkonten und einen neuen Marker. Senden, bearbeiten und löschen Sie gezielt und überprüfen Sie die Erfassung zwischen den einzelnen Schritten. Legen Sie die erwarteten Aktionen und einen Stichtag fest, bevor Sie die Ergebnisse überprüfen. R = |observed∩expected| / |expected| Δ t = treceipt - taction Es zählen nur übereinstimmende erwartete Aktionen; doppelte Empfangsbestätigungen erhöhen den Zähler nicht. Der Nenner muss ungleich Null sein. Eine fehlende Empfangsbestätigung weist keine gemessene Verzögerung auf. Dokumentieren Sie die Unsicherheit der Zeitangaben; verwenden Sie Ihre eigene kontrollierte Löschzeit, da Telegram den genauen Zeitpunkt der Löschung nicht angibt. Ein Ergebnis wie 5/6 (83,3 %) beschreibt die Testaktionen, nicht die Vollständigkeit des gesamten Telegram-Datenverkehrs. ## Wählen Sie einen Arbeitsablauf aus Die [vollständige Anleitung zur Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/) verfolgt den Verlauf eines Vorfalls über einen Kanal, eine Gruppe, einen Bot und einen privaten Chat hinweg: 1. Aktivieren Sie auf einem dedizierten Erfassungskonto den Untersuchungsmodus für das gesamte Konto und erstellen Sie eine Bestandsliste der zugänglichen Chats. Verwenden Sie ausgewählte Chats oder einen Ordner für ein Hauptkonto. 2. Erfassen Sie Protokoll-Momentaufnahmen, den vollständigen Verlauf pro Chat sowie erhaltene Anhänge. 3. Speichern Sie Live-Änderungen sowie alle absichtlichen Interaktionen mit den Bedienfeldern zusammen mit den entsprechenden Belegen. 4. Verfolgen Sie numerische Absender-IDs, Antwortbeziehungen, wiederkehrende Empfänger und Datei- Hashes anhand zitierter Datensätze und Personenprofile. 5. Fügen Sie im Case Board quellverknüpfte Notizen und Sammlungen hinzu. Rekonstruieren Sie eine chatübergreifende Zeitleiste mit Zeitstempeln und expliziten Lücken. 6. Vergleichen Sie die Arbeitsbereiche anderer Konten, wobei deren Ursprünge und Schlüssel getrennt bleiben. 7. Stellen Sie die signierten Protokolle, Profile und Verlaufsexporte zusammen und überprüfen Sie diese anhand von Fallnotizen. Der Leitfaden unter „`/docs/cases/`“ auf der Website enthält eine interaktive Fallkarte sowie Varianten für Streitigkeiten mit Bots, gelöschte Nachrichten und Teilnehmer, die ihren Namen ändern. Das Case Board speichert Notizen und Sammlungen innerhalb eines Arbeitsbereichs. Gruppenexporte stellen separate Arbeitsbereichspakete zusammen; die arbeitsbereichsübergreifende Korrelation und eine kombinierte Zeitleiste bleiben Aufgabe der Analysten. [Abgeschlossene Validierung und verbleibende Arbeiten](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) · [Exportieren und verifizieren](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#investigation-handoff) · [Beginnen Sie mit einem Konto](https://phishdestroy.io/tgwitness/de/docs/reference/quickstart/) --- # Telegram · Berichtskonfiguration und -überprüfung Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/ Berichtsfilter, acht Designs, Inhaltsvorlagen, gespeicherte Änderungsverläufe und die Bewertung sind in den signierten Exporten enthalten. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Berichtsfilter, acht Designs, Inhaltsvorlagen, gespeicherte Änderungsverläufe und die Bewertung sind in den signierten Exporten enthalten. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/investigation/) ![Untersuchung](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) Verwandeln Sie ausgewählte Beobachtungen in einen lesbaren Fallbericht: mit Fragestellung, Umfang, gespeicherten Änderungen, Diagrammen, Ergebnissen und Quellenangaben. Jeder Bericht bietet dem Empfänger die Möglichkeit, das gelieferte Material zu überprüfen und den Erfassungsumfang der Datenerhebung zu begutachten. Der Abschnitt **„Vertrauensgrundlagen“** erscheint in Protokoll-, Übergabe-, Chat-, Konto- und Freigabeberichten. Protokoll- und Übergabe-PDFs verwenden dieselbe Bewertung wie ihr signiertes `report.json`. ZIP-Manifeste enthalten `case_assessment` im signierten Manifest. Diese Bewertung wird zusammen mit dem exportierten Material übermittelt. Die ursprünglichen Beobachtungen behalten ihre bestehenden Signaturen. ## Dokumentformate und Lesereihenfolge ### Report Studio Öffnen Sie **„Exporte“ → „Konfigurieren“ und „Vorschau**“. Gehen Sie die folgenden Schritte durch: **„Daten“ → „Gestaltung & Inhalte“ → „Vorschau**“: 1. Verwenden Sie den gesamten Arbeitsbereich oder wählen Sie Chats, Autoren, einschließlich UTC-Beobachtungsdaten und Ereignistypen aus. Laden Sie den Katalog, um nach Chats und Autoren zu suchen, oder geben Sie deren Telegram-IDs ein. Autorenfilter gleichen aufgezeichnete Absender-IDs ab; eine Löschmeldung ohne Absender entspricht keinem Autorenfilter. 2. Wählen Sie ein Seitendesign aus und legen Sie anschließend Diagramme, Teilnehmerbezeichnungen, das Protokoll und Ihre schriftlichen Erkenntnisse fest. Bei einer Änderung des Designs bleiben diese Einstellungen erhalten. 3. Erstellen Sie die Vorschau. Sie zeigt tatsächliche Zahlen, Aktivitäten, Teilnehmer, Beispiel- Datensätze, gespeicherte Änderungen und fehlende Nachrichtennummernbereiche an. Durch Ändern einer Auswahl wird die Vorschau als veraltet markiert. Speichern Sie die Datei, bevor Sie HTML, signiertes PDF, signiertes JSON oder die ZIP-Datei mit den Beweismitteln herunterladen. Die Datenvorschau erfasst das vollständige, stabile Protokollpräfix, nicht nur eine anfängliche Stichprobe. Nur angezeigte Beispielzeilen und lange Listen sind begrenzt; ihre ausgelassenen Zählwerte werden angezeigt. Ein späterer Export erstellt einen neuen stabilen Snapshot, sodass die laufende Erfassung die Zahlen erhöhen kann. Umfang, Zählwerte und Quellenidentität sind im signierten Bericht enthalten. Das Öffnen oder Anzeigen des Formulars in der Vorschau speichert es nicht. **Leitfaden zur Rechtsordnung.** Öffnen Sie unter Dokumentdetails den Punkt **Leitfaden zur Rechtsordnung · optional** , um eine Rechtsordnung sowie ein zivil-/handels- oder strafrechtliches Verfahren auszuwählen. Der Anhang enthält die Rechtsgrundlage, Quellenlinks, Vorbereitungshinweise und den Stand der Forschung. Zusammenfassungen und Erläuterungen zu den Erfassungssicherheitsmaßnahmen in der Landessprache sind optional. Standardmäßig ist keine Gerichtsbarkeit ausgewählt. Diese Auswahlmöglichkeiten gehören zum Arbeitsbereich und sind von gespeicherten Layoutkonfigurationen sowie impliziten Standardeinstellungen für das Teilen und Kopieren ausgeschlossen. Siehe [Standardwerte, unterstützte Berichte und Recherchegrenzen](https://github.com/phishdestroy/TgWitness/blob/main/docs/JURISDICTION_GUIDANCE.md) . **Wählen Sie die Empfängerkopie aus.** Diagramme und das Protokoll verwenden die ausgewählten Datensätze. Integrität, Aufbewahrung und Erfassungsbereich beschreiben das vollständige Quellprotokoll. Die Beweismittel-ZIP-Datei enthält die Originaldatensätze und Anhänge. Verwenden Sie [eine minimierte Übergabe,](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#handover-extract) wenn ein Empfänger nur ausgewählte, zulässige Daten erhalten soll. ### Lesen Sie Änderungen, Löschungen und fehlende IDs Eine Bearbeitung zeigt den gespeicherten Text **„Vorher“** und **„Nachher“** an und hebt die geänderten Wörter hervor. Eine Löschung zeigt die letzte vor der Meldung gespeicherte Version an. Wenn kein früherer Inhalt erfasst wurde, wird dies im Bericht vermerkt. Wenn Sie nur Bearbeitungen oder Löschungen auswählen, bleiben die vorherigen Versionen als explizit gekennzeichneter Kontext außerhalb der Filter verfügbar. Nicht relevante Meldungen werden diesen Verlaufsdaten nicht hinzugefügt. **Nicht beobachtete Nachrichten-IDs** sind Lücken zwischen bekannten Nummern in den ausgewählten Chats und dem aus dem Datum abgeleiteten ID-Bereich. Jeder bekannte Quelldatensatz wird überprüft, bevor eine Nummer als nicht beobachtet deklariert wird: Das Herausfiltern eines anderen Autors, eines Ereignistyps oder eines Datums darf keine falsche Lücke erzeugen. Benachbarte gespeicherte Nachrichten werden als Kontext gekennzeichnet. Eine fehlende Nummer markiert eine nicht beobachtete Position; Löschmeldungen und erfolglose Nachprüfungen werden als eigene Ereignistypen gemeldet. ### Wählen Sie ein Design Für HTML-Berichte zum Journal und zu einzelnen Chats sowie für signierte PDF-Berichte stehen neun Seitenlayouts zur Verfügung. Sie verwenden dieselben Datensätze und Berechnungen und unterscheiden sich in Titelseiten, Typografie, Kapitelüberschriften, Tabellen und Abständen. | Gestaltung | Schreibstil | | --- | --- | | Klassisch | Eine klassische Akte mit dunklem Einband und nummerierten Abschnitten. | | Redaktionelle Hinweise | Eine gerahmte Titelseite mit Serifenschrift, breiten Rändern und einer schmalen Kapitelleiste. | | Hintergrundinformationen | Ein kompaktes Deckblatt mit marineblauem Buchrücken, kurzen Überschriften und eng gesetzten Tabellen. | | Analytik | Ein Cover im Umfrage-Stil, modulare Diagrammtafeln und Abbildungen in Monospace-Schrift. | | Technisch | Ein liniertes Register, eine nummerierte Referenzleiste und präzise Vergleichstabellen. | | Übersicht | Ein Panorama-Titelbild, großzügige Abstände und auffällige Übersichtsgrafiken. | | Lesereihe | Eine Abschnittsleiste und gruppierte Kapitel für Ergebnisse, Umfang, Änderungen und das Beobachtungsprotokoll. | | Ledger & Margin | Nummerierte Kapitel mit breitem Rand, exakte Diagramme und Tabellen sowie ein separates Nachrichtenprotokoll. | | Profilübersicht | Kennzahlen, beobachtete Profile und durchsuchbare Abschnitte mit Links zu Chat-Einträgen. | Das Design wird pro Arbeitsbereich gespeichert und im signierten Exportmanifest erfasst. HTML funktioniert offline, unterstützt helle und dunkle Designs und passt sich an schmale Bildschirme sowie Sprachen mit Schreibrichtung von rechts nach links an. Native PDFs verwenden mitgelieferte Schriftarten; das „Editorial“-Design umfasst „Noto Serif“ unter der mitgelieferten SIL Open Font License. Lesereihen sowie „Ledger & Margin“ gelten auch für Kontoübersichten, Konto-Chats und das Teilen von Kopien. Für PDF-Dateien in Chinesisch, Japanisch und Koreanisch ist zusätzlich eine geeignete Schriftart auf dem Server erforderlich, wie beispielsweise „Noto Sans CJK“, die systemweit installiert oder im Verzeichnis „`TGWITNESS_FONT_DIR`“ abgelegt sein muss. Ist diese nicht verfügbar, enthält die ZIP-Datei die HTML- und JSON-Berichte. Diese beiden Entwürfe umfassen ein lesbares Protokoll ohne JavaScript. Bei umfangreichen Exporten enthält diese Ansicht bis zu 500 vollständige Datensätze innerhalb eines Eingabebudgets von 8 MiB; der Bericht kennzeichnet die Obergrenze und enthält Links zum vollständigen Viewer sowie zu den Quelldatensätzen. Das Kontoverzeichnis und der Beziehungsindex beschreiben dasselbe Lesebeispiel, nicht alle Teilnehmer. Diagramme des vollständigen Journals behalten ihren separat angegebenen Umfang bei. ### Inhalt auswählen | Inhaltsverzeichnis | Standardmäßig enthalten | | --- | --- | | Fallakte (empfohlen) | Aktivitäten, Beobachtungszeitpunkte, Teilnehmer, Chats und das Transkript der Aufzeichnung. | | Hintergrundinformationen | Eine Aktivitätsübersicht ohne Teilnehmerranglisten oder das Transkript. | | Überprüfung der Aktivitäten | Aktivitäten, Beobachtungszeitpunkte, Teilnehmer, Chats und deren Zusammensetzung, mit Quellenangaben und genauen Zahlen. | | Individueller Bericht | Ihre eigene Kombination aus Diagrammen, Transkripten und Vorschauen. | Beim Ändern einer Voreinstellung bleiben Ihr Design, die Falldetails und die schriftliche Analyse erhalten. Integritätsprüfungen, Erfassungsgrad, Lesehinweise und Anweisungen zur Verifizierung bleiben in jedem Design erhalten. Quelldatensätze im ZIP-Archiv bleiben unverändert, wenn ein Diagramm oder ein Transkript ausgeblendet wird. Die optionalen **Untersuchungsnotizen** enthalten die Frage, die Methode, die Ergebnisse und die Schlussfolgerung, die vom Verfasser des Berichts verfasst wurden. Geben Sie in den Ergebnissen die Quelldatei und die Datensatznummern an. Die Signatur sichert diese vom Verfasser verfassten Aussagen zusammen mit dem Bericht; die Beobachtungen aus der Quelle und die Interpretation des Verfassers bleiben identifizierbar. Bei minimierten Übergaben werden diese privaten Notizen und vollständigen Journaldiagramme weggelassen. Die Auswahlmöglichkeiten für Diagramme und Untersuchungen gelten für Journalberichte. Wählen Sie Aktivitäten im Zeitverlauf, die UTC-Heatmap nach Wochentag/Stunde, Teilnehmer-Rankings, Chat- Rankings und die Zusammensetzung der Datensätze aus. Wählen Sie 5–30 rangierte Gruppen und neutrale Teilnehmer- Aliase oder Konto-IDs aus. Unbekannte Absender und die übrigen Teilnehmer werden in separaten Zeilen angezeigt. Aliase wirken sich nur auf Diagramme aus; die Quelldatensätze enthalten weiterhin die tatsächlichen Identitäten. Die Designvorschau wird anhand des ungespeicherten Entwurfs aktualisiert und verwendet dabei Komponenten für Produktionsdeckblatt, Untersuchung und Diagramme, beschränkt auf Übereinstimmungen innerhalb der ersten 50.000 Quelldatensätze. Die Datenvorschau unten berechnet die vollständige Auswahl. Sie ist ausdrücklich nicht signiert und speichert keine Bearbeitungen. Die Schaltflächen „Deckblatt“ und „Diagramme“ wechseln den jeweiligen Abschnitt. Dies ist keine vollständige PDF-Vorschau. **Mit „Berichtseinstellungen speichern“** werden die Auswahlmöglichkeiten auf zukünftige Exporte angewendet; bereits signierte Dateien sind unveränderbar. Das PDF verwendet das ausgewählte Deckblatt, die Typografie, das Kapitellayout und dieselben ausgewählten Aggregate wie HTML und signiertes JSON. Vertrauensbewertung, Erfassungsgrad und Prüfanweisungen bleiben erhalten. Das Ausblenden von Diagrammen oder des lesbaren Transkripts entfernt keine maßgeblichen Quellzeilen aus der ZIP-Datei. Deaktivierte Diagrammreihen werden im analytischen JSON weggelassen; verwenden Sie einen minimierten Export, um die Offenlegung von Quelldatensätzen einzuschränken. Filter für die Datenauswahl gelten für Journalberichte; Konto- und Weitergabe-Exporte behalten ihren eigenen Erfassungs- und Offenlegungsumfang. Eine Auswahl kann ganze Chats, Autoren, UTC-Daten, Eintragstypen und einzelne Nachrichten enthalten. Mit **Auswählen** in einem Chat markierte Nachrichten erscheinen unter **Ausgewählte Nachrichten**; der Bericht umfasst dann die Nachrichteneinträge dieser Nachrichten und aller vollständig ausgewählten Chats und listet die gewählten Nachrichtennummern unter **Ausgewählte Daten** auf. Fehlende Nachrichtennummern und ihre benachbarten Einträge werden nur für vollständig ausgewählte Chats ausgewiesen. **Nachrichtennummern hinzufügen** unter der Chatliste fügt Nachrichten hinzu, ohne den Chat zu öffnen: eine Zeile pro Chat mit der Chat-ID, einem Doppelpunkt und den Nachrichtennummern oder `t.me/c/…`-Links zu einzelnen Nachrichten. Gemeinsame Design- und Diagrammeinstellungen werden in neue Chat-/Konto-Exporte und Vorschauen zur Kontofreigabe übernommen. Die Sprach- und Datenschutzeinstellungen für Konten und Freigaben bleiben unabhängig; private Fall- und Untersuchungsnotizen werden nicht in diese Exporte kopiert. Konto- und Freigabereports bleiben als HTML-Dateien durch ihr signiertes Archivmanifest geschützt. Das Journal, die minimierte Journalübergabe und Einzel-Chat-Kits stellen ebenfalls signierte PDFs bereit. ### Was die Diagramme aussagen Protokollaktivitäten und Heatmaps erfassen neue, historische, wiederhergestellte, bearbeitete, gelöschte und bei erneuter Überprüfung fehlende **Beobachtungen**, sortiert nach dem Beobachtungszeitpunkt des Collectors in UTC. Heartbeats und Empfangsbestätigungen für Anhänge werden ausgeschlossen. Teilnehmer-Rankings zählen nur neue, historische und wiederhergestellte Nachrichtenbeobachtungen: Ein Absender wird nicht als Bearbeiter oder Löscher deklariert. Wiederholte Beobachtungen können dieselbe Telegram-Nachricht beschreiben. Die Protokollanalysen behalten die Zählungen nach Art, Verweise auf den ersten/letzten Datensatz und den SHA-256-Hash der Quelldatei „ `events.jsonl`“ bei. Zahlenangaben enthalten exakte Werte in HTML und PDF. Tägliche Zeitintervalle werden nach 366 aufgezeichneten Tagen auf Monate umgestellt; Diagramme fassen diese zu höchstens 36 Intervallen gleicher Breite zusammen. Bei mehr als 100.000 eindeutigen Identifikatoren oder 1.200 Monaten ist das betroffene Diagramm nicht verfügbar, während die genauen Gesamtzahlen weiterhin verfügbar bleiben. Snapshot- und Kontofreigabe-Diagramme zählen nur die enthaltenen Zeilen mit Nicht-Dienst-Nachrichten, unter Verwendung der aufgezeichneten Nachrichtenzeit. Freigabe-Aggregate werden nach der Schwärzung und Filterung berechnet. Diese Diagramme verwenden höchstens 90 gleich breite UTC-Datumsintervalle und behalten bis zu 10.000 Gruppierungswerte bei; überschüssige Zählwerte werden explizit ausgewiesen und abgeglichen. Das letzte Intervall kann kürzer sein. Unbekannte oder ungenaue Datumsangaben fließen nicht in Zeitdiagramme ein. Ein leeres Intervall bedeutet, dass keine Beobachtungen enthalten sind; bei Lücken die Abdeckung prüfen. Diese Diagramme beschreiben gespeicherte Aktivitäten. Unbekannte Absender bleiben eine separate Kategorie, und jede Überprüfung wird einzeln ausgewiesen. Sofern enthalten, wird „`analytics.json`“ durch die signierten Datei-Hashes des Archivs geschützt. Der Journal-`report.json` bettet dieselbe ausgewählte Aggregation ein. Die Signaturprüfung erkennt geänderte Bytes. Um die Zahlen zu überprüfen, berechnen Sie die Journal-Aggregate mit „`report_analytics.Analytics`“ und „`selected`“ neu oder die Snapshot-Aggregate mit „`snapshot_analytics.collect`“ und „`project`“. ### Anomalieindikatoren **Vorschau.** Beweisberichte enthalten einen Abschnitt **Anomalieindikatoren**, der von registrierten Prozessoren berechnet wird (`tgwitness/metrics/`, eine Datei pro Metrik). Der Bericht nennt jeden Prozessor, der ausgeführt wurde, zusammen mit seiner Version und gibt dessen Methode unter der Tabelle an, sodass die Berechnung anhand von `events.jsonl` mit `tgwitness.metrics.run` wiederholt werden kann. | Prozessor | Was es zeigt | | --- | --- | | `first_time_posters_over_time`, Version 1 | Erstmalige Poster und Nachrichten pro UTC-Tag. Eine Markierung erfordert mindestens fünf erstmalige Poster und das Dreifache ihres Medians, wobei das Nachrichtenvolumen höchstens das 1.5-fache ihres Medians betragen darf. Die Basislinie umfasst mindestens sieben Beobachtungstage innerhalb der letzten 14 Kalendertage, nach einer sieben Tage dauernden Aufwärmphase. | | `service_vs_message_ratio`, Version 1 | Unterscheidung zwischen den gespeicherten Nachrichtennummern pro Chat und dem Anteil, der von Servicemeldungen belegt wird. Es wird eine Nummerierung beschrieben; es wird keine bestimmte fehlende Nummer erklärt. | | `join_leave_per_month`, Version 1 | Neuanmeldungen, Abmeldungen sowie Löschungen oder Sperren pro Monat, jeweils eine pro Person, Chat, Änderung und Tag. | | `pinned_per_month`, Version 1 | Gefestigte Servicemeldungen, Aufhebungen der Feststellung sowie festgesteckte Nachrichten, die zwischen Momentaufnahmen des Chat-Status hinzugefügt oder entfernt wurden, pro Monat. | **Weitere Tools → Parameter → Berichtsmetriken** wählen Prozessoren und die Anzahl der angezeigten Zeilen aus, auch in gefilterten Berichten. Tägliche und monatliche Tabellen zeigen aktuelle Zeilen an, Tabellen zur Dienstverteilung ordnen Chats nach der Anzahl gespeicherter Nachrichten. Summen beziehen sich auf jede Zeile. Erstellen Sie aus einem Quell-Checkout alle neun oben aufgeführten Layouts aus demselben fiktiven Journal: ``` python tools/build_report_styles.py --output test-results/report-styles ``` Öffnen Sie die resultierende Datei „`index.html`“, um vollständige HTML-Berichte, signierte PDFs und ZIP-Dateien zu vergleichen. Jedes Layout basiert auf demselben Quellprotokoll. Verwenden Sie für jeden Durchlauf ein neues Ausgabeverzeichnis, damit zuvor signierte Beispiele erhalten bleiben. ![Fiktives HTML-Dossier](https://phishdestroy.io/tgwitness/assets/dossier-en.png?v=62db26820986) Die HTML-Seite beginnt mit einem Fallüberblick und Kennzahlen. Die nummerierte Beweiskarte verlinkt auf jeden Befund, die ihn stützenden Fakten, Einschränkungen und die unabhängige Überprüfung. Durchsuchbare Datensätze und stabile Datensatzverweise bleiben im Offline-Viewer verfügbar. Das Design passt sich an schmale Bildschirme, verschiedene Designs und Browser ohne JavaScript an. Das signierte PDF verfügt über ein eigenes A4-Deckblatt, eine Berichtsreferenz und einen QR-Code, eine Zusammenfassung, eine Beweiskarte, nummerierte Feststellungen und Dokumenten-Lesezeichen. Die Seiten- Kopf- und Fußzeilen kennzeichnen den Bericht. Ein QR-Code identifiziert das Material; er ist kein eigenständiges Verifizierungsergebnis. Browser-Ausdrucke sind von diesem kryptografisch signierten PDF getrennt. Die Beobachtungszeitleiste ordnet aufgezeichnete Beobachtungszeiträume und Unterbrechungen auf derselben UTC-Achse an. Leere Bereiche bedeuten keine abgeleitete Abdeckung; die detaillierten Tabellen behalten die genauen Intervalle bei. Die ZIP-Datei enthält die lesbaren Berichte, signierte JSON-Dateien, Quelldatensätze und Anweisungen zur Verifizierung. Erstellen Sie ein neues, fiktives Dossier in Englisch/Russisch/Deutsch mit der installierten Entwicklungsumgebung: ``` python tools/build_dossier_example.py --output test-results/my-new-dossier ``` Jedes Sprachverzeichnis enthält die Dateien „`report.html`“, „`report.pdf`“, „`report.json`“ und „`dossier.zip`“. Vorhandene Beispielverzeichnisse werden niemals überschrieben. Zur Erstellung werden weder ein Telegram- Konto noch ein externer Zeitstempel-Dienst oder eine Netzwerkverbindung verwendet. ![Die ersten drei Seiten des fiktiven, signierten PDF-Dokuments](https://phishdestroy.io/tgwitness/assets/dossier-pdf.png?v=30a8d283dcc2) ## Ein konkreter Fall Bei einem Journal mit 1,200 Einträgen und einem validierten Zeitstempel bei Eintrag 1,000 identifiziert der Bericht 200 spätere Einträge außerhalb der Grenzen dieses Zeitstempels. Der Zeitstempel legt eine Obergrenze für den Zeitpunkt fest, zu dem der Checkpoint existierte; jede Nachricht behält ihre eigene Sendezeit aus Telegram bei. Wenn drei weitere Zeitstempel-Dateien die Validierung nicht bestehen oder nicht validiert werden können, werden sie separat gezählt und können keine positive Schlussfolgerung liefern. Ein verwendbarer Zeitstempel muss alle folgenden Prüfungen bestehen: Sein Abdruck stimmt mit dem Checkpoint überein, seine Signatur lässt sich zum Zeitpunkt der Stempelung auf eine vertrauenswürdige TSA-Root zurückverfolgen, und die Signatur, der Schlüssel, die Zählung und der Kopf des Checkpoints stimmen genau mit dem Journal-Präfix überein. Das bloße Parsen eines Zeitstempels oder das Vorhandensein einer OTS-Quittung reicht nicht aus. Der Leser muss die vertrauenswürdige TSA-Root selbstständig auswählen und die Überprüfung wiederholen. OTS benötigt eine eigene Bitcoin-Bestätigungsprüfung. | Berichtsstatus | Bedeutung | | --- | --- | | Beim Export geprüft | Der Exporteur hat die angegebene Überprüfung durchgeführt; eine unabhängige Wiederholung ist dennoch erforderlich. | | Aufgezeichnet; Überprüfung erforderlich | Die zugrunde liegende Beobachtung oder Aussage des Bedieners wird aufgezeichnet; es handelt sich nicht um eine unabhängige Bestätigung. | | Nicht in diesem Text enthalten | Der Text enthält keine Belege für diese Behauptung. Es wird nicht gesagt, dass es anderswo keine gibt. | | Nicht unabhängig überprüft | Der Bericht liefert kein unabhängiges Verifizierungsergebnis. | | Unvollständig oder nicht verfügbar | Material oder eine erforderliche Überprüfung fehlt, ist unvollständig oder war nicht erfolgreich. | Überprüfen Sie jede Prüfung separat und vergleichen Sie sie mit dem erfassten Erfassungsumfang. ## Was eine umfassende Konfiguration beibehalten muss 1. Bevor Sie sich auf die Erfassung verlassen, sichern Sie den Fingerabdruck des Erfassers über einen separaten, vertrauenswürdigen Kanal. Vergleichen Sie diese Referenz mit dem Signaturschlüssel des Exports. 2. Behalten Sie unabhängig voneinander mit Zeitstempeln versehene Kontrollpunkte bei sowie, sofern verwendet, ein Zeugenprotokoll, das außerhalb der administrativen Kontrolle des Collectors liegt. Vergleichen Sie diese mit dem exportierten Protokoll, um dessen frühere Grenzen zu überprüfen. 3. Erfassen Sie den Umfang der Datenerfassung, Lücken, Filter, Einschränkungen und Änderungen bei der Erfassung. Erläutern Sie fehlende Zeiträume, die für den konkreten Fall relevant sind, und unterscheiden Sie dabei klar zwischen nicht erfassten Nachrichten-IDs, Löschhinweisen und erfolglosen Nachprüfungen. 4. Behalten Sie die ursprünglichen ZIP-Dateien und deren Hashes bei. Erfassen Sie jeden Inhaber, jede Übertragung, jedes Datum und jeden Zweck. Behalten Sie die zugeordneten Aussagen der Betreiber und Fallnotizen dazu bei. 5. Bei vertraulichen VMs sind das Zitat, die Challenge, die Intel-Zertifikatskette, die Messwerte, die genaue Quelle und die Bedingungen für den Umgang mit Schlüsseln zu bewahren und unabhängig zu überprüfen. Das Ergebnis der Beglaubigungsprüfung ist zusammen mit den geprüften Artefakten aufzubewahren. Siehe „[Überprüfungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope)“ für die Prüfungen hinsichtlich Erfassung, Archivintegrität, Zeit und Erfassungsumfang in jedem Modus. ## Überprüfung durch den Empfänger Verwenden Sie eine vertrauenswürdige Installation von TgWitness und einen unabhängig ermittelten Fingerabdruck: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca tsa-root.pem python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL --require-witness python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --check-drand ``` Der zweite und dritte Befehl können die Mindestanforderungen an Beweismittel erfüllen: Ein geprüfter Zeitstempel oder die von Telegram in den Witness-Beiträgen festgelegten Datumsangaben liefern einen externen Zeitstempel für den letzten Datensatz. Die ZIP-Datei des Zeugen muss aus einer unabhängig vertrauenswürdigen Quelle stammen; bewahren Sie auch deren Schlüssel und Herkunft auf. Bewahren Sie die Befehle, die Tool-Version, die Ausgaben, die überprüften Eingabe-Hashes sowie ungelöste Fragen auf. Die Beacon-Verifizierung ist eine separate Online-Prüfung; der Berichtsrenderer kontaktiert niemals einen Dienst, nur um einen Bericht anzuzeigen. Bei Streitigkeiten über eine bestimmte Nachricht sind die Archivreferenz, die maßgebliche Datei- und Datensatzreferenz anzugeben und anschließend der relevante Zeitrahmen, Erfassungslücken, die Auswahl sowie bestätigendes Material zu beschreiben. Bei einer Kopie zur Weitergabe sind zudem die aufgezeichnete Transformation und deren Verweise auf das Quellarchiv zu überprüfen. Private Filter und Identitätszuordnungen bleiben von der öffentlichen Bewertung ausgeschlossen. Die Überprüfung der signierten PDF-Datei erkennt Änderungen an den abgedeckten Bytes. Bewahren Sie die ursprüngliche digitale Datei und das Überprüfungsergebnis zusammen mit etwaigen Screenshots oder ausgedruckten Lesekopien auf. --- # Telegram · Kontoexport Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/account-export/ Exportieren Sie, was ein Konto derzeit lesen kann: Umfang, wiederaufnehmbare Aufträge, ein signiertes Archiv und minimierte Freigabekopien. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Translation coverage: this edition includes material from the English original. Exportieren Sie, was ein Konto derzeit lesen kann: Umfang, wiederaufnehmbare Aufträge, ein signiertes Archiv und minimierte Freigabekopien. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Beweise und Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) ![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) Beim Exportieren eines Kontos wird der Erfassungsslot des Kontos reserviert. Die Live-Beobachtung kann fortgesetzt werden, während das Archiv ermittelt, heruntergeladen, überprüft und gepackt wird. Pausieren Sie einen anderen Verlaufs- oder Exportauftrag, bevor Sie eine konkurrierende Erfassung starten. Durch das Pausieren des Archivs läuft die Beobachtung weiter, und durch das Pausieren der Beobachtung bleibt der Archivierungsauftrag erhalten. Exporte auf verschiedenen Konten können gleichzeitig ausgeführt werden. Ein reiner „Takeout“-Auftrag, der auf Freigabe wartet, gibt sein Konto frei, sodass ein separater Export in einer regulären Sitzung starten kann, während die Freigabe noch aussteht. Eine aktive Erfassung reserviert dieses Konto weiterhin. Wählen Sie als Installationsadministrator **Startseite → Mein Konto exportieren** oder **Exporte → Telegram-Konto → Kontoexport konfigurieren**. Melden Sie sich bei Bedarf an, überprüfen Sie den Umfang und starten Sie den Export explizit. Eine kontinuierliche Beobachtung ist nicht erforderlich. **Gespeicherte Beobachtungen** ist ein separater Export des bestehenden Journals; dessen ZIP-Datei enthält alle Quellen unabhängig von Journalfiltern. Jeder Arbeitsbereich verfügt über eigene Jobs, eine eigene Signaturidentität und eigenen Speicher. Ein erteilter Panel-Zugriff, einschließlich einer uneingeschränkten Berechtigung für den normalen Export, kann diese kontoweiten Pfade nicht öffnen. Sender- und Textfilter lassen sich unter **„Nach Absender oder Nachrichtentext filtern“** erweitern. **Der Bereich „Kontodaten & Verbindungsmethode“** enthält optionale Kontokategorien und die Auswahl zwischen „Takeout“ und „reguläre Sitzung“; in der Zusammenfassung werden die aktiven Auswahlen auch im geschlossenen Zustand angezeigt. Beim Schließen dieser Bereiche bleiben die Einstellungen erhalten. Export- und Berichtsentwürfe bleiben beim Wechseln der Ansichten in der aktuellen Panel-Sitzung erhalten; sie werden beim Neuladen des Browsers nicht gespeichert. Vorhandene Aufträge bleiben über beide Exportoptionen erreichbar. Dieser Arbeitsablauf exportiert Daten, auf die das verbundene Konto derzeit Zugriff hat. Die standardmäßige **automatische** Methode beginnt mit [Telegram Takeout](https://core.telegram.org/api/takeout), wodurch der zugängliche Verlauf in seinem aktuellen Zustand zurückgegeben wird, einschließlich verlassener Kanäle, gespeicherter Kontakte und anderer Kontodaten. Falls Telegram eine Wartezeit vorschreibt, bevor „Takeout“ startet, setzt die automatische Methode sofort mit der regulären Sitzung fort; das Protokoll vermerkt `account_export.transport` und das signierte Inventar nennt die verwendete Methode und listet die Änderung als Auslassung auf. **Die Telegram Takeout-Sitzung** wartet stattdessen **nur** auf die Genehmigung, und **die Reguläre Sitzung** fragt niemals nach „Takeout“. Geheime Chats werden live vom [Secret Chat-Modul](https://phishdestroy.io/tgwitness/de/docs/reference/secret-chats/) aufgezeichnet, Bearbeitungen durch Live-Beobachtung. Die reguläre Sitzung hat einen anderen Erfassungsumfang und zeichnet nicht unterstützte Kategorien auf. **Home → Alles exportieren** startet einen Export aller Chat-Arten, aller Anhangstypen, des Profils, der Kontakte, der Profilfotos, der Stories, der Sitzungsmetadaten und weiterer Kontodaten in allen Formaten: das signierte TgWitness-Archiv mit JSON- und HTML-Ansichten für Telegram Desktop. **Auswahl zum Exportieren** öffnet das untenstehende Formular mit denselben Standardeinstellungen. Takeout ist die offizielle Export-API, die auch von Telegram Desktop verwendet wird. TgWitness kann Desktop-kompatibles JSON direkt aus der eigenen Erfassung schreiben; das Importieren eines fremden Archivs ist nicht erforderlich. Chat- und Nachrichten-IDs sind über beide Übertragungswege verfügbar. Die Exportgeschwindigkeit und die Genehmigungsverzögerung von Takeout hängen von den Telegram-Beschränkungen für das Konto ab sowie davon, ob ein Chat öffentlich oder weiterleitbar ist. Messen Sie denselben Umfang und dieselben Medieneinstellungen, bevor Sie die Geschwindigkeit vergleichen. Für bis zu 20 explizit ausgewählte Chat-IDs ermittelt der reguläre API-Export diese Peers direkt, bevor das vollständige Dialoginventar des Kontos berücksichtigt wird. Ein lesbarer öffentlicher Kanal kann daher exportiert werden, ohne ihm beizutreten, selbst wenn er nicht in der Dialogliste aufgeführt ist. Nicht zwischengespeicherte Peers greifen auf den regulären Bestand zurück. Der Archivfilter bleibt weiterhin in Kraft: Wenn Telegram einen Dialog nicht zurückgibt und archivierte Chats ausgeschlossen sind, wird der unbekannte Archivstatus als Auslassung vermerkt. Takeout behält sein Verfahren zur Aufteilung des Bestands bei. Keiner der beiden Pfade tritt Chats bei oder ändert Weiterleitungsberechtigungen. Im Desktop-kompatiblen JSON erscheinen Kanäle, die Telegram als `left` kennzeichnet, unter `left_chats`, einschließlich lesbarer öffentlicher Kanäle, denen das Konto nicht beigetreten ist. Sowohl `FLOOD_WAIT`- als auch `FLOOD_PREMIUM_WAIT`-Pausierungsanfragen gelten für den gesamten vom Server angeforderten Zeitraum. Die Frist des Kontos bleibt über Wiederverbindungen und Neustarts hinweg bestehen; eine kürzere spätere Wartezeit kann diese nicht verkürzen. Wiederholungsversuche sind begrenzt, bei einer Stornierung bleiben versiegelte Seiten erhalten, und API-Anmeldedaten werden nicht rotiert, um eine Ratenbegrenzung zu umgehen. Es erfolgt kein Kauf eines Premium-Abonnements. ## Wählen Sie aus, was erfasst werden soll | Einleitung | Bedeutung | | --- | --- | | Zweck | Halten Sie fest, warum diese Akquisition erforderlich ist. Geben Sie hier keine unnötigen Namen oder vertraulichen Details zum Fall an. | | Berichtssprache | Wählen Sie die Sprache für die Beschriftungen im lesbaren Bericht aus. Der Originaltext der Nachrichten bleibt unverändert; nicht übersetzte Vorlagenbeschriftungen verwenden Englisch. Die Sprache wird über die Optionen des signierten Auftrags festgelegt. | | Chat-Typen / Chat-IDs | Alle ausgewählten Arten oder nur die aufgelisteten Chats; „Gespeicherte Nachrichten“ gehören zu privaten Chats. Archivierte Chats sind separat auswählbar. | | Daten | UTC. Die Kalenderdaten für „Von“ und „Bis“ des Panels sind beide enthalten. Die API verwendet inklusive `from_utc` und exklusive `to_utc`; das Panel sendet den Beginn des Tages nach „Through“. Ein leerer Grenzwert lässt diese Seite uneingeschränkt. | | Absender-IDs | Nur Nachrichten der aufgeführten Absender; eine leere Liste umfasst alle Absender. | | Der Text enthält | Groß-/Kleinschreibung bei wörtlichen Phrasen wird nicht berücksichtigt, die Suche erfolgt mit „ODER“. Bedingungen zu Absender, Datum und eigener Nachricht werden mit „UND“ kombiniert. | | Eigene Nachrichten | Nur ausgehende Nachrichten aufbewahren. | | Medientypen | Wählen Sie Anhangskategorien aus oder löschen Sie alle, um das Herunterladen von Nachrichtendateien zu vermeiden. | | Datei- bzw. Gesamtmedienbeschränkungen | MiB pro Datei und GiB an insgesamt heruntergeladenen Medien. Text, Empfangsbestätigungen, lesbare Berichte und ZIP-Overhead benötigen zusätzlichen Speicherplatz. | | Kontokategorien | Profil, Kontakte, Profilfotos, Stories, Sitzungsmetadaten und andere Takeout-Daten verfügen über separate Steuerelemente. | Die Voreinstellung **„Minimize“** deaktiviert Dateien und Kontometadaten. Absender- und Inhaltsfilter werden vor der Speicherung von Nachrichtenseiten und dem Herunterladen von Medien angewendet. Telegram übermittelt weiterhin API-Verlaufsseiten, die Nachrichten enthalten, die zur Auswertung dieser Filter benötigt werden: Die Filterung ist keine Garantie dafür, dass nicht ausgewählte Nachrichten niemals in den Prozessspeicher gelangen. Andere laufende Beobachtungen im Arbeitsbereich haben ihre eigenen Umfangs- und Aufbewahrungseinstellungen. Profilbildverlauf, Stories, Sitzungsmetadaten und andere Kontodaten sind standardmäßig ausgewählt. Deaktivieren Sie diese sowie das Profil und die Kontakte, wenn für den Fall ausschließlich Nachrichten benötigt werden. Sind Anhänge oder Metadaten nicht erforderlich, verhindert deren Ausschluss bei der Erfassung, dass eine weitere private Kopie in diesem Export gespeichert wird. Bei Foto-Nutzdaten wird die in den Metadaten und Hash-Manifesten angegebene Variante des Standbilds verwendet, einschließlich Fotos mit einer animierten Avatar-Variante. Diese Animation ersetzt nicht das ausgewählte Standbild. Eine Nutzlast, die kürzer oder länger als die beobachtete Größe ist, wird als fehlgeschlagener Anhang erfasst, und eine geänderte Darstellung während der Erneuerung der Dateireferenz wird abgelehnt. Diese Fehler führen dazu, dass das Archiv unvollständig bleibt, während die Nachrichtendatensätze erhalten bleiben. Bei einer unabhängigen Verifizierung werden zudem gespeicherte Anhänge abgelehnt, deren signierte Länge im Widerspruch zu ihrer beobachteten Größe oder Darstellung steht, auch in älteren Archiven. Falls eine dedizierte Medienverbindung vorübergehend ausfällt, nutzen Lesezugriffe auf Anhänge die Standard-Dateiverbindung. Nach einer Minute wird die dedizierte Verbindung im Hintergrund erneut versucht, während die Downloads fortgesetzt werden. Bei dieser Wiederherstellung bleibt das konfigurierte Verbindungslimit erhalten und gilt separat für jedes Rechenzentrum. Telegram-Flood- Wartezeiten und Autorisierungsfehler werden weiterhin weitergeleitet. ## Nachrichtennummern und Aktivitätsübersicht Jedes Kontoarchiv enthält `message-gaps.json` und `map.html`. Kanäle und Supergruppen nummerieren ihre Nachrichten pro Chat, sodass jede fehlende Nummer zwischen der ersten und der letzten exportierten Nachricht eine Nachricht dieses Chats darstellt. Private Chats, Bots und einfache Gruppen nutzen eine gemeinsame Nummernfolge für das gesamte Konto: Eine dort fehlende Nummer gehörte zu einem bestimmten Chat. Der zugehörige Chat wird nachgewiesen, wenn eine exportierte Antwort oder ein Pin auf die Nummer verweist; andernfalls wird geschätzt, welche Chats in der Zeit zwischen den benachbarten Nachrichten aktiv waren, und der Rest wird Chats zugeschrieben, die nicht im Export enthalten sind. Jeder Durchlauf enthält sein Zeitfenster, benachbarte Nachrichten, die Anteile pro Chat und eine Konfidenzkennzeichnung. Ein begrenzter Umfang (Filter, nicht ausgewählte Chats) wird angegeben, da fehlende Nummern in diesem Fall Nachrichten außerhalb der Auswahl umfassen. `map.html` zeigt einen Kalender, Chats im Zeitverlauf sowie stundenweise Raster nach Wochentagen für Nachrichten und fehlende Nummern an, ergänzt durch Tabellen zu jedem Chat und den längsten Nachrichtenfolgen. Chat-Seiten zeigen einen eigenen Kalender, die Teilnehmerentwicklung im Zeitverlauf für Gruppen sowie eine Markierung im Protokoll an den Stellen, an denen Nachrichten fehlen. `verify.py` berechnet neu `message-gaps.json` aus den signierten Seiten und lehnt eine geänderte Datei ab. Die Aktivitätsübersicht listet die größten Lücken bei Kanälen und Supergruppen auf, einschließlich ihrer Nummernbereiche und der Zeitpunkte benachbarter Nachrichten. Öffnen Sie einen Bereich, um zu dessen markierter Position im paginierten Transkript zu springen. Diese Markierungen verzeichnen fehlende Nummern zwischen gespeicherten Nachbarn; Löschvorgänge, deren Zeitpunkte und Nachrichtentexte stammen ausschließlich aus gespeicherten Datensätzen. Breite Tabellen lassen sich auf kleinen Bildschirmen innerhalb ihrer Karten scrollen. Umfangreiche Transkripte enthalten ein Seitenverzeichnis mit Zeiträumen für Nachrichten und einen Kalender. Wählen Sie einen Monat aus, um den ersten Eintrag in der Reihenfolge der erfassten Seiten zu öffnen. Die Monatsangaben basieren auf den aufgezeichneten Nachrichten-Datumsangaben in UTC; undatierte Einträge bleiben im Transkript erhalten. Die Seitennavigation umfasst die erste, die letzte und die vorherigen bzw. nächsten Seiten und öffnet den entsprechenden Nachrichtenabschnitt direkt. Das Verzeichnis funktioniert offline ohne JavaScript. ## Zusammenfassung, Berichterstattung und Überprüfung Jeder Auftrag friert seine Optionen und die Kontoidentität ein. Bestandsliste und erfasste Seiten werden signiert; Seitenbelege zeichnen Hashes, Cursorpositionen, Zeitangaben, Ergebnisse von Anhängen und den vorhergehenden Beleg auf. Nur festgeschriebene Seiten treiben den Fortschritt voran. Beim Neustart/Fortsetzen werden diese Aufzeichnungen überprüft, bevor fortgefahren wird. Ein geändertes Konto, eine geänderte signierte Seite oder eine inkonsistente Belegkette werden abgelehnt. Optionen können während einer Erfassung nicht bearbeitet werden: Starten Sie einen neuen Auftrag für einen anderen Umfang. Mit „Pause“ wird der laufende Kontovorgang unterbrochen. Beim Neustart der Anwendung bleiben unvollendete Arbeiten erhalten und können explizit fortgesetzt werden. Eine abgelaufene Takeout-Sitzung erfordert eine explizite Fortsetzung; das Ändern von Telegram-Split-Bereichen kann eine neue Erfassung erfordern. Bei der Fortsetzung bleiben vorherige Beobachtungen erhalten, sodass ein lang andauernder Export nicht als ein einziger atomarer Snapshot gilt. Andere Vorgänge, die einen Kontowechsel erfordern, sowie konfliktbehaftete Exporte werden während der Erfassung blockiert. Warten Sie, bis die Paketierung abgeschlossen ist, bevor Sie einen Arbeitsbereich löschen. „Fortsetzen“ zeigt sofort **die Meldung Gespeicherte Exportdaten werden überprüft…** an und überprüft den gespeicherten Inhalt im Hintergrund, bevor eine Verbindung zu Telegram hergestellt wird. Das Fenster bleibt während der Überprüfung verfügbar. „Pause“ wartet, bis der Überprüfungsvorgang sicher abgeschlossen ist, bevor das Konto freigegeben wird; diese Funktion funktioniert auch, wenn sie unmittelbar nach dem Start oder der Fortsetzung gedrückt wird. Bei langsamen Speichermedien kann diese Wartezeit lang sein. Bei fehlgeschlagenen Integritätsprüfungen wird ein fehlgeschlagener Auftrag mit einer Erklärung angezeigt und die Dateien bleiben erhalten. Wenn Telegram die Autorisierung des Kontos während der Erfassung von Bestandsdaten, Verlaufsdaten oder Anhängen beendet, wird der Vorgang unterbrochen, ohne dass die noch nicht abgeschlossene Seite als abgeschlossen markiert wird. Stellen Sie die Verbindung zu demselben Konto wieder her und setzen Sie den Vorgang fort, um ab der zuletzt gespeicherten Seite weiterzumachen. Nicht verfügbare Nachrichtenplatzhalter verschieben den Cursor im Verlauf nach vorne, beenden den Lesevorgang jedoch nicht: Ältere verfügbare Nachrichten werden weiterhin angefordert, und ein Platzhalter wird nicht als erfasste Nachricht oder bestätigte Löschung dargestellt. The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed. Fertiggestellte ZIP-Dateien stehen weiterhin für wiederholte Downloads und HTTP-Range-Downloads zur Verfügung. Ein Kontoarchiv enthält `manifest.json`, `manifest.sig`, die signierte Datei `job.json`, `inventory.json`, `receipts/`, autoritative `data/*.jsonl`, ausgewählte `media/`, lesbares HTML und einen Verifizierer. Speichern Sie den Fingerabdruck des Collectors über einen unabhängigen Kanal und verifizieren Sie ihn anschließend mithilfe einer vertrauenswürdigen Installation. Das Panel speichert das Archiv als `tgwitness-account-export-EXPORT_ID.zip`; eine versiegelte Erfassung enthält es in ihrem Beweismittelarchiv als `account-export.zip`. Verwenden Sie den Namen der Datei, die Sie haben: ``` python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256 ``` Für Archive, deren entpackter Inhalt 4 GiB überschreitet, legen Sie explizit eine angemessene `--max-gib`. Das Panel überprüft seine authentifizierten, vollständigen lokalen Archive anhand ihrer angegebenen erweiterten Größe und des veröffentlichten ZIP-Digests; die externe CLI behält ihre eigene Größenbeschränkung bei. Überprüfen Sie das Archiv, bevor Sie die lesbare HTML-Datei öffnen. Der im Archiv enthaltene Verifizierer ist praktisch, aber ein unabhängig beschaffter Verifizierer vermeidet es, ausführbarem Code zu vertrauen, der mit den Nachweisen geliefert wird. Die Ed25519-Signatur und die SHA256-Hashes erkennen Änderungen, nachdem der Collector die entsprechenden Bytes festgeschrieben hat. Überprüfen Sie dieses Ergebnis zusammen mit dem aufgezeichneten Erfassungsumfang, den Erfassungsintervallen, den externen Zeitstempelbelegen und den für die ausgewählte Bereitstellung verfügbaren Herkunftsprüfungen. Spätere Beobachtungen werden separat aufgezeichnet, wobei zuvor erfasste Versionen erhalten bleiben. ## Bereiten Sie eine Offenlegung für einen Anwalt oder einen anderen Empfänger vor Behalten Sie nach dem Herunterladen eines fertigen Exports die Originaldatei ZIP bei und öffnen Sie `index.html` aus einer extrahierten Kopie. Der Bericht erläutert seinen Umfang, die verfügbare Abdeckung und Einschränkungen. Seine Datensatzreferenzen kombinieren die Archivreferenz, den Dokumentpfad und die Datensatznummer, sodass ein Empfänger denselben Eintrag im HTML-Code oder im Ausdruck finden kann. Ein Beispiel finden Sie unter [Den fiktiven Bericht öffnen](https://phishdestroy.github.io/TgWitness/demo/report/). Wählen Sie nach Abschluss eines Kontoexports **die Option „Freigabekopie erstellen“** aus. Dadurch wird eine separate, signierte Derivatdatei erstellt. Die Quelldatei ZIP bleibt unverändert und privat; versenden Sie sie nicht zusammen mit einer minimierten Derivatdatei, es sei denn, der Empfänger ist zum Empfang des vollständigen Inhalts berechtigt. Wählen Sie die Sprache des Berichts separat aus. Das Ändern der Sprache oder einer Auswahl-Einstellung erfordert vor der Erstellung eine weitere Vorschau. 1. Geben Sie den Zweck der Offenlegung ein und wählen Sie Datumsbereiche, Absender-IDs und Kriterien für den Wortlaut aus. 2. Wählen Sie aus, ob Identitäten beibehalten, nur aufgeführte Teilnehmer angezeigt oder alle Teilnehmer pseudonymisiert werden sollen. Im pseudonymisierten Modus werden zudem Chat-IDs/Titel und Nachrichten-IDs ersetzt. Pseudonyme bleiben innerhalb einer Offenlegung unverändert und ändern sich zwischen unabhängig voneinander erstellten Offenlegungen. 3. Behalten Sie den Nachrichtentext bei, lassen Sie ihn vollständig weg oder fügen Sie wörtliche Namen/Phrasen zur Maskierung hinzu. Im privaten Modus maskiert das Tool außerdem bekannte versteckte Absendernamen und alternative Benutzernamen, Absender-IDs in Form ganzer Token, Namen aus Direktchats, Links, E-Mail-Adressen und telefonähnliche Zeichenfolgen. Der Abgleich bekannter Namen berücksichtigt die Unicode-Groß-/Kleinschreibung, einschließlich `Straße`/`STRASSE`. Allgemeine Gruppen-/Kanaltitel werden nicht automatisch aus dem Nachrichtentext entfernt. Wenn das Limit für die Maskierung bekannter Identitäten überschritten wird, schränken Sie den Quell-Export ein oder lassen Sie Text weg; das Tool überspringt spätere Namen nicht stillschweigend. Hierbei handelt es sich um „Best-Effort“-Regeln, nicht um eine allgemeine Anonymisierung. 4. Lassen Sie Dateien unberücksichtigt, es sei denn, der Empfänger benötigt sie. Die enthaltenen Originale behalten ihre Pixel, Audio, Text und Metadaten bei. Sie werden vom Tool **nicht** anonymisiert. 5. Zeigen Sie eine Vorschau der Zählwerte, Warnungen und Beispielnachrichten in transformierter Form an und bestätigen Sie anschließend die Erstellung ausdrücklich. Die Beispiele sind auf jeweils 12 Nachrichten und 2.000 Textzeichen begrenzt. Dies ist ein Beispiel und keine vollständige Überprüfung des Ergebnisses. Das Ändern von Einstellungen erfordert eine weitere Vorschau. Eine Vorschau läuft nach 15 Minuten ab und ist an diese Administratorsitzung sowie an das exakte Original-ZIP gebunden; sie kann nach der Erstellung nicht wiederverwendet werden. Eine neue Vorschau macht die vorherige für denselben Auftrag und dieselbe Sitzung ungültig. 6. Sehen Sie sich das vollständige Ergebnis an `index.html` und `messages.jsonl` vor der Übergabe. Falls darin unnötige Informationen enthalten sind, erstellen Sie eine neue Offenlegung mit strengeren Ausschlusskriterien. Bearbeiten Sie das signierte ZIP nicht direkt an Ort und Stelle. ### Durch die Auswahl ausgelassene Nachrichten **Vorschau.** Eine Offenlegung erscheint unvollständig, wenn sie es tatsächlich ist. In jedem Chat, der mindestens eine offengelegte Nachricht enthält, werden die von der Auswahl ausgelassenen Nachrichten als Markierungen angezeigt, `[withheld by selection — rule: sender]` (oder `text`, `period`). Wählen Sie **„Durch die Auswahl ausgelassene Nachrichten**“: eine Markierung für jede Folge aufeinanderfolgender zurückgehaltener Nachrichten (Standard) oder eine für jede einzelne Nachricht. Markierungen enthalten nur die Regel und eine Zählung, niemals Text, Absender, Datum oder Dateien. Chats, in denen nichts offengelegt wurde, werden vollständig ausgelassen, sodass das Paket deren Existenz nicht preisgibt. Offen gelegte Antworten geben an, worauf sie sich beziehen: eine in dieser Kopie enthaltene Nachricht, eine durch die Auswahl zurückgehaltene Nachricht oder eine Nachricht, die nicht im Quell-Export enthalten ist (vor dem Export gelöscht oder nie exportiert; der Export kann nicht unterscheiden, was zutrifft). Eine zurückgehaltene Nachricht, auf die eine offengelegte Antwort Bezug nimmt, erhält immer eine eigene Kennzeichnung, sodass die Antwort auf einen Datensatz verweist, der erklärt, warum sie leer ist. Diese drei Zustände unterscheiden sich von Löschungen und Lücken in der Datensammlung, die zum Quell-Export gehören. Im `messages.jsonl` (Format `tgwitness-account-disclosure-v2`) enthält jede Nachricht `state`: `disclosed`oder `withheld` mit `rules` und `count`. Eine offengelegte Antwort enthält `reply_to` mit dem Ziel `id` und `state` (`disclosed`, `withheld`, `not_in_source`). Das Manifest zählt offengelegte Nachrichten, Chats, Medien und `withheld` Nachrichten. `verify.py` Es lehnt einen Marker ab, der Inhalt enthält, sowie eine Antwort, die auf einen im Paket fehlenden Datensatz verweist; Pakete der Version 1 werden wie bisher verifiziert. Das minimierte Format lässt strukturierte Kontoprofile, Kontakte, Avatare, Sitzungen, Stories, Telegram-Rohobjekte, Weiterleitungs-Header, Antwortzitate, Kontaktkarten und Standort-Metadaten weg. Es schließt die ursprünglichen JSONL-Dateien, private Filtereinstellungen, den Pseudonymschlüssel und die Identitätszuordnung aus. Ausgewählter Text, explizit beibehaltene Identitäten und eingebundene Dateien können weiterhin dieselben Namen, IDs oder Phrasen enthalten, die in diesen Filtern verwendet werden; sie müssen separat überprüft werden. Die private Richtlinie und der Pseudonymschlüssel werden verschlüsselt im lokalen Tresor des Auftrags aufbewahrt; das Löschen des Auftrags löscht die zugehörigen privaten Offenlegungsdatensätze. Die öffentliche Richtlinie erfasst die Anzahl der Filter statt der Filterwerte. Der angegebene Zweck ist im Manifest und im HTML öffentlich: Explizite private Kriterien und – in pseudonymisierten Modi – bekannte verborgene Identitäten werden dort ebenfalls maskiert, auch wenn der Nachrichtentext weggelassen wird. Halten Sie den Zweck frei von unnötigen persönlichen Details; unbekannter identifizierender Kontext kann bestehen bleiben. Das Manifest enthält die abgeleiteten Dateien, die öffentlichen Richtlinien und den Hashwert der Original-ZIP-Datei. Durch eine Überprüfung lassen sich die Integrität sowie – sofern die Quelle lokal bereitgestellt wird – die Übereinstimmung der Quellverknüpfungen feststellen. Das Panel speichert die Freigabekopie unter dem Namen `tgwitness-disclosure-DISCLOSURE_ID.zip`: ``` python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip ``` Die Quellenverknüpfung zeigt, aus welchem Archiv und mit welchem Collector-Schlüssel die Offenlegung stammt. Die Offenlegung enthält nur die ausgewählten Inhalte; prüfen Sie die Auswahl und das Entfernen identifizierender Details anhand des ursprünglichen Exports. ## Freigabe und gehostete Erfassung Wählen Sie die Nachrichten und Dateien aus, die der Empfänger benötigt, überprüfen Sie die vollständige Kopie, die weitergegeben wird, und bewahren Sie die Quelle separat auf. Notieren Sie den Hash-Wert der übermittelten ZIP-Datei, damit der Empfänger genau diese Kopie identifizieren und verifizieren kann. Durch Pseudonymisierung werden die ausgewählten Identifikatoren ersetzt; der enthaltene Text und die Originaldateien bleiben Teil der Überprüfung. GitHub Actions unterstützt den Export des gesamten Kontos und ausgewählter Chats über Takeout oder die reguläre API sowie ein Ereignisprotokoll für einen einzelnen Chat. Die Anleitung zur gehosteten Erfassung erläutert die Überprüfung der Einstellungen und das 120-Minuten-Limit. Um eine aus der gehosteten Erfassung abgeleitete Freigabekopie zu überprüfen, vergleichen Sie deren Quell-Hash mit dem Originalarchiv und verifizieren Sie die Bescheinigung dieses Archivs mit den [-modus-spezifischen Prüfungen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope). [Format der Beweismittel](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) · [Fallberichte](https://phishdestroy.io/tgwitness/de/docs/reference/case-reports/) --- # Telegram · Format der Beweismittel Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/evidence/ Inhalt der signierten ZIP-Datei, Protokolltypen, Prozessbestätigungen, Benutzerprofile, externe Kopien und Offline-Überprüfung. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Translation coverage: this edition includes material from the English original. Inhalt der signierten ZIP-Datei, Protokolltypen, Prozessbestätigungen, Benutzerprofile, externe Kopien und Offline-Überprüfung. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness speichert für das Konto sichtbare Telegram-Beobachtungen in einem signierten Journal. Empfänger können die gespeicherten Datensätze, Anhänge und Berichte anhand eines vertrauenswürdigen Collector-Schlüssels verifizieren, die externe Zeit eines Drittanbieters für den letzten Datensatz überprüfen und das Journal mit einem zuvor gespeicherten Checkpoint vergleichen. Diese Seite beschreibt die Formate, die Prüfungen und das für die Übergabe aufzubewahrende Material. Empfänger können unter Windows mit **VERIFY.cmd** beginnen: Das Programm fragt nach der Original- ZIP-Datei und dem unabhängig ermittelten Schlüssel-Fingerabdruck, zeigt ein kommentiertes Ergebnis an und speichert ein separates Verifizierungsprotokoll. Informationen zur Einrichtung und zu Vertrauensgrenzen finden Sie unter den [-Verifizierungs-Launchern und der portablen Laufzeitumgebung](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md). **Auf dieser Seite** - [Was ist signiert?](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#what-is-signed) - [Vergleich von Chat-Exporten](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#comparing-chat-exports) - [Übergabe der Untersuchung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#investigation-handoff) - [Auszug aus der Übergabe](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#handover-extract) - [Lesbare Berichte](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#readable-reports) - [Kanonisierung von Ereignissen](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#event-canonicalization) - [Akteur-Semantik](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#actor-semantics) - [Abdeckung: Kontinuität, Lücken und nicht beobachtete IDs](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids) - [Ersteller](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#producer) - [Personenprofile](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#people-profiles) - [Unabhängiger Zeuge](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#independent-witness) - [Manifest und Checkpoints](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#manifest-and-checkpoints) - [Verifizierungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) - [Anhänge](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#attachments) - [Dauerhafte Erfassung und Verarbeitung von Belegen (0.2)](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#durable-collection-and-process-receipts-02) - [RFC 3161-Vorbereitung und Antwortüberprüfung (0.2)](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02) - [Optionale Datensätze im Beweismodus: drand und Telegram-Geräte](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices) ## Was ist signiert? | Material | Schutz | Was ist zu beachten? | | --- | --- | --- | | Jeder Eintrag im Protokoll, einschließlich operativer Ereignisse | SHA-256-Kette und eine Ed25519-Signatur pro Ereignis | Original-`events.jsonl`, der Fingerabdruck des vertrauenswürdigen Schlüssels, sowie ein gespeicherter Kontrollpunkt | | Inhalt der ZIP-Datei mit den Beweismitteln | `manifest.sig` signiert das kanonische Manifest, in dem die Hash-Werte der Inhaltsdateien aufgeführt sind | Das vollständige ZIP-Archiv, einschließlich Manifest und Signatur | | Erhaltene Anhänge | SHA-256 und Byteanzahl in einem signierten „`media.saved`“-Ereignis; Datei-Hash im signierten ZIP-Manifest | Die Originaldaten innerhalb der verifizierten ZIP-Datei | | Checkpoint | Ed25519-Signatur über die Länge des Protokolls, den Kopf-Hash, den öffentlichen Schlüssel und den Erstellungszeitpunkt | Eine unabhängige Kopie, die vor einer umstrittenen Änderung gesichert wurde | | Ausführungsbeleg | Signierte Aufzeichnung der Collector-Version, der Hashes der Quelldateien und der Starteinstellungen, ebenfalls in `process.started` enthalten | Der Beleg, der zugehörige Journal-Eintrag und die Umgebungsnachweise für den ausgewählten Verifizierungsmodus | | Lesbare Berichte: „`report.html`“ und seine Teile „`report.json`“, „`report.pdf`“, „`chat.pdf`“ | Ein Ed25519-Siegel pro Datei über deren Inhalt; das PDF trägt zudem eine Standard-PDF-Signatur (siehe [Lesbare Berichte](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#readable-reports)) | Die empfangene Datei und der Fingerabdruck des vertrauenswürdigen Schlüssels; die darin beschriebene ZIP-Datei | | Standalone-CSV | Keine eigenständige kryptografische Signatur; Ereignis-Hashes allein reichen nicht aus | Verwenden Sie den exakten Inhalt der verifizierten ZIP-Datei zur Integritätsprüfung. | | Screenshots, Ausdrucke oder von einem Browser erstellte PDF-Dateien | Keine TgWitness-Signatur auf dem abgeleiteten Dokument | Bewahren Sie das ursprüngliche, verifizierte Paket auf und dokumentieren Sie, wie das Derivat erstellt wurde. | Der Collector überprüft die Journal-Signaturen, bevor jedes Exportformat generiert wird. Lesbare HTML- und PDF-Berichte tragen ihre eigenen Siegel; eigenständige CSV-Dateien werden als Teil einer signierten ZIP-Datei überprüft. Behalten Sie die ZIP-Datei bei, um die Anhangsbytes und das Manifest zu erhalten, sowie einen separaten Checkpoint, um das Journal anhand einer früheren Grenze zu überprüfen. ## Formate und Verifizierungspfade Der Erfassungsmodus und das Ausgabeformat beantworten unterschiedliche Fragen. Der Modus liefert Erfassungs- und Umgebungsnachweise; jedes Format bewahrt oder präsentiert einen Teil dieses Datensatzes unter Berücksichtigung der unten aufgeführten Prüfkriterien. | Ausgabe | Verifizierung und Verwendung | | --- | --- | | Beweismaterial ZIP | Kanonische Ereignisse, signiertes Manifest, Abdeckung, Verwahrungseinträge, Anhänge und verfügbare externe Belege; überprüfen Sie das Archiv und dessen ausgewählten Erfassungsmodus. | | ASiC-E-Container | Die ZIP-Datei mit den Nachweisen als ETSI-ASiC-E-Container (EN 319 162-1) mit einem `mimetype`-Eintrag und der Datei `META-INF/ASiCManifest.xml`, die mit dem arbeitsbereichseigenen Zertifikat auf Stufe B-B oder, bei aktivierter Zeitstempelung, auf Stufe B-T CAdES-signiert ist. Validatoren wie EU DSS prüfen Format und Integrität und melden, da das Zertifikat selbst ausgestellt wurde, keinen Vertrauensanker. EU DSS 6.3 lehnt mit den Standardeinstellungen einen Container mit mehr als 1000 Dateien ab („Zu viele Dateien erkannt“). `verify.py` überprüft das Ed25519-Manifest und jede aufgeführte Datei sowie die SHA-256-Werte in `META-INF/ASiCManifest.xml` und in einer hinzugefügten `ASiCManifestNNN.xml`- oder `ASiCEvidenceRecordManifest.xml`-Datei und schlägt fehl, wenn ein `META-INF/`-Eintrag vorhanden ist, der von keiner dieser Dateien abgedeckt wird. Es überprüft die CAdES-Signaturen nicht und gibt dies auch an. | | HTML- und JSON-Berichte | Einzeln versiegelte Ansichten mit Quellenangaben, die ebenfalls im ZIP-Manifest aufgeführt sind. Ihre erfassten Zählwerte fassen die Arten der Journalereignisse zusammen. | | PDF-Berichte | Ed25519-Siegel sowie eine PAdES-Baseline-PDF-Signatur über den Byte-Bereich: B-B oder B-T mit einem Signatur-Zeitstempel, sofern die Zeitstempelung aktiviert ist. Der TgWitness-Verifizierer verwendet den vertrauenswürdigen Ed25519-Schlüssel; die Anzeige der Zertifikatsvertrauenswürdigkeit durch den Betrachter ist eine separate Überprüfung. | | CSV | Eine Tabellenkalkulationsansicht, die vom ZIP-Manifest abgedeckt wird. Die Formelauflösung schützt die Verwendung der Tabellenkalkulation; der ursprüngliche signierte Text verbleibt im Journal. | | JSONL | Signierte Ereignisaufzeichnungen, einschließlich Verweisen auf Anhänge. Die ZIP-Datei mit den Nachweisen enthält zusätzlich die erhaltenen Anhangsdaten. | | Chat-Export und Desktop-kompatible Ansichten | Erfassung des Verlaufs und der verfügbaren Admin-Log-Einträge mit der angeforderten Darstellung und dem signierten Archiv. Die gespeicherten Versionen der Live-Überwachung stellen einen separaten Erfassungspfad dar. | | Medien und reine Hash-Einträge | Gespeicherte Bytes werden anhand ihres SHA256-Hashwerts und ihrer Nachrichtenreferenz überprüft. Bei der reinen Hash-Erfassung werden die verfügbaren Hash-Metadaten für einen späteren Vergleich mit den Dateibyte beibehalten. | | STIX/MISP und Personenprofile | Quellverknüpfte extrahierte Beobachtungen, Konto-IDs und analytische Übereinstimmungen. Profilsignaturen und Datensatz-Hashes können mit den Originalnachweisen abgeglichen werden; die Herkunft des Avatar-Caches wird separat gekennzeichnet. | | Auszug aus der Übergabe | Signierte Offenlegungsregeln, unveränderte Datensätze und markierte, minimierte Datensätze, die die ursprünglichen Hashes/Signaturen beibehalten. Verwenden Sie das beibehaltene Original für einen Vergleich, der zurückgehaltene Felder erfordert. | | Zeugen und Zeitbelege | Frühere Journalgrenzen, Kontinuität und die einzelnen verifizierten Zeitangaben. Sie begleiten die Erfassungs- und Archivprüfungen. | | Passwortgeschützte Bereitstellung | Schützt das enthaltene Paket während der Übertragung. `.tgwpw` verwendet eine authentifizierte AES-GCM-Verschlüsselung, einschließlich eines authentifizierten Abschlussdatensatzes; das enthaltene Journal behält seine Signaturen und Erfassungsbelege bei. | Ein Ausdruck oder Screenshot ist eine Darstellung des signierten Materials. Seine Berichts- ID, der Schlüssel-Fingerabdruck und die QR-Referenz helfen dabei, die Originaldatei zur Überprüfung zu finden. Verwahrungserklärungen dokumentieren den bereitgestellten Prüfer und die Übertragungsinformationen; Prüferergebnisse und Erfassungsbelege werden als separate Beweismittel aufbewahrt. ### Externe Signaturen Eine Signatur kann auch von einem Schlüssel stammen, den TgWitness niemals besitzt, wie beispielsweise die qualifizierte elektronische Signatur eines Ermittlers oder das Siegel einer Organisation. Bei **Exporten** gibt **die externe Signatur** auf einem vorbereiteten Export ohne Passwort die zu signierenden Bytes aus: eine neue `META-INF/ASiCManifestNNN.xml` Auflistung aller Dateien mit ihrem jeweiligen SHA-256-Hash für einen ASiC-E- Container oder die `manifest.json` für einen ZIP-Export. Der Unterzeichner gibt ein CMS (CAdES) zurück `.p7s`, entweder separat oder mit eingebettetem Inhalt. TgWitness prüft, ob die Signatur genau diese Bytes abdeckt, und verifiziert sie anhand des Zertifikats des Unterzeichners (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Die Kette wird nur anhand der vom Betreiber bereitgestellten Stammzertifikate überprüft; Sperrstatus, vertrauenswürdige Listen und qualifizierter Status werden nicht geprüft. Das Fenster zeigt pro Signatur einen Status an: Warten auf eine Signatur, angehängt und nicht geprüft, verifiziert, Algorithmus wird nicht unterstützt, Signatur ungültig, signierte Bytes stimmen nicht überein oder Zertifikat ist nicht mit einem bereitgestellten Stammzertifikat verkettet. Wird der Export nach der Ausgabe der Bytes geändert, werden alle zugehörigen Signaturen auf „signierte Bytes stimmen nicht überein“ gesetzt. **Beim Herunterladen mit Signaturen** werden die Signaturen und ihre Manifeste unter `META-INF` in einen ASiC-E-Container ein. Bei einer ZIP-Datei werden die unveränderte ZIP-Datei sowie die `.p7s` Dateien sowie `SIGNATURES.txt` in eine äußere ZIP-Datei. Ungültige Signaturen und Signaturen, die andere Bytes überlagern, werden weggelassen. Eine Signatur mit einem Algorithmus, den TgWitness nicht überprüfen kann, wird einbezogen; das Bedienfeld zeigt ihren Status an, ebenso wie `SIGNATURES.txt` bei einer ZIP-Datei. ### Signierte Chat-Bilder **Durch das Herunterladen der signierten ZIP-Datei** in der Bildvorschau werden die Seiten als PNG-Dateien gespeichert, `pages.sig.json` und `README.txt`. Jede Seite endet mit den angezeigten Protokollnummern, dem Chat, der Renderzeit, dem Fingerabdruck des Arbeitsbereichsschlüssels und dem Befehl, der diesen überprüft. Das Fenster sendet nur den SHA-256-Hash und die Protokollnummern jeder Seite; der Server bestätigt, dass die Protokolle zu dem Chat gehören, signiert die Erklärung (`tgwitness-image-attestation-v1`) mit dem Arbeitsbereichsschlüssel und protokolliert die Signierung als `export.image_attested`. ``` python verify.py page-01.png page-02.png pages.sig.json python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip ``` Der Verifizierer überprüft die Signatur, ordnet jede PNG-Datei einer signierten Seite zu und gibt den Schlüssel-Fingerabdruck aus. `--fingerprint` Er vergleicht den Unterzeichner mit einem Fingerabdruck, der unabhängig vom Absender ermittelt wurde. `--evidence` Liest eine signierte ZIP-Datei mit Beweismaterial aus demselben Arbeitsbereich ein und verlangt, dass jeder Datensatz der Bilder mit demselben Hash vorhanden ist. Ein verändertes Pixel, eine geänderte Aussage oder ein anderer Schlüssel führt zum Fehlschlagen der Prüfung. Die Bilder zeigen gespeicherte Datensätze im TgWitness-eigenen Layout; sie zeigen nicht, was Telegram irgendjemandem angezeigt hat. ## Vergleich von Chat-Exporten Überprüfen und vergleichen Sie zwei signierte ZIP-Dateien mit Chat-Exporten anhand unabhängig gespeicherter Fingerabdrücke der Unterzeichner: ``` python -m tgwitness.verify first.zip --compare second.zip \ --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256 ``` `--require` und `--require-tier` werden in Kombination mit `--compare` nicht akzeptiert; überprüfen Sie das erforderliche Profil jedes Archivs anhand der jeweiligen Verifizierung. Wenn beide Archive dieselben numerischen Konto- und Chat-IDs aufzeichnen, werden die Datensätze anhand der Nachrichten-ID gepaart. **Unverändert** bedeutet Übereinstimmung des vollständigen gespeicherten JSON-Datensatzes: Volltext, Autor, Datumsangaben, Antwortziel, verschachtelte Metadaten und unbekannte Felder sind alle enthalten. Die Reihenfolge der Schlüssel im JSON-Objekt spielt keine Rolle; fehlende Felder, Nullwerte, Werttypen und die Reihenfolge der Arrays hingegen schon. Die 300-Zeichen-Vorschau dient nur zur Anzeige. Geänderte Einträge benennen die abweichenden `changed_fields`-Elemente der obersten Ebene, einschließlich Änderungen, die in dieser Vorschau nicht sichtbar sind. Doppelte Nachrichten-IDs werden beim Abgleich abgelehnt, anstatt sich gegenseitig zu überschreiben. Eine Abweichung kann ein geänderter Anzeigename, eine geänderte Aufrufzahl, eine Sammlungsanmerkung oder andere Beobachtungsmetadaten sein. Telegram-Bearbeitungen erscheinen als eigene Bearbeitungsereignisse, und die Verifizierung jedes Archivs zeigt an, ob dieses Archiv intakt ist. Unparsierte Datensätze verbleiben im Vergleich und werden anhand ihrer gespeicherten Darstellung verglichen. Bei abweichenden oder fehlenden Konto-/Chat-Identitäten ermittelt das Tool mögliche Übereinstimmungen anhand von Absender, vollständigem Text, Datei-Hash, Medientyp und einer Zeittoleranz von fünf Sekunden und meldet diese als **Matched** statt als **Unchanged**. Nicht geparste Datensätze bleiben unzugeordnet. Unterschiede in gepaarten Datensätzen werden unter `changed` aufgelistet, auch im Inhaltsmodus. Mit `--json` zählt `matched` die Kandidatenpaare und `unchanged` zählt Paare, deren vollständig gespeicherte Datensätze identisch sind. Die bestehenden Ausgaben `changed_fields` und `unchanged` (Ganzzahl) bleiben kompatibel mit früheren Vergleichsergebnissen. Das Archivformat und die Signaturüberprüfung bleiben unverändert. ## Übergabe von Ermittlungsergebnissen 1. Halten Sie die Fallreferenz, den Bearbeiter, die numerische Telegram-Konto-ID, die ausgewählten Quellen, die Erfassungsrichtlinie und den Erfassungszeitraum in Ihren Fallnotizen fest. TgWitness sichert Beobachtungen und unterstützt quellenverknüpfte Notizen und Erfassungen im [„Case Board](https://phishdestroy.io/tgwitness/de/docs/reference/case-board/)“. Bewahren Sie Übergabe- und Verwahrungsprotokolle zusammen mit Ihren Fallunterlagen auf. Überprüfen Sie die geplante Erfassungs Konfiguration im Rahmen des [Live-Abnahmeverfahrens](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md). 2. Speichern Sie den Fingerabdruck des öffentlichen Schlüssels des Arbeitsbereichs separat, bevor Sie sich auf dessen Exporte verlassen. Lassen Sie den Nachweis-Modus aktiviert (Standardeinstellung), damit Checkpoints RFC 3161- und OpenTimestamps-Quittungen erhalten. Speichern Sie signierte Checkpoints während der Erfassung außerhalb des Collectors. Protokollieren Sie Unterbrechungen und die Grenzen der Sichtbarkeit des Kontos. 3. Exportieren Sie eine **signierte ZIP-Datei** und bewahren Sie die signierte Ausführungsbestätigung auf. Verwenden Sie einen Prüfpunkt an oder vor der Grenze des exportierten Protokolls. Ein späterer Prüfpunkt kann einen früheren Export zu Recht als zu kurz zurückweisen. Exporte umfassen das vollständige Arbeitsbereichsprotokoll, unabhängig von Panel-Filtern; überprüfen Sie das Material, bevor Sie es weitergeben. 4. Lassen Sie den Empfänger die ZIP-Datei mit einer vertrauenswürdigen Kopie des Verifizierers, dem unabhängig bereitgestellten Fingerabdruck und dem separat beschafften Stammzertifikat des Zeitstempeldienstes überprüfen. Ausgehend von einem vertrauenswürdigen Checkout mit aktiver Python- Umgebung: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` Der Fingerabdruck und ein geprüfter Zeitstempel des letzten Datensatzes erfüllen die Mindestanforderungen für Beweismittel; `--require evidence` beendet das Programm andernfalls mit dem Code 2. Der Checkpoint ist eine unterstützende Prüfung, da er mit dem Schlüssel des Collectors signiert ist. Bei erfolgreicher Ausgabe werden `key_pinned: true` und `checkpoint_checked: true` gemeldet, wenn beide Eingaben bereitgestellt und akzeptiert wurden. Behalten Sie das Verifizierungsergebnis bei. ``` For a handover requiring the final exported record to be witnessed, use `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`. This refuses an export with an unwitnessed tail. Add `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the witness posts as external time. See the [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary). ``` 1. Erfassen Sie den SHA-256-Hash des Archivs, die Exportgrenze, das Übertragungsdatum, den Absender und den Empfänger in Ihrem Aufbewahrungsprotokoll. Bewahren Sie das Originalpaket unverändert auf und arbeiten Sie mit Kopien. Geben Sie Beweisdateien weiter, nicht das private Datenverzeichnis der Anwendung, das auch Kontositzungen und Signaturgeheimnisse enthält. Wählen Sie für die Übertragung ein passwortgeschütztes AES-256-ZIP oder den sichereren `.tgwpw`- Container. ZIP verwendet die kostengünstige Passwortableitung von WinZip; verwenden Sie eine lange, zufällige Passphrase. `.tgwpw` verwendet scrypt und AES-256-GCM und lässt sich mit dem Befehl `unseal-password` des eigenständigen Verifizierers öffnen. Das Passwort wird nicht gespeichert und dient ausschließlich dem Schutz der Vertraulichkeit; der Empfänger entschlüsselt das Archiv und überprüft den darin enthaltenen signierten Export, der unverändert ist. 2. Um einen Checkpoint außerhalb des Beweismodus mit einem Zeitstempel zu versehen, befolgen Sie das [Verfahren gemäß RFC 3161](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/) und bewahren Sie die Anfrage, den Checkpoint, die Informationen zur vertrauenswürdigen Zertifizierungsstelle sowie die verifizierte Antwort der Autorität auf. Das bloße Vorbereiten einer Anfrage führt nicht zum Erhalt eines Zeitstempels. Verwenden Sie für `.tgwpw` einen unabhängig beschafften Verifizierer und wählen Sie eine neue Ausgabedatei mit der ursprünglichen Erweiterung: `python verify.py unseal-password export.tgwpw --out evidence.zip`. Der Befehl fordert zur Eingabe des Passworts auf; `--password-stdin` liest zur Automatisierung eine Zeile ein. Er überschreibt niemals eine vorhandene Datei und veröffentlicht Klartext erst, nachdem alle Datensätze authentifiziert wurden. Führen Sie anschließend eine normale Signaturprüfung an der entschlüsselten Datei durch. Der Container verwendet scrypt (`N=131072`, `r=8`, `p=1`, 16-Byte-Salt; ca. 128 MiB RAM) sowie AES-256-GCM mit 1 MiB großen Datensätzen und einem authentifizierten Abschlussdatensatz. Ein verschlüsselter Metadaten-Datensatz speichert den internen Dateinamen, sodass heruntergeladene Container umbenannt werden können. Eine erfolgreiche Verifizierung stellt die Integrität in Bezug auf den vertrauenswürdigen Collector-Schlüssel und die beibehaltene Grenze sicher. Siehe [Verifizierungsumfang](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) für die Vertrauensannahmen und [Validierungsergebnisse](https://phishdestroy.io/tgwitness/de/docs/reference/verification/) der durchgeführten Prüfungen. ## Auszug aus der Übergabe Eine signierte ZIP-Datei enthält das gesamte Arbeitsbereichsprotokoll. Wenn ein Gericht, ein Anwalt oder eine Meldestelle für Missbrauch nur bestimmte Chats, einen Zeitraum oder bestimmte Personen benötigt, erstellt **„Exporte → Übergabeauszug“** eine minimierte Kopie (`tgwitness-handover-v1`) gemäß den ausgewählten Offenlegungsregeln. Der Bediener gibt den Zweck an und wählt die Chats, einen optionalen Zeitraum (UTC) sowie die Personen aus, auf die sich der Auszug bezieht, und legt fest, was mit allen anderen geschieht (angezeigt, durch Pseudonyme P01, P02… oder weggelassen werden), welche Nachrichtentexte erhalten bleiben, welche Anhänge und Profilfotos enthalten sind und ob Telefonnummern und E-Mail-Adressen in Texten maskiert werden. Der Zweck und diese Regeln sind im signierten Manifest und im Bericht enthalten; das Journal protokolliert „`handover.exported`“ mit dem Zugriff, der es erstellt hat, sowie dem SHA-256-Hash der Datei, nicht den Inhalt. `verify.py` überprüft einen Auszug auf zwei Arten. Ein als unverändert angezeigter Datensatz wird vollständig verifiziert: sein Inhalt wird mit seinem Hash, seiner Ed25519-Signatur und seinem Verweis auf einen enthaltenen Vorgänger abgeglichen. Ein minimierter Datensatz behält den ursprünglichen Hashwert und die Signatur bei, sodass die Signatur weiterhin gültig ist, die ausgeblendeten Felder jedoch nicht daraus neu berechnet werden können; der Datensatz gibt an, was ausgeblendet wurde, und der Bericht kennzeichnet dies. Kontoweite Dienstdatensätze (Start- und Stoppvorgänge, Abdeckungslücken, Verbindungs-, Netzwerk- und Speicherhinweise, Änderungen des Geltungsbereichs und der Einstellungen) behalten nur die für ihre Art aufgeführten Felder bei: Darin enthaltene Chat-Listen werden auf die ausgewählten Chats gekürzt und deren Gesamtzahlen neu gezählt; eine Lücke bei der Live-Abfrage in einem Chat außerhalb der Auswahl führt zum Verlust dieses Chats, seiner Nachrichtenanzahl und des Zeugen-Kontos; in einem ausgewählten Abfrage-Chat wird das Zeugen-Konto durch sein Pseudonym ersetzt, es sei denn, alle werden angezeigt oder es handelt sich um eine der ausgewählten Personen. Das Manifest gibt die Journal-Länge und den Kopf an, über dem die Signatur des Sammlers steht, und zählt die ausgelassenen Datensätze; `coverage.json` beschreibt die ausgewählten Chats. Neue Auszüge enthalten zudem `proofs.jsonl`: Für jeden enthaltenen Datensatz und für den Journal-Kopf wird der Merkle-Pfad vom ursprünglichen Hash des Datensatzes zur Journal-Wurzel angegeben, die im signierten Manifest genannt ist. `verify.py` überprüft jeden Pfad, sodass für jeden Datensatz nachgewiesen wird, dass er zu demselben Journal mit dieser Länge und diesem Kopf gehört, ohne dass das vollständige Journal vorliegt; ein Auszug mit 100 Nachrichten wird unabhängig von der Journalgröße in etwa einer Sekunde überprüft. `--range=CHAT:FROM-TO` bestätigt zusätzlich, dass Nachrichten von FROM bis TO eines Chats im Auszug enthalten sind, und gibt an, wie viele Datensätze dafür überprüft wurden. Namen innerhalb von Dateinamen werden nicht erkannt. Überprüfen Sie die endgültigen Dateien vor der Weitergabe: Freitext, Dateinamen und ausgewählte Anhänge können weiterhin Personen identifizieren. Bewahren Sie die vollständige signierte ZIP-Datei auf: Der Auszug ist eine Offenlegung, kein Ersatz. ## Lesbare Berichte Signierte Beweismittel, Übergabe- und Chat-ZIP-Dateien enthalten lesbare HTML- und JSON-Berichte sowie PDF-Dateien, sofern die erforderlichen Schriftarten verfügbar sind, in der ausgewählten Berichts-Sprache. Jeder Bericht ist mit dem Ed25519-Schlüssel des Arbeitsbereichs versiegelt und kann separat überprüft werden: ` `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]``. - `report.html` / `chat.html`: Die Seal-Anweisung (`tgwitness-report-seal-v1`) schließt die Datei und signiert das SHA-256 jedes davor liegenden Bytes. Lange Protokolle und Chats werden in Teile einer konfigurierbaren Größe aufgeteilt (Berichtseinstellungen, 500 bis 100.000 Datensätze; standardmäßig 5.000): `records/records-0001.html` oder `messages/messages-0001.html`, jeweils mit Nummer, Bereich und Gesamtsumme versiegelt und zusammen mit dem entsprechenden SHA-256 im signierten Manifest aufgeführt. Serien von Collector-Heartbeats werden als eine Zeile angezeigt, sofern sie in den Berichtseinstellungen nicht einzeln aufgeführt sind. - `report.json` (`tgwitness-report-json-v1`, Schlüssel `format`, `report`, `seal`): Das Siegel signiert das SHA-256 des kanonischen JSON von `report`, sodass die Fakten von Fallbearbeitungssystemen und Skripten gelesen werden können und daraus eine Auswahl zum Datenschutz getroffen werden kann, während die signierte Datei intakt bleibt. - `report.pdf` / `chat.pdf`: ein formelles Dokument zum Ausdrucken und Ablegen, das zweimal über dieselben Bytes signiert ist, wobei die gesamte Datei mit Ausnahme des Signaturwerts (`/ByteRange`). Die Standard-PDF-Signatur ist PAdES Baseline (ETSI EN 319 142-1, `/SubFilter /ETSI.CAdES.detached`: CMS mit SHA-256 und ECDSA P-256, Signaturzertifikat v2, keine CMS-Signaturzeit; die angegebene Zeit ist `/M`) auf Stufe B-B oder B-T mit einem RFC-3161-Signatur-Zeitstempel im CMS, wenn die Zeitstempelung aktiviert ist und eine Zeitstempelbehörde über die Route auf Anfragen außerhalb von Telegram antwortet. Es verwendet ein selbst ausgestelltes Dokumentensignaturzertifikat, das im Workspace-Tresor aufbewahrt wird; dessen Seriennummer entspricht dem Ed25519-Schlüssel-Fingerabdruck. Das Ed25519-Siegel wird innerhalb des CMS als das unsigned-Attribut `2.25.240684792623320047764573196045913242332` und benennt den SHA-256-Hash des Zertifikats mit `"content": "pdf-byte-range"`, sodass der Ed25519-Schlüssel für das Zertifikat bürgt. Das Zertifikat ist nicht qualifiziert: Ein PDF-Reader zeigt die Signatur als gültig und den Unterzeichner als unbekannt oder nicht vertrauenswürdig an, bis das Zertifikat als vertrauenswürdig eingestuft wird; vergleichen Sie stattdessen den Ed25519- Fingerabdruck. Chinesische, japanische und koreanische PDFs benötigen eine Schriftart auf dem Server (oder in `TGWITNESS_FONT_DIR`); ohne diese enthält die ZIP-Datei lediglich die HTML- und JSON-Berichte . - `report.en.html`, `report.en.pdf` / `chat.en.html`, `chat.en.pdf`: das englische Original desselben Berichts, wenn die Berichtssprache nicht Englisch ist, auf dieselbe Weise versiegelt und signiert und im signierten Manifest unter `report.original` genannt. Der Bericht in der gewählten Sprache beginnt mit der Empfehlung, das englische Original mit einer beglaubigten oder vereidigten Übersetzung einzureichen; siehe [Berichte für Gerichte übersetzen](https://phishdestroy.io/tgwitness/de/docs/reference/translation/). In einem Kanal oder einer Supergruppe nummeriert Telegram die Nachrichten der Reihe nach mit 1, 2, 3 … Ein Chat-Export listet die erste und letzte Nummer, die Gesamtanzahl sowie jede Folge fehlender Nummern in `message-ids.json` , das Manifest und den `chat.json` -Header auf und markiert jede Lücke an der Stelle, an der sie im Transkript auftritt. `verify.py` zählt sie ab `chat.json` neu. Eine fehlende Nummer ist eine Nachricht, die Telegram nicht zurückgegeben hat (vor dem Export gelöscht oder für das Konto nicht sichtbar); in privaten Chats und einfachen Gruppen werden die Nummern von allen Chats des Kontos gemeinsam genutzt, und Lücken werden nicht gezählt. Nach dem Einlesen des Verlaufs fragt der Export bei Telegram erneut jede fehlende Nummer ab, und zwar nach Nummer (`channels.getMessages`, bis zu 10.000 Nummern einschließlich der 1.000 unterhalb der ersten Nachricht, gleichmäßig verteilt auf alle Lücken, sofern es mehr davon gibt). Das Ergebnis befindet sich in `message-ids.json` und im Bericht. Eine leere Antwort vermerkt, dass die Nummer zum Zeitpunkt der erneuten Überprüfung für dieses Konto nicht verfügbar ist; die Ursache bleibt dabei ungenannt. Eine bei der erneuten Überprüfung zurückgegebene Nachricht wird dem Export hinzugefügt und markiert `found_on_recheck`. Wenn im Beobachtungsarbeitsbereich festgestellt wurde, dass Nachrichten des Chats gelöscht wurden, bei einer erneuten Überprüfung fehlten oder bearbeitet wurden, fügt der Chat-Export Folgendes hinzu `journal-changes.jsonl`: diese Protokoll-Einträge, jede gespeicherte Version sowie den Hinweis, jeweils mit dem Hash und der Ed25519-Signatur, die sie im Protokoll erhalten haben. `verify.py` berechnet den Hash jedes Datensatzes neu, gleicht dessen Signatur mit dem Exportschlüssel ab und vergleicht die Anzahl mit dem signierten Manifest; der Beweismittelexport enthält die vollständige Hash-Kette. Der Bericht listet diese Nachrichten unter **Löschungen und Frühere Versionen** auf. Jeder Bericht beginnt mit **Kurz gesagt**: ein Absatz, dann was das Material zeigt und was die Aufzeichnung enthält. Der seiteninterne Siegelsstempel färbt sich bernsteinfarben, wenn der Browser die Signatur des Siegels überprüft hat, nicht die Seite selbst: Ein Browser weist einer Seite keine eigenen Bytes zu. Er wird erst grün, wenn der Leser die Datei in das Prüffeld am Ende der Seite zieht und jedes Byte übereinstimmt, und nur, wenn die angezeigte Seite genau diese Datei ist; andernfalls wird er rot. Jeder Bericht nennt das Programm genau: den Git-Commit, bei dem der Collector aus einem Checkout ausgeführt wird oder der Installer `TGWITNESS_COMMIT` festlegt, sowie die SHA-256 der Quelldateien (`source_tree_sha256`, den kanonischen JSON des Pfads → SHA-256 jeder `.py`-, `.js`-, `.css`-, `.html`- und `.svg`-Datei im Paket), die ein Checkout dieses Commits reproduziert, sofern die Dateien nicht geändert wurden. Der Client „Telegram“ wird nach seiner Bibliothek, seiner API-Schicht und seinem Rechenzentrum benannt. Zu Beginn der Beobachtung sowie zu Beginn und Ende eines Chat-Exports fragt der Collector bei „Telegram“ nach dessen Zeit („`updates.getState`“, ganze Sekunden) und zeichnet die Zeit von „Telegram“ abzüglich der Uhrzeit des Collectors auf, unter Berücksichtigung der Ungenauigkeit durch die Übertragungszeit; die Berichte zeigen diese Messungen unter „Chain of Custody“ an. Ein Chat-Export protokolliert außerdem, wann er den Verlauf gelesen hat, zusätzlich zu den Datumsangaben der Nachrichten. ### Anleitung zum Offline-Berichtsbetrachter und zum Archiv Entpacken Sie die ZIP-Datei vollständig, bevor Sie `chat.html` oder `report.html` öffnen. Der Viewer bietet Suchfunktionen, Filter, Teilnehmer, Indikatoren, Datensatzdetails sowie die Auswahl von JSON und CSV ohne Server. Bewahren Sie `viewer/` und `media/` neben dem Bericht auf. Auswahlen sind Ableitungen: Verwenden Sie `verify.py SELECTION.json --evidence ARCHIVE.zip`, um sie mit dem signierten Archiv zu vergleichen. Der Verifizierer prüft die Berichts-ID, den Signaturschlüssel, die Archivgrenze und jeden ausgewählten Eintrag; bearbeitete, fehlende und doppelte Einträge führen zu einem Fehler. Auswahlhinweise und Erstellungszeitpunkt bleiben unsignierte Metadaten. Lücken bei den Nachrichtennummern werden nur bei einem vollständigen, ungefilterten, aufsteigend sortierten Chat-Feed angezeigt. Das Ausblenden einer Kategorie oder das Nichtladen eines Datenblocks darf eine ausgelassene Zeile nicht als Hinweis auf eine fehlende Nachricht interpretieren. Suchmarkierungen werden auf Klartext vor der HTML-Escape-Verarbeitung angewendet, wobei literale Markups beibehalten werden. Der Browser überprüft Manifest-Signaturen, die Berichts-ID und den Schlüssel sowie alle aufgeführten Datei-Hashes. Er lehnt mehrdeutige oder fehlerhafte ZIP-Strukturen, doppelte Namen und unsichere Pfade ab und begrenzt Dateien auf 256 MiB sowie die angegebene Gesamtgröße des Inhalts auf 4 GiB. Verwenden Sie für größere Archive den eigenständigen Verifizierer. Diese Browserprüfung ergänzt die Prüfungen des Verifiers hinsichtlich Journalketten und Datensemantik. `README.txt` enthält eine Einführungsanleitung, ein abgeglichenes Dateiverzeichnis, Anweisungen zur Überprüfung sowie Hinweise zum Datenformat in der Berichts-Sprache, gefolgt von einer vollständigen englischen Anleitung. `SHA256SUMS` umfasst die darin aufgeführten Dateien, mit Ausnahme der Datei selbst, von `manifest.json` und `manifest.sig`; das signierte Manifest umfasst zudem `SHA256SUMS`. Behalten Sie die ursprüngliche ZIP-Datei unverändert bei und speichern Sie Arbeitsdateien außerhalb des entpackten Ordners. PDF-Berichte enthalten Abschnitts-Lesezeichen sowie Fall-/Berichts-Identifikationen auf den folgenden Seiten. ### Der Chat zum Zeitpunkt des Exports Ein Chat-Export erfasst, was Telegram zu Beginn des Exports über den Chat angegeben hat: Telegrams eigene Bezeichnungen (`scam`, `fake`, `restricted` mit den jeweiligen Begründungen, `verified`), Benutzernamen, Beschreibung, Anzahl der Mitglieder und Administratoren, die verknüpfte Diskussion, den Inhaltsschutz, ob neue Mitglieder frühere Nachrichten sehen können und ab welcher Nachricht dieses Konto den Verlauf einsehen kann (`available_min_id`), das Datum der ersten Nachricht, sofern es sich um die Erstellung des Chats handelt, sowie die SHA-256-ID des Chat-Fotos (gespeichert in `media/`). Es erfasst die Position des exportierenden Kontos im Chat: Rolle, Beitrittsdatum, wer es eingeladen hat und, im Falle eines Administrators, dessen Rechte. Eine von Telegram abgelehnte Anfrage wird stattdessen benannt. Wenn das exportierende Konto ein Administrator ist, liest der Export das Administratorprotokoll des Chats (Telegram bewahrt dieses etwa 48 Stunden lang auf) in die Datei `admin-log.json` ein: Löschungen und Bearbeitungen mit dem bereitgestellten Inhalt, dem ausführenden Konto und dem Datum der Quellaktion. Diese Einträge ergänzen die erfassten Versionen des Live-Journals und die Aufzeichnungen über den Empfang von Löschungen. ### Indikatoren Die Berichtsliste und das Archiv enthalten die Einträge `indicators.csv` , `indicators.stix.json` (STIX 2.1 ) sowie `indicators.misp.json` (Ereignis MISP ), auf deren Grundlage eine Missbrauchsstelle in den aufgezeichneten Nachrichten Maßnahmen ergreifen kann: Links und Domains (auch solche, die hinter Text, in Schaltflächen und in Link-Vorschauen verborgen sind), Kryptowährungs- Adressen, Telegram -Benutzernamen und Einladungslinks, Telefonnummern, E-Mail-Adressen und gespeicherte Bilder. Bitcoin-, Litecoin-, Dogecoin- und TRON-Adressen werden nur aufgeführt, wenn ihre Base58-Prüfsumme stimmt, SegWit-Adressen, wenn ihre Bech32- oder Bech32m-Prüfsumme stimmt, und TON-Adressen, wenn ihr CRC stimmt; EVM- und Solana-Adressen werden als nicht geprüft markiert. Bilder enthalten SHA-256 und einen perzeptuellen Hash (dHash, 64 Bit), der bei komprimierten oder in der Größe angepassten Kopien nahezu unverändert bleibt. Berichte schreiben Indikatoren so, dass sie nicht versehentlich geöffnet werden (`hxxps[://]example[.]com` ); die Dateien behalten die Werte unverändert bei. Jeder Indikator wird als unbekannt und nicht zur automatischen Erkennung gekennzeichnet (STIX , `indicator_types: unknown` , MISP , `to_ids: false` , Verteilung an die eigene Organisation): Die Auflistung bedeutet, dass eine Nachricht ihn enthielt, nicht, dass er bösartig ist. Ein Link, dessen Text eine andere Adresse anzeigt als die, die beim Öffnen angezeigt wird, wird im Bericht markiert. Die „PDF“-Berichte enden mit einer vom Prüfer handschriftlich zu unterzeichnenden Erklärung, einer Checkliste für einen Notar oder Gerichtssachverständigen sowie einem QR-Code (ebenfalls auf der ersten Seite) mit der Berichts-ID, dem Schlüssel-Fingerabdruck und dem „SHA-256“ der maßgeblichen Daten, sodass ein Ausdruck zum entsprechenden Archiv zurückverfolgt werden kann. ## Kanonisierung von Ereignissen Die Hash-Eingabe besteht genau aus folgenden Feldern: ``` seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash ``` Serialisierung unter Verwendung von Python-kompatiblem JSON mit UTF-8, sortierten Objektschlüsseln, ohne ASCII- Escaping, ohne unbedeutende Leerzeichen und ohne NaN/Unendlich: ``` json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"), allow_nan=False).encode("utf-8") ``` Der SHA-256-Hash dieser Bytes wird zum Ereignis-Hash. Die Signatur erfolgt mit Ed25519 über die 32 Roh-Hash-Bytes und wird anschließend Base64-kodiert. Der erste „previous_hash“ besteht aus 64 Nullen. Die Sequenznummern beginnen bei 1 und erhöhen sich um 1. Alle Ereignisse, einschließlich operativer Ereignisse, teilen sich eine Kette. Es erfolgt keine Unterdrückung doppelter Zustellungen: Wiederholte Beobachtungen stellen separate Empfangsbestätigungen dar und sind kein Hinweis auf unterschiedliche Telegram-Aktionen. Rohdaten von Telegram-Nachrichten sind ISO-Zeichenketten; binäre Felder werden zu Objekten, die bytes_base64 enthalten. Nachrichtentext, Entitäten, Mediendeskriptoren, Antwort-Metadaten, Reaktionen und Service-Aktionen werden in den Rohdaten der Nachricht beibehalten, sofern sie vorhanden sind. Eine Live- Nachricht behält außerdem das Telegram-Update bei, durch das sie übermittelt wurde `transport_update`; wenn dieses Update dieselbe Nachricht enthält wie `raw`, wird ihr `message` Feld ist `{"same_as": "raw"}` anstelle einer zweiten Kopie. `observed_at` ist die UTC-Zeit, zu der der Collector den Datensatz geschrieben hat; `source_at` ist das Datum, das von diesem Telegram-Ereignis bereitgestellt wird. Bei Datensätzen, die während der Verarbeitung einer Live-Aktualisierung geschrieben werden, wird zusätzlich `payload.received_at`, die UTC-Zeit, zu der das Update den Collector erreichte, sowie `payload.processing_delay_ms`. Live-Bearbeitungen behalten das übermittelte Bearbeitungsdatum bei, Verlaufs-Snapshots behalten das Nachrichten-Datum mit einer aktuellen Beobachtungszeit bei, und eine gewöhnliche Löschbenachrichtigung zeichnet die Empfangszeit mit einem Null-Quelldatum auf. Admin-Log- Einträge behalten ihr übermitteltes Aktionsdatum separat bei. Die Empfangsreihenfolge und die Reihenfolge der Quellereignisse sind unterschiedliche Zeitachsen, wobei Uhrzeitbeobachtungen und externe Empfangsbestätigungen zum Vergleich zur Verfügung stehen. ## Semantik der Akteure Die Zuordnung erfolgt anhand der Ereignisquelle. `message.new.actor_id` und `message.edited.payload.sender_id` enthalten den Absender der Nachricht. Gewöhnliche `message.deleted`-Benachrichtigungen enthalten Nachrichten-IDs und haben ein null-Feld für den Akteur; verfügbare Admin-Log-Einträge enthalten die angegebene Aktion, den Akteur und das Datum. Nachrichten des Mitgliedschaftsdienstes enthalten Absender und Aktionstyp, rohe Teilnehmer-Updates enthalten die angegebene `actor_id`, und Reaktions-Snapshots bewahren ihre angegebenen Zählwerte und sichtbaren Identitäten. Lesen Sie diese Datensätze zusammen mit den erfassten Versionen und [den Belegen für die Panel-Interaktion](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#own-actions). Löschbenachrichtigungen für private Chats und normale Gruppen enthalten nur Nachrichten-IDs. Diese Chats teilen sich eine kontoweite ID-Sequenz, sodass eine ID eine einzelne Nachricht dieses Kontos identifiziert. Wenn eine Nachricht mit dieser ID zuvor in diesem Journal gespeichert wurde, wird die Löschung in diesem Chat als `message.deleted` mit der Nutzlast `chat_resolution` als Methodenname aufgezeichnet. IDs, die nie gespeichert wurden, werden als `deletion.unscoped` geführt: eine tatsächliche Löschbenachrichtigung, deren Chat noch nicht zugeordnet wurde. Dies unterscheidet sich von `message.missing_on_recheck`, das ein nicht verfügbares Abfrageergebnis protokolliert, sowie von einer Lücke in den gespeicherten Nachrichten-IDs. Kanäle und Supergruppen nummerieren Nachrichten pro Chat und werden auf diese Weise niemals zugeordnet. Wenn die gelöschte Nachricht vom beobachteten Konto gesendet wurde, ist `payload.deleted_message_was_outgoing` wahr; der Löschende wird weiterhin nicht angegeben. Eine Benachrichtigung ohne Geltungsbereich behält ihre eigene Kennzeichnung bei, da sich der passende Chat möglicherweise außerhalb des aktuellen Beobachtungsbereichs befindet oder keine eindeutige Übereinstimmung aufweist. Die erneute Überprüfung auf Fehlen bleibt eine separate Beobachtung gegenüber einer Löschbenachrichtigung in Berichtszahlen, Filtern und Kennzeichnungen. Eine spätere Wiederherstellung hebt den aktuellen Fehlzustand auf, während die frühere erfolglose Überprüfung im signierten Verlauf erhalten bleibt; Löschbenachrichtigungen bleiben ein separater Ereignistyp. Mehrere IDs, die aus einer Benachrichtigung heraus demselben Chat zugeordnet werden, werden als `deletion.batch` zusammengefasst, unabhängig von ihrer Anzahl, wobei die Nachrichten-IDs genau so angegeben werden, wie Telegram sie gesendet hat, und unabhängig davon, wie viele davon dieses Konto gesendet hat. In der Benachrichtigung von Telegram werden die Nachrichten aufgelistet; im Administratorprotokoll des Chats wird der zuständige Administrator genannt, wo das Konto dies nachlesen kann. Die Verknüpfung (`message.deletion_attributed`) wird hergestellt, je nachdem, was zuerst eintrifft: Eine Abfrage, die den Eintrag im Administratorprotokoll vor der Löschbenachrichtigung gesehen hat, wird abgeglichen, sobald die Benachrichtigung erfasst wird. ## Erfassungsumfang: Kontinuität, Lücken und nicht erfasste IDs Jede signierte ZIP-Datei enthält „`coverage.json`“, der HTML-Bericht beginnt mit derselben Zusammenfassung, und „ `verify.py`“ berechnet diese anhand von „`events.jsonl`“ neu, anstatt der Datei zu vertrauen: - **Kontinuierliche Beobachtung von X bis Y.** Ein Zeitraum beginnt mit `observation.started` und endet bei einer Pause, einem Stopp, einer unterbrochenen Telegram-Verbindung, einer Abmeldung, einem Prozessstart ohne ordnungsgemäßen Stopp oder nach mehr als drei Minuten ohne Aufzeichnung während der Beobachtung (Heartbeats werden jede Minute geschrieben, daher bedeutet Stille, dass der Prozess gestoppt wurde, eingefroren ist oder der Computer in den Ruhezustand gewechselt ist). Wenn das Heartbeat-Intervall unter **Weitere Tools → Parameter** geändert wird, wird dies bei jedem Heartbeat protokolliert, und die zulässige Stille beträgt drei Intervalle, jedoch niemals weniger als drei Minuten. - **In der Lückenliste** wird der Zeitraum zwischen den einzelnen Zeitabschnitten mit dem jeweiligen Grund aufgeführt. Eine Lücke, die zum Zeitpunkt des letzten Eintrags noch offen war, wird mit „`not_resumed_by_last_record`“ gekennzeichnet. - **Nachrichten-IDs wurden nicht erfasst.** Bei Kanälen und Supergruppen, die die Nachrichten pro Chat nummerieren, werden die zwischen den erfassten IDs fehlenden IDs als Bereiche aufgeführt. Sie werden als „*nicht erfasst“* gemeldet – gelöscht, nie zugestellt oder außerhalb des gespeicherten Verlaufs – niemals als „gelöscht“. Private Chats und normale Gruppen nutzen eine accountweite Sequenz, daher haben Lücken innerhalb eines solchen Chats keine Bedeutung und werden dort nicht aufgeführt. - Meldungen über Lücken auf Chat-Ebene (beispielsweise wenn Telegram in einem Kanal zur Wiederherstellung von Datenunterschieden auffordert) werden als Notizen gezählt; sie unterbrechen die globale Abdeckung nicht. - **Sitzungsprotokolle.** Sitzungen, in denen der Aktualisierungszähler von Telegram anstieg, obwohl keine Aktualisierung diese Sitzung erreichte (`updates_diverted`), diese Sitzung aus der Sitzungsliste von Telegram entfernt wurde, während die Verbindung weiterhin bestand (`session_revoked_externally`), oder die Antwort einer Witness-Abfrage nur aus dem Verlauf eintraf (`probe_ack_missed_live`), werden separat aufgeführt. Der Verifizierer meldet außerdem, woher der Telegram-Sitzungsschlüssel stammt, welche anderen Sitzungen bei Beginn der Beobachtung angemeldet waren, welche Sitzungen während der Beobachtung hinzugefügt wurden, Telegram-Sicherheitshinweise (777000), welche anderen Sitzungen aus dem Arbeitsbereich beendet wurden, Zeiträume, in denen nur diese eine Sitzung aktiv war, die Anzahl der Witness-Probes sowie Aktualisierungen zu Telefonanrufen. Siehe [Konten](https://phishdestroy.io/tgwitness/de/docs/reference/accounts/#witness-probe). Solange [Strict Chosen Chats](https://phishdestroy.io/tgwitness/de/docs/reference/collection/#strict-chosen-chats) aktiviert ist (`scope.strict` in `observation.started`), werden die Sitzungsliste (außer wenn dies die einzige Sitzung ist oder wenn **Telegram-Geräte** aktiviert ist), Sicherheitshinweise und Anruf-Updates nicht erfasst; ihr Fehlen sagt daher nichts aus, und eine Löschung wird nur dann einer Sitzung nur dann einer Sitzungsprüfung zugeordnet, wenn innerhalb der letzten 10 Minuten zuvor eine Sitzung lief. ### Aktualisierungsreihenfolge (`pts`) Telegram-Nummern: Aktualisierungen zu Nachrichten mit `pts`: eine Sequenz für das Konto (private Chats und einfache Gruppen zusammen) und eine für jeden Kanal oder jede Supergruppe. Der Kollektor zeichnet jeden lückenlos empfangenen Abschnitt als `coverage.sequence` Datensatz: die erste und letzte `pts`, die Anzahl der Aktualisierungen jedes Typs sowie die Angabe, ob sie live gesendet oder von `getDifference` oder `getChannelDifference`. Eine Unterbrechung ist ein `coverage.gap` Datensatz, und `coverage.gap_closed` bezeichnet den `pts` , ab dem die Sequenz wieder vollständig ist. Eine lückenlose Reihe zeigt, dass jedes Telegram-Update, das in dieser Reihenfolge zwischen dem ersten und dem letzten `pts` den Telegram-Client dieses Collectors erreicht hat. Es sagt nichts über Inhalte aus, die Telegram nie an dieses Konto gesendet hat, über die Zeit vor dem ersten aufgezeichneten `pts`oder über Abschnitte, die der Collector nicht notiert hat. Ein `pts` Zeitraum, der von keinem erfassten Zeitraum oder keiner Differenz abgedeckt wird, wird als Lücke dargestellt. `GET /api/continuity` Gibt für ein Intervall (`since`, `until`, `chat_id`), ob jede Folge ununterbrochen ist, und listet die Unterbrechungen mit ihren Gründen auf. `verify.py` gibt dasselbe aus den Datensätzen eines Archivs unter **Folgenkontinuität** aus. ### Fehlende Nachrichtennummern (`gap_summary`) For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). **Vorschau.** `coverage.json` → `gap_summary` misst die von Telegram zugewiesenen Nummern, die dieser Kollektor nie gesehen hat. Telegram nummeriert Nachrichten einmal pro Kanal oder Supergruppe und einmal pro Konto über private Chats, Bots und normale Gruppen hinweg. Eine Nummer zwischen zwei beobachteten Nachrichten ist entweder beobachtet oder fehlt; ein zusammenhängender Bereich ist eine positive Aussage, dass jede darin nummerierte Nachricht beobachtet wurde. Eine Lücke nennt weder einen Akteur noch einen Grund. | Fachgebiet | Bedeutung | | --- | --- | | `status` | `on` oder `off`, wenn unter **Weitere Tools → Parameter → Lückenanalyse** deaktiviert | | `parameters` | Die Parameter, die zu dem Ergebnis geführt haben, damit es reproduziert werden kann | | `chats[]` | Ein Eintrag pro Kanal oder Supergruppe, jeweils eigenständig nummeriert | | `account` | Die kontoweite Abfolge von privaten Chats, Bots und normalen Gruppen | | `status` (pro Sequenz) | `applicable`, oder `not_applicable` mit `reason` | | `observed_from`, `observed_to`, `span` | Erste und letzte beobachtete Nummer sowie die Größe des Bereichs | | `observed`, `observed_without_content` | Beobachtete Nummern; solche, die nur aus einem Lösch- oder Nachprüfungsdatensatz bekannt sind | | `missing`, `density`, `gap_ranges`, `largest_gap` | Nie beobachtete Zahlen, ihr Anteil am Bereich, Anzahl der Durchläufe, der längste Durchlauf | | `clusters[]` | Aufgeführte Lücken: `low`, `high`, `missing`, sowie die benachbarten beobachteten Zahlen `after` / `before` mit ihren Beobachtungszeitpunkten | | `service_estimate` | Nur wenn aktiviert: Wie viele fehlende Nummern wären bei ihrem beobachteten Anteil Servicemeldungen? Wird niemals abgezogen von `missing` | Die Gültigkeit wird aus dem Protokoll abgeleitet und niemals vorausgesetzt: - **Kanäle und Supergruppen** werden pro Chat erfasst, auch beim Export ausgewählter Chats. Die vom Absender ausgewählten Einträge bilden die Grundlage für die Erfassung `not_applicable`. - **Die kontoweite Sequenz** wird nur von der ersten bis zur letzten Nachricht gemessen, die eingegangen ist, während die Erfassung des gesamten Kontos aktiv war, und umfasst private Chats, Bots, normale Gruppen sowie die eigenen Nachrichten des Kontos, wobei kein solcher Chat ausgeschlossen wird (`scope.changed`). Zahlen, die mit `deletion.unscoped` als beobachtet, ohne dass deren Inhalt berücksichtigt wird. Ein Export oder eine Übergabe ausgewählter Chats kann diese nicht erfassen. Wurde die Erfassung des gesamten Kontos aus- und wieder eingeschaltet, weist ein Hinweis darauf hin, dass die in der Zwischenzeit verwendeten Zahlen als Lücken erscheinen. - Servicemeldungen sind Protokolleinträge mit eigenen Nummern, sodass sie Lücken selbst schließen; die optionale Schätzung dient lediglich als Kontext. `verify.py` berechnet neu `gap_summary` aus `events.jsonl` mit den Parametern im signierten `coverage.json` Element (Standardwerte für ältere Archive) und gibt die kontoweite Zeile in der Abdeckungszusammenfassung aus. Das `get_capture_status`(MCP und die Befehlszeile) gibt denselben Messwert für die Chats zurück, die ein Zugriff lesen darf; die kontoweite Sequenz gilt nur für Zugriffe, die den gesamten Arbeitsbereich abdecken. Wiederholte Beobachtungen einer Dienstnachricht zählen nur einmal, und die Schätzung des Kontodienstes verwendet ausschließlich Zahlen innerhalb des gemessenen Bereichs. Ein angewendeter Geltungsbereich muss die eigenen Nachrichten des Kontos explizit beibehalten, bevor eine kontoweite Messung aktiviert wird; die Messung beginnt mit Datensätzen, die diese Informationen enthalten. Der gemessene Bereich umfasst die laufende Beobachtung, und deren Fortsetzung wird vermerkt. Die Abfrage des Live-Archivs verfügt über ein Zeitbudget, einschließlich des Datenbank-Scans, und kennzeichnet eine unvollendete Messung als unvollständig. Telegram dokumentiert die [einzelnen Nachrichten-ID-Sequenzen](https://core.telegram.org/api/updates#message-id-sequences). Diese Nummern beschreiben Beobachtungen; Löschhinweise, erneute Überprüfungen und der Admin-Protokoll-Eintrag erklären, warum eine Nummer fehlt, wo Telegram sie meldet. Wenn Telegram das Konto nicht mehr akzeptiert, enthält der Datensatz `coverage.gap`, der die Überwachung beendet, `cause` (`account_banned`, `account_frozen`, `account_deleted`, `session_duplicated`, `session_revoked`, `session_expired`, `session_ended` oder `not_authorized`) sowie den Fehler Telegram; `verify.py` benennt die Ursache, aus der der Zeitraum endet. Die Abdeckung umfasst aufgezeichnete Beobachtungszeiträume, Unterbrechungen und Nachrichtenergebnisse. Bewerten Sie diese zusammen mit den ausgewählten Chats, dem Zeitraum und den Richtlinien für Anhänge; eine erneute Überprüfung der Ergebnisse und der aufgezeichneten Lücken zeigt, wie vollständig die Aktualisierungen des Kontos beobachtet wurden. ## Produzent Das signierte Manifest der Beweis-ZIP-Dateien, Chat-Exporte, Zeugen-Journale und die Angaben in den Personenprofil-Dateien enthalten `producer`: Software, Version, Projekt (PhishDestroy), Homepage und Quell-Repository. Der HTML-Bericht und der Verifizierer zeigen diesen signierten Producer-Eintrag an. Hashwerte der Quelldateien identifizieren den aufgezeichneten Quellcode-Baum zum Vergleich mit einem vertrauenswürdigen Checkout. Die Herkunft der Ausführung wird separat durch [eine GitHub-Erfassungsbescheinigung](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) oder [Intel-TDX-Messungen](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/) überprüft, sofern diese aktiviert sind. Archive, die erstellt wurden, bevor das producer-Feld existierte, werden weiterhin unterstützt und als Legacy-Datensätze gekennzeichnet. Jeder `observation.started`-Datensatz nennt außerdem den Telegram-Client, der die Beobachtung durchgeführt hat: dessen `api_id` (niemals den Hash), unabhängig davon, ob es sich um ein integriertes öffentliches Schlüsselpaar oder die eigene Anwendung des Betreibers handelt, die in der Verbindungsanfrage von Telegram gesendete Client-Beschreibung sowie die Art der Verbindungsroute mit dem IP-Modus (keine Proxy-Adresse oder Geheimnis). Der Bericht und `custody.json` listen jeden einzelnen Client und jede Route mit dem Zeitpunkt ihrer Aufzeichnung auf sowie die Zeitpunkte, zu denen kein gelisteter Proxy geantwortet hat und Telegram die Adresse des Servers erkannt hat. Dies geht aus zuvor aufgezeichneten Protokollen hervor. ## Personenprofile Eine Profildatei (`tgwitness-dossier-v1`, JSON) wird auf Anfrage aus den bereits im Protokoll vorhandenen Einträgen für einen Chat erstellt; es werden keine Daten von Telegram abgerufen, und Profilinhalt werden niemals in das Protokoll geschrieben (das Aktivieren und Deaktivieren von Profilen wird als `dossier.changed` protokolliert). Für jede Person mit einer gespeicherten Nachricht werden Name und Benutzernamenverlauf sowie Telegram-Kennzeichnungen (Bot, Betrug, Fälschung, Premium, verifiziert, eingeschränkt, gelöscht) – wie zum Zeitpunkt der Speicherung sichtbar – sowie Profil- Foto-IDs, SHA-256- und Perceptual-Hash (pHash, kompatibel mit `imagehash.phash`) des Avatars aus dem lokalen Avatar-Cache mit ähnlichen Avataren, Aktivitäten (erste und letzte Nachricht, Anzahlen, bearbeitete und gelöschte Freigaben, Nachrichten nach UTC-Stunde), wer wem antwortet, andere Chats in diesem Journal, in denen die Person geschrieben hat, sowie erwähnte Wallets (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; Base58Check-Adressen werden anhand der Prüfsumme validiert), Telefonnummern, Benutzernamen und Links, einschließlich hinter Text versteckter Links. Jeder Sachverhalt listet die Protokoll-Einträge (`seq`) auf, aus denen er stammt, und `record_hashes` enthält den Hashwert jedes referenzierten Eintrags. Die Aussage ist mit dem Workspace-Schlüssel signiert: ``` python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip ``` Überprüft die Signatur, verifiziert den Beweisexport selbst (Signatur, Hash-Kette und Dateien) sowie die Tatsache, dass jeder referenzierte Datensatz unverändert in diesem Export desselben Arbeitsbereichs vorhanden ist. Avatar-Hashes werden als aus dem lokalen Cache stammend gekennzeichnet (keine Protokoll-Datensätze). Erwähnungen sind Musterübereinstimmungen und Anhaltspunkte zur Überprüfung. Profile werden pro Chat aktiviert, können als passwortgeschützte AES-256-ZIP-Datei exportiert werden und werden gelöscht, wenn sie deaktiviert werden oder wenn der Chat aus den Quellen entfernt wird. ## Unabhängiger Zeuge Ein Witness-Journal (`tgwitness-witness-v1`) und seine Kanalbeiträge werden anhand eines Beweisexports mit `verify.py --witness … --channel …` überprüft; siehe [unabhängiger Witness](https://phishdestroy.io/tgwitness/de/docs/reference/witness/). Anhand einer öffentlichen Adresse `https://t.me/s/…` oder `https://telegram.me/s/…` liest der Verifizierer das Datum jedes Beitrags aus Telegram aus, und das früheste solche Datum eines Beitrags am Anfang des Exports gilt als externe Zeitangabe für den letzten Datensatz. Daten aus anderen Quellen sind bereitgestellte Metadaten. ## Manifest und Kontrollpunkte manifest.json enthält das Format, den Exportzeitpunkt, den öffentlichen Schlüssel, den Fingerabdruck, die Journal- Länge, den Kopf-Hash, den Geltungsbereich, den Ersteller, Einschränkungen sowie den SHA-256-Hash jedes Inhaltselements außer `manifest.json` und `manifest.sig` selbst. manifest.sig ist die Base64-Signatur nach Ed25519 über das kanonische Manifest-JSON. Der Verifizierer lehnt unerwartete/fehlende Elemente, doppelte Namen, beschädigte Dateien, unterbrochene Sequenzen/Ketten, ungültige Signaturen und Abweichungen von einem angegebenen Checkpoint ab. Er extrahiert niemals Archivpfade. Er begrenzt die insgesamt deklarierte unkomprimierte Größe auf 4 GiB; `--max-gib N` erlaubt größere Archive, die mit einem erhöhten Limit unter **Weitere Tools → Parameter** erstellt wurden. Ein großes Archiv wird von mehreren Prozessen gleichzeitig überprüft: Die Elemente werden parallel gehasht, und nach den ersten 5.000 Datensätzen werden der Inhalts-Hash und die Signatur jedes Datensatzes von Worker-Prozessen überprüft, während der Hauptprozess der Kette, der Abdeckung und den Verknüpfungen der Reihe nach folgt. `--jobs N` legt die Anzahl der Prozesse fest; standardmäßig `auto` verwendet einen pro CPU, maximal 16, und `--jobs 1` wird alles in einem Prozess verarbeitet. Das Ergebnis ist in beiden Fällen dasselbe, und eine Änderung wird mit derselben Meldung abgelehnt. Hashwerte an den durch beibehaltene Checkpoints und Zeitstempel-Anker angegebenen Positionen werden während dieses einzelnen Durchlaufs beibehalten, sodass jeder Anker verglichen wird, ohne das Journal erneut lesen zu müssen. Auf einem Computer mit 32 Threads benötigte ein 10,8-GB-Archiv mit 400.000 Datensätzen 58,9 s in einem Prozess, 15,2 s bei 4 und 8,4 s bei 16; ein Durchlauf über die Datensätze in der richtigen Reihenfolge legt dann die Obergrenze fest. Führen Sie die Verifizierung anhand Ihrer installierten TgWitness-Version oder eines geprüften Checkouts durch. Die im Archiv enthaltene Kopie ermöglicht eine portable Nutzung; vergleichen Sie diese Kopie mit Ihrer vertrauenswürdigen Installation, bevor Sie sie ausführen. Ein Checkpoint signiert eine Erklärung, die den öffentlichen Schlüssel, die Journal-Länge, den Kopf- Hash und den Erstellungszeitpunkt enthält. Er enthält außerdem die neueste DRAND-Runde, die der Arbeitsbereich abgerufen hat (`drand_anchor` ): Der Collector fragt vor jedem periodischen Checkpoint ein DRAND-Relay über die externe Route des Arbeitsbereichs ab, sodass Hide IP, Proxys und eine deaktivierte externe Route zum Tragen kommen und der Checkpoint selbst niemals eine Verbindung nach außen herstellt. Der Prüfer kann überprüfen, ob ein späteres Archiv dasselbe Präfix enthält. Mit `--checkpoint` und `--check-drand` bestätigt er diese Runde bei den Drand-Relays und meldet, dass der Checkpoint nicht früher als zum Zeitpunkt der Runde signiert wurde; die Runde ändert die Sicherheitsstufe nicht. Bewahren Sie den Checkpoint außerhalb des Collectors auf, damit bei einer späteren Verifizierung das Archiv mit einer separat davon geführten Referenz verglichen wird. Der Collector-Schlüssel signiert es, sodass es die Datensätze nur dann an ihn bindet, wenn der Empfänger es vor dem Archiv über einen anderen Kanal erhalten hat; für sich allein erfüllt es nicht die Mindestanforderungen für einen Nachweis. ## Auslesen eines Verifizierungsergebnisses Der Verifizierer meldet die Archivintegrität, die Signaturzuordnung und die Sicherheitsprüfungen getrennt voneinander. Eine gültige Signatur zeigt an, dass sich die Bytes seit dem Signieren nicht verändert haben. Der Betreiber übermittelt dem Empfänger den Schlüssel-Fingerabdruck über einen separaten Kanal. Ohne `--fingerprint`besteht ein intaktes Archiv die Signatur- und Formatprüfungen mit `signer_pinned: false`, und die letzte Zeile beginnt mit `EVIDENCE: minimum not met · missing: confirmed signer key`. Für eine automatisierte Richtlinie zur lokalen Archivierung, die einen festgelegten Unterzeichner und das Minimum an Nachweisen erfordert: ``` python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence ``` Verwenden Sie einen Fingerabdruck, der über den vertrauenswürdigen Kanal des Empfängers aufbewahrt wird. Ein vertrauenswürdiger Zeuge kann den Kollektor auch über ein konsistentes, bezeugtes Journal festpinnen; geben Sie `--witness`, `--witness-fingerprint` und `--require-witness` an. `--strict` beendet die Ausführung mit dem Status 2 bei einem nicht festgepinnten Unterzeichner; eine nicht erfüllte Anforderung `--require-tier` oder `--require evidence` führt ebenfalls zur Beendigung mit Status 2. `--require evidence` erfordert `--fingerprint` und eine externe Zeitangabe eines Drittanbieters, die den letzten Datensatz abdeckt. Lesen Sie `signer_pinned`, `requirements_met` und die Sicherungsergebnisse, nicht nur den Beendigungscode. [Die versiegelte Erfassung](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) verwendet stattdessen ihren Beglaubigungsprüfer und die genehmigte Richtlinie, um den Erfassungs-Digest zu authentifizieren. ## Umfang der Überprüfung Die Verifizierung überprüft das Archiv und den zu seiner Erstellung verwendeten Erfassungsmodus. Wählen Sie den Modus, dessen Vertrauensgrenze dem jeweiligen Fall entspricht, und behalten Sie dessen Verifizierungsdaten bei. | Erfassungsmodus | Was der Verifizierer überprüft | Verifizierungsdaten und Vertrauensgrenze | | --- | --- | --- | | Lokaler Arbeitsbereich | Signaturen, Hash-Kette, Manifest und Anhang-Bytes aufzeichnen | Vom Empfänger gespeicherter Fingerabdruck des Collectors und externe Zeitangabe eines Dritten: verifizierte RFC-3161- oder OpenTimestamps-Belege oder von t.me gelesene Witness-Beiträge. Gespeicherte Checkpoints und Witness-Datensätze dienen der Überprüfung. | | Lokaler Arbeitsbereich mit einem unabhängigen Witness | Die Archivprüfungen sowie die Übereinstimmung mit einem früheren Protokollpräfix, das vom Zeugen beibehalten wurde | Witness-Fingerabdruck und -Einträge; der Schlüsselkontrollnachweis des Verwahrers zeigt, wer den Witness-Schlüssel hält. Mit `--channel https://t.me/s/…` liefern die von Telegram gesetzten Beitragsdaten externe Zeit | | [GitHub Actions-Aufzeichnung](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | GitHub-Bescheinigung des Archiv-Digests, der genehmigten Workflow- und Collector-Commits, des gehosteten Runners, der neuen Sitzungs-/Schlüsselherkunft und der internen Archivintegrität | Richtlinie für vertrauenswürdige Prüfer, Aufrufer-Repository und GitHub-Bescheinigungsbündel; die Datenerfassung läuft im festgesteckten Workflow ab | | [Cloud-Bereitstellung](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/) | Lebenszyklus- und Zugriffsprotokolle des Anbieters, Status von Firewall und Cloudflare sowie das signierte Ausführungsprotokoll des Collectors | Schreibgeschützte Abfragen an den Anbieter und Cloudflare; die Verfügbarkeit einzelner Prüfungen hängt vom Anbieter ab | | [Vertrauliche Intel TDX-VM](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | Signatur und Plattformstatus angeben, Verknüpfung mit der Collector-Anweisung, Kompositions- und Betriebssystemmessungen | Intel-Vertrauenskette und erwartete Messwerte für die Bereitstellung; die Ergebnisse jeder erforderlichen TDX-Prüfung beibehalten | Bei der versiegelten Erfassung erhält der zugelassene Erfasser Daten über eine authentifizierte Telegram-Verbindung innerhalb der verifizierten Umgebung. Die Bescheinigung bindet das Archiv an diese Ausführung, sodass die Verifizierung sowohl die Erfassung als auch die spätere Dateiintegrität abdeckt. Dies beruht auf dem zugelassenen Code und der oben aufgeführten Vertrauenskette der Plattform. Die Überprüfung der GitHub-Erfassung erfordert eine innerhalb der Ausführung erstellte Sitzung und lehnt Erfassungen aus importierten Sitzungen ab. Der Ausführungsbeleg protokolliert die Collector-Version, Datei-Hashes und Starteinstellungen. GitHub-Provenienz und TDX-Messungen dienen der Umgebungsprüfung; der Validierungsdatensatz identifiziert getestete Konfigurationen. ### Woher die Nachrichten stammen Telegram übermittelt Nachrichten an jeden Client, einschließlich der offiziellen Apps, innerhalb einer MTProto-Sitzung. Der Autorisierungsschlüssel der Sitzung wird anhand des festgelegten Server-Schlüssels von Telegram ausgehandelt, und jede Aktualisierung wird verschlüsselt und auf Integrität geprüft unter Verwendung dieses Schlüssels übermittelt. Der Collector empfängt Nachrichten über die authentifizierte Sitzung des Kontos und trägt jede Beobachtung bei ihrem Eintreffen in das Journal ein, zusammen mit den Identifikatoren für den Chat, die Nachricht und den Absender sowie dem Datum, das Telegram jeder Nachricht zugewiesen hat. In GitHub Actions-Erfassung und bei Intel TDX-Bereitstellungen bindet die Bescheinigung zudem diese Sitzung und den Signaturschlüssel an die genehmigte Ausführung des Collectors. Das Journal protokolliert, woher der Autorisierungsschlüssel stammt. Bei der Anmeldung per Telefon oder QR-Code oder bei einer unabhängigen Anmeldung aus einer Sitzungsdatei wird `account.authorized` mit `key_origin: "created"` geschrieben; bei der Erfassung anhand eines importierten `.session`-, TData- oder JSON-Schlüssels wird `imported` geschrieben. Ein importierter Schlüssel existiert ebenfalls, unabhängig davon, woher er stammt. Beglaubigte Bereitstellungen lehnen importierte Schlüssel ab. Die Herkunft eines Datensatzes in Telegram beruht auf der authentifizierten Verbindung des Kontos, den Verbindungs- und Erfassungsdatensätzen im Journal, den erfassten MTProto-Frames, die den Journal-Einträgen zugeordnet sind ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics)), dem Telegram-Datum jeder Nachricht sowie – bei beglaubigter Erfassung – der verifizierten Ausführungsumgebung. Archivsignaturen bewahren diesen Datensatz für spätere Überprüfungen auf. Gespeicherte Checkpoints legen frühere Journalgrenzen fest, Erfassungsdatensätze zeigen die Ergebnisse der Erfassung an, und verifizierte externe Zeitstempel ordnen die festgeschriebenen Bytes zeitlich ein. Für einen lokalen Arbeitsbereich stellt der Empfänger vertrauenswürdige Collector- oder Witness-Eingaben bereit. Bei der versiegelten Erfassung binden die vertrauenswürdige Richtlinie und die Bescheinigung den Archiv-Digest an die genehmigte Collector-Ausführung. Es handelt sich um unterschiedliche Verifizierungspfade; melden Sie die für den ausgewählten Pfad abgeschlossenen Prüfungen. ## Anhänge Dateien werden unter „media/“ anhand ihres SHA-256-Hashs adressiert. Ein „media.saved“-Ereignis verknüpft einen Hash und die Byte-Länge mit einem bestimmten Nachrichtenereignis. Die ursprünglichen Dateinamen dienen als Metadaten, niemals lokale Pfade. Mediendaten werden asynchron heruntergeladen, sodass eine sofortige Löschung die Erfassung verhindern kann. Deaktivierte Erfassung, übergroße Dateien oder Dateien mit unbekannter Größe, Download-Fehler sowie unterbrochene Downloads werden als Ergebnisse angezeigt. Ein Prozessabsturz kann nicht referenzierte Teil-Dateien hinterlassen; diese werden nicht in die Exporte einbezogen. Der ZIP-Exporter gleicht gespeicherte Medien anhand ihrer Namen ab. JSONL-, CSV- und HTML-Exporte überprüfen Ereignissignaturen, enthalten jedoch keine Medienbytes. Abgeleitete Berichte dienen der Benutzerfreundlichkeit; „events.jsonl“ ist die maßgebliche Darstellung der Ereignisse. Bei einem vollständigen Chat-Export werden Anhänge gemäß den Anhangseinstellungen des Arbeitsbereichs im Ordner „media/“ gespeichert und mit dem Namen „SHA-256“ versehen. Jeder Nachrichteneintrag in chat.json benennt seine Datei (`file`, `file_sha256`) oder den Grund für deren Fehlen (`file_status`), zusammen mit dem, was der Leser um den Text herum gesehen hat: Links hinter dem Text, Weiterleitungsquelle, Bot-Schaltflächen, Signatur, Aufrufe und den Timer für die automatische Löschung. `verify.py` überprüft, ob sich jede benannte Datei im signierten Manifest unter diesem Hash befindet. ## Dauerhafte Erfassung und Verarbeitung von Belegen (0,2) Ein Medienauftrag und die damit verbundene Nachrichtenereignis-Festschreibung erfolgen in einer Transaktion. Der Auftrag speichert den ursprünglichen TL-Nachrichtenbeschreiber; die signierte Beobachtung bindet deren SHA-256-Hash, das Konto sowie die Größenrichtlinie. Die Wiederherstellung überprüft diese Bindung vor dem Herunterladen. Es wird niemals die aktuelle Nachricht abgerufen, und ein neuerer Anhang wird stillschweigend ersetzt. Unterbrochene Aufträge werden erneut versucht, während ein dauerhafter Fehler ein explizites Ergebnis bleibt. Jeder Arbeitsbereich verfügt über ein eigenes Protokoll und eine eigene Signaturidentität. Ein process.started-Ereignis enthält eine Lauf-ID, lokale Uhrzeiten, Versionen von Abhängigkeiten, Hashes der Quelldateien, das anfängliche Konto/den anfänglichen Geltungsbereich sowie die Erfassungseinstellungen. Heartbeats enthalten die Lauf-ID, die monotone Zeit und den Status der Warteschlange. Der Ausführungsbeleg kann auch als separat signierte Erklärung heruntergeladen werden. Zur Verifizierung der Ausführungsumgebung kombinieren Sie ihn mit der GitHub-Bescheinigung oder den TDX-Prüfungen, die in [Verification scope](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#verification-scope) beschrieben sind. Automatische Checkpoints werden lokal beim Start, alle fünf Minuten während der Beobachtung (**Weitere Tools → Parameter → Signierter Checkpoint alle**) sowie beim ordnungsgemäßen Beenden gespeichert. Bei der Startüberprüfung und beim Export wird das Journal mit dem zuletzt gespeicherten lokalen Checkpoint verglichen. Dadurch kann ein Datenbank-Rollback erkannt werden, sofern der Checkpoint erhalten bleibt. Durch die unabhängige Speicherung bleibt diese Referenz außerhalb des Arbeitsbereichs verfügbar; ein verifizierter externer Zeitstempel verankert sie zusätzlich zeitlich. Nach einem Neustart wird die gespeicherte Telegram-Aktualisierungsposition fortgesetzt (`catch_up_from` in `observation.started`) und versäumte Aktualisierungen werden angefordert. Die gespeicherte Position umfasst nur Aktualisierungen, deren Verarbeitung abgeschlossen ist; daher werden Aktualisierungen, die zum Zeitpunkt des Verbindungsabbruchs oder des Prozessabbruchs noch ausstehend waren, erneut angefordert. Eine regelmäßige Überprüfung erfasst `message.recovered` auf verpasste Nachrichten und `message.missing_on_recheck` wenn Telegram eine gespeicherte Nachricht nicht mehr zurückgibt; Letzteres ist keine Löschmitteilung und nennt weder einen Löschenden noch einen Zeitpunkt. ### Externe Sicherung und Wiederherstellung (S3) Die externe Kopie (**Einstellungen → Benachrichtigungen und externe Kopie → Externe Kopie** oder **Weitere Tools → Extras → Nachweise & Backups**; standardmäßig deaktiviert) lädt Journalsegmente, gesicherte Dateien, Checkpoints mit ihren Zeitstempeln und abgeschlossene Chat-Exporte in einen S3-kompatiblen Speicher hoch, verschlüsselt mit AES-256-GCM vor dem Hochladen unter Verwendung eines im Workspace-Tresor gespeicherten Schlüssels; die Aufbewahrung mit Object Lock gilt, sofern der Bucket dies unterstützt. Ohne den heruntergeladenen Schlüssel kann die Kopie nicht gelesen werden. Wiederherstellung und Überprüfung mit `python -m tgwitness.replica restore --key-file KEY.json --out DIR`. Die Wiederherstellung erfordert ein leeres Standardverzeichnis. Downloads und entschlüsselte Objekte verbleiben im privaten Zwischenspeicher, bis das gesamte Protokoll und jeder aufbewahrte Prüfpunkt verifiziert sind. Unsichere Objektpfade, inkonsistente Segmentbereiche und Protokolle, die kürzer als ein Prüfpunkt sind, werden abgelehnt; bei fehlgeschlagener Verifizierung werden keine wiederhergestellten Dateien veröffentlicht. Bei Aufbewahrungsprüfungen werden der zurückgegebene „Object Lock“-Modus und das Datum mit der beim Upload übermittelten Frist verglichen (mit einer Rundungstoleranz von einer Sekunde). Eine abgelaufene, ungültige oder verkürzte Frist gilt nicht als verifiziert. Der Status gibt das Stichprobenobjekt an, dessen Aufbewahrungsstatus für diesen Upload-Durchlauf zurückgelesen wurde. Fehlende oder beschädigte lokale Medien werden als Fehler des Durchlaufs gemeldet, und der Mediencursor bleibt vor diesem stehen, sodass die Datei im nächsten Durchlauf erneut versucht wird; die darauf folgenden Dateien, Checkpoints und Exporte werden weiterhin kopiert. Die Wiederherstellungsprüfung vergleicht alle Verweise auf erhaltene Medien mit entschlüsselten Hashes und aufgezeichneten Größen. Identische, sich überschneidende Protokollsegmente aus unterbrochenen Uploads werden dedupliziert; widersprüchliche Überschneidungen werden verworfen. Während eines Uploads erstellte Kontrollpunkte werden zurückgestellt, bis die von ihnen abgedeckten Protokolleinträge kopiert wurden, sodass ein abgeschlossener Durchlauf keinen Kontrollpunkt vor seinem Protokoll veröffentlicht. ### Streaming-Export-Momentaufnahmen Streaming-Exporte verwenden einen stabilen SQLite-Lese-Snapshot. Dessen Anfang kann älter sein als das aktuelle Live-Protokoll, wenn der Download abgeschlossen ist. Ein nach diesem Snapshot erstellter Checkpoint kann korrekt melden, dass das Archiv kürzer ist; vergleichen Sie dies mit einem Checkpoint am oder vor dem exportierten Präfix, nicht mit einem beliebigen späteren Checkpoint. ## Vorbereitung gemäß RFC 3161 und Überprüfung der Antworten (0.2) Im „Evidence“-Modus wird lediglich der SHA-256-Hash jedes signierten Checkpoints an die aufgeführten RFC 3161- Zertifizierungsstellen und OpenTimestamps-Kalender gesendet – und zwar über die Workspace-Route und niemals über MTProxy. Zeitstempel sind standardmäßig in jedem Einrichtungsziel aktiviert; **die Nachweise für einen Fall** erfassen auch drand. Die Antworten werden gespeichert in `checkpoints/anchors/`, exportiert als `.tsr` und `.ots` Dateien unter `anchors/`, und von `verify.py` (`--tsa-ca` überprüft die TSA-Signatur; bestätigt OpenTimestamps-Nachweise mit `ots upgrade` und `ots verify`). Eine RFC-3161-Autorität, die zweimal hintereinander fehlschlägt, wartet vor dem nächsten Versuch: ein Intervall, dann zwei, vier und so weiter bis zu sechs Stunden oder so lange, wie es ihr `Retry-After` vorschreibt, bis zu einem Tag. Ein Durchlauf, der nur wartende Autoritäten findet, schreibt keinen Datensatz; andernfalls listet `anchor.completed` sie unter `deferred` mit `retry_at` auf. Bis sie wieder antworten, zeigt das Panel Zeitstempel als **Degraded** an. Das Panel erstellt ein Anforderungsarchiv, das kanonische checkpoint.json-Bytes, einen SHA-256-Nachrichtenabdruck und einen zufälligen Nonce in timestamp.tsq, Prüfsummen sowie Anweisungen enthält. Es wird keine Netzwerkanfrage gestellt; das Token, das die Instanz für diese Anfrage zurückgibt, ist der Zeitstempel. `python -m tgwitness.anchor verify` prüft die Antwort ohne OpenSSL gegen die Checkpoint-Bytes und die ursprüngliche Anfrage. Eine vertrauenswürdige CA-Datei muss ausdrücklich angegeben werden; enthaltene Zertifikate gelten nicht automatisch als vertrauenswürdig. Die Prüfung der Anfrage ist in der CLI optional; bewahren Sie die Anfrage daher auf und übergeben Sie --request, um die Nonce zu prüfen. Das Ergebnis gibt an, ob sie geprüft wurde. Die Checkpoint-Signatur des Collectors und das Journal müssen weiterhin separat mit dem vertrauenswürdigen Collector-Fingerabdruck geprüft werden. Die Verifizierung überprüft die Signatur der Antwort, die Checkpoint-Bytes und, sofern vorhanden, die ursprüngliche Anfrage unter der angegebenen CA-Vertrauensbasis. Für Zeitstempel, die im Evidenzmodus erfasst wurden, überprüft `verify.py` außerdem die gespeicherten OCSP- oder CRL-Evidenzdaten ([Sperrung von Signaturzertifikaten](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/#signing-certificate-revocation)). Siehe das [Verfahren](https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/) und [die Validierungsergebnisse](https://phishdestroy.io/tgwitness/de/docs/reference/verification/). ## Optionale Datensätze im Beweismodus: „drand“- und „Telegram“-Geräte Zwei weitere Aufzeichnungen können parallel zu den Zeitstempeln laufen. Beide sind nur wirksam, solange der Evidenzmodus aktiviert ist. **Beweismittel für einen Fall** Aktiviert „drand“; andernfalls starten beide. Tauschen Sie sie aus unter „Weitere Werkzeuge“ → „Extras“ → „Nachweise & Sicherungen“ → **Weitere Zeugen · optional**, oder `"drand": true` und `"devices": true` in `POST /api/evidence`. Ein Fehler verhindert weder den anderen noch die Zeitstempel; das Fenster zeigt unter dem Formular jeweils das aktuellste Ergebnis an. **drand** (`beacon.drand` ). Bei jedem Durchlauf wird die neueste Runde von drand quicknet, die öffentliche Zufallszahl der League of Entropy (eine Runde alle 3 Sekunden), in das Journal geschrieben: `chain` , `round` , `randomness` , `signature` , `round_time` und das `relay` , das geantwortet hat. Eine verifizierte unvorhersehbare Runde liefert eine untere Zeitreferenz für das nachfolgende, per Hash verknüpfte Material. Ein verifizierter Zeitstempel an einem späteren Checkpoint liefert einen oberen Zeitbezug. Diese Prüfungen begrenzen das verknüpfte Material. Der Collector fragt zuerst `drand.cloudflare.com` ab, dann die Relays von Protocol Labs über die Workspace-Route, mit einer Anfrage pro Durchlauf. `verify.py` prüft, ob jede Zufallszahl das SHA-256 ihrer Signatur ist und ob die Rundenzeit stimmt, und meldet die Runden, die längste Zeitspanne ohne eine Runde sowie den Rückstand der Uhr des Collectors gegenüber drand. `--check-drand` vergleicht die Runden mit einem Cloudflare-Relay und einem Protocol Labs-Relay, entweder mit allen oder mit einer zufälligen Stichprobe von 100 aus einem langen Protokoll; eine Runde, die abweicht, führt zum Fehlschlagen der Überprüfung. **, Telegram,** (`account.devices`). Bei jedem Durchlauf werden die Sitzungen des Kontos mit `account.getAuthorizations` gelesen, die Liste Telegram wird unter „Einstellungen“ → „Geräte“ angezeigt und vollständig aufgezeichnet: vollständig, wenn sie sich seit dem letzten Durchlauf geändert hat, mit den Sitzungs-Hashes `added` und `removed`; ansonsten nur deren Anzahl und SHA-256. Gerätemodell, Plattform, App und Version, Erstellungsdatum und letzte Aktivität, Land und Region werden gespeichert; IP-Adressen hingegen nicht, da der Export von Beweismaterial außerhalb Ihrer Kontrolle liegt. Die eigene Sitzung des Collectors ist ständig aktiv, daher zählt nur die Aktivität anderer Sitzungen als Änderung. „`verify.py`“ meldet, wie oft die Liste aufgezeichnet wurde sowie jede neue und beendete Sitzung. Die Liste wird nur gelesen, solange die Beobachtung läuft. Was sie zeigen: drand ordnet die Datensätze nach der öffentlichen Zeit an, und die Geräteliste ist Telegrams Erklärung über den Collector, die wie jeder andere Datensatz vom Collector signiert ist. **Cloudflare Gateway-Protokoll** (`cloudflare.gateway_dns`). Für einen Server, der über das Cloudflare-Gateway ([Gateway-DNS](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)) auflöst, kopiert jeder Durchlauf die seit der letzten Kopie vom Gateway protokollierten Daten: ein Eintrag pro Zeitfenster von maximal drei Stunden mit `from`, `until`, `location_id`, dem `address` des Servers, sofern festgelegt, und dem `queries` als `[at, name, type, rcode, decision, colo]`, auch wenn keine vorhanden waren. Richten Sie dies unter „ **Cloudflare Gateway-Protokoll“ ein:**: Konto, Standort, optionale Adresse und ein schreibgeschütztes Token (Konto Analytics-Lesezugriff; Zero Trust PII-Lesezugriff, um eine Adresse eines gemeinsam genutzten Standorts zu speichern). Das Panel überprüft diese Angaben mit einer Anfrage vor dem Speichern; das Token bleibt verschlüsselt und gelangt niemals in das Protokoll. `verify.py` listet die Fenster, die am häufigsten aufgerufenen Namen und alle Zeiträume auf, für die keine Kopie vorliegt; ein Datensatz, dessen Anzahl nicht mit seinen Abfragen übereinstimmt, schlägt fehl. Ein Fenster, das mehr als eine Seite mit Abfragen in einer einzigen Sekunde enthält, behält diese Seite bei und gibt an, dass der Rest fehlt. Die Kopie ist die Antwort von Cloudflare über den Collector, signiert vom Collector; innerhalb von 24 Stunden kann jeder mit einem schreibgeschützten Token diese mit Cloudflare abgleichen. --- # Telegram · Berichte für Gerichte übersetzen Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/translation/ Welche Datei das Original ist, was mit einer beglaubigten Übersetzung einzureichen ist und welche Begriffe Übersetzer beibehalten. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Welche Datei das Original ist, was mit einer beglaubigten Übersetzung einzureichen ist und welche Begriffe Übersetzer beibehalten. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Beweise und Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) ![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness erstellt Berichte in 25 Sprachen. Die englische Fassung ist das Original. Bei den anderen Sprachen handelt es sich um maschinelle Übersetzungen, von denen einige einer terminologischen Überprüfung unterzogen wurden; sie dienen dem Betreiber als Hilfe beim Lesen des Berichts und sind keine beglaubigten Übersetzungen. ## Was ist einzureichen? Reichen Sie das englische Original zusammen mit einer beglaubigten oder vereidigten Übersetzung in die Gerichtssprache ein. Ein vereidigter Übersetzer kennt die lokale Fachterminologie und die formalen Anforderungen an Gerichtsdokumente. Wenn die Sprache des Berichts nicht Englisch ist, enthalten die ZIP-Dateien mit den Belegen, Chats und der Übergabe auch das englische Original desselben Berichts: `report.en.html` und `report.en.pdf`, oder `chat.en.html` und `chat.en.pdf` bei einem Chat-Export. Sie sind mit demselben Schlüssel versiegelt und signiert wie der Bericht in der ausgewählten Sprache und werden mit ihrem SHA-256-Hash im signierten Manifest aufgeführt, das sie unter `report.original`. Ein auf Englisch exportierter Bericht ist selbst das Original. Der Bericht in der ausgewählten Sprache öffnet sich mit derselben Empfehlung und verweist auf die englische Datei. Vergleichen Sie vor der Übersetzung das Original mit dem Archiv: ``` python -m tgwitness.verify report.en.html --fingerprint KEY --evidence tgwitness-evidence.zip ``` `README.txt` Jedes Archiv endet mit einem Abschnitt **Für Übersetzer**, in dem die Originaldateien aufgeführt sind und die nachstehenden Begriffe wiederholt werden. Der [Text und das Expertenprotokoll](https://github.com/phishdestroy/TgWitness/blob/main/docs/NARRATIVE.md) enthalten dieselbe Empfehlung. ## Was wörtlich bleibt - Dateinamen, Befehle, Hashwerte, Schlüssel-Fingerabdrücke, Telegram-IDs, Nachrichtennummern und URLs. - Zeiten: UTC gemäß ISO 8601, wie angegeben. Bitte rechnen Sie diese nicht in eine lokale Zeitzone um. - Erfasste Nachrichten: Zitieren Sie diese in der Originalsprache und geben Sie die Übersetzung separat an, gekennzeichnet als Übersetzung. ## Begriffe | Begriff | Bedeutung | Nicht zu übersetzen als | | --- | --- | --- | | Journal | Die vom Collector verwaltete, signierte und mit Hash-Verknüpfungen versehene Folge von Datensätzen | Journal, Journal, Magazin | | Aufzeichnung | Ein signierter Eintrag im Journal; verwende dafür durchgehend ein einziges Wort | Hinweis, Artikel | | Beobachtung | Was der Collector zu einem bestimmten Zeitpunkt erhalten hat | Eine Feststellung zur Richtigkeit des Inhalts | | Collector | Der TgWitness-Prozess, der über das eigene Telegram-Konto des Betreibers beobachtet wurde | Sammlung von Gegenständen | | Datenerhebung | Empfangen und Speichern von Updates aus Telegram | Sammlung, Sammlung, Zusammenstellung | | Löschhinweis | Die Meldung von Telegram, dass eine Nachricht gelöscht wurde; es wird nicht angezeigt, wer sie gelöscht hat | Eine nachweisliche Löschung durch eine namentlich genannte Person | | bei erneuter Überprüfung nicht vorhanden | Telegram zeigte die Nachricht bei erneuter Überprüfung nicht mehr an: gelöscht oder für dieses Konto nicht mehr sichtbar | Gelöscht | | Nummer der fehlenden Nachricht | Eine Nummer ohne Nachricht im Export: wurde zuvor gelöscht oder war für dieses Konto nie sichtbar | Fehlende Nachricht, verlorene Nachricht | | Lücke | Ein Zeitraum ohne Beobachtung | Beweis dafür, dass nichts passiert ist | | frühere Version | Der Text vor der Bearbeitung; beide Versionen werden beibehalten | Korrektur, Fälschung | | Checkpoint | Eine signierte Zusammenfassung der Journal bis zu einer bestimmten Seitenzahl | Checkpoint im physikalischen Sinne | | Zeitstempel-Dienst (TSA) | Ein unabhängiger Zeitstempel-Dienst gemäß RFC 3161 | Behörde, staatliche Stelle, Zertifizierungsstelle | | Quittung mit Zeitstempel | Die Antwort eines Zeitstempel-Dienstes oder eine OpenTimestamps-Quittung, aus der hervorgeht, dass zu einem bestimmten Zeitpunkt ein Checkpoint existierte | Beweise, Nachweis der Tatsachen | | Siegel | Die in einer Berichtsdatei eingebettete Signatur „Ed25519“ | Stempel eines Beamten | | Fingerabdruck des Signaturschlüssels | Der SHA-256-Hash des öffentlichen Schlüssels, der über einen separaten vertrauenswürdigen Kanal ermittelt wurde | Biometrischer Fingerabdruck | | Zeuge | Eine unabhängige Stelle oder ein unabhängiger Dienst, der bzw. der Checkpoints verwaltet oder bestätigt | Eine Person, die vor Gericht aussagt | | Auszug aus dem Übergabeprotokoll | Auszug aus einem für einen Dritten erstellten Journal, in dem die Daten anderer Personen anonymisiert wurden | Vollständiger Export | | minimierter Datensatz | Ein Datensatz, dessen ausgeblendete Felder benannt und durch ihren Hash ersetzt werden | Gelöschter oder geschwärzter Datensatz | --- # Telegram · Unabhängiger Zeuge Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/witness/ Führen Sie „Witness“ mit einem eigenen Schlüssel und Bot aus, veröffentlichen Sie signierte Checkpoints in einem Kanal und vergleichen Sie die Exporte damit. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) Führen Sie „Witness“ mit einem eigenen Schlüssel und Bot aus, veröffentlichen Sie signierte Checkpoints in einem Kanal und vergleichen Sie die Exporte damit. [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Beweise und Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) ![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) [Exportieren und verifizieren](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) · [Hohe Sicherheit](https://phishdestroy.io/tgwitness/de/docs/reference/high-assurance/) · [Anleitung zum Panel](https://phishdestroy.io/tgwitness/de/docs/reference/panel/#extras) Ein Witness speichert signierte Checkpoints getrennt vom Collector. Er überprüft die Signatur des Collectors und die Kontinuität des Journals, signiert das Ergebnis mit seinem eigenen Schlüssel und veröffentlicht es in einem Telegram-Kanal. Führen Sie ihn auf einem separaten Server mit Lesezugriff auf den Witness-Endpunkt des Collectors aus. Das technische Ergebnis umfasst aufbewahrte Journal-Präfixe, Challenge-Antworten, Signaturprüfungen, Merkle-Inklusions-/Konsistenzprüfungen und signierte Kontinuitätsergebnisse. Für einen Witness, den ein anderer Verwahrer betreibt, bewahren Sie Verwahrer und Schlüsselkontrollnachweis mit dessen Fingerabdruck auf. Getrennte Schlüssel und getrennte Verwahrung beschreiben unterschiedliche Teile des Aufbaus. Der Verifier meldet, dass ein zweiter Schlüssel den Journal-Kopf festgehalten hat und bis zu welchem Eintrag; der Schlüsselkontrollnachweis des Verwahrers zeigt, wer diesen Schlüssel hält. Das Witness-Journal ist eine unterstützende Prüfung; das Minimum für Beweise ist Zeit von Dritten. Die Kanalbeiträge fügen externe Zeit hinzu: Telegram datiert jeden öffentlichen Beitrag, und der Verifier liest diese Daten selbst. Ablaufdiagramm · Collector → Zeuge (Signierter Prüfpunkt: Anzahl der Einträge + Head-Hash); Zeuge → Witness-Protokoll, eigener Schlüssel; Zeuge → Telegram-Kanal (Signierter Beitrag über den eigenen Bot); Beweismaterial-ZIP → verify.py; Witness-Protokoll, eigener Schlüssel → verify.py; Telegram-Kanal → verify.py (t.me/s-Seite live lesen oder als Desktop-Export) · Collector · Zeuge · Witness-Protokoll, eigenerSchlüssel · Telegram-Kanal · Beweismaterial-ZIP · verify.py · Signierter Prüfpunkt: Anzahl · der Einträge + Head-Hash · Signierter Beitrag über den · eigenen Bot · t.me/s-Seite live lesen oder · als Desktop-Export **Diagramm als Text** 1. Collector → Zeuge (Signierter Prüfpunkt: Anzahl der Einträge + Head-Hash) 2. Zeuge → Witness-Protokoll, eigener Schlüssel 3. Zeuge → Telegram-Kanal (Signierter Beitrag über den eigenen Bot) 4. Beweismaterial-ZIP → verify.py 5. Witness-Protokoll, eigener Schlüssel → verify.py 6. Telegram-Kanal → verify.py (t.me/s-Seite live lesen oder als Desktop-Export) **Auf dieser Seite** - [Was der Witness festhält](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#what-the-witness-holds) - [Was überprüft und aufgezeichnet wird](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#what-it-checks-and-records) - [Einen Witness ausführen](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#run-a-witness) - [Öffentliche Nachweisseite für mehrere Arbeitsbereiche](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#public-proof-page-for-several-workspaces) - [Überprüfen](https://phishdestroy.io/tgwitness/de/docs/reference/witness/#verify) ## Was der Witness festhält | Der Zeuge hat | Der Zeuge hat niemals | | --- | --- | | Ein schreibgeschütztes **Witness-Token** für einen Arbeitsbereich | Die Telegram-Sitzung oder die API-Zugangsdaten des Erfassers | | Eigener Ed25519-Schlüssel und eigenes Protokoll | Der Speicher des Collectors, der Signaturschlüssel oder das Panel-Token | | Ein eigenes Telegram-Bot-Token | Inhalt der Nachricht: Der Kopf besteht aus einer Datensatzanzahl und einem Hash | Das Token wird unter **Weitere Tools → Extras → Unabhängiger Zeuge** erstellt, einmal angezeigt und ausschließlich als SHA-256 gespeichert. Es öffnet genau einen Endpunkt, `GET /api/witness/head`, der einen frisch signierten Checkpoint sowie signierte, inhaltsfreie Sammelzähler und den Betriebszustand zurückgibt. Es kann weder das Panel öffnen, noch Nachrichteninhalte lesen oder Einstellungen ändern, und das Panel-Token wird dort nicht akzeptiert. Ein Token kann auf derselben Seite widerrufen werden. Der Collector protokolliert, wann ein neuer Witness-Schlüssel mit der Überprüfung beginnt (`witness.seen`), und zeigt die letzte Überprüfung pro Token an; ein Witness, der innerhalb von 2.5-Intervallen keine Überprüfung durchgeführt hat, wird als überfällig markiert. Neue Zeugen senden bei jeder Abfrage eine zufällige Herausforderung; die Erfassungsanweisung gibt diese unter der Signatur des Sammlers wieder. Zähler sind an den genauen Kontrollpunkt gebunden und werden in signierte Zeugenbeiträge aufgenommen. Ältere Kopfzeilen werden vom eigenständigen Zeugen weiterhin akzeptiert. Das Wachstum des Protokolls allein wird niemals als neue Nachricht gezählt. ## Was überprüft und aufgezeichnet wird In jedem Intervall (standardmäßig alle 10 Minuten) führt TgWitness folgende Schritte durch: 1. ruft den Header selbst ab (der Collector kann ihn weder übertragen noch überspringen); 2. Überprüft die Signatur des Collectors, den festgesteckten Collector-Schlüssel (`--collector-fingerprint`, bzw. den zuerst gesehenen Schlüssel), einen nicht abnehmenden Zähler und einen unveränderten Kopf bei einem unveränderten Zähler. Merkle-Inklusions- und Konsistenznachweise überprüfen, ob ein wachsendes Journal den beibehaltenen Checkpoint erweitert. Sobald Kontinuitätsnachweise verwendet wurden, wird deren Entfernung abgelehnt; 3. fügt seinem eigenen Protokoll einen signierten Datensatz hinzu: `witness.anchor` mit dem Status `ok`, `key_changed`, `rollback` (weniger Datensätze als zuvor), `fork` (gleiche Länge, anderer Kopf) oder `invalid` (die Antwort hat die Überprüfung nicht bestanden) oder `witness.no_response`, wenn der Kollektor nicht geantwortet hat; 4. Das Ergebnis wird signiert im Kanal veröffentlicht, einschließlich der Meldung „keine Antwort“, solange TgWitness läuft und die Bot-API erreichen kann. Die Beitrags-ID wird aufgezeichnet (`witness.posted`), ebenso wie ein fehlgeschlagener Beitrag (`witness.post_failed`). Ein Eintrag sieht wie folgt aus; die letzte Zeile enthält die signierte Erklärung: ``` TgWitness witness #42 · journal head Collector 3fa9c2d1e0b4a7f6: 18234 records Head 9b1f…c07e 2026-10-28T19:40:00.123+00:00 TGW1.eyJhdCI6…. ``` ## Ein Witness ausführen Sie benötigen einen Telegram-Bot (erstellen Sie einen mit @BotFather), einen Kanal, in dem dieser Bot als Administrator fungiert, sowie die Adresse des Collectors, die für den Zeugen erreichbar ist – über HTTPS außerhalb eines privaten Netzwerks (siehe das HTTPS-Profil im Abschnitt [„Bereitstellung“](https://phishdestroy.io/tgwitness/de/docs/reference/deployment/)). Öffnen Sie im Panel **Weitere Tools → Extras → Unabhängiger Witness → „Konfigurieren** “. In drei Schritten werden der schreibgeschützte Zugriff, Ihr Kanal und das Intervall festgelegt, anschließend wird der Witness gestartet. Die Veröffentlichungsrichtlinie, ein optionaler HTTP/SOCKS5-Proxy und eine benutzerdefinierte Bot-API-Adresse finden Sie unter **„Erweiterte Einstellungen** “. Das Formular lädt die Datei `witness.json` herunter, in der der Collector-Schlüssel dieses Arbeitsbereichs festgehalten ist. Laden Sie das neu erstellte schreibgeschützte Token mit **„Zugriffsdatei speichern** als“ `witness-token.txt` herunter; legen Sie diese Datei sowie eine auf dem Witness-Host erstellte `bot-token.txt` -Datei neben dieser JSON-Datei ab. Der Collector erhält das Bot-Token niemals. Der Download startet weder einen Dienst noch wird eine Nachricht veröffentlicht. Es wird kein Witness für ein gehostetes Projekt implizit registriert. ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json python -m tgwitness.witness fingerprint --config witness.json ``` Der erste Befehl überprüft Konfigurations- und Geheimdateien ohne Netzwerkanfragen oder Schlüsselerstellung. Pfade in JSON sind relativ zu dieser Datei; CLI-/Umgebungspfade sind relativ zum Arbeitsverzeichnis. Bewahren Sie den Fingerabdruck des Witness außerhalb seines Hosts auf. Der „Last-Poll“-Indikator des Collectors bestätigt lediglich eine Anfrage; die Veröffentlichung wird von Proof gemeldet oder im Witness-Protokoll und im Kanal überprüft. Wenn sich das Panel hinter einem SSH-Tunnel befindet, stellen Sie nur den begrenzten Witness-Endpunkt auf einem separaten HTTPS-Hostnamen gemäß [diesem Caddy-Beispiel](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example) bereit. Der Standard-Arbeitsbereich verwendet dann „`https://witness.example.org`“, andere Arbeitsbereiche verwenden „ `https://witness.example.org/profiles/ID`“. Token sind weiterhin erforderlich; das Panel und seine anderen API-Routen werden von diesem virtuellen Host nicht weitergeleitet. Wählen Sie „`all`“ für regelmäßig veröffentlichte Checkpoints. Ein Fünf-Minuten-Intervall entspricht etwa 288 Einträgen pro Arbeitsbereich pro Tag. „`changes`“ und „`problems`“ lassen bewusst einige Überprüfungen unveröffentlicht. MTProxy ist für den Telegram-Client des Erfassers vorgesehen. Witness-HTTP-Abfragen und die HTTPS-Bot-API von Telegram verwenden ihre eigene direkte/HTTP/SOCKS5-Route ([Bot-API](https://core.telegram.org/bots/api)). **Neben dem Collector, mit Docker** (derselbe Host – unabhängiger Prozess und Schlüssel, jedoch derselbe Betreiber): Geben Sie die Werte in „`.env`“ ein und starten Sie das Profil. ``` TGWITNESS_WITNESS_TOKEN=tgww_... TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC... TGWITNESS_WITNESS_CHANNEL=@your_witness_channel # another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/ docker compose --profile witness up -d docker compose logs witness # prints the witness key fingerprint ``` Verwenden Sie bei der Veröffentlichung eines Bildes den Code `docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d`. **Auf einem fremden Server** (getrennte Verwahrung): Kopieren Sie das Repository dorthin, setzen Sie `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` sowie die drei oben genannten Werte in `.env` und führen Sie anschließend ``` docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d ``` oder ohne Docker: ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel ``` ### Auf Discord veröffentlichen Ein Witness kann Beiträge statt auf Telegram auch in einem Discord-Kanal veröffentlichen. Öffne in Discord **„Kanal bearbeiten“ → „Integrationen“ → „Webhooks“**, erstelle einen Webhook und kopiere dessen URL. Wähle im Bedienfeld in Schritt 2 **„Discord-Webhook · dein Kanal**“ aus. Speichere auf dem Witness-Host die URL als `discord-webhook.txt` neben `witness.json`; sie gelangt niemals zum Collector. ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --discord-webhook-file discord-webhook.txt ``` Ein Witness hat einen Publisher: entweder einen Telegram-Kanal oder einen Discord-Webhook, nicht beides. Beiträge enthalten dieselbe signierte Aussage und können niemanden anpingen. Ein Beitrag, der länger als die von Discord festgelegten 2,000 Zeichen ist, wird durch eine kurze Zeile ersetzt, wobei der vollständige Check als `witness-check.txt` angehängt wird. Jede Beitrags-ID wird als `witness.posted` aufgezeichnet. `verify.py --channel` liest nur Telegram-Kanäle aus; für Discord sollte daher das Witness-Journal geführt werden: Es enthält jeden Check. Discord-Beiträge liefern dem Verifizierer keine externe Zeitangabe. ### Optionen | Option | Umfeld | Standard | Bedeutung | | --- | --- | --- | --- | | `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | Intervalle zwischen den Überprüfungen: 1–1.440 | | `--timeout` | `_TIMEOUT` | 30 | Wartezeit für den Collector und die Bot-API: 5–600 Sekunden | | `--post` | `_POST` | `all` | `all`: alles in Ordnung; `changes`: ein neuer Ansatz oder ein Problem; `problems`: ausschließlich Probleme und fehlende Antworten | | `--title` | `_TITLE` | `TgWitness witness` | Die ersten Wörter jedes Kanalbeitrags | | `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | Speichern Sie den Collector-Schlüssel, anstatt der ersten Antwort zu vertrauen | | `--proxy` | `_PROXY` | direkt | `socks5://host:port` oder `http://host:port` | | `--bot-api` | `_BOT_API` | `https://api.telegram.org` | Adresse der Bot-API, z. B. eines lokalen Bot-API-Servers | | `--data-dir` | `_DATA` | `witness-data` | Witness-Schlüssel und Protokoll | | `--config` | `_CONFIG` | – | JSON-Datei mit einer der oben genannten Optionen | Die Collector-Adresse, die Tokens und der Kanal stammen von `--collector`, `--token` oder `--token-file`, `--bot-token` oder `--bot-token-file`, `--discord-webhook-file` und `--channel`, oder `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` und `_CHANNEL`, wodurch Geheimnisse aus der Prozessliste ferngehalten werden. Eine Konfigurationsdatei verwendet Optionsnamen mit Unterstrichen sowie „`texts`“, wodurch die Wörter der Kanalbeiträge ersetzt werden: ``` {"collector": "https://your-collector.example.org", "token_file": "witness-token.txt", "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel", "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness", "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}} ``` `texts`-Schlüssel: `ok`, `key_changed`, `rollback`, `fork`, `invalid`, `no_response`, `collector`, `records`, `head`. Die Befehlszeile hat Vorrang vor der Umgebung, die Umgebung vor der Datei. Unbekannte Optionen oder Text-Schlüssel stoppen den Zeugen mit einer Meldung, anstatt ignoriert zu werden. Der Wortlaut hat keinerlei Einfluss auf die Verifizierung: verify.py überprüft das signierte Token am Ende jedes Beitrags. Bei `--post changes` oder `problems` befinden sich nicht gepostete Prüfungen weiterhin im Witness-Journal, und `verify.py` listet sie als nie gepostet auf; der Startdatensatz benennt die Richtlinie. Jede Prüfung erscheint weiterhin im Journal, sodass weniger Beiträge bedeuten, dass weniger Einträge von Telegram datiert werden, nicht jedoch, dass weniger Prüfungen vorhanden sind. Auch ohne Kanal führt „Witness“ weiterhin sein Protokoll. Bewahren Sie den Fingerabdruck des „Witness“-Schlüssels (`python -m tgwitness.witness fingerprint`) an einem anderen Ort auf. ## Öffentliche Proof-Seite für mehrere Arbeitsbereiche `python -m tgwitness.proof` TgWitness unterstützt bis zu 32 Arbeitsbereiche gleichzeitig und stellt eine schreibgeschützte Seite mit der neuesten signierten Überprüfung jedes einzelnen bereit. Jeder Arbeitsbereich erhält einen eigenen Witness-Schlüssel und ein Journal im Datenordner sowie einen angehefteten Collector-Schlüssel; das Posten in einem Telegram-Kanal ist pro Arbeitsbereich optional. Beginnen Sie mit [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example): | Fachgebiet | Bedeutung | | --- | --- | | `title` | Seitentitel, 1–100 Zeichen | | `data_dir` | Witness-Schlüssel und -Journale, bezogen auf die Datei; Standard `proof-data` | | `interval`, `timeout` | Minuten zwischen den Überprüfungen (1–1440, Standardwert 5); Sekunden Wartezeit (5–600, Standardwert 20) | | `workspaces[].id`, `label` | Kurzer Alias in Kleinbuchstaben und der angezeigte Name | | `workspaces[].collector` | Adresse des Collectors; andere Arbeitsbereiche enden auf `/profiles/` | | `workspaces[].collector_fingerprint` | Erforderlich, für jeden Arbeitsbereich unterschiedlich | | `workspaces[].token_file` | Datei mit dem schreibgeschützten Witness-Token dieses Arbeitsbereichs | | `workspaces[].channel`, `bot_token_file` | Optional, beides zusammen: Jede Überprüfung in einem Kanal veröffentlichen | | `workspaces[].proxy`, `bot_api` | Optionale Route und Bot-API-Adresse | ``` python -m tgwitness.proof --config proof.json --check-config python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790 ``` Der erste Befehl überprüft die Datei und die Token-Dateien, ohne eine Verbindung herzustellen. Die Seite beantwortet nur GET- und HEAD-Anfragen: - `/` Zeigt alle Arbeitsbereiche an; ein Arbeitsbereich, der seit 2,5 Intervallen nicht überprüft wurde, wird als veraltet markiert. - `/api/proof` Liefert dasselbe Ergebnis wie JSON. - `/api/proof/` Lädt die neueste signierte Erklärung herunter (`tgwitness-public-proof-v1`): Witness-Aufzeichnungsnummer und Hash, Status, angehefteter Collector-Schlüssel, Checkpoint, Erfassungszähler sowie die Angabe, ob der Kanalbeitrag erfolgreich war, signiert mit dem Witness-Schlüssel dieses Arbeitsbereichs. - `/healthz` Gibt den Status 503 zurück, wenn der Monitor eines Arbeitsbereichs gestoppt wurde. Weisen Sie der Seite einen eigenen Hostnamen zu, wie z. B. [„Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example)“. Zur Überprüfung exportieren Sie das Witness-Journal eines Arbeitsbereichs mit `python -m tgwitness.witness export --data-dir proof-data/ --out witness.zip` und verwenden Sie es wie unten beschrieben. ## Überprüfen Auf der Seite des Zeugen: Exportieren Sie das Protokoll: ``` python -m tgwitness.witness export --out witness.zip # Docker (add -f deploy/compose/compose.witness.yaml on a witness server): docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip docker compose cp witness:/witness/witness.zip . ``` Anschließend kann man an beliebiger Stelle mit der signierten ZIP-Datei des Collectors und der Adresse des öffentlichen Kanals: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel ``` `--channel` akzeptiert auch einen Telegram-Desktop-Export (*Chat-Verlauf exportieren* → JSON ergibt `result.json`) oder eine gespeicherte Kopie der Seite; diese überprüfen den Inhalt des Beitrags, liefern jedoch keine externe Zeitangabe. `verify.py` überprüft das Zeugen-Journal (Kette und Signaturen) und anschließend, ob **jeder Head, den der Zeuge gesehen hat, Teil des exportierten Journals ist**: Der Datensatz an dieser Stelle muss genau diesen Hash aufweisen. Ein Head, der nicht übereinstimmt, führt zum Fehlschlagen der Überprüfung – das Journal wurde geändert, nachdem der Witness es gesehen hat. Es werden außerdem Heads gemeldet, die nach dem Export gesehen wurden, vom Witness aufgezeichnete Anomalien, fehlgeschlagene Antworten, Zeiträume, deren übereinstimmende Checkpoints in diesem Export vorhanden sind („Witnessed from X to Y“) sowie Lücken. Spätere Checkpoints verlängern diese Zeiträume nicht. Das Ergebnis enthält die Nummer des zuletzt übereinstimmenden Datensatzes und die Anzahl der nachfolgenden Datensätze ohne übereinstimmenden Checkpoint. Es zählen nur Antworten, die mit dem eigenen Schlüssel des Exports signiert wurden: Ein Export, der mit einem Schlüssel signiert wurde, den der Zeuge nie gesehen hat, wird als nicht bezeugt gemeldet, und ohne `--fingerprint` bleibt sein Unterzeichner ungebunden. Mit `--channel` muss jeder signierte Beitrag Datensatz für Datensatz mit dem Zeugen-Journal übereinstimmen : Geänderte Beiträge bestehen die Überprüfung nicht, fehlende Beiträge werden aufgelistet. Die Übereinstimmung des Tokens authentifiziert den Inhalt; das Datum liegt außerhalb des signierten Tokens. Mit einer Live-Adresse `https://t.me/s/…` oder `https://telegram.me/s/…` liest der Prüfer das Datum jedes Beitrags zum Zeitpunkt der Überprüfung von der Seite ab. Telegram legt dieses Datum fest; Daten von bearbeiteten Beiträgen werden nicht verwendet. Das früheste solche Datum eines Beitrags am Exportanfang ist die externe Zeit des letzten Datensatzes, der diese Mindestbedingung für den Nachweis erfüllt. Daten aus anderen Quellen, wie beispielsweise einer bereitgestellten `result.json`-Datei, einer gespeicherten Seite oder einer anderen Webadresse, sind bereitgestellte Metadaten, keine unabhängige Zeitangabe; das Ergebnis gibt an, woher die Beitragsdaten stammen (`post_date_verification`). ### Eine beglaubigte Exportgrenze ist erforderlich Für eine Übergabe, die eine beglaubigte Abschlussaufzeichnung enthalten muss, fügen Sie bitte „`--require-witness`“ hinzu: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness ``` Dies erfordert den unabhängig gespeicherten Fingerabdruck des Zeugen, einen anderen Schlüssel als den Collector-Schlüssel und einen passenden Checkpoint genau am Ende dieses Exports. Ein Checkpoint, der nur ein früheres Präfix abdeckt, ist unzureichend. Unterbrechen Sie die Erfassung, lassen Sie den Zeugen den Endzustand beobachten und exportieren Sie, bevor weitere Einträge in das Journal geschrieben werden; sollte sich das Journal ändern, speichern Sie einen weiteren Checkpoint und exportieren Sie diesen Zustand. Ein späterer Checkpoint allein kann den endgültigen Hash eines kürzeren Exports nicht verifizieren. Wenn zusätzlich `--channel` angegeben wird, führen fehlende beanspruchte Beiträge oder eine leere Übereinstimmungsmenge zum Scheitern dieser strengen Prüfung. Ohne das Flag melden gewöhnliche Integritätsprüfungen weiterhin nicht bezeugte Datensätze, ohne ein ansonsten intaktes Archiv zurückzuweisen. Das Witness-Journal und den darin festgehaltenen Schlüssel getrennt aufbewahren. Online-Prüfungen verifizieren die Kontinuität zwischen den Kontrollpunkten; die Offline-Verifizierung vergleicht jeden gespeicherten Kontrollpunkt mit dem Export. Ältere Heads ohne Kontinuitätsnachweise behalten den Offline-Vergleich bei und werden ohne Online-Kontinuitätsprüfung gemeldet. Der Bericht listet die Ausfallzeiten der Witnesses und fehlgeschlagene Veröffentlichungen nach Zeitintervallen auf. ### Tägliche Siegel und nicht verfügbare Zeitstempelkalender Der Witness versiegelt die Journalgrenze des vorangegangenen UTC-Tages und übermittelt den Hash dieses signierten Siegels an OpenTimestamps. Eine Kalenderübermittlung ist ein ausstehender Nachweis; nur unabhängig überprüfte Bitcoin-Commitments erhalten eine Bestätigung im Verifier. Wenn alle Kalender fehlschlagen, verbleiben das signierte Siegel und der erfolglose Versuch im Protokoll. Der stündliche Wartungsdurchlauf versucht diesen ursprünglichen Datensatz erneut, auch nach einem Neustart oder einer Datumsänderung. Er scannt höchstens 32-Siegel, übermittelt höchstens zwei fehlende Einreichungen und benötigt höchstens 60 Sekunden für Wiederholungsversuche pro Durchlauf. Ein persistenter Cursor durchläuft nacheinander ältere Siegel. Beibehaltene Einreichungen folgen dem bestehenden Proof-Upgrade-Pfad. Ein erneuter Versuch überschreibt das Siegel nicht, ändert weder dessen ursprüngliches Datum noch behauptet er, dass der Kalender es früher empfangen habe. Eine spätere Bitcoin-Bestätigung bleibt eine spätere externe Bestätigung. Fehlende Nachweise bleiben `none`; ausstehende Nachweise bleiben `pending`, bis der Prüfer sie unabhängig überprüft. --- # Telegram · Zeitstempel Canonical page: https://phishdestroy.io/tgwitness/de/docs/reference/timestamp/ RFC 3161-Zeitstempel für signierte Checkpoints: Was wird an die Behörde gesendet und wie wird eine Antwort verifiziert? [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/de/llms.txt) RFC 3161-Zeitstempel für signierte Checkpoints: Was wird an die Behörde gesendet und wie wird eine Antwort verifiziert? [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Beweise und Verifizierung](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/) ![Beweise & Verifizierung](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness erstellt RFC-3161-Anfragen und überprüft die Antworten des Zeitstempeldienstes (TSA). Bei diesem manuellen Verfahren wird weder eine TSA ausgewählt noch werden Daten übermittelt; der Beweismodus erledigt beides nach einem Zeitplan ([Beweisformat](https://phishdestroy.io/tgwitness/de/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)). Eine vorbereitete Anfrage stellt **noch keinen Zeitstempel-Nachweis** dar. ## Was die Beweise belegen Ablaufdiagramm · Beobachtungen zu Konten → SHA-256-Kette und Ed25519-Signaturen; SHA-256-Kette und Ed25519-Signaturen → Signierter Kontrollpunkt; Signierter Kontrollpunkt → Exakter Byte-Hash und zufälliger Nonce; Exakter Byte-Hash und zufälliger Nonce → RFC 3161-Anfrage; RFC 3161-Anfrage → Unabhängige TSA; Unabhängige TSA → Signierte Antwort der TSA; Signierter Kontrollpunkt → Daten, Nonce und explizite CA-Vertrauenswürdigkeit überprüfen; Signierte Antwort der TSA → Daten, Nonce und explizite CA-Vertrauenswürdigkeit überprüfen · Beobachtungen zuKonten · SHA-256-Kette undEd25519-Signaturen · SignierterKontrollpunkt · Exakter Byte-Hash undzufälliger Nonce · RFC 3161-Anfrage · Unabhängige TSA · Signierte Antwort derTSA · Daten, Nonce undexpliziteCA-Vertrauenswürdigkeit überprüfen **Diagramm als Text** 1. Beobachtungen zu Konten → SHA-256-Kette und Ed25519-Signaturen 2. SHA-256-Kette und Ed25519-Signaturen → Signierter Kontrollpunkt 3. Signierter Kontrollpunkt → Exakter Byte-Hash und zufälliger Nonce 4. Exakter Byte-Hash und zufälliger Nonce → RFC 3161-Anfrage 5. RFC 3161-Anfrage → Unabhängige TSA 6. Unabhängige TSA → Signierte Antwort der TSA 7. Signierter Kontrollpunkt → Daten, Nonce und explizite CA-Vertrauenswürdigkeit überprüfen 8. Signierte Antwort der TSA → Daten, Nonce und explizite CA-Vertrauenswürdigkeit überprüfen Die Signatur des Collectors bindet Datensätze an seinen Schlüssel. Eine vertrauenswürdige TSA-Antwort kann nachweisen, dass ein bestimmter Checkpoint zum von der TSA angegebenen Zeitpunkt existierte. Der Checkpoint kann dann das Journalpräfix binden. Diese obere Zeitgrenze gilt für dieses festgeschriebenen Präfix; einzelne Telegram-Aktionen behalten ihre aufgezeichneten Ereigniszeiten bei. ## Vorgehensweise Der Journal-Verifizierer meldet Rückschritte und nicht analysierbare `observed_at`-Werte in `chronology`, sofern vorhanden, und fügt seiner Befehlsausgabe eine Warnung hinzu. Er behält die signierten Zeitstempel bei und überprüft weiterhin deren Signaturen. Ein Rückschritt kann durch eine Uhrenkorrektur verursacht werden; überprüfen Sie dies daher anhand der Uhrenaufzeichnungen des Hosts. Unabhängige Zeitangaben stammen aus verifizierten externen Zeitstempeln, aus Witness-Beiträgen, die von ihrer öffentlichen t.me-Seite gelesen werden, sowie aus drand-Runden; `--strict` regelt das Signer-Pinning und die unterstützten Formate. Aufgezeichnete DRAND-Werte werden offline auf strukturelle und Hash-Inkonsistenzen überprüft. `--check-drand` vergleicht ausgewählte aufgezeichnete Runden mit HTTPS-Relay-Antworten; das Ergebnis gibt an, wie viele Runden verglichen wurden und welche Relays geantwortet haben, und die verglichenen Runden liefern die authentifizierte untere Zeitgrenze. 1. Bewahren Sie den Fingerabdruck des Collector-Schlüssels über einen separaten vertrauenswürdigen Kanal auf; er identifiziert den Collector unabhängig von der untersuchten ZIP-Datei. 2. Laden Sie unter **„Exporte“ → „Zeitstempelanfrage vorbereiten“** die ZIP-Datei mit der Anfrage für den ausgewählten Arbeitsbereich herunter. Entpacken Sie die Dateien „`checkpoint.json`“, „`timestamp.tsq`“, „`SHA256SUMS`“ und „`README.txt`“. Ändern Sie die Checkpoint-Bytes nicht. 3. Wählen Sie ein für die Untersuchung geeignetes TSA aus. Senden Sie „`timestamp.tsq`“ gemäß der dokumentierten Methode, zusammen mit „`application/timestamp-query`“ für einen HTTP-Dienst. Speichern Sie die ursprüngliche binäre Antwort als „`timestamp.tsr`“ sowie den Endpunkt, den Abrufzeitpunkt und das Ergebnis der Anfrage. Die Anfrage enthält einen Hash und einen Nonce anstelle von Nachrichten; die Netzwerk-Metadaten geben die Anfrage dennoch preis. 4. Beziehen Sie das vertrauenswürdige Stammzertifikat unabhängig von der Antwort sowie alle erforderlichen Zwischenzertifikate. Ein Zertifikat in der Antwort wird nicht allein dadurch vertrauenswürdig, dass es dort enthalten ist. 5. Überprüfen Sie anhand einer vertrauenswürdigen TgWitness-Installation Folgendes: ``` python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem ``` Fügen Sie bei Bedarf `--intermediates tsa-intermediates.pem` hinzu. OpenSSL wird nicht benötigt: Signatur, Verweis auf das Signaturzertifikat und Kette werden in Python mit der Bibliothek `cryptography` geprüft, demselben Code, den `verify.py --tsa-ca` verwendet. `openssl ts -verify` bleibt eine unabhängige zweite Prüfung für Fachleute, die eine wünschen. 1. Exportieren Sie nach dem Checkpoint ein signiertes Protokoll als ZIP-Datei, sodass es dieses Präfix enthält. Überprüfen Sie dies anhand des unabhängig bekannten Fingerabdrucks: ``` python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` Dies zeigt, dass der Export das zeitgestempelte Präfix enthält. `verify.py` liest Zeitstempelbelege nur aus der ZIP-Datei, wo sie im Beweismodus gespeichert sind; die manuelle Antwort wird in Schritt 5 geprüft und deckt die Datensätze bis zu diesem Checkpoint ab. 1. Bewahren Sie die ZIP-Datei, den Checkpoint, die Anfrage, die Antwort, die Zertifikatskette, die Verifizierungsergebnisse sowie die Übergabeprotokolle außerhalb des Collectors auf. Wiederholen Sie die Verifizierung bei Erhalt. So erstellen Sie eine Anfrage anhand eines gespeicherten Checkpoints: ``` python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip ``` Bei der Aufbereitung wird das JSON-Format kanonisiert und der entsprechende Checkpoint in das Archiv aufgenommen. Verwenden Sie die **Checkpoint-Bytes aus diesem Archiv** für die TSA-Verifizierung, auch wenn die Eingabedatei abweichende Leerzeichen enthielt. ## Grenzen der Verifizierbarkeit | Prüfpunkt | Aktuelles Verhalten | | --- | --- | | Daten | Der SHA-256-Hash der exakten Checkpoint-Bytes muss mit der Antwort übereinstimmen. | | Anfrage | Mit „`--request`“ werden die ursprüngliche Abfrage und der Nonce verifiziert | | TSA-Signatur | Signatur, Signaturzertifikat und seine Kette bis zur ausdrücklich angegebenen CA werden zum Zeitpunkt des Zeitstempels geprüft | | Signatur des Erfassers | Unabhängig verifiziert durch den Protokollprüfer mit einem festgesteckten Schlüssel | | Widerruf | Der Evidenzmodus speichert OCSP/CRL-Evidenz, die von `verify.py` überprüft wird | | Geplante Einreichung | Beweismodus, der bei jedem Einrichtungsziel aktiviert wird | `--request` ist technisch optional, ohne diese Angabe lässt sich die ursprüngliche Nonce jedoch nicht prüfen. Für dieses vollständige Verfahren muss `request_checked` im Ergebnis true sein. Jedes Zertifikat der Kette muss zum Zeitpunkt des Zeitstempels gültig sein, und das Signaturzertifikat darf nur für Zeitstempel bestimmt sein. Die TSA-Antwort verankert die übermittelten Checkpoint-Bytes an den angegebenen Zeitpunkt. Überprüfen Sie dieses Ergebnis anhand der Erfassungsdatensätze und der Umgebungsverifizierung für den ausgewählten Modus. Der Beweismodus umfasst die qualifizierte TSA der belgischen Regierung `http://tsa.belgium.be/connect` ein (RFC 3161-Antworten sind signiert, sodass einfaches HTTP sie nicht schwächt). Wenn die Stammzertifizierungsstelle dieses Anbieters an `--tsa-ca` übergeben wird, meldet `verify.py` einen qualifizierten eIDAS-Zeitstempel und dessen Zeitstempeleinheit; die Verordnung (EU) Nr. 910/2014, Artikel 41 Absatz 2, geht von der Genauigkeit der Zeitangabe und der Integrität der verknüpften Daten aus. ### Widerruf von Signaturzertifikaten Unmittelbar nach jeder Antwort ruft der Evidenzmodus Widerrufsnachweise für das TSA-Signaturzertifikat ab: eine OCSP-Antwort von der AIA-OCSP-Adresse des Zertifikats, andernfalls die CRL von dessen Verteilungspunkt (maximal 4 MiB). Diese wird neben der Antwort als `checkpoint-N..ocsp` oder `.crl` gespeichert und mit ihr exportiert. Ein fehlgeschlagener Abruf verzögert niemals den Zeitstempel; der Datensatz `anchor.completed` listet ihn als `unavailable` mit Angabe des Grundes auf. `verify.py` überprüft die Signatur der OCSP-Antwort (durch den Aussteller oder durch ein Antwortzertifikat, das der Aussteller für den Zweck der OCSP-Signierung bereitgestellt hat), die Zertifikats-ID und den Status sowie, ob die Antwort zum Zeitpunkt genTime oder später ausgestellt wurde oder zu diesem Zeitpunkt noch gültig war (nextUpdate). Bei einer CRL überprüft es die Signatur des Ausstellers, dasselbe Zeitfenster und, ob die Seriennummer nicht aufgeführt ist. Anschließend wird entweder `signing certificate not revoked as of