TgWitness / Documentation

Ce qui a été testé →

Référence / Configuration

Telegram · Connexion, proxys et protection des données

Authentification, pools de proxys automatiques, modes IP, politique de repli, requêtes externes et stockage des secrets.

TgWitness / Documentation · Déploiement et restauration

Déploiement et restauration

Ce document décrit le comportement d’TgWitness0.9.3 et ses limites. L’authentification, l’accès aux sources, la connectivité réseau et l’exhaustivité de la capture constituent des états distincts. Pour les étapes de connexion, les formats de fichiers et la gestion de plusieurs comptes, commencez par consulter la section Comptes et formats de session. Pour les politiques relatives aux événements et le comportement en cas de redémarrage, consultez la section Fonctionnement de la collecte.

Configuration guidée de la connexion#

Dans Plus d’outils → Compte → Itinéraire de connexion, l’administrateur peut choisir Ce compte, Un groupe de comptes ou Tous les comptes, puis sélectionner un itinéraire. L’option Vérifier la sélection affiche la liste des comptes concernés. L’option Préparer et tester permet de tester l’itinéraire proposé sans modifier celui qui est enregistré. L’option Appliquer la connexion vérifiée valide l’aperçu, met en pause la surveillance si nécessaire, enregistre l’itinéraire et reprend la surveillance déjà en cours. La collecte ne démarre jamais sur un compte précédemment inactif. Les téléchargements de l’historique restent suspendus et peuvent être repris séparément. Mettez en pause les exportations actives avant de changer de compte.

Par défaut, les modifications apportées aux groupes conservent les comptes sur leur propre route. Ne désactivez cette option que lorsque l'aperçu affiche les modifications que vous souhaitez effectuer. L'application rend compte des résultats de chaque compte ; il ne s'agit pas d'une transaction « tout ou rien » entre les bases de données. Un changement ayant échoué rétablit les paramètres précédents de ce compte. Un échec de reprise est indiqué explicitement. Les aperçus expirent au bout de dix minutes et les modifications apportées aux paramètres de connexion ou à l'appartenance à un groupe nécessitent une nouvelle vérification.

La fonction « Apply » réutilise un résultat de pré-vérification réussi pendant 90 secondes maximum lorsque son itinéraire, son mode et sa politique restent inchangés. Un tunnel géré doit toutefois disposer du même processus en cours d’exécution. Les résultats plus anciens, les processus de tunnel modifiés et les itinéraires automatiques du pool MTProxy sont vérifiés à nouveau. L’enregistrement d’application signé conserve l’heure de vérification d’origine et consigne la réutilisation ainsi que son ancienneté. Chaque pré-vérification ferme son client temporaire non authentifié ; le collecteur se connecte à l’aide de sa propre session autorisée.

Itinéraire Ce que gère TgWitness
Direct Connexions depuis l'hôte ; aucun VPN d'hôte externe n'est détecté ni imposé.
VPN Un profil WireGuard à tunnel complet par compte, géré par un processus SOCKS5 local dans l'espace utilisateur. Aucune interface hôte ni aucun pilote n'est installé.
Mon proxy Identifiants SOCKS5, HTTP CONNECT ou MTProxy. Une URL peut remplir les champs SOCKS5/HTTP. La sélection de plusieurs comptes partage ce proxy saisi.
MTProto public Le pool existant attribue des routes Telegram. Les requêtes externes sont désactivées jusqu'à ce qu'un proxy externe approprié soit configuré dans les paramètres avancés.
WARP Un tunnel local distinct pour chaque compte sélectionné, avec un enregistrement WARP et un profil WireGuard conservés dans le coffre-fort de ce compte.

La vérification de l'itinéraire actuel utilise une nouvelle connexion Telegram non authentifiée, et non la session du compte. Elle établit une connexion via l'itinéraire menant au centre de données du compte et effectue un aller-retour MTProto non authentifié (req_pq_multi) ; il ne crée aucune clé d’autorisation et n’utilise aucun compte. La latence indiquée correspond au temps de connexion plus l’aller-retour, et la vérification enregistre ces deux parties séparément. Pour les routes prenant en charge le protocole HTTP, elle demande également la trace HTTPS de Cloudflare via cette route et affiche l’adresse IP de sortie signalée, le pays, l’état WARP et l’heure de la vérification. La préparation WARP échoue à moins que la trace n’indique que WARP est actif. Ces vérifications préalables indiquent la connectivité de la route et la sortie observée. Examinez les enregistrements capturés à l’aide des résultats d’acquisition et de vérification de l’archive. Un processus local en cours d’exécution ne constitue pas à lui seul une vérification de sortie réussie.

