TgWitness / Documentation

Ce qui a été testé →

Référence / Collecter

Telegram · Mode enquête

Enquêtes portant sur l’intégralité d’un compte, couvrant les chaînes, les groupes, les discussions privées et les bots, depuis la définition du périmètre jusqu’à la constitution d’un dossier de cas vérifié.

TgWitness / Documentation

Enquête

Suivez une affaire à travers les canaux, les groupes, les discussions privées et les bots, depuis l’acquisition initiale jusqu’à une chronologie référencée et un transfert vérifiable. La version interactive du site web est disponible à l’adresse /docs/cases/ ; instructions de prévisualisation.

Sur cette page

Exemple concret : un changement de destination au cours de quatre conversations#

Une annonce fait référence à un bot. Un groupe opérationnel discute d’une nouvelle destination de paiement, et le clavier du bot l’affiche. L’annonce est modifiée, un message privé de suivi répète la destination, puis un message de groupe disparaît.

Les questions sont les suivantes : qu’a-t-on observé avant et après la modification, quels comptes Telegram ont publié chaque élément, où la destination est-elle apparue, quels octets de pièce jointe ont été conservés, et quels intervalles restent inconnus ?

Tous les noms, identifiants, dates et heures ainsi que les références du journal figurant dans cet exemple sont fictifs. Le processus utilise les fonctionnalités actuelles ; la carte de l’affaire est une illustration et non un graphique généré automatiquement par l’application.

OrganigrammeChaînes → Journal de l'espace de travail; Groupes → Journal de l'espace de travail; Conversations privées → Journal de l'espace de travail; Bots → Journal de l'espace de travail; Journal de l'espace de travail → Rechercher dans toutes les sources; Journal de l'espace de travail → Fiches de personnes avec références aux enregistrements; Journal de l'espace de travail → Versions enregistrées et accusés de réception des pièces jointes; Rechercher dans toutes les sources → Chronologie de l’analyste et registre des sources; Fiches de personnes avec références aux enregistrements → Chronologie de l’analyste et registre des sources; Versions enregistrées et accusés de réception des pièces jointes → Chronologie de l’analyste et registre des sources; Journal de l'espace de travail → Fichier ZIP contenant les preuves signées; Chronologie de l’analyste et registre des sources → Transfert de dossier avec des éléments de preuve vérifiés séparément; Fichier ZIP contenant les preuves signées → Transfert de dossier avec des éléments de preuve vérifiés séparémentChaînesGroupesConversations privéesBotsJournal de l'espace detravailRechercher dans toutes lessourcesFiches de personnes avecréférences auxenregistrementsVersions enregistrées etaccusés de réception despièces jointesFichier ZIP contenant lespreuves signéesChronologie de l’analysteet registre des sourcesTransfert de dossier avecdes éléments de preuvevérifiés séparément
Schéma sous forme de texte
  1. Chaînes → Journal de l'espace de travail
  2. Groupes → Journal de l'espace de travail
  3. Conversations privées → Journal de l'espace de travail
  4. Bots → Journal de l'espace de travail
  5. Journal de l'espace de travail → Rechercher dans toutes les sources
  6. Journal de l'espace de travail → Fiches de personnes avec références aux enregistrements
  7. Journal de l'espace de travail → Versions enregistrées et accusés de réception des pièces jointes
  8. Rechercher dans toutes les sources → Chronologie de l’analyste et registre des sources
  9. Fiches de personnes avec références aux enregistrements → Chronologie de l’analyste et registre des sources
  10. Versions enregistrées et accusés de réception des pièces jointes → Chronologie de l’analyste et registre des sources
  11. Journal de l'espace de travail → Fichier ZIP contenant les preuves signées
  12. Chronologie de l’analyste et registre des sources → Transfert de dossier avec des éléments de preuve vérifiés séparément
  13. Fichier ZIP contenant les preuves signées → Transfert de dossier avec des éléments de preuve vérifiés séparément

