TgWitness / Documentation

Ce qui a été testé →

Référence / Collecter

Telegram · Discussions secrètes : configuration et enregistrement

Installez l’extension du protocole des discussions secrètes, activez-la par compte et enregistrez les discussions que TgWitness crée ou accepte.

TgWitness / Documentation

L'application publiée comprend le backend « Secret Chat », l'intégration du collecteur, les routes API et l'interface Pseudo-secret. La bibliothèque de protocoles est un module distinct : ouvrez Pseudo-secret, cliquez sur Installer, puis activez-la. L'acceptation automatique des messages entrants reste désactivée jusqu'à ce que vous l'activiez.

Module de protocole#

Module kiaro-telethon-secret-chat 0.2.0
Auteur KiaroSama
Licence GPL-3.0 ou version ultérieure ; sa LICENSE et NOTICE restent dans l’archive enregistrée
Source KiaroSama/Telethon-Secret-Chat lors de la validation d87bf037b90060383c7b704d8a06ebb98c621c6f
Vérifier SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c sur la liste des fichiers de paquets et leurs propres valeurs SHA-256

La fonction Installer et activer est accessible à l'administrateur principal. TgWitness télécharge l' archive source de ce commit depuis GitHub via la route de l'espace de travail pour les requêtes extérieures à Telegram, compare chaque fichier du paquet avec la valeur définie dans la version de TgWitness, enregistre l'archive dans modules/telethon-secret-chat-<commit>.zip dans le répertoire de données et charge le code depuis la mémoire. Aucun redémarrage n’est nécessaire. La vérification s’effectue à nouveau à chaque démarrage ; une archive présentant des différences n’est pas chargée et la page l’indique. Un fichier de paquet modifié, manquant ou ajouté entraîne l’échec de la vérification.

Ce module est une œuvre distincte, régie par sa propre licence. TgWitness ne le fournit pas : chaque installation le télécharge depuis le dépôt de son auteur. La page Détails affiche le module chargé, son auteur, sa licence, son commit et sa valeur SHA-256.

Un hôte n'ayant pas accès à GitHub peut installer ce même commit dans l'environnement Python à la place ; le panneau utilise alors cette copie :

python -m pip install ".[secret-chats]"

TgWitness devient un point de terminaison pour les discussions qu’il crée ou accepte. Il enregistre les messages, les pièces jointes disponibles, les modifications de la minuterie et les avis de suppression dans le journal signé. Le contenu précédemment enregistré reste disponible après un avis de suppression ultérieur.

Disponibilité du package#

Le 8 novembre 2026 , le paquet d’installation publié a été vérifié à la source b35f8e18f3d1 , version b35f8e18f3d1-1ff85ec98bb2 , version 0.9.1 preview. Le fichier wheel immuable et son verrou de dépendances ont passé avec succès la vérification des signatures de version SHA-256 et RSA. Le backend et l’interface intégrés correspondaient à cette révision source octet par octet. Le paquet contient également l’enregistrement de l’API et les hooks du collecteur.

Ce paquet ne contenait pas la bibliothèque de protocole, et celle-ci ne figure pas dans le lock des dépendances. L' secret-chats entrée « extra » dans pyproject.toml fixe le même commit que le bouton du panneau.

Cette inspection du paquet détermine quels fichiers et quelles déclarations de dépendances sont fournis. L’enregistrement de validation identifie les différentes vérifications d’exécution. Le guide précédent du 6 novembre décrivait un instantané de développement ; il ne décrit plus le paquet ci-dessus.

Utiliser l’interface#

Ouvrez Pseudo-secret, installez le module si la page le propose, activez-le pour le compte et connectez-le. Les demandes entrantes attendent d'être acceptées, sauf si l'acceptation automatique est activée. Le démarrage, l'acceptation, l'envoi et la fermeture utilisent les autorisations d'interaction du compte et la protection en lecture seule.