Le panneau calcule une moyenne mobile des cinq dernières vérifications. Un itinéraire est considéré comme lent lorsque cette moyenne dépasse 5 secondes ou que trois vérifications consécutives dépassent cette valeur, et comme indisponible après deux échecs consécutifs ; network.slow_route et network.route_recovered enregistre les changements. Pour une route WARP lente, la fonction « Re-roll WARP » redémarre le tunnel du compte vers d’autres points de terminaison Cloudflare WARP, conserve le plus rapide et enregistre network.warp_rerolled avec les temps avant et après ; New WARP identity enregistre un nouvel appareil WARP et ne le conserve que s’il est plus rapide. L’adresse du proxy local, le compte Telegram et sa session restent les mêmes ; les connexions Telegram se reconnectent via le tunnel redémarré. Un itinéraire WARP lent est relancé automatiquement au maximum une fois toutes les 30 minutes ; lorsque cela ne suffit pas, les relances suivantes attendent l’intervention de l’opérateur.

WARP et WireGuard portables#

Il s'agit d'une intégration non officielle de WARP utilisant wgcf 2.3.1 et wireproxy 1.1.3 . L'administrateur accepte explicitement la configuration avant le premier téléchargement ou l'enregistrement WARP. Ces connexions de configuration sont établies directement vers GitHub et Cloudflare et Ces connexions de configuration passent directement par GitHub et Cloudflare et révèlent l’adresse IP de la machine. Le trafic des comptes ordinaires conserve son itinéraire existant jusqu’à l’application. Cloudflare choisit l’adresse de sortie et le pays ; des tunnels distincts peuvent partager une même adresse de sortie. La sélection du pays, la rotation périodique des adresses IP et un kill switch VPN à l’échelle de l’hôte ne sont pas fournis par cette fonctionnalité.

Téléchargements d'outils pris en charge : Linux et macOS x86-64/ARM64, ainsi que Windows x86-64. Les artefacts sont vérifiés par rapport aux hachages SHA-256 inclus dans le code source examiné, et les exécutables mis en cache sont vérifiés à nouveau avant leur lancement. Aucun utilitaire n’est ajouté au PATH, installé en tant que service système, ni doté d’un écouteur public. Tous les fichiers se trouvent dans le répertoire portable-routes/ de l’espace de travail et dans des entrées de coffre-fort chiffrées. L’écouteur de bouclage SOCKS5 nécessite des identifiants générés de manière indépendante.

Les profils privés et les identifiants du compte WARP sont chiffrés à l’aide du coffre-fort de l’espace de travail existant. Lors de son exécution, l’assistant a besoin d’un fichier de configuration en clair accessible uniquement au propriétaire ; celui-ci est supprimé lors d’un arrêt normal. Un plantage de l’hôte peut laisser ce fichier dans le dossier de données réservé au propriétaire. Cela ne chiffre pas le disque et n’offre aucune protection contre son administrateur. Le superviseur ferme le tunnel si le canal parent du panneau disparaît. Un tunnel ayant échoué n’active jamais de solution de secours directe. Le redémarrage du panneau restaure un tunnel sélectionné ; les démarrages ayant échoué sont réessayés avec un délai limité. Arrêter le tunnel met également l’observation en pause et maintient l’état d’arrêt. Démarrer le tunnel lance le tunnel ; reprendre l’observation séparément lorsque vous êtes prêt.

Les profils WireGuard téléchargés doivent contenir une interface et un pair, des routes IPv4 et IPv6 complètes, et ne doivent comporter ni hooks, ni includes, ni substitutions d’environnement, ni écouteurs supplémentaires. Les adresses des points de terminaison publics sont résolues et épinglées avant le démarrage. Utilisez un VPN externe ou une passerelle SOCKS5 pour OpenVPN/IPsec et les points de terminaison privés.