1. Définir le cas et recueillir l’intégralité des faits#

  1. Associez le compte de collecte à son propre espace de travail. Dans Case Board ou dans votre registre des dossiers, consignez la référence du dossier, l’identifiant du compte, l’espace de travail et la date de début de l’observation. Conservez séparément l’empreinte digitale de la clé de signature de confiance.
  2. Pour un compte de collecte dédié, ouvrez Plus d’outils → Sources → Portée → Mode d’investigation. Le préréglage sélectionne Compte entier, canaux/groupes/discussions privées/bots, propres actions, profils de source et les 200 derniers messages visibles pour les sources nouvellement découvertes. Vérifiez ces paramètres, cliquez sur Enregistrer la portée, puis confirmez la portée. Les comptes principaux utilisent des discussions sélectionnées ou un dossier ; la collecte sur l’ensemble du compte est disponible pour les comptes marqués pour investigation.
  3. Chargez les discussions et comparez les sources avec la liste des conversations du compte. Vérifiez les exclusions. Plus d’outils → Paramètres → Le nombre de discussions lues à partir de la liste du compte est par défaut de 1,000 et peut aller jusqu’à 20,000. Les sources dépassant la limite de la liste sont ajoutées lorsqu’ elles deviennent actives. Enregistrez ce qui a été effectivement répertorié.
  4. Dans Plus d’outils → Sources → Enregistrement, sélectionnez Toute l’activité visible et enregistrez les paramètres de surveillance. Vérifiez les types et limites de pièces jointes ainsi que l’espace disque disponible.
  5. Lancez l’observation. Validez un nouveau message contrôlé, une modification et une suppression, puis conservez les références du test ainsi que les éventuels échecs.

La portée compte entier enregistre l’activité visible par le compte dans le cadre des paramètres enregistrés, au sein des discussions auxquelles le compte a participé. Les discussions secrètes sont enregistrées par le module Discussions secrètes, et les conversations existantes sont rétroactivement intégrées via l’historique. Voir la portée de la collecte.

2. Répertorier toutes les sources et recueillir le contexte historique#

Tenez un registre des sources avec une ligne par conversation :

Domaine Enregistrer
Identité Espace de travail, identifiant de compte, identifiant numérique de la conversation, titre et type
Visibilité Adhésion/rôle, accès confirmé ou non confirmé, exclusions
Capture en temps réel Date de lancement, types d’événements sélectionnés et modifications ultérieures de la politique
Historique du journal Capture d'écran demandée/réalisée, limite, heure et références d'enregistrement
Historique complet Nom de fichier d’exportation signé par conversation, limites et statut (réussite/échec)
Pièces jointes Reçus multimédias complets, hachages, tailles et résultats omis ou échoués
Champ d'application Pannes, collecte incomplète, FloodWait, messages indisponibles et autres lacunes

Utilisez la méthode d’acquisition adaptée à chaque source :

  • Le chargement de l’historique complet dans Plus d’outils → Sources → Chats concernés charge les anciens messages disponibles provenant des sources activées dans le journal de l’espace de travail. Il prend en charge la mise en pause/reprise ainsi qu’un rapport de progression signé. Voir Acquisition de l’historique.
  • L’instantané de l’historique enregistre les messages visibles récents dans le journal d’observation. Sa valeur maximale par défaut est de 500 ; via Plus d’outils → Paramètres → Taille maximale de l’instantané de l’historique, il est possible de porter cette valeur à 10,000. Il s’agit d’observations de l’historique actuel, et non de modifications reconstituées.
  • Exportations → Capturer ou exporter une conversation → Exporter la conversation complète, ou Conversations → Exporter une conversation, récupère l’ historique actuellement visible d’une conversation dans un ensemble séparé et signé chat.json / chat.html. Répétez l’opération pour les sources du dossier et conservez chaque résultat.
  • Lorsqu’un nouveau chat ou un nouveau bot apparaît, il est possible d’en enregistrer le profil ainsi que jusqu’à 1 000 messages récents ; le mode « Enquête » en sélectionne 200. Les chats existants ne bénéficient pas de cette collecte rétroactive lorsque le mode est activé.
  • Le téléchargement des pièces jointes visibles permet de conserver les octets conformément à la politique configurée. Exigez un reçu media.saved complet avec SHA-256 et le nombre d’octets. Une tâche en file d’attente, une vignette ou un nom de fichier ne constituent pas une pièce jointe conservée.

