TgWitness / Documentation

Ce qui a été testé →

Référence / Sécurité et projet

Telegram · Sécurité et traitement des données

Modèle de menace, modèle d’accès, données confidentielles au repos, exposition du réseau, importation de sessions et procédure de signalement d’une vulnérabilité.

TgWitness / Documentation · Déploiement et restauration

Déploiement et restauration

Cette page décrit l'accès, le stockage et la protection du réseau dans un espace de travail local ou sur serveur. Pour la collecte sur un GitHub Runner ou dans une machine virtuelle confidentielle Intel TDX, consultez les modes de vérification , qui ajoutent des contrôles de l'environnement de collecte. Les connexions de compte, les notifications, les horodatages, les copies hors site et les témoins disposent de leurs propres paramètres de routage.

Domaine En bref
Accès Clé d'administrateur et accès limité aux comptes/discussions, sept niveaux d'autorisation et sessions révocables ; « localhost » par défaut
Secrets au repos La session, la paire API, la clé de signature et les paramètres de proxy sont chiffrés à l'aide de Fernet
Messages et fichiers multimédias Fichiers de l’espace de travail, protégés par le chiffrement du disque ou du volume et les droits d’accès aux fichiers de l’hôte
Intégrité Chaîne de hachages SHA-256 et signature Ed25519 sur chaque enregistrement
Heure externe Les reçus RFC 3161 et OpenTimestamps, les publications de témoins datées par Telegram et l’attestation GitHub ; les points de contrôle conservés, les enregistrements de témoins et les mesures Intel TDX constituent des vérifications à l’appui. Le vérificateur indique quelles conditions de preuve sont remplies.

Pour les rapports de vulnérabilité, veuillez consulter la politique de sécurité.

Sur cette page

Modèle d'accès#

Le jeton du panneau principal accorde un contrôle total. D’autres personnes peuvent bénéficier d’un accès limité : espaces de travail et chats sélectionnés, autorisations, date d’expiration, restrictions d’adresse IP, limites de connexion et sessions révocables. Un accès limité à un chat ne permet pas d’effectuer des opérations sur l’ensemble de l’espace de travail, même si l’autorisation correspondante est cochée. Chaque espace de travail dispose de son propre journal, de son propre coffre-fort et de sa propre clé de signature au sein d’un même processus ; la séparation entre les utilisateurs sur l’hôte est assurée par les comptes du système d’exploitation.

Par défaut, le panneau écoute sur localhost. La connexion via le navigateur échange un jeton d’accès contre des identifiants de session ; le navigateur l’envoie sous forme de jeton « bearer ». Celui-ci est conservé dans sessionStorage plutôt que dans un cookie d’authentification. Le verrouillage ou la déconnexion efface la session du navigateur. La fermeture du navigateur ou la fin d’une session n’interrompt pas la collecte.

Les jetons émis et les identifiants de session sont conservés sous forme de hachages dans le coffre-fort chiffré. La révocation met fin aux sessions associées ; les modifications d’autorisations s’appliquent aux demandes ultérieures. Les fichiers téléchargés ne peuvent pas être récupérés. L’administrateur peut également limiter ses propres sessions de navigateur, mais les scripts utilisant directement le jeton du panneau principal conservent un accès complet et contournent ces limites de session de navigateur.

Les échecs d’authentification sont limités en nombre par adresse client. Les restrictions IP s’appliquent à l’ adresse détectée par l’application ; veuillez vérifier le comportement du proxy inverse avant de vous y fier . Les identifiants de Witness restent des identifiants distincts, en lecture seule, destinés au contrôle de l’état de fonctionnement.

Accès à la démo#

/api/demo-access est un bootstrap délibérément non authentifié destiné à une démonstration synthétique isolée et explicitement lancée. Il émet une capacité distincte valable pendant la durée de vie du processus, jamais le véritable jeton de panneau ni une substitution de TGWITNESS_TOKEN. Son émission et son utilisation nécessitent un pair en boucle fermée et un hôte, sans en-têtes transférés ni requête inter-origines. Des espaces de travail supplémentaires ou une session autorisée désactivent ce chemin. Les espaces de travail actifs n’émettent jamais cette capacité. La démonstration ne permet pas de connecter des comptes ni de modifier les paramètres de collecte.

Contenu des panneaux et exportations#

Le site n’utilise aucune police externe, aucun outil d’analyse, aucune ressource CDN ni aucun média distant intégré. Le texte provenant de Telegram est inséré sous forme de texte brut, et non en HTML. Les pièces jointes téléchargées sont fournies sous forme de pièces jointes binaires. Les exportations au format JSONL conservent les chaînes de caractères d’origine ; le format HTML les échappe ; les cellules CSV susceptibles de contenir des formules sont préfixées d’une apostrophe.

Les exportations excluent les secrets d’authentification et de signature, mais contiennent délibérément les métadonnées sources collectées, les identifiants et, éventuellement, du contenu personnel ou sensible. Des hachages d’accès à Telegram et des références de fichiers peuvent apparaître dans les métadonnées sources brutes.