Méthodes d’authentification#

L’identifiant API et le hachage API identifient une application ; ils ne remplacent pas les identifiants de connexion au compte. Ils sont facultatifs dans TgWitness. Ordre de priorité : une paire saisie dans le formulaire, puis une provenant d’un fichier JSON de compte importé, puis la paire enregistrée dans l’espace de travail, puis le pool intégré de 50 paires publiques, essayées dans un ordre aléatoire avec rotation automatique lorsque Telegram en refuse une. Seule la paire Telegram Desktop (2040) est envoyée avec une description correspondante du client Telegram Desktop. Votre propre paire, issue des outils de développement API sur my.telegram.org, peut être utilisée avec tous vos comptes ; chaque compte dispose toujours de sa propre autorisation.

Méthode Exigences Assistance TgWitness
Numéro de téléphone, code, authentification à deux facteurs (2FA) facultative Accès au compte ; paire d’API facultative Connexion au panneau d'administration
Clé d'authentification HEX + identifiant DC Clé complète de 512 caractères et DC 1–5 Onglet « Clé d'authentification directe » ; l'identifiant utilisateur facultatif est vérifié avant l'enregistrement de l'autorisation
Telethon StringSession Une chaîne de session valide Connexion au panneau d'administration
Telethon SQLite .session Texte définitif et cohérent Importation directe des schémas via l'interface graphique 7/8 ; interface en ligne de commande (CLI) hors ligne en option
Pyrogram SQLite .session Session utilisateur de production fermée Importation directe des schémas via le panneau 2/3
Telegram Desktop TData ZIP Un seul compte moderne ; code d'accès local si le compte est protégé Conversion en mémoire avec vérification des sommes de contrôle et du déchiffrement
Fichier JSON du compte Champs API/session/clé pris en charge Les métadonnées suffisent à elles seules à remplir les identifiants de l'API ; une connexion par session/clé ou par numéro de téléphone/code QR reste toutefois nécessaire
Connexion par QR code Confirmation provenant d’une application Telegram officielle Génération locale de codes QR, expiration/nouvelle tentative, authentification à deux facteurs (2FA) en option
TDLib / Pyrogram StringSession Autres formats spécifiques aux bibliothèques Non pris en charge
Jeton du bot Un bot doté de son propre modèle d’accès et de mise à jour Non utilisé par ce collecteur

Telegram choisit le mode de transmission du code, y compris l’envoi éventuel d’un SMS. Un hachage API ne peut pas rétablir une session révoquée ni remplacer un mot de passe 2FA oublié. TgWitness ne conserve pas les codes de connexion ni le mot de passe 2FA de Telegram sur le disque.

Pour une source privée, le compte doit déjà disposer d’un accès. Un nom d’utilisateur de groupe n’est pas nécessaire. Un proxy ou une importation de session ne confère ni adhésion ni droits d’administrateur . Les paramètres du chat déterminent si les membres peuvent consulter l’historique antérieur à leur adhésion.

Importer un fichier de session Telethon#

Telethon SQLite, Pyrogram SQLite et Telegram Desktop TData utilisent des formats différents. Le panneau détecte et convertit les structures prises en charge ; le renommage d'un fichier ne constitue pas une conversion. Sélectionnez une session et son fichier JSON associé dans la section Fichiers, cliquez sur Vérifier les fichiers, puis sur Connecter le compte. Jusqu'à quatre fichiers correspondants et 8 Mio au total sont acceptés. Consultez les limites de format pour plus de détails sur TData/JSON. Il n'y a pas de récupération du code d'accès. La connexion par téléphone/authentification à deux facteurs (2FA) ou par code QR crée une autorisation distincte.

Le chemin d’accès en ligne de commande optionnel, réservé à Telethon, reste disponible :

  1. Arrêtez le client en utilisant la session d’origine et créez une copie cohérente. Le convertisseur rejette les fichiers comportant un WAL/journal inachevé. Fermez le client d’origine correctement au lieu de supprimer ces fichiers pour contourner la vérification.
  2. Depuis l'environnement TgWitness, exécutez :