Une exportation complète d’une conversation ne remplit pas le journal ni les profils des personnes avec l’ensemble de ses messages. Utilisez « Charger l’historique complet » ou des « instantanés de journal délimités » pour l’historique que vous devez analyser dans TgWitness. Vérifiez la liste des sources activées avant de lancer une analyse de l’historique. Aucune de ces deux méthodes ne permet de récupérer les données que Telegram ne renvoie plus.

3. Conserver l’évolution du dossier et les interactions délibérées#

Marquez les discussions relatives à des affaires en cours comme sources prioritaires. Vérifiez les intervalles de vérification, le rattrapage continu et les résultats relatifs aux médias. Veillez à ce que le collecteur continue d’observer pendant l’utilisation du compte. Utilisez Discussions → Profil → Enregistrer le profil maintenant pour conserver les métadonnées de la source, telles que les descriptions et les commandes du bot. Cela est distinct des profils de personnes dérivés des messages enregistrés.

Lorsque l’affaire implique de suivre une source ou d’interagir avec un bot :

  1. Ouvrir le lien Telegram → Enregistrer l’aperçu : cette fonction enregistre le lien fourni et l’ aperçu affiché avant toute action.
  2. La commande « join / open and observe » effectue l'opération « join/open » et envoie le paramètre de démarrage du bot lorsqu'il est fourni. Une demande d'adhésion en attente d'approbation est enregistrée comme « en attente ».
  3. Les réponses textuelles émises par le panneau et les pressions sur les boutons prises en charge conservent les codes interaction.requested et interaction.result. Les accusés de réception de rappel peuvent conserver le texte de la fenêtre contextuelle renvoyée, l'état de l'alerte et l'URL.

Il s’agit là d’actions réelles sur les comptes. Les pressions sur les boutons de rappel dans une autre application Telegram ne sont pas visibles par le collecteur, bien que les messages ou modifications qui en résultent puissent l’être. Le mini-client n’effectue pas de workflows liés aux applications web, aux paiements, au téléphone ou à la localisation. Pour connaître le comportement exact, consultez la section « Interactions avec les panneaux ».

4. Relier les observations entre les différentes discussions#

Dans le Journal, sélectionnez « Toutes les sources » et effectuez une recherche dans le contenu enregistré. Ouvrez les enregistrements correspondants et notez l’espace de travail, le chat, l’identifiant du message, la séquence et le hachage de l’enregistrement.

Dans une conversation concernée, ouvrez « Personnes » → « Activer les profils » et examinez le profil d’une personne :

  • Noms/pseudonymes observés au fil du temps et identifiant numérique Telegram.
  • Relations entre les réponses et les références aux enregistrements sources.
  • Également dans… d’autres discussions de ce journal d’espace de travail où cet identifiant a écrit.
  • Activité, modifications/suppressions et mentions de portefeuilles, de téléphones, de noms d'utilisateur et de liens.
  • Métadonnées des avatars enregistrés et avatars similaires mis en cache, avec leur origine respective.

Ouvrez les enregistrements cités avant d’utiliser un profil dérivé dans une conclusion. Les profils concernent les personnes dont les messages ont été enregistrés, et non l’ensemble des membres du groupe. Plus d’outils → Paramètres → Le nombre d’enregistrements cités par fait limite la liste de références, et non le nombre d’activités sous-jacentes. Les mentions et la similitude des avatars constituent des pistes ; la propriété et l’identité reposent sur des identifiants numériques et des expéditeurs attribués.

