TgWitness / Dokumentation

Was wurde getestet? →

Referenz / Sammeln

Telegram · Geheime Chats: Einrichtung und Aufzeichnung

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

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 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 , Release b35f8e18f3d1-1ff85ec98bb2 , Version 0.9.1 Preview, überprüft. Das unveränderliche Wheel 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 fixiert denselben Commit wie die Schaltfläche im Panel.

Diese Paketprüfung ermittelt, welche Dateien und Abhängigkeitsdeklarationen ausgeliefert werden. Der Validierungsdatensatz 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 gesendet; Screenshot-Benachrichtigungen werden niemals gesendet. Siehe secret_chats.py, API-Routen und Zugriffsrichtlinien.

Die historische Prüfung behält ihre ursprünglichen Snapshot-Ergebnisse bei. Die aktuelle Verfügbarkeit und Implementierung sind der oben angegebenen Paketversion und den aktuellen Funktionen 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.