Secrets au repos#

Les identifiants de l'API Telegram, la session et la clé de signature sont chiffrés avec Fernet. Pour les messages et les médias locaux, le chiffrement est assuré par le disque ou le volume de l'hôte ; l'espace de travail stocke des fichiers ordinaires. Les exportations peuvent utiliser un fichier ZIP AES-256 protégé par mot de passe, et les copies hors site utilisent le chiffrement AES-256-GCM.

La clé du coffre-fort est par défaut le répertoire de données protégées. Utilisez un fichier de clé principale externe ci-dessous pour la stocker séparément. Sous Unix, les nouveaux fichiers de clé privée utilisent le mode 0600 et les nouveaux répertoires de données utilisent le mode 0700 ; sous Windows, définissez les droits d'accès (ACL) du répertoire pour le compte de service et les administrateurs autorisés. Les droits d'accès existants du répertoire sont conservés.

Clé principale externe#

Pour un nouveau répertoire de données, TGWITNESS_VAULT_KEY_FILE peut fournir une clé principale aléatoire externe. HKDF-SHA256 et un sel aléatoire distinct génèrent une clé Fernet différente pour chaque espace de travail. Le fichier vault.external.json doit être conservé à des fins de restauration. Des clés principales manquantes ou erronées entraînent un échec de la fermeture. Les coffres-forts locaux existants ne sont pas migrés de manière silencieuse. Le panneau affiche le mode de stockage des clés sélectionné. Le chiffrement du disque protège les fichiers de messages et multimédias locaux dans les deux modes ; voir « connexion » et « protection des données » pour les détails de configuration.

Proxys et chemins de réseau#

La configuration du proxy est chiffrée dans le coffre-fort. Les mots de passe et les secrets MTProxy ne sont ni renvoyés par l’API ni consignés dans les enregistrements de preuves. Chaque espace de travail choisit son itinéraire Telegram et un mode IP.

L'option « Masquer l'adresse » désactive le recours direct à Telegram et nécessite un proxy pour les requêtes HTTP externes. Le mode de secours explicitement sélectionné autorise l'accès direct à Telegram après un certain délai ; le mode tunnel/VPN autorise les routes directes. Le choix du mode tunnel n'entraîne ni l'installation ni la vérification d'un VPN. Ces paramètres ne contrôlent pas l'ensemble du trafic de la machine, ni les navigateurs, ni les gestionnaires de paquets, ni la résolution DNS de l'hôte proxy local.

MTProxy achemine uniquement le trafic Telegram. Les requêtes externes peuvent utiliser un proxy SOCKS5/HTTP distinct, la route SOCKS5/HTTP de l’espace de travail ou une route directe autorisée ; elles peuvent également être désactivées. Le témoin indépendant dispose de ses propres paramètres de transport. L’authentification SOCKS5/HTTP CONNECT standard n’est pas chiffrée par ces protocoles de proxy eux-mêmes. Les faux secrets TLS MTProxy ne sont toujours pas pris en charge.

Connexion et importation de sessions#

Les fichiers .tgwitness-session convertis contiennent un secret d’autorisation en texte clair jusqu’à ce qu’ils soient chargés et stockés dans le coffre-fort. L’interface en ligne de commande (CLI) hors ligne accepte les schémas Telethon validés. L’importation via le panneau accepte en outre Pyrogram SQLite, les fichiers ZIP TData modernes à compte unique, ainsi que les entrées JSON documentées. Elle est authentifiée, limitée à quatre fichiers / 8 MiB, et traite les téléchargements en mémoire sans extraction d’archive ni enregistrement des fichiers d’origine. Les identifiants normalisés ne sont renvoyés qu’au navigateur authentifié à l’origine de la requête ; ils sont enregistrés dans le coffre-fort chiffré une fois l’autorisation Telegram validée. Protégez les fichiers originaux et convertis, et évitez que des clients simultanés ne clonent une autorisation.

Le traitement TData vérifie les sommes de contrôle des conteneurs, les hachages de décryptage locaux et les longueurs de structure. Un code d’accès local fourni pour la version Desktop est utilisé de manière temporaire et n’est pas stocké. L’analyseur syntaxique limité prend en charge les formats Desktop qu’il valide et rejette les autres. Les images QR sont générées localement, contiennent des jetons de connexion Telegram à durée de vie limitée et ne sont jamais envoyées à un service de rendu externe. Le verrouillage, le changement d’espace de travail, une nouvelle connexion et les changements d’itinéraire annulent les tentatives QR en attente. Le rechargement ou la fermeture d’un onglet peut laisser une tentative en attente jusqu’à son expiration. Une connexion QR réussie impose toujours la liaison de compte. Les corps d’API ordinaires restent limités à 16 KiB ; la voie d’importation authentifiée accepte jusqu’à 12 MiB de JSON encodé, en appliquant séparément la limite inférieure pour le fichier décodé.