Le dossier signé distingue les indications de l'encodeur des fichiers transférés et réutilisés en deux catégories : clients.forwarded et clients.reused. Ces fichiers ne sont pas pris en compte dans clients.observed ni dans la liste media_timing.pre_existing. Un fichier réutilisé signifie que le même identifiant de document Telegram a été observé dans un autre message plus tôt dans ce journal, au sein des discussions autorisées du lecteur. Son premier enregistrement observé est mentionné ; une autre observation ou modification du même message ne constitue pas une réutilisation.

La section paid_reactions du dossier conserve le dernier classement « Stars » disponible pour chaque message répertorié, avec les enregistrements sources et les indicateurs d'anonymat. Il s'agit de chiffres instantanés, et non de la somme des paiements supplémentaires ni d'une liste complète des personnes ayant réagi. Un instantané sans classement ne fournit aucune liste de remplacement. Cette section signale les messages omis lorsque la limite d'affichage est atteinte.

Les listes de surveillance et les exportations d’indicateurs analysent les libellés des boutons, les URL, le texte de copie, les requêtes intégrées et les octets de rappel qui se décodent en UTF-8 valide. Les encodages de rappel non valides ou trop volumineux sont ignorés lors de l’extraction de texte ; les octets d’origine restent dans l’enregistrement sauvegardé. Les listes de surveillance existantes doivent être réanalysées pour inspecter les anciens enregistrements à l'aide de ces champs supplémentaires. L'inspection n'entraîne pas l'activation du bouton.

Dans l’exemple ci-dessous :

Lien Enregistre Observation étayée
Même compte d'expéditeur Groupe n° 146 et discussion privée de suivi n° 205 Les deux fournissent l'identifiant d'expéditeur Telegram 71001
Même destinataire #146, clavier du bot #173, modification d'une chaîne #188, message privé #205 Tous contiennent pay.example.invalid/new ; une destination répétée relie le contenu
Même fichier enregistré Réceptions multimédias n° 151 et n° 209 terminées Les valeurs SHA-256 complètes concordent pour les octets conservés
Attribution de la chaîne #101 et #188 Ne pas attribuer une publication de chaîne à l’utilisateur 71001 sans mentionner l’expéditeur.

Comparer les hachages des pièces jointes et les références de messages associées, et conserver les chronologies des comptes regroupées par les identifiants Telegram fournis dans ces enregistrements.

Conservez les notes de travail de l’équipe sur Case Board : ajoutez aux favoris les enregistrements sur lesquels vous vous appuyez, tels que #146, #188 et #205, mettez en surbrillance la chaîne de destination exacte, et enregistrez un extrait de chaque action enregistrée entre deux enregistrements ou sur une plage horaire. Les notes et les statuts conservent l’examen effectué par l’équipe dans leur propre historique signé, distinct des observations sources.

5. Créer la chronologie inter-discussions#

Utilisez les versions enregistrées dans les discussions et leurs liens vers le journal n°… Dans le journal, regroupez toutes les sources avec les modifications, les suppressions et la couverture. Conservez à la fois source_at, lorsqu’il est fourni, et observed_at.

Exemple de durée d’observation Référence Remarque
09:00 Chaîne n° 101 Destination d'origine enregistrée
09:12 Groupe n° 146 ; média n° 151 Nouvelle destination publiée ; téléchargement du fichier terminé
09:16 Bot n° 173 Le clavier pointe vers la nouvelle destination
09:20 Chaîne n° 188 Annonce modifiée ; les deux versions enregistrées sont conservées
09:24 Vie privée #205 ; médias #209 Le même identifiant d’expéditeur correspond à la même destination ; les mêmes octets de fichier sont conservés
09:28 Groupe n° 231 Avis de suppression reçu ; auteur de la suppression et heure exacte de la suppression inconnus

