# 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-<commit>.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.
