Référence / Configuration
Telegram · Formats des comptes et des sessions
Connectez-vous par téléphone, via un code QR ou une clé d'authentification, importez des sessions Telethon, Pyrogram ou Telegram Desktop, et gérez plusieurs comptes.
TgWitness / Documentation · Pour commencer
TgWitness se connecte en tant que compte utilisateur Telegram (et non en tant que bot) via MTProto, à l’aide de Telethon. Chaque compte dispose de son propre espace de travail (appelé « workspace » dans l’ API et les outils en ligne de commande) avec sa propre session, ses propres sources, son propre journal et sa propre clé de signature.
Les fichiers de session, les chaînes de session et les clés d’authentification constituent des autorisations de compte : toute personne qui en détient une peut agir au nom de ce compte. Ils ne contiennent pas l’historique des messages.
[!AVERTISSEMENT] Utilisez des comptes dédiés. Telegram restreint et peut bannir définitivement les comptes en cas de volumes de requêtes qu’il juge excessifs, quels que soient le client ou l’objectif, et ne documente ces limites que partiellement. Connectez des comptes destinés à l’observation plutôt que des comptes personnels ou ayant une valeur particulière, et créez un identifiant API / un hachage API sur un compte dédié.
- En bref
- Avant de commencer : identifiant API et hachage API
- Numéro de téléphone · Code QR · Clé d'authentification + identifiant DC
- Fichiers de compte: Telethon .session · Pyrogram .session · Paire session + JSON · TData · StringSession · Clé d’authentification et DC sur une seule ligne · Fichier JSON du compte
- Identifiez ce dont vous disposez · Formats non pris en charge
- Comptes multiples · Assurer la sécurité des fichiers de compte · Dépannage
En bref#
| Ce dont vous disposez | Onglet « Ajouter un compte » | Vous aurez également besoin de |
|---|---|---|
| Le numéro de téléphone et l'accès à ses codes de connexion | Téléphone | Mot de passe 2FA s'il est activé |
| Telegram ouvert sur un autre appareil | Code QR | Mot de passe 2FA s'il est activé |
Un fichier .session (Telethon ou Pyrogram) |
Fichiers | Fichier JSON complémentaire facultatif pour les paramètres de l’application |
.session + .json portant le même nom |
Fichiers (sélectionnez les deux) | Généralement, rien d’autre |
Un dossier « tdata » dans Telegram Desktop |
Fichiers (au format ZIP) | Le code d'accès local de l'application de bureau, s'il en a été défini un |
Une session StringSession de Telethon (texte, .txt, .tgwitness-session) |
Fichiers | Aucune paire d’API distincte n’est requise |
Une clé d’authentification et un DC sur une seule ligne : <512 hex>:<1–5> |
Fichiers (collage ou fichier texte) | Aucune paire d’API distincte n’est requise |
Un .json avec une session ou une clé d'authentification |
Fichiers | Aucune paire d’API distincte n’est requise |
| Une clé d'authentification (512 caractères hexadécimaux) et son numéro DC | Clé d'authentification | Identifiant utilisateur facultatif |
TgWitness identifie les fichiers en fonction de leur contenu, et non de leur nom. Le fait de renommer un fichier ne le convertit jamais.
Avant de commencer : identifiant API et hachage API#
Vous pouvez vous connecter sans créer d'application API Telegram. Lorsqu'aucune paire n'est saisie,
importée ou déjà enregistrée dans l'espace de travail, TgWitness sélectionne une paire parmi son pool intégré de
50 paires API publiques (tgwitness/api_pool.py), en privilégiant Telegram Desktop pour une nouvelle
connexion et en conservant en priorité une paire enregistrée ; les candidats restants sont mélangés au hasard. Si Telegram refuse une paire
(API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), la suivante est testée,
jusqu’à huit par connexion ; les paires refusées sont ignorées jusqu’au redémarrage. La paire ayant permis la connexion est
enregistrée avec le compte et réutilisée pour celui-ci.
Les paires intégrées sont publiques : elles sont publiées dans le code open source des clients
et des bibliothèques Telegram. Un identifiant API et un hachage API identifient l’application auprès de Telegram
et ne donnent aucun accès aux données du compte. La connexion utilise l’autorisation propre au compte : un code
de connexion et un mot de passe 2FA, ou une session déjà autorisée par ce compte. Chaque
observation.started enregistrement mentionne la paire utilisée ; ainsi, une paire intégrée est documentée pour
une procédure judiciaire de la même manière que la vôtre. Vous pouvez également saisir votre propre paire sur my.telegram.org.
D’après l’expérience du projet, une nouvelle paire personnelle entraîne la déconnexion de la plupart des comptes ; n’en utilisez donc une
que lorsqu’une affaire nécessite votre propre application : créez-la avec un compte dédié et
saisissez-la avant le début de la collecte (étapes ci-dessous).
Les champs de connexion manquants utilisent une paire appareil/système d'exploitation déterministe issue des catalogues
opentele2 2.0.0 fournis :
2040 (ordinateur de bureau), 6 (Android), 21724 (Android X), 10840 (iOS), 2834 (macOS) et 2496 (Web).
L'identifiant de compilation source d'Android 4 utilise également le catalogue Android, tel qu'identifié dans
les variables de compilation (BuildVars) de Telegram pour Android .
La valeur par défaut pour Web est A ; un suffixe de version d’application K ou un pack de langue macos importé sélectionne
K, et la version 0.7.0 sélectionne Webogram. Les identifiants d’application inconnus conservent les valeurs par défaut de l’hôte
de Telethon. Les champs importés prévalent toujours, y compris une version d’application plus ancienne et un
pack de langue vide. Le catalogue ne modifie jamais l’identifiant API/hachage. Son instantané de version est
vérifié explicitement, et non récupéré lors de la connexion. Un profil enregistré reste stable après les mises à jour.
account.getAuthorizations rend compte des métadonnées d’autorisation enregistrées par Telegram ; il ne s’agit
pas d’un simple écho de chaque nouveau initConnection. Comparez-le avec le profil réellement envoyé.
La connexion d’une autorisation existante ne valide pas le hachage API associé :
initConnection envoie l’ID API, tandis que le hachage est utilisé par les demandes de connexion.
Après une nouvelle autorisation par téléphone ou QR code, TgWitness demande la configuration, le centre de données le plus proche,
l’état de connexion, les langues (lorsque le pack de langues n’est pas vide), les mises à jour de l’application et
les mises à jour des conditions d’utilisation, avec un intervalle de 0.3 à 1.5 secondes entre chaque requête. La mise à jour du statut
marque brièvement le compte comme étant en ligne. Cette séquence s’exécute une seule fois à la fin de la connexion,
et non lors d’importations, de reconnexions ou de redémarrages. L’autorisation est enregistrée en premier ; une requête
échouée interrompt la séquence sans nouvelle tentative ni annulation de la connexion. Les résultats sont
enregistrés sous la forme account.initialized, avec les noms d’erreur plutôt que le corps des réponses.
Ce sont les politiques propres à Telegram qui déterminent les restrictions du compte.
Pour tdesktop
, en l'absence de tz_offset
, le décalage UTC local du serveur est utilisé, arrondi
à 900
secondes à l'aide de l'algorithme
opentele2
(MIT ; licence en tgwitness/client_profiles.LICENSE
). Il est actualisé à chaque
connexion afin de refléter les changements liés à l'heure d'été. Un tz_offset
importé prévaut sur toutes les plateformes et est conservé tel quel, y compris s’il est égal à zéro. Les autres entrées
initConnection.params
sont conservées.
Le formulaire de connexion HTTP accepte le fuseau horaire numérique renvoyé par l’importation de fichier ;
les valeurs booléennes, les fractions et les décalages hors de la plage prise en charge sont rejetés.
Les routes directes, SOCKS5 et HTTP CONNECT utilisent le protocole ConnectionTcpObfuscated
de Telethon (MTProto abrégé et obscurci). HTTPS CONNECT conserve le protocole TLS jusqu’au proxy et utilise
le même transport obscurci à l’intérieur du tunnel. MTProxy conserve son
transport intermédiaire aléatoire obligatoire et sa gestion des secrets. Les changements de route appliquent les
mêmes choix. L’obscurcissement modifie le formatage des paquets ; il ne masque pas le compte
ni ses métadonnées client vis-à-vis de Telegram et n’implique pas d’immunité face aux restrictions.
Une fois un client autorisé connecté, TgWitness vérifie la configuration, le centre de données le plus proche,
l'autorisation en cours, la référence de couche validée, les langues, les mises à jour des applications
et les mises à jour des conditions d'utilisation. Ces diagnostics s’exécutent une fois par instance de client,
avant la collecte, et s’affichent dans les détails de la connexion avec leur heure. La clé
account.connection_checked enregistre le résultat sans hachages de session, adresses IP,
jetons ni hachages d’API. Ces diagnostics n’acceptent jamais les conditions d’utilisation ni n’installent de mises à jour. Un échec de requête
ou un « FloodWait » interrompt les requêtes suivantes ; un résultat manquant reste inconnu.
Les vérifications locales peuvent toujours signaler leurs résultats tandis que les vérifications réseau sont ignorées.
Lorsque l’option Chats sélectionnés strictement est activée, l’
autorisation actuelle n’est pas demandée et cette vérification est indiquée comme ignorée.
Après la connexion et à chaque nouvelle connexion, TgWitness lit le paramètre de contenu sensible
du compte. Lorsqu’il est désactivé et que Telegram autorise la modification, TgWitness l’active
afin que le contenu que Telegram marque comme sensible (18+) soit enregistré, et enregistre la variable
account.content_settings. Ce paramètre appartient au compte et s’applique dans toutes les
applications Telegram. Le mode « Discussions sélectionnées » ne le modifie pas ; activez-le avant de vous connecter.
Les requêtes simultanées visant à rétablir la connexion d'un espace de travail partagent le même client et attendent que l'établissement de la connexion soit terminé. Une tentative ayant échoué ou ayant été annulée libère la requête suivante, qui peut alors réessayer. Si les identifiants enregistrés, le client ou l'état d'autorisation changent pendant l'établissement de la connexion, la tentative la plus ancienne s'arrête au lieu de signaler que la connexion est prête.
Les diagnostics FloodWait conservent la méthode TL ayant échoué, les éventuels wrappers Takeout/range,
l'attente demandée par le serveur et le délai effectif dans telegram.backoff.
Les détails de connexion indiquent la méthode et le délai lorsque les requêtes sont mises en pause.
Le diagnostic inclut les compteurs d’appels client par méthode depuis la
création de ce client ; ils comptabilisent séparément la résolution des pairs imbriqués, mais ne comptent pas les paquets
ni les tentatives de réessai internes de Telethon. Les compteurs actuels sont également disponibles sous le nom d’
collector.rpc_activitydans l’API d’état. Aucun argument de requête, nom d’utilisateur,
hachage d’accès ou texte d’exception n’est inclus. Le dernier diagnostic et le délai complet
sont conservés après un redémarrage. Les attentes antérieures sans enregistrement de méthode ne peuvent pas être attribuées
rétroactivement. Voir : limites d’exportation pour l’examen du code source et
la distinction entre la découverte et l’acquisition de l’historique.
official_app=True ou False est l'indicateur d'autorisation actuelle de Telegram. Aucune de ces
valeurs ne permet de déterminer si le compte est restreint, de confiance ou sous observation.
Les instantanés account.devices existants en mode preuves conservent l'historique de tous les
appareils connectés ; les diagnostics de connexion ne conservent que la description de l'appareil actuel.
Avant la connexion, des contrôles préventifs comparent la plateforme API, le pack linguistique, les formats de l’appareil/du système d’exploitation et de la version de l’application, les paramètres régionaux du système mobile, ainsi que la couche de schéma réelle de Telethon à la référence du catalogue vérifiée. Les avertissements apparaissent dans le journal du serveur et dans les métadonnées de l’état du compte ; ils ne remplacent jamais les valeurs importées ni ne modifient la couche de schéma. Une couche différente est un signal indiquant qu’il faut vérifier la compatibilité ; l’état de connexion du compte lui-même indique si cela fonctionne. Telegram décide des restrictions de son côté, quel que soit le profil client utilisé. Le statut de compte déconnecté utilise le profil enregistré au lieu de générer une autre description de l'appareil.
Pour utiliser votre propre application à la place :
- Ouvrez my.telegram.org et connectez-vous avec n'importe quel numéro de téléphone dont vous disposez. Le code vous est envoyé dans l'application Telegram, et non par SMS.
- Choisissez des outils de développement d'API.
- Créer une application : titre et nom court au choix (5 à 32 lettres), plateforme « Desktop ». Les champs « URL » et « Description » peuvent rester vides.
- Copiez l’api_id de l’application (un nombre) et l’api_hash de l’application (32 caractères hexadécimaux).
Dans le panneau, les champs « API ID » et « Hash » se trouvent sous le formulaire de connexion. Vous pouvez coller une seule
paire api_id:api_hash dans le champ « API ID » : les deux champs seront alors automatiquement remplis. Une seule paire peut être
utilisée pour tous vos comptes. Une fois la connexion établie, ces informations sont enregistrées, chiffrées, dans
cet espace de travail uniquement et ne sont jamais renvoyées au navigateur.
Trois types d’informations d’identification sont concernés :
| Secret | Ouvrir | Où le trouver |
|---|---|---|
| Jeton de panel | Le panneau web de TgWitness | panel-token.txt dans le répertoire de données, ou TGWITNESS_TOKEN |
| ID de l'API + hachage | Rien en soi ; identifie l’application | Appariement intégré, paramètres importés ou votre propre application sur my.telegram.org |
| Autorisation du compte | Le compte Telegram | Créé via une connexion par téléphone ou code QR, ou importé en tant que session |
Si Telegram doit être accessible via un proxy, configurez-le d’abord dans Plus d’outils → Compte → Paramètres → Paramètres de connexion → Modifier l’itinéraire de connexion.
Numéro de téléphone#
- Ouvrez Plus d’outils → Compte, onglet Téléphone, puis saisissez le numéro au format international,
par exemple
+44 7700 900123. Les espaces et les tirets sont supprimés automatiquement. - Cliquez sur « Continuer ». Les champs « API ID » et « Hash » peuvent rester vides.
- Saisissez le code envoyé par Telegram, généralement via l’application Telegram ; c’est Telegram qui décide s’il faut envoyer un SMS.
- Si le compte dispose d’une authentification en deux étapes, saisissez ce mot de passe. Il ne s’agit ni du jeton du panneau ni du code d’accès de l’appareil.
- Vérifiez l'identifiant du compte affiché après la connexion, puis sélectionnez les sources.
Les identifiants de connexion et le mot de passe 2FA ne sont jamais enregistrés sur le disque.
Code QR#
Utilisez cette fonction lorsque le compte est déjà connecté sur un téléphone ou un autre ordinateur.
- Onglet « Code QR » → Afficher le code QR. Les champs « ID API » et « Hachage » peuvent rester vides.
- Sur l’appareil connecté : Paramètres → Appareils → Associer un appareil de bureau, scannez le code puis confirmez.
- Saisissez le mot de passe 2FA dans TgWitness si Telegram vous le demande.
L'image QR est générée localement. Les codes ont une durée de validité limitée ; cliquez sur « Générer un autre code QR » pour réessayer. Le verrouillage du panneau, le changement d'espace de travail ou le lancement d'une nouvelle session annulent un code en attente.
Clé d'authentification + identifiant DC#
Une clé d'autorisation (Auth Key) est la clé d'autorisation brute de 256 octets qui sous-tend chaque session Telegram, représentée sous la forme de 512 caractères hexadécimaux, accompagnée du numéro du centre de données DC 1 à 5.
- Onglet « Clé d'authentification ». Collez la clé complète ; une clé raccourcie contenant «
…» ne fonctionnera pas. - Sélectionnez l'identifiant DC fourni avec la clé.
- Vous pouvez, si vous le souhaitez, saisir l’identifiant utilisateur. TgWitness refuse alors la connexion si Telegram signale un compte différent.
- Compte Press Connect.
Une clé d'authentification (512 caractères) n'est pas un hachage API (32 caractères). La même clé peut également être importée au format JSON ; voir « Account JSON ».
Fichiers de compte#
Ouvrez Ajouter un compte → Fichiers et sélectionnez jusqu’à quatre fichiers appartenant à un même compte, pour un total de 8 Mio, cliquez sur Vérifier les fichiers, puis sur Connecter le compte. La sélection de fichiers ou le collage du texte de la session n’entraîne l’envoi d’aucune donnée ; la commande Vérifier les fichiers les envoie à votre serveur TgWitness, qui les lit sans connexion et affiche la session qu’il a trouvée.
Les formulaires Fichiers, Clé d'authentification et d'importation en masse affichent l'avertissement de session parallèle avant la connexion. Par défaut, les autorisations importées sont réutilisées. Gardez le client d'origine fermé tant que sa clé est utilisée ici. Fichiers et Clé d'authentification proposent également Créer une autorisation indépendante, décrite ci-dessous. L'importation en masse utilise toujours le mode direct. La connexion par téléphone et par QR code interactif crée des autorisations distinctes. L'en-tête d'avertissement reste visible dans le formulaire d'importation ; son explication complète s'ouvre automatiquement lorsque des fichiers ou une chaîne de clé/session sont fournis. Il peut être masqué après lecture, afin que le sélecteur de fichiers et les commandes de connexion restent utilisables sur un téléphone.
Un déploiement certifié (Phala Cloud, Intel TDX) ne prend pas en charge les clés importées. Dans ce cas, les clés Fichiers et Auth ne fonctionnent que si l’option Créer une autorisation indépendante est sélectionnée ; l’importation en masse est refusée. La connexion par téléphone et par code QR fonctionne normalement.
- Les fichiers sont convertis en mémoire sur votre serveur TgWitness. Les fichiers téléchargés ne sont pas stockés, les fichiers ZIP ne sont pas extraits sur le disque et aucun service externe n’est sollicité.
- La session ainsi obtenue est ensuite vérifiée auprès de Telegram. Si un fichier mentionne un identifiant d’utilisateur, celui-ci doit correspondre au compte indiqué par Telegram.
- Les fichiers décrivant différents comptes ou différents identifiants API sont rejetés au lieu d’en choisir un seul.
- Le champ Code d'accès ou texte de session contient le champ de code d'accès local TData, une zone permettant de coller une StringSession et de lire des fichiers sans se connecter (remplit le formulaire sans contacter Telegram). Le collage d’une StringSession efface les fichiers sélectionnés, et la sélection de fichiers efface le texte collé ; ainsi, la vérification et la connexion utilisent le dernier choix. Après un changement de code d’accès, appuyez à nouveau sur Vérifier les fichiers.
Créer une autorisation indépendante#
Sélectionnez Créer une autorisation indépendante avant de connecter des fichiers importés ou une clé d’authentification. TgWitness connecte brièvement le donneur importé, l’utilise pour approuver le jeton de connexion QR du nouveau client, puis déconnecte le donneur immédiatement après l’approbation. Le nouveau client dispose de sa propre clé d’autorisation et d’un profil de bureau sélectionné séparément. Les identifiants API et le profil d’appareil fournis par le donneur ne sont utilisés que pour la connexion du donneur. Aucune autorisation existante n’est déconnectée ni révoquée.
Veillez à ce que le client d'origine du donateur reste complètement fermé pendant cette étape. La connexion initiale utilise toujours sa clé copiée ; ce mode ne permet donc pas d'éliminer ce risque initial d'utilisation parallèle. Une fois la nouvelle autorisation établie, le propriétaire peut rouvrir le client d'origine et utiliser les deux simultanément. La connexion interactive par code QR permet au client d’origine d’approuver la connexion sans copier ni connecter sa clé à ce stade.
Ne vous déconnectez pas et ne mettez pas fin à la session du donateur. Lorsque la session ayant approuvé une connexion via QR
prend fin, Telegram met également fin à la session qu’il a approuvée ; lors d’un test en conditions réelles, la nouvelle
autorisation a cessé de fonctionner moins d’une seconde après la déconnexion du donateur. L’importation enregistre
les informations relatives à la session du donateur (session_origin.approved_by : appareil, identifiant API et heure de création).
La liste des sessions la marque, Terminer la session la rejette, tandis que Terminer toutes les autres sessions
et Faire de celle-ci la seule session la laissent connectée.
Si Telegram demande une authentification à deux facteurs (2FA), ce mode utilise twoFA les données du fichier JSON sélectionné lorsqu’il est présent,
ou demande le mot de passe. Si un mot de passe importé est rejeté, le système revient au formulaire de saisie du mot de passe.
Les mots de passe ne sont pas enregistrés. La clé candidate est enregistrée sous forme chiffrée dans
independent_login.enc, y compris les modifications effectuées lors de la migration du centre de données. Après une
interruption, sélectionnez le même donneur et cette option pour reprendre la clé candidate enregistrée.
Le donneur est vérifié help.getAppConfig avant l’approbation ; un compte gelé
s’arrête à cette étape. Si Telegram refuse le donneur avant d’approuver la connexion, la
clé candidate non approuvée est écartée et l’importation peut recommencer. Un autre donneur ne remplace une
clé candidate enregistrée que lorsque Telegram signale que cette clé candidate n’est pas connectée ; une
clé candidate connectée ou en attente de son mot de passe d’authentification à deux facteurs est conservée.
L’espace de travail reste réservé à ce compte ; un échec de finalisation ne supprime pas
le nouvel espace de travail. Conservez son répertoire de données et sa clé de coffre-fort. Les identifiants finaux et l’
account.authorized l’entrée du journal indiquent la méthode d’importation, les formats d’entrée et l’
identifiant API du donneur, sans la clé ni le mot de passe du donneur.
Le 5 novembre 2026, un compte dédié a passé avec succès des tests en conditions réelles avec les donateurs Telethon, Pyrogram et TData : achèvement de l’authentification à 2 facteurs (2FA), nouvelles clés d’autorisation distinctes, accès simultané par le donateur et un nouveau client, et lecture d’un canal public. Le cas Téléthon a également permis de reprendre un candidat enregistré après une interruption à l’étape du mot de passe. Chaque nouvelle autorisation a permis de mener à bien les six requêtes d’initialisation post-connexion, et son journal signé a été vérifié. La session d’origine est restée utilisable dans les quatre formats fournis.
La base de données des erreurs RPC de Telegram associe
FRESH_CHANGE_ADMINS_FORBIDDEN au changement d’administrateur, FRESH_CHANGE_PHONE_FORBIDDEN
au changement de numéro de téléphone et FRESH_RESET_AUTHORISATION_FORBIDDEN à la
révocation d’autres sessions, à la modification de leur durée de vie ou à l’enregistrement d’une clé d’accès.
SESSION_TOO_FRESH_* et PASSWORD_TOO_FRESH_* concernent les transferts de propriété et les
retraits de revenus ou de cadeaux. Il ne s’agit pas d’opérations de collecte ; une nouvelle connexion n’
implique pas une interdiction générale de lecture de 24 heures. L’exportation peut renvoyer
TAKEOUT_INIT_DELAY_* séparément. TgWitness conserve les pauses demandées par le serveur et ne tente pas
automatiquement de faire accepter à nouveau le jeton ni de révoquer des sessions pour contourner les restrictions.
Plus d'outils → Compte → Sécurité du compte → Sessions de ce compte → Mettre fin à toutes les autres sessions : appelle la méthode `auth.resetAuthorizations` à la
demande de l'opérateur et enregistre `account.all_other_sessions_terminated` avec le nombre de sessions
avant et après. Telegram l'accepte à partir d'une session connectée depuis 24 heures.
Lorsque cet espace de travail est connecté via un code QR à partir d’une session importée, la session qui l’a approuvée
reste connectée : TgWitness met fin aux autres une par une à l’aide de `account.resetAuthorization` et
enregistre `kept_approving_session`. Il fait de celle-ci la seule session, puis s’arrête pour cette raison
et ne modifie pas le mot de passe.
Faites en sorte que cette session soit la seule à procéder ainsi pour une clé créée lors de la connexion à cet espace de travail, puis activez une authentification en deux étapes si le compte n’en dispose pas. Le panneau affiche ce mot de passe une seule fois ; TgWitness ne le conserve dans le coffre-fort de l’espace de travail que jusqu’à ce moment-là. Le journal enregistre session.exclusive_from. Si Telegram répertorie ultérieurement une autre session, le journal l’enregistre session.exclusive_ended et le panneau déclenche une alerte. Le vérificateur affiche les deux.
Faire de cette session la seule autorisée par Telegram revient à effectuer la même action selon un délai. L’
option apparaît sous Sessions de ce compte pour une clé créée dans cet espace de travail et est
enregistrée sous la forme session.exclusive_automatic. Pendant l’observation, le collecteur vérifie toutes les cinq
minutes si 24 heures se sont écoulées depuis l’enregistrement account.authorized de cette clé —
Telegram répond FRESH_RESET_AUTHORISATION_FORBIDDEN avant cela — puis exécute la même
opération une seule fois. La réussite est enregistrée sous la forme session.exclusive_from, comme pour le bouton manuel.
Un refus est enregistré une seule fois sous la forme session.exclusive_postponed avec le motif fourni par Telegram, et le
collecteur effectue une nouvelle tentative avec un délai croissant pouvant aller jusqu’à six heures. Le mode lecture seule n’a aucun effet ici :
la fin des sessions est une action liée à la sécurité du compte, et non une action liée à la conversation.
Un mot de passe en deux étapes généré par l’exécution automatique est enregistré dans le coffre-fort de l’espace de travail, chiffré à l’aide de la clé de l’espace de travail, avant que Telegram ne le définisse. Le panneau le récupère une seule fois à partir de POST /api/account/sessions/only/password, qui le supprime ensuite, puis l’affiche dans la même boîte de dialogue que le flux manuel lorsque vous ouvrez les sessions de ce compte. La page de connexion indique qu’un mot de passe est en attente. Il n’est jamais consigné dans le journal et subsiste après un redémarrage jusqu’à ce qu’il ait été affiché.
De nouvelles sessions sont également signalées pendant l’observation : lorsque la liste des sessions de Telegram s’enrichit d’une entrée,
l’enregistrement account.sessions la répertorie sous added et le panneau déclenche une alerte indiquant l’
appareil, l’application et le pays issus de cet instantané.
Sonde de témoin#
Plus d’outils → Compte → Sécurité du compte → La sonde Witness vérifie si un autre client reçoit les mises à jour de ce compte. Ajoutez un deuxième espace de travail connecté avec un compte Telegram différent et sa propre clé de session, créez un groupe privé avec les deux comptes, puis choisissez ce groupe comme Chat de sonde et le deuxième espace de travail comme Espace de travail témoin, puis activez la sonde. Les deux comptes doivent avoir l’option Lecture seule désactivée, et l’espace de travail témoin doit être en mode d’observation.
Pendant l’observation, cet espace de travail envoie probe:<n>:<token> au groupe toutes les 60 à 120 secondes
et enregistre probe.sent. Le témoin répond ack:<n>:<token> et enregistre probe.seen et
probe.ack_sent. Un accusé de réception (ack) qui parvient à cette session sous forme de mise à jour en temps réel dans les 20 secondes est
enregistré comme probe.acked. Sinon, l’espace de travail lit l’historique récent du groupe. Un accusé de réception
trouvé à cet endroit mais non transmis en temps réel est enregistré sous la forme coverage.gap avec la raison
probe_ack_missed_live : le panneau déclenche une alerte et marque la réception de l’événement comme ayant échoué jusqu’à ce qu’un
accusé de réception ultérieur arrive en temps réel (connection.restored, raison probe_ack_live). Aucun accusé de réception n’est enregistré sous la forme
probe.unanswered ; une interruption de connexion pendant l’attente ou un historique illisible est enregistré sous la forme
probe.inconclusive. Les restrictions en lecture seule, les restrictions Telegram et les pauses FloodWait sont enregistrées une seule fois
sous la forme probe.skipped.
Téléthon .session#
| De quoi s’agit-il ? | La base de données SQLite créée par les outils basés sur Telethon, par exemple my_account.session |
| Reconnu par | Tableaux sessions (avec dc_id, server_address, port, auth_key) et version = 7 ou 8 |
| Exigences | Exactement une ligne de session autorisée ; une base de données fermée et complète |
Fermez d’abord le programme qui a créé le fichier. Si my_account.session-journal ou
my_account.session-wal se trouve à côté, la base de données n’est pas finalisée : ouvrez puis
fermez correctement le client d’origine. La suppression de ces fichiers « sidecar » peut laisser une copie corrompue.
Pyrogram .session#
| De quoi s’agit-il ? | La base de données SQLite que les outils basés sur Pyrogram créent |
| Reconnu par | Tableau sessions avec dc_id, auth_key, test_mode, user_id, is_bot ; version = 2 ou 3 |
| Exigences | Une seule session d'utilisateur autorisée sur le réseau de production. Les sessions des bots et des centres de données de test sont rejetées. |
L'identifiant utilisateur enregistré est vérifié auprès de Telegram lors de la connexion.
Paire session + JSON#
Les comptes sont souvent distribués sous la forme de deux fichiers portant le même nom, par exemple
447700900123.session et 447700900123.json. Sélectionnez-les tous les deux en même temps.
- À partir du fichier JSON, TgWitness utilise
app_id/api_idetapp_hash/api_hash; vous n’avez donc généralement pas besoin de saisir d’identifiants d’API. - Le profil de connexion utilise
device_model(aliasdevice),system_version(aliassdk),app_version,lang_code,system_lang_code(aliassystem_lang_pack),lang_packettz_offset(facultatif) (secondes par rapport à l'UTC, de -43200 à 50400). Les champs fournis ont priorité sur les valeurs par défaut générées et sur la langue du panneau/navigateur . Les alias en conflit sont rejetés. Le profil résolu est enregistré dans les identifiants chiffrés de l'espace de travail et réutilisé après le redémarrage, y compris sa version d'application. phone, les paramètres de proxy et les jetons d'appareil sont ignorés.twoFAest en lecture seule lorsque Créer une autorisation indépendante est sélectionné ; l'importation directe l'ignore.- Un fichier JSON ne comportant pas de champ d’autorisation pris en charge ne contient que des métadonnées. Ajoutez son fichier de session ou poursuivez avec une connexion par téléphone ou via un code QR. Un fichier JSON contenant une session prise en charge ou une clé d’authentification (Auth Key) peut autoriser l’accès à lui seul ; voir Account JSON.
Telegram Desktop (TData)#
TData correspond au dossier « tdata » de l’application Telegram Desktop (l’application multiplateforme
disponible sur desktop.telegram.org).
| Système | Emplacement par défaut : tdata |
|---|---|
| Windows | %APPDATA%\Telegram Desktop\tdata (Telegram portable : à côté de Telegram.exe) |
| Linux | ~/.local/share/TelegramDesktop/tdata |
| macOS | ~/Library/Application Support/Telegram Desktop/tdata |
Pour l'importer :
Avertissement concernant les sessions parallèles. L'importation directe de TData réutilise la clé d'autorisation de Telegram Desktop. N'utilisez pas cette clé simultanément dans Desktop et TgWitness. Telegram peut invalider l'autorisation avec
AUTH_KEY_DUPLICATED, rendant les deux copies inutilisables jusqu'à une nouvelle connexion.Fermez complètement Desktop, y compris son processus dans la barre d’état, et gardez cette instance fermée pendant que TgWitness utilise la session importée. : Quittez, ne vous déconnectez pas et ne révoquez pas la session : la révocation invalide également la copie importée. Si vous avez besoin que les deux clients fonctionnent, sélectionnez Créer une autorisation indépendante et gardez Desktop fermé jusqu’à ce que la nouvelle connexion aboutisse, ou connectez-vous à TgWitness par téléphone ou via un QR code. Un compte dédié est recommandé, mais cela ne garantit pas la sécurité de l’utilisation parallèle des clés clonées.
Cela s'applique également aux fichiers
.sessionimportés, au texte StringSession et à la clé d'authentification au format HEX. Les autres clients disposant de leurs propres autorisations créées de manière indépendante peuvent rester connectés. Consultez la documentation de Telegram relative à AUTH_KEY_DUPLICATED.
- Quittez complètement Telegram Desktop.
-
Créez un fichier ZIP ne contenant que ces deux éléments provenant de
tdata:key_datas- le fichier de 16 caractères se terminant par «
s» situé à côté, généralement «D877F783D5D3EF8Cs»
La compression de l’intégralité du dossier avec son cache multimédia dépasse généralement les limites (512 entrées, 32 Mio décompressés). 3. Sélectionnez le fichier ZIP dans « Fichiers ». Si Telegram Desktop dispose d’un code d’accès local, saisissez-le d’abord dans le champ « Code d’accès » ou « Texte de session ». Il ne s’agit pas du mot de passe 2FA.
Prise en charge : un compte par archive, stockage moderne key_datas/key_data0/key_data1,
code d'accès local. Non pris en charge : les dossiers contenant plusieurs comptes connectés, les anciennes
versions de la version de bureau, les fichiers ZIP protégés par mot de passe et l'application native distincte pour macOS « Telegram for macOS ».
Telethon StringSession#
Une seule ligne de texte, commençant généralement par « 1 » et comptant environ 350 caractères. Importez-la
sous forme de fichier « .txt » ou « .tgwitness-session » (4 Ko maximum), ou collez-la dans le champ
« Code d'accès » ou « Texte de session ». Seules les chaînes Telethon sont acceptées ; les chaînes Pyrogram et TDLib
utilisent des formats différents.
Clé d’authentification et DC sur une seule ligne#
Les listes de comptes comportent souvent l’autorisation brute sous la forme <512 hexadecimal characters>:<DC id>,
par exemple a1b2…ef:5. Collez cette ligne sous Code d’accès ou Texte de session, chargez-la en tant que
fichier texte, ou placez-la dans le champ session d’un JSON de compte. TgWitness
associe les DC 1 à 5 aux mêmes adresses de production que l’importation JSON auth_key + dc_id et
signale le format comme Clé d’authentification HEX et DC. Tout autre numéro de DC ou toute autre longueur de clé est rejeté.
Fichier JSON du compte#
Un objet JSON, d'une taille maximale de 64 KiB, dans un fichier se terminant par .json.
| Champ (alias) | Signification |
|---|---|
api_id (app_id) |
ID de l'application, un nombre positif |
api_hash (app_hash) |
Hachage de l'application, 32 caractères hexadécimaux |
string_session (session_string, session_str ; ancien session) |
Texte Telethon StringSession, ou <512 hexadecimal characters>:<DC id>, et non un nom de fichier |
auth_key (auth_key_hex) + dc_id |
Clé d'authentification complète de 512 caractères et DC 1 à 5 |
user_id (id) |
Facultatif ; vérification effectuée par rapport à Telegram avant l'enregistrement de l'autorisation |
device_model (device) |
Description du dispositif de connexion |
system_version (sdk) |
Version du système d'exploitation de connexion |
app_version |
Version de l'application envoyée à Telegram |
lang_code, system_lang_code (system_lang_pack), lang_pack |
Langue du client, langue du système et pack linguistique du client ; un champ lang_pack vide est autorisé |
tz_offset |
Décalage UTC facultatif en secondes, envoyé dans initConnection.params ; chaîne de caractères entière ou décimale |
Si un alias et le nom principal sont tous deux présents, ils doivent correspondre. Les champs de session Telethon
explicites ont priorité sur un blob session générique dans un autre format. Si
les deux contiennent des sessions Telethon reconnaissables, elles doivent décrire la même autorisation.
En l’absence de champ explicite, session doit être une StringSession Telethon valide ou une clé d’authentification
et un DC sous la forme <512 hexadecimal characters>:<DC id>. Exemples :
{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }
{
"api_id": 1234567,
"api_hash": "0123456789abcdef0123456789abcdef",
"auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
"dc_id": 2,
"user_id": 123456789
}
Le premier exemple ne concerne que la saisie des identifiants API ; connectez-vous par téléphone ou via un code QR, ou ajoutez un fichier de session. Les listes groupées (un tableau JSON de comptes) ne sont pas acceptées.
Identifiez ce dont vous disposez#
| Vous voyez | Il s'agit de | Utilisation |
|---|---|---|
*.session ; lorsque vous l'ouvrez dans un éditeur de texte, « SQLite format 3 » s'affiche en haut de la page |
Telethon ou Pyrogram SQLite | Fichiers (détectés automatiquement) |
Un dossier « tdata » contenant « key_datas » |
Telegram Desktop TData | Compressez les deux fichiers au format ZIP, puis « Fichiers » |
Une ligne de texte commençant par 1, environ 350 caractères |
Telethon StringSession | Fichiers |
Une ligne de texte 512 characters 0-9a-f, suivie de : et d’un chiffre compris entre 1 et 5 |
Clé d’authentification et DC | Fichiers, code d’accès à la boîte ou texte de session |
*.json avec app_id/app_hash |
Métadonnées associées | Fichiers, ainsi que la session correspondante |
*.json avec auth_key ou string_session |
Fichier JSON du compte | Fichiers |
512 caractères 0-9a-f |
Clé d'authentification | Clé d'authentification |
32 caractères 0-9a-f |
Hachage de l'API | ID API + hachage |
td.binlog ou db.sqlite provenant d’une application TDLib |
Stockage TDLib | Non pris en charge |
123456789:AA… |
Jeton du bot | Non pris en charge |
Formats non pris en charge#
| Format | Alternative |
|---|---|
Stockage TDLib (td.binlog) et exportations TDLib |
Connectez-vous par téléphone ou via un code QR |
| Chaînes de session Pyrogram | Utilisez le fichier Pyrogram .session, ou le code QR/le numéro de téléphone |
| TData avec plusieurs comptes connectés | Déconnectez-vous des autres comptes dans Telegram Desktop, ou utilisez le fichier de session propre à chaque compte |
| Jetons de bot | Non pris en charge : TgWitness observe en tant que compte utilisateur |
| Listes au format CSV/JSON de nombreux comptes | Importez les fichiers de session pris en charge via Comptes → Importer des comptes, ou connectez-vous par téléphone/QR dans des espaces de travail distincts |
| Sessions de test sur DC ou via un bot | Utilisez un compte utilisateur de production |
Comptes multiples#
Appuyez sur le signe + à côté du sélecteur de compte, ou ouvrez Plus d’outils → Compte → Paramètres → Paramètres de connexion → Espaces de travail, saisissez un libellé et connectez-vous.
- N’importe quel nombre d’espaces de travail, y compris l’espace principal. Chacun dispose de sa propre session, de son itinéraire de proxy, de ses sources, de sa politique de capture, de son journal, de sa clé de signature, de ses points de contrôle et de ses exportations.
- Le fait de changer d'espace de travail affiché ne met pas les autres en pause.
- Un journal reste lié au compte qui l’a créé. Se connecter avec un autre compte nécessite un autre espace de travail, et un même compte ne peut pas être attribué à deux espaces de travail.
- Le jeton du panneau principal contrôle l’ensemble des espaces de travail. Les droits d’accès accordés permettent de limiter l’accès d’autres personnes à certains comptes et discussions, avec des autorisations distinctes et des limites de session.
- La fonction « Comptes » permet de renommer un espace de travail et d’en supprimer un ajouté, avec sa session, son journal, ses sources et sa clé de signature. L’espace de travail principal ne peut pas être supprimé depuis le panneau.
Importation par lots et groupes de comptes#
Utilisez Comptes → Importer des comptes pour ajouter plusieurs comptes, associer des fichiers par nom de base et consulter le résultat de chaque connexion. Chaque compte dispose de son propre espace de travail.
Un groupe regroupe des comptes liés sans fusionner leurs sessions, leurs clés ou leurs
preuves. Ouvrir le groupe sur Comptes mène à sa page à l'adresse /groups/<id>:
- Comptes: itinéraire de connexion, observation et dernier message de chaque membre, avec les boutons « Tout démarrer » et « Tout mettre en pause ».
- Nécessite une attention: les comptes dont la session a été déconnectée, qui sont indisponibles ou qui présentent un problème de connexion, d’acquisition, de source ou de média ; chaque nom renvoie vers sa fiche.
- Les discussions impliquant plusieurs comptes permettent de visualiser : les sources partagées, les comptes qui les surveillent et les interruptions dans la période d’observation de l’espace de travail disponible (jusqu’à sept jours). L’exportation avec N comptes répartit l’exportation d’un canal ou d’un supergroupe entre eux et signe une seule archive.
- Exporter le groupe: une image ZIP contenant l’exportation signée de chaque compte sous
accounts/etmanifest.jsonrépertoriant leurs SHA-256 et leurs empreintes de clé, signées par l’ espace de travail principal dansmanifest.signature.json. Vérifiez chaque archive de compte individuellement à l’aide depython -m tgwitness.verifyet l’empreinte digitale de confiance de ce compte.
Les membres partagent les paramètres du groupe ; un compte peut conserver ses propres valeurs. Consultez la section sur les paramètres partagés, le guide d'importation et des groupes ainsi que le tableau de bord du pool MTProxy.
Se déconnecter#
Autres outils → Compte → Se déconnecter de Telegram (avec l’observation en pause) demande à Telegram de mettre fin à la session ; celle-ci disparaît donc également de la section Paramètres → Appareils du compte, et la session est supprimée du coffre-fort de l’espace de travail. Le journal, les sources, les paramètres et la clé de signature sont conservés, et le journal enregistre la déconnexion. L’espace de travail appartient toujours à son compte : seul ce compte peut s’y reconnecter. Si Telegram ne répond pas, la session est tout de même supprimée ici et le panneau l’indique ; mettez-y fin dans Telegram sous Paramètres → Appareils.
Lorsque Telegram met fin à la session#
Si Telegram bloque, gèle ou déconnecte le compte, ou met fin à la session depuis un autre appareil, le
journal enregistre la cause, l’erreur Telegram, l’itinéraire et le centre de données. L’état du compte
indique : « Télécharger le rapport de perte de compte » : un fichier JSON signé contenant les enregistrements du journal
des 24 heures précédant la perte, à savoir les connexions, les itinéraires, les sessions, les notifications du compte et les
lacunes de couverture, chacun avec son hachage de journal et sa signature. Vérifiez-le à l’aide de
python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP; l’exportation des preuves
contient la chaîne de hachages complète. Un compte gelé est également détecté lorsqu’il se connecte et pendant la surveillance, et ses
actions d’envoi et de participation sont désactivées.
Assurer la sécurité des fichiers de compte#
- Traitez chaque
.session, fichier ZIP TData, StringSession, clé d’authentification et fichier JSON de compte comme un mot de passe. TgWitness conserve les informations d’autorisation importées dans son coffre-fort chiffré ; vous pouvez supprimer les fichiers d’origine par la suite. - N’exécutez pas la même autorisation dans deux programmes à la fois. Telegram pourrait la révoquer
(
AUTH_KEY_DUPLICATED), et les deux instances cesseraient alors de fonctionner. - Une session expirée ou révoquée ne peut pas être réactivée par conversion. Veuillez vous reconnecter.
Dépannage#
| Message ou symptôme | Que faire ? |
|---|---|
| Impossible de lire cette session. Fermez son client d'origine… | Le fichier SQLite est ouvert ou inachevé (fichier sidecar -journal/-wal). Fermez correctement le programme d'origine et recopiez le fichier. |
| Schémas SQLite Telethon pris en charge : 7 et 8 / Pyrogram… 2 et 3 | Ce fichier a été créé à l'aide d'une version très ancienne ou inconnue de la bibliothèque. Veuillez vous connecter par téléphone ou via un code QR à la place. |
| Seules les sessions d'utilisateurs autorisées en production sont prises en charge | Le fichier Pyrogram appartient à un bot ou au réseau de test. |
| L'archive TData dépasse 512 entrées ou 32 Mio | Seuls les fichiers ZIP « key_datas » et « D877F783D5D3EF8Cs » sont concernés, et non l'intégralité du dossier. |
| Impossible de déchiffrer TData. Vérifiez le code d'accès local du bureau. | Saisissez le code d'accès local de Telegram Desktop dans le champ « Code d'accès » ou « Texte de session ». |
| Importez un compte TData à la fois | Telegram Desktop disposait de plusieurs comptes ; voir la section « Formats non pris en charge ». |
| Certains fichiers décrivent différents comptes ou identifiants API | Sélectionnez les fichiers d’un seul compte. |
| Le fichier JSON ne contient aucune information d'identification ou d'autorisation prise en charge par l'API. | Vérifiez les noms des champs dans le fichier JSON du compte. |
| Métadonnées de l'API uniquement | Le fichier JSON ne contient pas de session. Ajoutez le fichier « .session » ou utilisez votre téléphone/le code QR. |
| La clé d'authentification HEX doit contenir l'intégralité des 512 caractères hexadécimaux | La clé est tronquée ou contient « … ». |
| L'identifiant du compte ne correspond pas à celui du compte importé | L'identifiant utilisateur du fichier diffère de celui indiqué par Telegram ; ce fichier concerne un autre compte. |
| Ce compte appartient déjà à un autre espace de travail | Ouvrez cet espace de travail au lieu d'ajouter le compte deux fois. |
| Connecté, mais il manque un groupe privé dans la liste des discussions sous Plus d’outils → Sources | Vérifier l’adhésion. Le sélecteur inspecte les 1,000 premières conversations ; augmenter la limite dans Plus d’outils → Paramètres. |
| Échec de la connexion via le proxy | Vérifiez le mode de routage et le mode IP. Le mode «MTProxy» tente automatiquement une autre entrée valide. Le mode «Hide the address » attend ; le mode «Direct », en dernier recours, peut se connecter directement après le délai configuré. Voir les modes de routage. |
Voir également : connexion et sécurité pour les proxys et le chiffrement, ainsi que le fonctionnement de la collecte des données enregistrées après connexion.