Action Résultat conservé
Lancer une conversation par nom d'utilisateur ou identifiant utilisateur Requête sortante ; le pair l’accepte sur son appareil.
Accepter une demande TgWitness devient le point de terminaison récepteur.
Envoyer ou recevoir un message secret_chat.message, avec sa direction, son contenu et le minuteur fourni.
Recevoir un fichier Octets déchiffrés stockés par SHA-256 et un reçu secret_chat.file ; inclus dans l’exportation des preuves.
Recevoir un rappel de délai ou un avis de suppression Un enregistrement d’action distinct, parallèlement aux messages et fichiers conservés.
Passer en revue la conversation Conversation, accusés de réception de fichiers, notifications et visualisation des clés.

Les discussions secrètes existantes sur un autre appareil conservent leurs clés spécifiques à cet appareil. Une session cloud importée ne transfère pas ces clés. Le matériel de clés des discussions secrètes et les compteurs utilisent le coffre-fort de l’espace de travail ; les messages conservés et les fichiers déchiffrés bénéficient des protections de stockage habituelles de l’espace de travail.

Rechercher les messages enregistrés#

Utilisez la fonction Rechercher dans une conversation ouverte pour trouver une expression exacte, sans tenir compte de la casse. Les touches Précédent et Suivant, ou Entrée et Maj+Entrée dans le champ de recherche, permettent de passer d'un message correspondant à l'autre. Le compteur indique le nombre de messages ; la première expression correspondante dans chaque message est mise en surbrillance. La touche Échap efface la recherche.

La fonction de recherche permet de garder à l'écran la conversation environnante, les fichiers enregistrés et les notifications de suppression. Elle effectue une recherche parmi les enregistrements déjà chargés dans le panneau. Lorsqu'il reste des enregistrements antérieurs, le panneau l'indique ; l'option Charger les enregistrements plus anciens étend l'historique et met à jour les résultats de la recherche tout en conservant le message actuel à l'écran.

Chaque conversation conserve son historique de recherche lorsque vous passez d'une discussion à l'autre au sein d'un même espace de travail. Le verrouillage du panneau ou le changement d'espace de travail efface ces recherches. Les termes de recherche restent en mémoire de la page et ne sont ni stockés dans la mémoire du navigateur, ni envoyés sous forme de requêtes API. La recherche n'entraîne pas l'envoi de messages Telegram ni de notifications de saisie ou de lecture. Les paramètres de visibilité existants continuent de régir l'ouverture d'une conversation et les autres actions.

Le rapport de compilation conserve la portée de sélection de la conversation choisie ; une recherche dans l'affichage ne limite pas automatiquement les enregistrements exportés. Prévisualisez la sélection du rapport avant de le télécharger.

Contrôles de persistance et d’interaction#

L’implémentation intégrée utilise la recherche dans le journal durable pour la détection des doublons, maintient les tâches de pièce jointe en attente après un téléchargement échoué, et achemine la fermeture via le même garde d’interaction que les autres actions à distance. Celles-ci remplacent les trois chemins signalés dans l’audit historique de l’instantané de développement du 6 novembre.

Les messages déchiffrés dont l'écriture dans le journal a échoué sont conservés dans le coffre-fort en vue d'une nouvelle tentative. Les vérifications de la taille des pièces jointes et de l'espace disque disponible reportent les téléchargements tout en conservant les tâches correspondantes. Le module réutilise la connexion existante du compte. Les notifications de lecture et de saisie ne sont envoyées que selon les options choisies dans Ce que voit l'autre partie ; les notifications de capture d'écran ne sont jamais envoyées. Voir secret_chats.py, les routes API et la politique d'accès.

L’audit historique conserve ses résultats d’instantané d’origine. La disponibilité et la mise en œuvre actuelles doivent être consultées dans la révision du paquet ci-dessus et les capacités actuelles.

Démonstration de l’interface#

Le scénario du site web utilise des requêtes, des messages et des fichiers fictifs pour illustrer le flux de travail du panneau. Il s’agit d’un exemple d’interface ; les vérifications de protocole et d’acquisition disposent de leurs propres résultats datés dans l’enregistrement de validation.