python -m tgwitness.sessions account.session --out account.tgwitness-session
  1. Sous « Ajouter un compte » → « Fichiers », chargez le résultat ou collez sa chaîne de caractères, puis continuez.
  2. Vérifiez l'identifiant numérique du compte affiché, sélectionnez les sources et lancez la surveillance.

Le fichier converti contient un mot de passe d’accès au compte non chiffré. Conservez-le dans un espace de stockage sécurisé et ne le commitez jamais ni ne l’envoyez à un service de conversion tiers. TgWitness enregistre la session autorisée dans son coffre-fort chiffré. La copie d’une session ne crée pas d’autorisation distincte : n’exécutez pas de clients simultanés avec des clés d’authentification clonées et ne supposez pas une mise à jour indépendante.

La conversion transfère l’autorisation, et non les messages originaux, le cache de l’entité ou un curseur de mise à jour persistant. Elle ne corrige pas la récupération des mises à jour lors des redémarrages du processus.

MTProto, Telethon et les proxys#

MTProto est le protocole de Telegram. Telethon est la bibliothèque cliente Python utilisée par TgWitness. MTProxy est un proxy de transport Telegram ; les protocoles SOCKS5 et HTTP CONNECT fournissent des tunnels généraux. Aucun d’entre eux ne remplace l’authentification du compte.

Enregistrez l’itinéraire pour chaque espace de travail dans Plus d’outils → Compte → Paramètres → Paramètres de connexion → Modifier l’itinéraire de connexion avant de vous connecter. Les nouveaux espaces de travail utilisent par défaut MTProxy automatique · listes publiques avec l’option Masquer l’adresse. Les espaces de travail existants qui utilisaient explicitement Direct conservent un mode le permettant.

Les fichiers sont lus via des connexions distinctes de celle utilisée pour lire les messages, comme le font les applications officielles. Dans le centre de données propre au compte, la clé d’autorisation du compte est réutilisée avec une nouvelle session MTProto ; pour un autre centre de données, une clé est créée et autorisée pendant que le compte est connecté, et elle n’est conservée qu’en mémoire. Chaque connexion de fichier emprunte le même itinéraire que le compte. Leur nombre par centre de données est limité via Paramètres → Performances → Connexions de fichiers par centre de données Telegram ; la valeur 0 signifie que les fichiers sont lus uniquement via la connexion principale du compte. Au maximum cinq connexions Telegram peuvent être établies simultanément pour l’ensemble des comptes d’une installation.

Modes IP#

C'est l'itinéraire qui détermine la connexion. Le mode IP, Protection de la propriété intellectuelle, dans la section « Compte » du panneau, détermine à quel moment l'adresse du serveur peut être exposée. Ces commandes n' installent pas de VPN et ne redirigent pas l'ensemble du trafic de la machine.

Mode Telegram Demandes externes
Masquer l'adresse (hide) Utilisez un proxy ; patientez si aucun ne fonctionne. Aucune solution de secours directe. Nécessite SOCKS5/HTTP ; les requêtes sans proxy compatible sont refusées.
Recourir à Direct en dernier recours (fallback) MTProxy peut utiliser automatiquement la connexion directe après le délai configuré, puis revenir à un proxy opérationnel. Privilégiez un proxy externe configuré ou la route SOCKS5/HTTP du compte ; à défaut, la connexion directe est autorisée.
Serveur derrière un tunnel ou un VPN (tunnel) Les routes directes et le basculement automatique immédiat vers le pool sont autorisés. L'accès direct est autorisé lorsqu'aucun proxy applicable n'est configuré.

Le mode « tunnel » ou « VPN » suppose que vous gérez ce réseau séparément. Sans un tunnel opérationnel, les destinataires peuvent voir l'adresse du serveur lui-même. Choisissez le mode en fonction de votre réseau réel, et non en fonction du nom de l'option.

Choisissez un parcours#

Itinéraire Paramètres Limites
MTProxy automatique Listes intégrées ou catalogue d’opérateurs Maintient une route Telegram opérationnelle ; la solution de secours directe dépend du mode IP
Direct Mode tunnel ou VPN Telethon utilise l'itinéraire réseau de l'hôte
SOCKS5 Hôte, port, nom d'utilisateur et mot de passe (facultatifs) python-socks, DNS de destination distante activé
HTTP CONNECT Hôte, port, nom d'utilisateur et mot de passe (facultatifs) Connexion HTTP simple (CONNECT) ; le protocole TLS vers le proxy lui-même n’est pas implémenté
MTProxy Hôte, port, clé secrète Transport expérimental Telethon ; 32 chiffres hexadécimaux ou « dd » + 32 chiffres hexadécimaux