D’autres enregistrements peuvent se situer entre ces exemples de références. Les numéros de séquence classent les observations par ordre chronologique ; les instantanés d’historique peuvent contenir des dates de source plus anciennes et arriver après les événements en temps réel. Distinguez les instantanés, les messages récupérés, les notifications de suppression et les résultats « manquant lors de la vérification ultérieure ». Marquez les lacunes de couverture comme des intervalles inconnus. L’acquisition ultérieure de l’historique n’établit pas rétroactivement une observation ininterrompue.

6. Ajouter les points de vue des comptes sans perdre leur origine#

Utilisez un espace de travail distinct pour chaque compte et répétez l’inventaire de celui-ci. Conservez l’identifiant du compte, le rôle, l’empreinte de la clé de signature et les références sources à chaque comparaison. Les numéros de message ne constituent pas des identifiants globaux valables pour l’ensemble des discussions et des comptes.

Case Board conserve les notes et les collections liées aux sources au sein de chaque espace de travail. L’écran de groupe permet de passer en revue ensemble l’état des comptes et peut regrouper les exportations provenant d’espaces de travail distincts. Mettez ces sources en corrélation dans vos notes de dossier ou vos outils d’analyse ; chaque journal conserve sa propre origine et sa propre clé de signature. Aucune recherche globale ni chronologie fusionnée entre les espaces de travail n’est générée. L’exportation multi-comptes d’un canal/supergroupe récupère l’historique de ce chat à partir des comptes éligibles.

Pour les travaux de plus grande envergure, veillez à respecter les limites en faisant appel à un témoin indépendant. Utilisez des contrôles de livraison pour valider le chemin de capture et la visibilité de chaque compte.

Récurrence des médias et sources de transfert#

Les rapports d’analyse comparent séparément les identifiants de documents Telegram et les hachages SHA-256 issus des enregistrements de fichiers sauvegardés. Ils présentent les messages et les discussions distincts, ainsi que la première et la dernière occurrence conservée, avec une chronologie des observations extensible au format HTML. Les instantanés ou modifications répétés d’un même message n’augmentent pas le nombre d’occurrences pour la même clé. Un fichier différent dans un message modifié conserve sa propre occurrence.

La mention « Première observation » suit l'ordre chronologique des publications dans la sélection du rapport. Elle ne prétend pas indiquer la toute première publication sur Telegram. Les identifiants de document permettent d'identifier les documents Telegram ; le SHA-256 compare les octets enregistrés. Les dHashes de 64 bits correspondants de différentes images enregistrées sont présentés comme des indices visuels ; cette comparaison utilise des hachages égaux, et non une recherche du plus proche voisin. Les octets des images doivent correspondre à leur SHA-256 enregistré avant l’analyse dHash ; les fichiers de plus de 64 Mio et les images de plus de 40 millions de pixels sont ignorés.

Les résumés des sources en amont comptabilisent les messages de destination distincts. Les identifiants de pair dans les en-têtes, les noms masqués, les signatures des auteurs de messages et le contexte des « Messages enregistrés » restent séparés. Le JSON du profil utilisateur inclut les sources de chaque expéditeur ; les publications sur les canaux apparaissent également dans le résumé au niveau du chat. Une source nommée sans identifiant de pair correspond à un regroupement de texte, et non à une personne identifiée. Les en-têtes des chats importés restent marqués comme importés.

Les fichiers ZIP de preuves non compacts comprennent media-repeats.json, forward-sources.json et observed-sources.gexf, protégés par le manifeste d’archive. Le graphe GEXF 1.3 comporte des arêtes typées forwarded_from et recommended. Les flèches vont de la conversation observée vers le pair référencé. Les poids des recommandations comptabilisent les observations de recommandations conservées ; les poids de transfert comptabilisent les messages distincts. Les noms masqués et les en-têtes importés ne créent pas d’arêtes d’identité. Aucune opération sur le graphe ne résout les profils ni n’appelle Telegram. Les métadonnées des arêtes comprennent les séquences sources et les hachages.