Les codes de connexion et les mots de passe de vérification en deux étapes de Telegram ne sont pas conservés. L’état du numéro de téléphone et du hachage du code est conservé en mémoire pendant l’autorisation. Les sessions Telegram permettent d’accéder au compte ; ne téléchargez jamais de répertoire de données, de session, de jeton, de clé de coffre-fort ou de clé de signature privée sur GitHub.

Journaux et transport#

La réponse de validation par défaut de l’API est remplacée afin qu’elle ne renvoie pas les valeurs des identifiants . La journalisation des accès à l’application est désactivée. Ne configurez pas de proxy inverse pour enregistrer les en-têtes d’autorisation ou le corps des requêtes. Le panneau écoute sur localhost ; l’accès à distance passe par le tunnel SSH fourni, Cloudflare Tunnel ou Caddy HTTPS, de sorte que les jetons et les secrets de connexion transitent via SSH ou TLS.

Intégrité et temps externe#

Les contrôles de vérification comparent les signatures des enregistrements, la chaîne de hachage, les pièces jointes et le manifeste d’exportation à la clé du collecteur. Une signature valide indique que les octets n’ont pas été modifiés depuis leur signature. Chaque espace de travail crée sa clé de signature lors de son premier démarrage et affiche son empreinte digitale dans le panneau et dans chaque exportation. L’opérateur transmet l’empreinte digitale au destinataire via un canal distinct, et --fingerprint verrouille la clé.

Tout enregistrement modifié, inséré ou supprimé rompt la chaîne de hachage ou une signature, et le vérificateur le signale. Des horodatages externes et un témoin permettent également de verrouiller le journal en dehors de l’ espace de travail. Les déclencheurs SQLite sur la table du journal empêchent uniquement l’application de écraser ou de supprimer un enregistrement par erreur. TGWITNESS_VAULT_KEY_FILE La clé du coffre-fort n'est pas incluse dans la copie du répertoire de données.

Les reçus RFC 3161 et OpenTimestamps, ainsi que les publications de témoins dont le vérificateur lit les dates sur Telegram, lient le préfixe du journal qu’ils couvrent à un horodatage défini par un tiers. Un cycle « drand » inscrit dans le journal indique que les enregistrements qui le suivent ont été créés au plus tôt au moment de la publication de ce cycle. Une attestation GitHub vérifiée comporte également l’horodatage de sa signature, ce qui lie l’intégralité de l’archive à un horodatage externe. Un point de contrôle est signé avec la clé du collecteur et lie les enregistrements qui le précèdent à partir du moment où le destinataire l’a obtenu, par un autre canal. Un témoin montre qu’une deuxième clé a conservé l’en-tête du journal ; l’enregistrement de contrôle des clés du dépositaire indique qui détient cette clé. Ces deux éléments constituent des vérifications complémentaires ; le minimum requis est l’horodatage par un tiers. La capture GitHub Actions ou un déploiement Intel TDX ajoute la provenance du workflow ou des mesures matérielles de l’environnement de collecte.

Chaque réponse de vérification répertorie les conditions de preuve en précisant comment chacune a été vérifiée, regroupées selon leur rôle au minimum :

Rôle Condition
Obligatoire Intégrité ; clé du signataire épinglée avec --fingerprint ; horodatage externe couvrant le dernier enregistrement (réception RFC 3161 vérifiée avec --tsa-ca, réception OpenTimestamps confirmée avec --check-bitcoin, message du témoin lu depuis t.me avec --channel, sceau Bitcoin du témoin ou attestation GitHub vérifiée)
Prise en charge, ne fait pas partie du minimum requis Témoin disposant de sa propre clé ; point de contrôle conservé ; exécution de collecte certifiée

Le minimum requis en matière de preuve consiste en la satisfaction des trois conditions obligatoires concernant le dernier enregistrement exporté ; un cycle de collecte vérifié et certifié ajoute le attested profil. La dernière ligne indique le résultat, et la réponse précise les options qui permettraient de remplir les conditions manquantes. Sans --fingerprint la ligne finale commence par EVIDENCE: minimum not met · missing: confirmed signer key. Lorsque les horodatages vérifiés ne couvrent que des enregistrements antérieurs, la réponse indique l’enregistrement jusqu’à lequel le minimum est valable. --require evidence ou --require attested se termine par le code 2 lorsque le profil n’est pas atteint pour l’ensemble de l’exportation, et une vérification demandée en ligne de commande qui ne peut pas s’exécuter est signalée comme non effectuée avec le même code. Chaque rapport comporte les mêmes conditions avec leur état dans cette copie et la commande qui les vérifie . Les niveaux d’assurance et --strict restent disponibles ; le format de preuve répertorie les vérifications pour chaque mode de collecte.

Si vous soupçonnez un problème#

Conserver le répertoire de données d'origine et utiliser une copie distincte pour l'analyse. Signaler la version concernée, le fonctionnement et les étapes reproductibles via la politique de sécurité, en préservant la confidentialité des données de compte et des identifiants.