Les faux secrets TLS « ee » sont rejetés. La normalisation de Telethon 1.45 peut supprimer un préfixe et un domaine, mais cela ne met pas en œuvre le « Fake TLS ». Collez « tg://proxy?server=…&port=…&secret=… » ou « https://t.me/proxy?server=…&port=…&secret=… » et sélectionnez « Remplir les champs à partir du lien ». Cela valide et remplit les champs sans connexion ni enregistrement ; vérifiez et enregistrez l’ itinéraire séparément. Les champs manuels restent disponibles. Voir les liens proxy Telegram.

Proxys publics fournis par votre installation#

La liste intégrée regroupe sept sources : SoliSpirit/mtproto, zakky8/mtproto-proxy-pro, kort0881/telegram-proxy-collector, 3yed-61/MTP-Collector, Therealwh/MTPproxyLIST, KhodeJav/telegram-proxy-collector et tgmtproxy/telegram-mtproto-proxy-list. L'instantané fourni contient des informations sur les points de terminaison, les sources et les dates de téléchargement. Les listes constituent des données d’entrée ; les vérifications de connectivité ci-dessous déterminent quels proxys sont utilisés.

MTProxy vérifie automatiquement la connectivité du transport Telegram, maintient un proxy opérationnel et bascule vers un autre en cas de défaillance. Les espaces de travail privilégient différents proxys lorsqu’il y a suffisamment d’entrées opérationnelles disponibles ; les proxys peuvent partager une adresse de sortie. Les proxys défaillants se mettent en veille avant une nouvelle tentative. Si aucun ne fonctionne, le mode IP détermine si la collecte doit attendre ou peut utiliser une connexion directe. Le changement de proxy ne modifie pas le compte ni n’efface son journal. Les choix et changements d’itinéraire sont consignés dans le journal signé.

Lorsque les itinéraires automatiques sont actifs, les listes sont actualisées toutes les heures et les vérifications de transport s’exécutent toutes les dix minutes par défaut. Ces intervalles sont configurables. La mise à jour des listes publiques déclenche une actualisation ; la simple consultation de la liste ne modifie pas un itinéraire manuel enregistré.

Le trafic Telegram et les requêtes HTTPS empruntent des chemins différents. Les téléchargements de listes utilisent une connexion HTTPS distincte et le chemin de requête externe fourni. « TGWITNESS_PROXY_FEED_PROXY » remplace explicitement ce chemin par un proxy HTTP/SOCKS5 ; les deux variantes du collecteur « Compose » le transmettent. Le pool d’arrière-plan suit l’espace de travail principal. Aucune session Telegram, aucun identifiant API, aucun jeton de panneau ni aucun jeton de bot n’est transmis aux fournisseurs de flux. Les noms des fournisseurs, les dates des instantanés et l’itinéraire de téléchargement apparaissent sous « D’où provient la liste ».

Un MTProxy achemine uniquement le trafic Telegram. Les opérations HTTP de l'espace de travail, telles que les horodatages, les notifications, les copies hors site et les vérifications de source, utilisent un proxy SOCKS5/HTTP distinct lorsqu'elles sont configurées, puis la route SOCKS5/HTTP du compte. En l'absence de l'un ou de l'autre, l'option « Masquer l'adresse » refuse la demande ; les autres modes autorisent le mode « Direct ». Les requêtes externes peuvent être désactivées. Un proxy de téléchargement de flux explicitement configuré reste une option de contournement distincte pour l'opérateur. Le service de témoin indépendant conserve sa propre route.

Pour les services privés gérés par l’opérateur, le paramètre d’environnement serveur existant TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1 autorise les destinations privées et conserve la résolution du nom d’hôte côté proxy. Il ne peut pas être activé depuis le panneau de configuration. Le mode « public uniquement » rejette les destinations ..onion avant d’interroger le résolveur public ; les services Tor « onion » nécessitent ce paramètre explicite de destination privée ainsi qu’un proxy adapté. Ce comportement DNS s’applique aux opérations HTTP externes, et non au transport de Telegram. Cloudflare documente le point de terminaison DNS JSON.