Les résumés suivent la sélection du rapport ; l'archive ZIP des preuves contient toujours le journal signé complet. Une sélection ne contenant que des événements de message compare les identifiants de document ; les comparaisons d'octets enregistrés et d'images nécessitent des événements de fichiers enregistrés dans le flux sélectionné. La sélection actuelle des messages cloud exclut le fichier media.saved. Les limites sont explicites : 200 000 occurrences de clés/messages conservées par analyse, 100 000 clés multimédia, 20 groupes de rapports, 100 références chronologiques par groupe et 1 000 arêtes de graphe exportées. Lorsqu’un plafond de comparaison est atteint, les résultats indiquent les occurrences omises et les comptages deviennent des bornes inférieures. Les limites d’affichage de la chronologie et du graphe sont indiquées séparément. Les fichiers ZIP compacts omettent ces résumés dérivés. Les enregistrements source signés restent inchangés.

7. Constituer et vérifier le dossier de transfert#

Conservez ces éléments ensemble dans un dossier de dossier constitué par un analyste :

Contenu Objectif
Notes d’enquête et registre des sources Question, politique de collecte, accès/rôle, conclusions, explications alternatives et lacunes
Chronologie Mention des dates ainsi que des références à l’espace de travail, au chat, au message et à la séquence pour chaque entrée
Case Board exportation et extraits, le cas échéant Signets liés aux sources, citations, notes d’équipe, collections, historique des révisions et enregistrements sélectionnés vérifiés par rapport au fichier ZIP contenant les preuves
Fichier ZIP de preuves signées par espace de travail Journal complet des enregistrements, manifeste et médias conservés inclus ; les filtres du panneau ne restreignent pas l'exportation du journal
Fichiers de profil des personnes signés séparément Références dérivées vérifiées par rapport aux preuves correspondantes de l’espace de travail
Exportations signées de l’intégralité des discussions Acquisition de l'historique visible en temps réel, distincte du journal d'observation
Empreintes de confiance, certificats racine TSA et points de contrôle antérieurs Identifiant de clé, heure externe du dernier enregistrement et limites du journal conservées
Éléments de preuve, s’ils sont configurés Journal distinct, messages signés et empreinte digitale du témoin
Résultats de vérification et hachages des fichiers fournis Ce qui a été vérifié, quels octets ont été transférés et à qui

À partir d’une installation de confiance, avec les noms de fichiers et l’empreinte digitale réelle de chaque espace de travail :

python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence
python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip
python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256
python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256

--require evidence se termine avec le code 2, sauf si l’empreinte correspond et qu’un horodatage externe provenant d’un tiers couvre le dernier enregistrement ; le point de contrôle sert de vérification complémentaire.

Conservez les résultats de vérification réels et les artefacts d’origine. Exportez les notes de l’espace de travail de Case Board avec les documents sources cités. Regroupez les résultats provenant de différents espaces de travail dans le répertoire de l’affaire de niveau supérieur ; chaque artefact TgWitness possède sa propre signature et sa propre procédure de vérification.

Adapter l’enquête#

Cas Trace Livrer
Litige relatif à une commande ou à un paiement géré par un bot Annonce de l’entrée → aperçu du lien enregistré → paramètre de démarrage du bot → versions « message » et « clavier » → accusés de réception des rappels du panneau → suivi des conversations privées/de groupe Chronologie observée des offres/réponses et sources vérifiées ; la confirmation de paiement provient de l’enregistrement de paiement.
Messages supprimés à la suite d’un incident Toutes les conversations concernées → originaux et modifications enregistrés → résultats des suppressions ou des éléments manquants lors d’une nouvelle vérification → médias conservés → couverture et autres points de vue des comptes Versions conservées et intervalles d’inconnues explicites ; aucun acteur de suppression inventé
Un participant change de nom d’une conversation à l’autre ID numérique de l'expéditeur → historique des noms/noms d'utilisateur → réponses → autres discussions observées → destinations/fichiers cités Chronologie de l'activité d'un compte Telegram avec des liens vers les enregistrements sources correspondants

Référence de la collection · Vérification des profils de personnes · Transfert des preuves · Validation terminée