Paramètres automatiques du pool

Sous Plus d’outils → Paramètres → MTProxy automatique, configurez le seuil d’échec, le délai de réinitialisation, la rotation planifiée, le partage de proxy et le délai de repli autorisé.

Contrôle Par défaut
Déconnexion avant remplacement 3, dans un délai de 10 minutes
Proxys testés par tentative de connexion 3
Premier / temps de repos maximal après un échec 10 minutes / 6 heures
Rotation prévue Désactivé ; activer en cas d'échec
Comptes par proxy 0 : privilégier les entrées distinctes, les regrouper si nécessaire. Définir 1 sur attendre une entrée exclusive.
Délai avant le recours autorisé à la solution de secours directe 10 minutes ; Masquer l'adresse, mais le refus persiste Direct
Actualisation du flux / contrôles de transport Minutes 60 / 10 ; les valeurs de l'espace de travail principal s'appliquent au pool partagé

Différents proxys peuvent partager une adresse de sortie. Les limites de Telegram s’appliquent à chaque route.

Pour remplacer la liste publique par votre propre catalogue d’opérateurs, configurez la surécriture ci-dessous. Cela désactive entièrement les abonnements externes, y compris lorsque son tableau « proxies » est vide.

Copiez le catalogue vide vers proxy-config/proxies.json et ajoutez vos points de terminaison publics déployés :

{"format": "tgwitness-proxy-catalog-v1", "proxies": [
  {"id": "project-eu", "label": "Project EU",
   "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}

Les valeurs d’exemple doivent être remplacées. Jusqu’à 32 entrées distinctes sont acceptées. La liste authentifiée renvoie des étiquettes/hôtes/ports sans secrets partagés ; la sélection d’un élément enregistre ses identifiants dans le coffre-fort de l’espace de travail. La disponibilité n’est pas vérifiée tant qu’un test de transport explicite n’a pas été effectué. Un catalogue mal formé permet une configuration manuelle.

Lancement en mode natif : définissez TGWITNESS_PROXY_CATALOG comme chemin d'accès JSON local. Docker :

docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build

Le montage en superposition est en lecture seule (proxy-config) ; les fichiers doivent être lisibles par le conteneur UID 10001. Ce répertoire est exclu de Git, du contexte de compilation Docker et des archives sources. Ce catalogue configure les comptes de collecte ; le bot témoin utilise sa propre route HTTP/SOCKS5, et non MTProxy.

La solution de secours directe est régie par le mode IP décrit ci-dessus. Suspendre la surveillance avant de modifier un itinéraire. L'enregistrement déconnecte les anciens clients et annule les connexions en cours ; un nouveau client utilise l'itinéraire enregistré. La liaison entre le journal et la session du compte est conservée. Les paramètres remplacent l'itinéraire précédent : veuillez saisir à nouveau les identifiants du proxy lors de sa modification.

Les identifiants sont chiffrés selon le standard network.enc. L’API ne renvoie ni le nom d’utilisateur, ni le mot de passe, ni la clé secrète. Les enregistrements signés contiennent le type de route et indiquent si des identifiants sont présents, sans mentionner le point de terminaison ni les clés secrètes. L’opérateur peut consulter le point de terminaison dans le panneau de contrôle. Les champs contenant les clés secrètes sont effacés après l’enregistrement, le verrouillage ou le changement d’espace de travail.

La fonction « Tester la connexion Telegram », également disponible avant la connexion, ouvre et ferme une connexion Telegram temporaire et non autorisée via le routeur. Elle ne contacte pas de site web de vérification d’adresse IP. En cas de succès, cela établit la connectivité de transport, mais ne garantit pas l’accès aux groupes, la livraison complète ni l’anonymat.

Le proxy s'applique aux connexions du client Telegram, y compris aux téléchargements de médias depuis les serveurs de distribution (DC) de Telegram. Le navigateur, pip, SSH et les outils TSA lancés manuellement empruntent des chemins distincts. Le nom d'hôte du proxy peut être résolu localement. rdns affecte les noms d'hôtes de destination ; Telegram fournit souvent des adresses IP numériques pour ses serveurs de distribution (DC).

SOCKS5 et HTTP CONNECT en clair ne chiffrent pas en eux-mêmes les identifiants du proxy ni le tunnel client-proxy. MTProto protège séparément le trafic Telegram. Utilisez un canal sécurisé approprié vers le proxy sur un réseau non fiable. Les groupes privés sont des discussions cloud protégées par MTProto en transit ; les discussions secrètes de bout en bout constituent un type de discussion distinct, enregistré par le module Secret Chat.

Chiffrement et signatures#

Niveau Mis en œuvre Responsabilité de l'opérateur
Trafic Telegram Telethon MTProto Confiance, acheminement et disponibilité de la plateforme
Panneau web Jeton porteur, configuration par défaut en boucle fermée, limites de requêtes HTTPS ou tunnel SSH pour l'accès à distance
Secrets Fernet pour les identifiants API, les sessions, les identifiants de proxy et la clé privée de signature Protégez la clé de déchiffrement et l’hôte d’exécution
Clé de coffre-fort Clé locale ou clé principale externe pour une nouvelle installation Stockage sécurisé et sauvegarde des clés séparés
Messages et pièces jointes Stockage des données de l’application en texte clair Disque/volume chiffré
ZIP/JSONL/CSV/HTML Contrôles d’intégrité, aucun chiffrement du contenu Protégez les copies exportées et les transferts
Provenance et date Journal signé, accusé de réception, outils conformes à la norme RFC 3161 Clé de confiance, points de contrôle indépendants/TSA et procédure de conservation

La protection du stockage dans « Compte » affiche ces états. Le jeton du panneau est un secret d’accès, et non un mot de passe de chiffrement. Il accorde un accès administrateur ; les jetons émis peuvent être limités à des comptes et à des discussions. Les espaces de travail partagent le processus hôte et ne constituent pas des locataires isolés.

BitLocker, LUKS, FileVault ou un volume chiffré géré peuvent protéger le stockage dans le cadre de leurs modèles de menaces respectifs. L’administrateur d’une machine déverrouillée et en cours d’exécution peut toujours lire les données. Tenez compte des fichiers WAL/SHM de SQLite, des fichiers multimédias, des exportations temporaires, de l’espace d’échange, des sauvegardes et des téléchargements du navigateur dans la planification du stockage. Un volume Docker n’est pas chiffré simplement parce qu’il s’agit d’un volume.

Clé principale externe#

Pour une nouvelle installation, placez la clé principale en dehors du répertoire de données. Cela ne migre pas automatiquement un coffre-fort à clé locale existant. Préparez un répertoire de clés accessible uniquement à l’identité du service, puis exécutez :

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, en utilisant l’environnement de projet installé :

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

Dans Docker, montez le fichier en lecture seule en dehors de /data, par exemple sur /run/secrets/tgwitness-master.key, et définissez la variable d’environnement sur ce chemin d’accès. L’UID du service doit pouvoir y accéder en lecture. Transmettez le chemin d’accès, et non les octets de clé, via les fichiers d’environnement/de configuration.

Chaque espace de travail reçoit un « salt » public aléatoire et sa propre clé Fernet dérivée via HKDF-SHA256. vault.external.json stocke les métadonnées de dérivation, et non la clé principale. Une clé manquante ou erronée empêche le démarrage sans la remplacer silencieusement. Conservez à la fois les métadonnées du « salt » et la clé principale à des fins de récupération.

Tous les espaces de travail dérivent de la même clé principale ; sa compromission affecte l’ensemble de l’ installation. Le processus en cours d’exécution peut déchiffrer les secrets. Il ne s’agit ni d’un HSM ni d’un KDF de mot de passe. Les mots de passe humains arbitraires ne sont pas acceptés à la place d’une clé aléatoire.

Conservez la clé existante pour les installations actuelles jusqu’à ce qu’une migration délibérée soit mise en œuvre et vérifiée. La suppression de « vault.key » ou le remplacement d’une clé principale peut empêcher l’accès aux sessions et aux clés de signature. Conservez les sauvegardes chiffrées et les clés séparément et testez la restauration dans une instance isolée.