Certaines parties de cette page sont encore en anglais : le texte original en anglais a été modifié après sa traduction.
Référence / Preuves
Telegram · Format des preuves
Contenu du fichier ZIP signé, types d’enregistrements, accusés de réception, profils des utilisateurs, copies hors site et vérification hors ligne.
TgWitness conserve les observations Telegram visibles par le compte dans un journal signé. Les destinataires peuvent vérifier les enregistrements, pièces jointes et rapports sauvegardés à l’aide d’une clé de collecteur de confiance, vérifier l’horodatage externe fourni par un tiers pour le dernier enregistrement, et comparer le journal à un point de contrôle qu’ils ont conservé précédemment. Cette page décrit les formats, les vérifications et les éléments à conserver en vue d’un transfert.
Les utilisateurs peuvent commencer par exécuter VERIFY.cmd sous Windows : l'outil demande le fichier ZIP d'origine et l'empreinte de la clé obtenue de manière indépendante, affiche un résultat commenté, et enregistre un rapport de vérification séparé. Consultez les lanceurs de vérification et l'environnement d'exécution portable pour connaître la configuration et les limites de confiance.
Sur cette page
- Qu'est-ce qui est signé ?
- Comparaison des exportations de discussions
- Transfert de l'enquête
- Extrait de transfert
- Rapports lisibles
- Canonisation des événements
- Sémantique des acteurs
- Couverture : continuité, lacunes et identifiants non observés
- Producteur
- Profils des personnes
- Témoin indépendant
- Manifeste et points de contrôle
- Portée de la vérification
- Pièces jointes
- Collecte et traitement durables des reçus (0.2)
- Préparation RFC 3161 et vérification des réponses (0.2)
- Enregistrements facultatifs en mode preuves : drand et appareils Telegram
Qu'est-ce qui est signé ?#
| Contenu | Protection | Éléments à conserver |
|---|---|---|
| Chaque observation du journal, y compris les événements opérationnels | Chaîne SHA-256 et signature Ed25519 par événement | events.jsonl d'origine, l'empreinte de la clé de confiance, et un point de contrôle conservé |
| Contenu du fichier ZIP de preuves | manifest.sig signe le manifeste canonique, qui répertorie les hachages des fichiers de contenu |
Le fichier ZIP complet, comprenant son manifeste et sa signature |
| Pièces jointes conservées | SHA-256 et nombre d’octets dans un événement media.saved signé ; hachage du fichier dans le manifeste ZIP signé |
Les octets d'origine contenus dans le fichier ZIP vérifié |
| Point de contrôle | Signature Ed25519 portant sur la longueur du journal, le hachage d'en-tête, la clé publique et l'heure de création | Une copie indépendante conservée avant une modification contestée |
| Reçu de transaction | Enregistrement signé de la version du collecteur, des hachages des fichiers source et des paramètres de démarrage, également inclus dans process.started |
Le reçu, le journal associé et les preuves environnementales pour le mode de vérification sélectionné |
Rapports lisibles : report.html et ses parties, report.json, report.pdf, chat.pdf |
Un sceau Ed25519 par fichier sur son contenu ; le PDF comporte également une signature standard PDF (voir Rapports lisibles ) | Le fichier tel qu'il a été reçu et l'empreinte digitale de la clé de confiance ; l'archive ZIP qu'il décrit |
| CSV autonome | Pas de signature cryptographique autonome ; les hachages d’événements seuls ne suffisent pas | Utilisez le fichier exact contenu dans l'archive ZIP vérifiée pour contrôler l'intégrité. |
| Captures d’écran, impressions ou fichiers PDF générés par un navigateur | Aucune signature TgWitness sur le document dérivé | Conservez le paquet original vérifié et documentez la manière dont le dérivé a été créé. |
Le collecteur vérifie les signatures du journal avant de générer chaque format d’exportation. Les rapports HTML et PDF lisibles comportent leurs propres sceaux ; le fichier CSV autonome est vérifié dans le cadre d’un fichier ZIP signé. Conservez le fichier ZIP afin de préserver les octets de la pièce jointe et le manifeste, ainsi qu’un point de contrôle distinct pour comparer le journal à une limite antérieure.
Formats et chemins de vérification#
Le mode d’acquisition et le format de sortie répondent à des questions différentes. Le mode fournit des preuves relatives à la collecte et à l’environnement ; chaque format conserve ou présente une partie de cet enregistrement en respectant les vérifications ci-dessous.
| Résultat | Vérification et utilisation |
|---|---|
| Preuves ZIP | Événements canoniques, manifeste signé, couverture, entrées de conservation, pièces jointes et reçus externes disponibles ; vérifier l’archive et son mode d’acquisition sélectionné. |
| Conteneur ASiC-E | Le fichier ZIP contenant les preuves, sous forme de conteneur ETSI ASiC-E (EN 319 162-1), comportant une entrée mimetype et le fichier META-INF/ASiCManifest.xml, signé selon la norme CAdES avec le certificat propre à l'espace de travail au niveau B-B, ou B-T lorsque l'horodatage est activé. Les validateurs tels que EU DSS vérifient le format et l’intégrité et, le certificat étant auto-émis, signalent l’absence d’ancrage de confiance. EU DSS 6.3, avec ses paramètres par défaut, refuse un conteneur comportant plus de 1 000 fichiers (« Trop de fichiers détectés »). verify.py vérifie le manifeste Ed25519 et chaque fichier répertorié, les valeurs SHA-256 dans META-INF/ASiCManifest.xml et dans un fichier ASiCManifestNNN.xml ou ASiCEvidenceRecordManifest.xml ajouté, et échoue si une entrée META-INF/ n’est couverte par aucun d’entre eux. Il ne vérifie pas les signatures CAdES et le signale. |
| Rapports HTML et JSON | Vues scellées individuellement avec références aux sources, également répertoriées dans le manifeste ZIP. Leurs compteurs enregistrés résument les types d’événements du journal. |
| Rapports PDF | Sceau Ed25519 associé à une signature PDF de référence PAdES sur la plage d'octets : B-B, ou B-T avec un horodatage de la signature lorsque l'horodatage est activé. Le vérificateur TgWitness utilise la clé Ed25519 de confiance ; l'affichage de la confiance du certificat par la visionneuse constitue une vérification distincte. |
| CSV | Une vue sous forme de feuille de calcul est couverte par le manifeste ZIP. L’échappement des formules protège l’utilisation de la feuille de calcul ; le texte signé d’origine reste dans le journal. |
| JSONL | Enregistrements d’événements signés, y compris les références aux pièces jointes. L’archive ZIP de preuves contient en outre les octets des pièces jointes conservés. |
| Exportation des discussions et vues compatibles avec les ordinateurs de bureau | Acquisition de l’historique et des enregistrements disponibles du journal d’administration, avec le rendu demandé et l’archive signée. Les versions enregistrées de la surveillance en temps réel constituent un chemin d’acquisition distinct. |
| Enregistrements multimédias et enregistrements sous forme de hachage uniquement | Les octets enregistrés sont vérifiés par rapport à leur SHA-256 et à leur référence de message. L’acquisition hash-only conserve les métadonnées de hachage disponibles pour une comparaison ultérieure avec les octets du fichier. |
| STIX/MISP et profils de personnes | Observations extraites liées à la source, identifiants de compte et correspondances analytiques. Les signatures de profil et les hachages d’enregistrements peuvent être vérifiés par rapport aux preuves originales ; la provenance du cache d’avatar est étiquetée séparément. |
| Extrait de la passation de pouvoir | Règles de divulgation signées, enregistrements inchangés et enregistrements marqués comme minimisés conservant les hachages/signatures d’origine. Utiliser l’original conservé pour une comparaison nécessitant des champs masqués. |
| Témoins et reçus temporels | Les limites antérieures du journal, la continuité et les affirmations temporelles individuelles vérifiées. Elles accompagnent les contrôles d’acquisition et d’archivage. |
| Livraison protégée par mot de passe | Protège le paquet joint pendant le transfert. .tgwpw utilise un chiffrement authentifié AES-GCM, incluant un enregistrement final authentifié ; le journal joint conserve ses signatures et ses reçus d’acquisition. |
Une impression ou une capture d’écran constitue une présentation du matériel signé. Son identifiant de rapport , son empreinte de clé et sa référence QR permettent de localiser le fichier original à des fins de vérification. Les déclarations de conservation enregistrent les informations fournies concernant l’examinateur et le transfert ; les résultats du vérificateur et les reçus d’acquisition sont conservés en tant que preuves distinctes.
Signatures externes#
Une signature peut également provenir d’une clé que TgWitness ne détient jamais, comme la
signature électronique qualifiée d’un enquêteur ou le cachet d’une organisation. Concernant les exportations, la
signature externe sur une exportation préparée sans mot de passe fournit les octets à signer : une nouvelle
META-INF/ASiCManifestNNN.xml liste répertoriant chaque fichier avec son SHA-256 pour un conteneur ASiC-E
, ou le nom de l’exportation manifest.json pour un fichier ZIP. Le signataire renvoie un CMS (CAdES)
.p7s, détaché ou avec le contenu intégré.
TgWitness vérifie que la signature couvre exactement ces octets et effectue une validation à l’aide du certificat du signataire (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). La chaîne est vérifiée uniquement par rapport aux certificats racines fournis par l’opérateur ; la révocation, les listes de confiance et le statut qualifié ne sont pas vérifiés. Le panneau affiche un état par signature : en attente d’une signature, jointe et non vérifiée, vérifiée, algorithme non pris en charge, signature non valide, octets signés ne correspondent pas, ou certificat non lié à une racine fournie. La modification de l’exportation après la distribution des octets fait passer toutes ses signatures à l’état « octets signés ne correspondent pas ».
Le téléchargement avec signatures ajoute les signatures et leurs manifestes dans META-INF
dans un conteneur ASiC-E. Pour un fichier ZIP, il place le fichier ZIP inchangé, les .p7s fichiers et
SIGNATURES.txt dans un fichier ZIP externe. Les signatures non valides et celles qui recouvrent d’autres octets
sont ignorées. Une signature utilisant un algorithme que TgWitness ne peut pas vérifier est incluse ; le
panneau affiche son état, tout comme SIGNATURES.txt pour un fichier ZIP.
Images de chat signées#
Le téléchargement du fichier ZIP signé dans l'aperçu de l'image permet d'enregistrer les pages au format PNG, pages.sig.json et
README.txt. Chaque page se termine par les numéros d’enregistrement du journal qu’elle affiche, la conversation, l’
heure de rendu, l’empreinte de la clé de l’espace de travail et la commande qui la vérifie. Le panneau
n’envoie que le SHA-256 et les numéros d’enregistrement de chaque page ; le serveur confirme que les enregistrements
appartiennent à la conversation, signe la déclaration (tgwitness-image-attestation-v1) avec la
clé de l’espace de travail et consigne la signature dans le journal sous la forme export.image_attested.
python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip
Le vérificateur vérifie la signature, associe chaque fichier PNG à une page signée et renvoie l'
empreinte de la clé. --fingerprint Il compare le signataire à une empreinte obtenue auprès de l’
expéditeur de manière indépendante. --evidence Il lit un fichier ZIP de preuves signées provenant du même espace de travail et
exige que chaque enregistrement des images soit présent avec le même hachage. Un pixel modifié,
une déclaration modifiée ou une autre clé entraîne l'échec de la vérification. Les images montrent les enregistrements sauvegardés dans la
mise en page propre à TgWitness ; elles ne montrent pas ce que Telegram a affiché à qui que ce soit.
Comparaison des exportations de discussions#
Vérifier et comparer deux fichiers ZIP d'exportation de discussions signés à l'aide d'empreintes digitales des signataires conservées indépendamment :
python -m tgwitness.verify first.zip --compare second.zip \
--fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
Les options --require et --require-tier ne peuvent pas être utilisées conjointement avec --compare ; vérifiez le
profil requis de chaque archive à l'aide de sa propre vérification.
Lorsque les deux archives enregistrent les mêmes identifiants numériques de compte et de discussion, les enregistrements sont appariés
par identifiant de message. Inchangé signifie que l’enregistrement JSON complet sauvegardé est identique :
le texte intégral, l’auteur, les dates, la cible de la réponse, les métadonnées imbriquées et les champs inconnus sont tous
inclus. L’ordre des clés de l’objet JSON n’a pas d’importance ; en revanche, les champs absents, les valeurs nulles, les types de valeurs
et l’ordre des tableaux sont pris en compte. L’aperçu de 300 caractères est uniquement destiné à l’affichage. Les entrées modifiées
désignent le changed_fields de niveau supérieur différent, y compris les modifications invisibles dans cet aperçu.
Les identifiants de message en double sont rejetés au lieu de se remplacer mutuellement lors de la mise en correspondance.
Une différence peut correspondre à un nom d’affichage modifié, à un nombre de vues, à une annotation de collecte ou à d’autres métadonnées d’observation. Les modifications apportées à Telegram apparaissent comme des événements de modification distincts, et la vérification de chaque archive indique si celle-ci est intacte. Les enregistrements non analysés restent dans la comparaison et sont comparés selon leur représentation enregistrée.
En cas d’identités de compte/de discussion différentes ou manquantes, l’outil trouve des correspondances candidates
à l’aide de l’expéditeur, du texte complet, du hachage du fichier, du type de média et d’une tolérance temporelle de cinq secondes,
et les signale comme Matched (correspondantes) plutôt que Unchanged (inchangées). Les enregistrements non analysés
restent sans correspondance. Les différences entre les enregistrements appariés sont répertoriées dans changed,
y compris en mode contenu. Avec --json, matched compte les paires candidates et
unchanged compte les paires dont les enregistrements complets sauvegardés sont identiques. Les
sorties existantes changed_fields et unchanged (entier) restent compatibles avec les
résultats de comparaison antérieurs. Le format d’archivage et la vérification de la signature restent inchangés.
Transfert de l'enquête#
- Consignez la référence du dossier, le nom de l’opérateur, l’identifiant numérique du compte Telegram, les sources sélectionnées, la politique de collecte et la période de collecte dans vos notes de dossier. TgWitness conserve les observations et prend en charge les notes et les collectes liées aux sources dans le « Case Board ». Conservez les registres de transfert et de conservation avec vos documents de dossier. Vérifiez la configuration de collecte prévue à l’aide de la procédure d’acceptation en direct.
- Conservez l'empreinte de la clé publique de l'espace de travail de manière indépendante avant de vous fier à ses exportations. Laissez le mode « evidence » activé (réglage par défaut) afin que les points de contrôle reçoivent des reçus conformes à la norme RFC 3161 et OpenTimestamps. Enregistrez les points de contrôle signés en dehors du collecteur pendant la collecte. Enregistrez les interruptions et les limites de visibilité du compte.
- Exportez un fichier ZIP signé et conservez le reçu d’exécution signé. Utilisez un point de contrôle situé au niveau ou avant la limite du journal exporté. Un point de contrôle situé plus loin dans le journal peut rejeter à juste titre une exportation antérieure en la jugeant trop courte. Les exportations incluent l’intégralité du journal de l’espace de travail, indépendamment des filtres des panneaux ; veuillez examiner le contenu avant de le partager.
-
Demandez au destinataire de vérifier le fichier ZIP à l’aide d’une copie fiable du vérificateur, de l’ empreinte digitale fournie indépendamment et du certificat racine de l’autorité d’horodatage obtenu séparément. À partir d’un checkout fiable avec son environnement Python actif :
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidenceL’empreinte digitale et l’horodatage vérifié de la dernière entrée satisfont aux critères minimaux de preuve ; sinon,
--require evidencese termine avec le code 2. Le point de contrôle constitue une vérification complémentaire, car il est signé avec la clé du collecteur. Une sortie réussie renvoiekey_pinned: trueetcheckpoint_checked: truelorsque les deux entrées sont fournies et acceptées. Conservez le résultat de la vérification.For a handover requiring the final exported record to be witnessed, use `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`. This refuses an export with an unwitnessed tail. Add `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the witness posts as external time. See the [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).- Enregistrez le SHA-256 de l’archive, la limite d’exportation, la date de transfert, l’expéditeur et
le destinataire dans votre registre de conservation. Conservez le paquet d’origine intact et travaillez
à partir de copies. Partagez les fichiers de preuves plutôt que le répertoire de données privées de l’application,
qui contient également des sessions de compte et des secrets de signature.
Pour le transfert, choisissez un fichier ZIP AES-256 protégé par mot de passe ou le conteneur
.tgwpw, plus sécurisé. Le format ZIP utilise la dérivation de mot de passe peu coûteuse de WinZip ; utilisez une longue phrase de passe aléatoire. Le format.tgwpwutilise scrypt et AES-256-GCM et s’ouvre avec la commandeunseal-passworddu vérificateur autonome. Le mot de passe n’est pas stocké et ne protège que la confidentialité ; le destinataire déchiffre l’archive et vérifie l’exportation signée qu’elle contient, laquelle est inchangée. - Pour horodater un point de contrôle en dehors du mode de preuve, suivez la procédure RFC 3161 et conservez la requête, le point de contrôle, les informations relatives à l’autorité de certification (CA) de confiance et la réponse vérifiée de l’autorité. La simple préparation d’une requête ne permet pas d’obtenir un horodatage.
- Enregistrez le SHA-256 de l’archive, la limite d’exportation, la date de transfert, l’expéditeur et
le destinataire dans votre registre de conservation. Conservez le paquet d’origine intact et travaillez
à partir de copies. Partagez les fichiers de preuves plutôt que le répertoire de données privées de l’application,
qui contient également des sessions de compte et des secrets de signature.
Pour le transfert, choisissez un fichier ZIP AES-256 protégé par mot de passe ou le conteneur
Pour .tgwpw, utilisez un vérificateur obtenu de manière indépendante et choisissez un nouveau fichier de sortie
avec l’extension d’origine : python verify.py unseal-password export.tgwpw --out evidence.zip.
La commande vous invite à saisir le mot de passe ; --password-stdin lit une ligne pour l’automatisation.
Elle ne remplace jamais un fichier existant et ne publie le texte en clair qu’après l’authentification de tous les enregistrements.
Effectuez ensuite une vérification normale de la signature sur le fichier déchiffré.
Le conteneur utilise scrypt (N=131072, r=8, p=1, sel de 16 octets ; environ 128 Mio de RAM)
et AES-256-GCM avec des enregistrements de 1 Mio et un enregistrement final authentifié. Un enregistrement de métadonnées chiffré
stocke le nom de fichier interne, ce qui permet de renommer les conteneurs téléchargés.
Une vérification réussie établit l’intégrité par rapport à la clé de collecte de confiance et aux limites définies. Consultez la portée de la vérification pour connaître les hypothèses de confiance et les résultats de validation des contrôles effectués.
Extrait de la passation de pouvoir#
Un fichier ZIP signé contient l'intégralité du journal de l'espace de travail. Lorsqu'un tribunal, un avocat ou un service de lutte contre les abus n'a besoin
que de certaines conversations, d'une période donnée ou de certaines personnes, la fonction « Exportations → Extrait de transfert » prépare une copie allégée
(« tgwitness-handover-v1 ») conformément aux règles de divulgation sélectionnées.
L’opérateur précise l’objectif et choisit les conversations, une période facultative (UTC), les personnes concernées par l’
extrait, le sort réservé à toutes les autres personnes (affichées, remplacées par des pseudonymes P01, P02… ou omises
), quels textes de messages sont conservés, quelles pièces jointes et photos de profil sont incluses, et si
les numéros de téléphone et adresses e-mail présents dans les textes sont masqués. L’objectif et ces règles figurent dans le
manifeste signé et dans le rapport ; le journal enregistre « handover.exported » avec l’accès qui
l’a préparé et la valeur SHA-256 du fichier, et non son contenu.
Le script verify.py vérifie un extrait de deux manières. Un enregistrement indiqué comme inchangé est vérifié dans son intégralité : son
contenu est comparé à son hachage, à sa signature Ed25519 et à son lien vers un prédécesseur inclus. Un
enregistrement « minimisé » conserve la somme de contrôle et la signature d’origine ; la signature reste donc valide, mais les
champs omis ne peuvent pas être recalculés à partir de celles-ci ; l’enregistrement précise ce qui a été omis et le rapport
le signale. Les enregistrements de service à l’échelle du compte (démarrages et arrêts, lacunes de couverture, notifications de connexion, de réseau et de stockage,
modifications de portée et de paramètres) ne conservent que les champs répertoriés pour leur type : les listes de discussions qu’ils contiennent sont réduites aux
discussions et leurs totaux sont recalculés ; une lacune de sondage en temps réel dans une discussion hors de la sélection entraîne la perte de cette discussion, de ses
numéros de messages et du compte témoin ; dans une discussion de sondage sélectionnée, le compte témoin est remplacé par son pseudonyme, sauf si
tout le monde est affiché ou s’il s’agit de l’une des personnes sélectionnées. Le manifeste indique la longueur et l’en-tête du journal, avec la signature du collecteur sur cet
en-tête, et dénombre les enregistrements omis ; le fichier coverage.json décrit les discussions sélectionnées. Les nouveaux extraits contiennent également
le fichier proofs.jsonl : pour chaque enregistrement inclus et pour l’en-tête du journal, le chemin Merkle allant du
hachage d’origine de l’enregistrement à la racine du journal mentionnée dans le manifeste signé. verify.py vérifie chaque
chemin, de sorte que chaque enregistrement s’avère appartenir au même journal de cette longueur et de cet en-tête, sans le
journal complet ; un extrait de 100 messages est vérifié en environ une seconde, quelle que soit la taille du journal.
L’option --range=CHAT:FROM-TO confirme en outre que les messages de FROM à TO d’une conversation figurent dans l’extrait
et indique le nombre d’enregistrements vérifiés pour ceux-ci. Les noms contenus dans les
noms de fichiers ne sont pas détectés. Vérifiez les fichiers finaux avant de les partager : le texte libre, les noms de fichiers et les
pièces jointes sélectionnées peuvent toujours permettre d’identifier des personnes. Conservez le fichier ZIP signé complet : l’extrait est une divulgation, pas un substitut.
Rapports lisibles#
Les preuves signées, les transferts et les fichiers ZIP de discussions contiennent des rapports lisibles au format HTML et JSON, ainsi que
des PDF lorsque les polices requises sont disponibles, dans la langue sélectionnée pour le rapport. Chaque
rapport est scellé à l’aide de la clé Ed25519 de l’espace de travail et peut être vérifié séparément : `
python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`.
report.html/chat.html: l'instruction de scellage (tgwitness-report-seal-v1) ferme le fichier et signe le SHA-256 de chaque octet qui le précède. Les journaux et les discussions volumineux sont divisés en parties d'une taille configurable (paramètres du rapport, de 500 à 100 000 enregistrements ; 5 000 par défaut) :records/records-0001.htmloumessages/messages-0001.html, chacune scellée avec son numéro, sa plage et le total, et répertoriée avec son SHA-256 dans le manifeste signé. Les séries de signaux de présence du collecteur sont affichées sur une seule ligne, sauf si les paramètres du rapport prévoient de les lister une par une.report.json(tgwitness-report-json-v1, clésformat,report,seal) : le sceau signe le SHA-256 du JSON canonique dureport, ce qui permet aux systèmes de gestion des dossiers et aux scripts de lire les faits et d’effectuer une sélection à des fins de protection des données tout en préservant l’intégrité du fichier signé.report.pdf/chat.pdf: un document officiel destiné à l'impression et à l'archivage, signé deux fois sur les mêmes octets, c'est-à-dire l'ensemble du fichier à l'exception de la valeur de la signature (/ByteRange). La signature PDF standard est la norme PAdES de base (ETSI EN 319 142-1,/SubFilter /ETSI.CAdES.detached: CMS avec SHA-256 et ECDSA P-256, certificat de signature v2, pas d’horodatage CMS ; l’horodatage déclaré est/M) au niveau B-B, ou B-T avec un horodatage de signature RFC 3161 dans le CMS lorsque l’horodatage est activé et qu’une autorité d’horodatage répond via le circuit pour les requêtes en dehors de Telegram. Elle utilise un certificat de signature de document auto-émis conservé dans le coffre-fort de l’espace de travail ; son numéro de série de sujet correspond à l’empreinte digitale de la clé Ed25519. Le sceau Ed25519 circule au sein du CMS sous la forme de l’ attribut non signé2.25.240684792623320047764573196045913242332et désigne le SHA-256 du certificat avec"content": "pdf-byte-range", de sorte que la clé Ed25519 se porte garante du certificat. Le certificat n’est pas qualifié : un lecteur de PDF affiche la signature comme valide et le signataire comme inconnu ou non fiable tant que le certificat n’est pas considéré comme fiable ; comparez plutôt l’empreinte Ed25519 . Les PDF en chinois, japonais et coréen nécessitent une police sur le serveur (ou dansTGWITNESS_FONT_DIR) ; en l’absence de celle-ci, l’archive ZIP ne contient que les rapports HTML et JSON .report.en.html,report.en.pdf/chat.en.html,chat.en.pdf: l’original anglais du même rapport lorsque la langue du rapport n’est pas l’anglais, scellé et signé de la même manière et désigné sousreport.originaldans le manifeste signé. Le rapport dans la langue choisie commence par la recommandation de déposer l’original anglais avec une traduction certifiée ou assermentée ; voir Traduire les rapports pour la justice.
Dans un canal ou un supergroupe, Telegram
numérote les messages 1, 2, 3… dans l’ordre. Une exportation de discussion répertorie le
premier et le dernier numéro, le nombre de messages présents ainsi que chaque série de numéros manquants dans
message-ids.json
, le manifeste et l’en-tête chat.json
, et signale chaque lacune à l’endroit où elle se trouve dans
la transcription. verify.py
les recompte à partir de chat.json
. Un numéro manquant correspond à un message que Telegram
n’a pas renvoyé (supprimé avant l’exportation ou non visible pour le compte) ; dans les discussions privées et les
groupes de base, les numéros sont partagés entre toutes les discussions du compte et les lacunes ne sont pas comptabilisées.
Après avoir lu l’historique, l’exportation demande à nouveau à Telegram tous les numéros manquants, par numéro (channels.getMessages, jusqu’à 10 000 numéros, y compris les 1 000 situés en dessous du premier message, répartis de manière uniforme sur toutes les lacunes lorsqu’il y en a davantage). Le résultat figure dans message-ids.json et dans le rapport. Une réponse vide indique que le numéro n’est pas disponible pour ce compte au moment de la nouvelle vérification ; elle ne précise pas la cause. Un message renvoyé lors de la nouvelle vérification est ajouté à l’exportation et marqué found_on_recheck.
Lorsque l’espace de travail d’observation a détecté que des messages de la conversation avaient été supprimés, manquaient lors d’une nouvelle vérification ou avaient été modifiés, l’exportation de la conversation ajoute journal-changes.jsonl: ces enregistrements du journal, chaque version sauvegardée et la notification, chacun accompagné du hachage et de la signature Ed25519 qu’il a reçus dans le journal. verify.py Il recalcule le hachage de chaque enregistrement, vérifie sa signature par rapport à la clé d’exportation et compare le nombre avec le manifeste signé ; l’exportation des preuves contient la chaîne de hachages complète. Le rapport répertorie ces messages sous les rubriques « Suppressions » et « Versions antérieures ».
Chaque rapport commence par En bref : un paragraphe, puis ce que le contenu montre et ce que contient l’enregistrement. Le cachet de la page passe à l’ambre lorsque le navigateur a vérifié la signature du cachet, et non celle de la page : un navigateur ne fournit pas ses propres octets à une page. Il ne devient vert que lorsque le lecteur glisse le fichier dans la zone de vérification en bas de la page et que chaque octet correspond, et uniquement si la page affichée correspond bien à ce fichier ; sinon, il devient rouge.
Chaque rapport nomme le programme avec exactitude : le commit Git au moment où le collecteur s'exécute à partir d'un checkout ou
lorsque le programme d'installation définit TGWITNESS_COMMIT, ainsi que le SHA-256 de ses fichiers source (source_tree_sha256,
le JSON canonique du chemin → SHA-256 de chaque fichier .py, .js, .css, .html et .svg du
paquet), que reproduit un checkout de ce commit à moins que les fichiers n'aient été modifiés. Le client Telegram
est nommé d’après sa bibliothèque, sa couche API et son centre de données. Lorsque l’observation commence et lorsqu’une exportation de chat
débute et se termine, le collecteur demande à Telegram son heure (updates.getState, en
secondes entières) et enregistre l’heure de Telegram moins l’heure du collecteur, en tenant compte de l’incertitude liée au
temps de transit ; les rapports indiquent ces mesures sous la rubrique « Chaîne de traçabilité ». Une exportation de discussion enregistre également
le moment où l'historique a été lu, en plus des dates des messages.
Guide d'utilisation de la visionneuse de rapports hors ligne et de l'archive#
Décompressez l'archive ZIP complète avant d'ouvrir chat.html ou report.html. La visionneuse offre des fonctionnalités de recherche,
de filtrage, d'affichage des participants, des indicateurs, des détails des enregistrements et des sélections JSON/CSV sans serveur. Conservez
viewer/ et media/ à côté du rapport. Les sélections sont des dérivés : utilisez verify.py SELECTION.json
--evidence ARCHIVE.zip pour les comparer avec l'archive signée.
Le vérificateur contrôle l’ID du rapport, la clé de signature, la limite de l’archive et chaque élément sélectionné ; les éléments modifiés,
manquants ou en double sont rejetés. Les notes de sélection et l’heure de création restent des métadonnées non signées.
Les écarts entre les numéros de messages ne s'affichent que pour un flux de discussion complet, non filtré et classé par ordre croissant. Le fait de masquer une catégorie ou de ne pas parvenir à charger un bloc de données ne doit pas transformer une ligne omise en preuve de l'absence d'un message. Les surlignages de recherche s'appliquent au texte brut avant l'échappement « HTML », en conservant le balisage littéral.
Le navigateur vérifie les signatures du manifeste, l'ID et la clé du rapport, ainsi que tous les hachages de fichiers répertoriés. Il rejette les structures ZIP ambiguës ou mal formées, les noms en double et les chemins d'accès non sécurisés, et limite la taille des fichiers à 256 Mio et le volume total déclaré du contenu à 4 Gio. Utilisez le vérificateur autonome pour les archives plus volumineuses. Cette vérification par le navigateur complète les contrôles effectués par le vérificateur sur les chaînes de journaux et la sémantique des données.
Le fichier README.txt contient un guide de démarrage, un inventaire des fichiers alignés, des instructions de vérification et des
remarques sur le format des données dans la langue du rapport, suivis d’un guide complet en anglais. SHA256SUMS couvre les
fichiers qui y sont répertoriés, à l’exception de lui-même, de manifest.json et de manifest.sig ; le manifeste signé
couvre également SHA256SUMS. Ne modifiez pas le fichier ZIP d’origine et enregistrez les fichiers de travail en dehors du
dossier extrait. Les rapports PDF comprennent des signets de section et l’identification du dossier/rapport sur les pages suivantes.
La conversation au moment de l'exportation#
Une exportation de discussion enregistre ce que Telegram indiquait à propos de la discussion au moment où l'exportation a commencé : les propres
étiquettes de Telegram (scam, fake, restricted avec leurs justifications, verified), les noms d'utilisateur, la description, le nombre de
membres et d'administrateurs, la discussion associée, la protection du contenu, si les nouveaux membres peuvent voir les messages antérieurs
et à partir de quel message ce compte a accès à l'historique (available_min_id), la date
du message n° 1 lorsqu'il s'agit de la création du chat, et le SHA-256 de la photo du chat (enregistrée dans media/).
Il enregistre la place du compte exportateur dans le chat : rôle, date d'inscription, nom de la personne qui l'a invité et, pour un
administrateur, ses droits. Une demande refusée par Telegram est mentionnée à la place.
Lorsque le compte exportateur est un administrateur, l’exportation lit le journal d’administration de la discussion (conservé environ
48 heures par Telegram) dans le fichier admin-log.json : suppressions et modifications avec le contenu fourni,
le compte auteur et la date de l’action source. Ces entrées complètent les
versions capturées du journal en temps réel et les enregistrements de réception des suppressions.
Indicateurs#
La liste des rapports et l'archive contiennent les références indicators.csv
, indicators.stix.json
(STIX 2.1
)
et indicators.misp.json
(événement MISP
), sur lesquelles un service de signalement des abus peut agir dans les messages enregistrés :
liens et domaines (y compris ceux cachés derrière du texte, dans des boutons et dans les aperçus de liens), adresses de cryptomonnaies,
noms d’utilisateur et liens d’invitation Telegram
, numéros de téléphone, adresses e-mail et images enregistrées.
Les adresses Bitcoin, Litecoin, Dogecoin et TRON ne sont répertoriées que si leur somme de contrôle base58 est valide,
les adresses SegWit si leur somme de contrôle bech32 ou bech32m est valide et les adresses TON si leur CRC
est valide ; les adresses EVM et Solana sont marquées comme non vérifiées. Les images comportent un SHA-256
et un hachage perceptuel
(dHash, 64 bits) que les copies recompressées ou redimensionnées conservent pratiquement inchangés. Les rapports enregistrent
des indicateurs afin qu’ils ne s’ouvrent pas par accident (hxxps[://]example[.]com
) ; les fichiers conservent les
valeurs telles qu’elles étaient. Chaque indicateur est marqué comme inconnu et non destiné à la détection automatique (STIX
,
indicator_types: unknown
, MISP
, to_ids: false
, distribution à la propre organisation) : le fait qu’il soit
répertorié indique qu’un message le contenait, et non qu’il est malveillant. Un lien dont le texte affiche une
adresse différente de celle vers laquelle il redirige est signalé dans le rapport.
Les rapports PDF se terminent par une déclaration de l'examinateur à signer à la main, une liste de contrôle destinée à un notaire ou à un expert judiciaire, ainsi qu'un code QR (également présent sur la première page) contenant l'identifiant du rapport, l'empreinte de la clé et le SHA-256 des données faisant autorité, de sorte qu'une impression permette de remonter jusqu'à son archive.
Canonisation des événements#
L'entrée de hachage se compose exactement des champs suivants :
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
Sérialisation au format JSON compatible Python avec UTF-8, clés d’objets triées, sans échappement ASCII, sans espaces insignifiants et sans NaN/infini :
json.dumps(value, ensure_ascii=False, sort_keys=True,
separators=(",", ":"), allow_nan=False).encode("utf-8")
Le SHA-256 de ces octets constitue le hachage de l’événement. La signature est générée à l’aide de l’algorithme Ed25519 sur les 32 octets bruts du hachage, puis encodée en base64. Le premier « previous_hash » est constitué de 64 zéros. Les numéros de séquence commencent à 1 et augmentent de 1. Tous les événements, y compris les événements opérationnels, partagent une seule chaîne. Il n’y a pas de suppression des doublons : les observations répétées constituent des reçus distincts, et non une affirmation d’actions distinctes sur Telegram.
Les données brutes de Telegram sont des chaînes ISO ; les champs binaires deviennent des objets contenant
des octets en base64. Le texte du message, les entités, les descripteurs multimédias, les métadonnées de réponse, les réactions
et les actions de service sont conservés dans les métadonnées brutes du message lorsqu’ils sont fournis. Un message en direct
conserve également la mise à jour de Telegram qui l’a transmis transport_update; lorsque
cette mise à jour transporte le même message que raw, son message champ est
{"same_as": "raw"} au lieu d’une deuxième copie.
observed_at correspond à l'heure UTC à laquelle le collecteur a créé l'enregistrement ; source_at est la date
fournie par cet événement Telegram. Les enregistrements créés lors du traitement d’une mise à jour en temps réel ajoutent
payload.received_atl'heure UTC à laquelle la mise à jour a atteint le collecteur, et
payload.processing_delay_ms. Les modifications en temps réel conservent la date de modification fournie, les
instantanés d’historique conservent la date du message avec une heure d’observation actuelle, et une
notification de suppression ordinaire enregistre l’heure de réception avec une date source nulle. Les entrées du journal d’administration
conservent séparément la date d’action fournie. L’ordre de réception et l’ordre des
événements sources constituent des chronologies distinctes, avec des observations d’horloge et des accusés de réception externes
disponibles à des fins de comparaison.
Sémantique des acteurs#
L’attribution suit la source de l’événement. message.new.actor_id et
message.edited.payload.sender_id indiquent l’expéditeur du message. Les notifications ordinaires
message.deleted comportent des identifiants de message et ont un champ acteur nul ;
les entrées disponibles du journal d’administration comportent l’action, l’acteur et la date fournis.
Les messages du service d’adhésion indiquent l’expéditeur et le type d’action, les mises à jour brutes des participants
conservent l’actor_id fourni, et les instantanés de réaction préservent leurs
comptages et identités visibles fournis. Lisez ces enregistrements conjointement avec les versions capturées
et les reçus d’interaction avec le panneau.
Les notifications de suppression pour les discussions privées et les groupes ordinaires ne contiennent que des identifiants de message.
Ces discussions partagent une séquence d’identifiants à l’échelle du compte ; ainsi, un identifiant désigne un message unique de
ce compte. Lorsqu’un message portant cet identifiant a été enregistré précédemment dans ce journal, la
suppression est consignée dans cette discussion sous la forme message.deleted, avec payload.chat_resolution
comme nom de la méthode. Les identifiants qui n’ont jamais été enregistrés sont conservés sous la forme deletion.unscoped : il s’agit d’une
notification de suppression effective dont la discussion n’a pas été mise en corrélation. Ceci se distingue
de message.missing_on_recheck, qui enregistre un résultat de requête indisponible, et
d’une lacune dans les identifiants de messages enregistrés. Les canaux et les supergroupes numérotent les messages par discussion et ne sont
jamais mis en correspondance de cette manière. Lorsque le message supprimé a été envoyé par le compte observé,
payload.deleted_message_was_outgoing est vrai ; l’auteur de la suppression n’est toujours pas fourni.
Une notification sans périmètre conserve son propre libellé car la conversation correspondante peut se situer en dehors du périmètre d’observation actuel ou ne pas avoir de correspondance unique. La vérification d’absence reste une observation distincte d’une notification de suppression dans les comptages de rapports, les filtres et les libellés. Une récupération ultérieure efface l’état d’absence actuel tout en conservant la vérification infructueuse antérieure dans l’historique signé ; les notifications de suppression restent un type d’événement distinct.
Les identifiants multiples correspondant à une même conversation à partir d’une seule notification sont regroupés sous le nom
deletion.batch, quel que soit leur nombre, avec les identifiants de message tels que Telegram
les a envoyés et le nombre de messages que ce compte a envoyés. La notification de Telegram
répertorie les messages ; le journal d’administration de la conversation mentionne le nom de l’administrateur en fonction, là où le compte
peut le consulter. Le lien (message.deletion_attributed) est établi selon la première occurrence :
une requête ayant détecté l’entrée du journal d’administration avant l’avis de suppression est mise en correspondance lorsque l’avis
est enregistré.
Portée : continuité, lacunes et identifiants non observés#
Chaque fichier ZIP signé porte la référence « coverage.json » ; le rapport HTML s'ouvre sur ce même résumé, et «
verify.py » le recalcule à partir de « events.jsonl » au lieu de se fier au fichier :
- Observation continue de X à Y. Une période commence par
observation.startedet se termine par une pause, un arrêt, une perte de connexion Telegram, une déconnexion, un démarrage de processus sans arrêt ordonné, ou plus de trois minutes sans aucun enregistrement pendant l’observation (des signaux de vie sont écrits toutes les minutes ; ainsi, le silence signifie que le processus s’est arrêté, s’est figé ou que l’ ordinateur est passé en veille). Lorsque l’intervalle entre les battements de cœur est modifié dans Plus d’outils → Paramètres, chaque battement de cœur enregistre cette modification et le silence autorisé passe à trois intervalles, jamais moins de trois minutes. - Les lacunes indiquent le délai entre deux périodes, accompagné de la raison. Une lacune toujours présente lors du dernier
enregistrement est signalée par le code «
not_resumed_by_last_record». - Les identifiants de messages non observés. Pour les chaînes et les supergroupes, qui numérotent les messages par discussion, les identifiants manquants entre ceux qui ont été observés sont répertoriés sous forme de plages. Ils sont signalés comme « non observés » — supprimés, jamais remis ou hors de l'historique enregistré — jamais comme « supprimés ». Les discussions privées et les groupes ordinaires partagent une séquence valable pour l'ensemble du compte ; ainsi, les lacunes au sein d'une telle discussion n'ont aucune signification et n'y sont pas répertoriées.
- Les notifications de lacunes au niveau des conversations (par exemple, lorsque Telegram demande la récupération des différences dans un canal) sont comptabilisées comme des notes ; elles n’interrompent pas la couverture globale.
- Enregistrements de session. Les fenêtres au cours desquelles le compteur de mises à jour de Telegram a augmenté alors qu’aucune mise à jour
n’est parvenue à cette session (
updates_diverted), où cette session a quitté la liste des sessions de Telegram alors que sa connexion restait active (session_revoked_externally), ou encore où la réponse d’une sonde témoin n’est parvenue qu’à partir de l’historique (probe_ack_missed_live) sont répertoriées séparément. Le vérificateur indique également la provenance de la clé de session Telegram, les autres sessions connectées au moment où l’observation a commencé, les sessions ajoutées pendant l’observation, les notifications de sécurité de Telegram (777000), les autres sessions terminées depuis l’espace de travail, les périodes « session uniquement », le nombre de sondes témoins et les mises à jour relatives aux appels téléphoniques. Voir les comptes. Lorsque l’option Chats strictement sélectionnés est activée (scope.strictdansobservation.started), la liste des sessions (sauf si c’est la seule session ou si l’option Appareils Telegram est activée), les notifications de sécurité et les mises à jour des appels téléphoniques ne sont pas collectées ; leur absence n’a donc aucune signification, et une suppression n’est associée à une session qu’une session s’est déroulée au cours des 10 minutes précédentes.
Séquence de mise à jour (pts)#
Telegram propose des mises à jour liées aux messages avec pts: une séquence pour le compte
(discussions privées et groupes de base confondus) et une pour chaque chaîne ou supergroupe. Le
collecteur enregistre chaque séquence reçue sans interruption sous forme d’un coverage.sequence
enregistrement : le premier et le dernier pts, le nombre de mises à jour de chaque type, et si elles
ont été transmises en temps réel ou renvoyées par getDifference ou getChannelDifference. Une interruption correspond à un
coverage.gap enregistrement, et coverage.gap_closed désigne le pts à partir de laquelle la séquence
est à nouveau complète.
Une série ininterrompue montre que toutes les mises à jour de Telegram numérotées dans cette séquence, entre
la première et la dernière, pts a bien été reçue par le client Telegram de ce collecteur. Cela ne dit rien sur le
contenu que Telegram n’a jamais envoyé à ce compte, ni sur la période antérieure à la première mise à jour enregistrée
pts, ni des séquences que le collecteur n’a pas consignées. Une pts avance qui n’est couverte par aucune
série ou différence enregistrée est représentée par une interruption.
GET /api/continuity indique si, sur un intervalle (since, until, chat_id) si chaque
séquence est ininterrompue et énumère les ruptures avec leurs causes. verify.py affiche les mêmes informations
à partir des enregistrements d'une archive sous « Continuité des séquences ».
Numéros de messages manquants (gap_summary)#
For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.
Aperçu. coverage.json → gap_summary mesure les numéros attribués par Telegram et que ce
collecteur n’a jamais détectés. Telegram numérote les messages une fois par chaîne ou supergroupe, et une fois par
compte pour l’ensemble des discussions privées, des bots et des groupes ordinaires. Un numéro situé entre deux
messages observés est soit observé, soit manquant ; une plage contiguë indique de manière certaine que
tous les messages qui y sont numérotés ont été observés. Une lacune ne désigne ni acteur ni raison.
| Domaine | Signification |
|---|---|
status |
on ou off lorsqu’il est désactivé dans Plus d’outils → Paramètres → Analyse des écarts |
parameters |
Les paramètres ayant permis d'obtenir ce résultat, afin de pouvoir le reproduire |
chats[] |
Une entrée par canal ou supergroupe, chacune étant numérotée individuellement |
account |
La séquence, à l'échelle du compte, des discussions privées, des bots et des groupes classiques |
status (par séquence) |
applicable, ou not_applicable avec reason |
observed_from, observed_to, span |
Numéro observé en premier et en dernier, ainsi que la taille de la plage |
observed, observed_without_content |
Numéros observés ; ceux qui ne sont connus qu’à partir d’un enregistrement de suppression ou de nouvelle vérification |
missing, density, gap_ranges, largest_gap |
Nombres jamais observés, leur part dans l'intervalle, nombre d'itérations, itération la plus longue |
clusters[] |
Listes des lacunes : low, high, missing, ainsi que les numéros observés adjacents after / before avec leurs heures d'observation |
service_estimate |
Uniquement lorsque cette option est activée : nombre de numéros manquants qui correspondraient à des messages de service, compte tenu de leur part observée. Jamais soustrait de missing |
La validité est dérivée du journal, elle n'est jamais présumée :
- Les canaux et les supergroupes sont mesurés par discussion, y compris lors de l'exportation des discussions sélectionnées.
Les enregistrements sélectionnés par l'expéditeur constituent la base de la mesure
not_applicable. - La séquence à l'échelle du compte est mesurée uniquement du premier au dernier message
reçu alors que la collecte de l'intégralité du compte était activée et inclut les discussions privées, les bots, les
groupes ordinaires et les messages propres au compte, sans exclure aucune de ces discussions (
scope.changed). Les numéros désignés pardeletion.unscopedsont considérés comme observés sans leur contenu. Une exportation ou un transfert de discussions sélectionnées ne permet pas de la mesurer. Si la collecte de l’ensemble du compte a été désactivée puis réactivée, une note indique que les numéros utilisés entre-temps apparaissent sous forme de lacunes. - Les messages de service sont des entrées de journal dotées de leurs propres numéros ; ils comblent donc eux-mêmes leurs lacunes ; l'estimation facultative ne sert qu'à fournir du contexte.
verify.py recalcule gap_summary à partir de events.jsonl à partir des paramètres du
coverage.json (valeurs par défaut pour les archives plus anciennes) et
affiche la ligne relative à l’ensemble du compte dans son résumé de couverture. Le get_capture_status(MCP et ligne de commande) renvoie la même mesure pour les discussions qu’un accès peut lire ;
la séquence à l’échelle du compte ne s’applique qu’aux accès couvrant l’ensemble de l’espace de travail.
Les observations répétées d’un même message de service ne comptent qu’une seule fois, et l’estimation du service de compte n’utilise que les nombres compris dans la plage mesurée. Une portée appliquée doit explicitement préserver les messages propres au compte avant que la mesure à l’échelle du compte ne soit activée ; la mesure commence à partir des enregistrements qui contiennent ces informations. La plage mesurée couvre l’observation en cours , et sa reprise est notée. La requête d’archive en temps réel dispose d’un budget temporel, incluant l’analyse de sa base de données, et marque une mesure inachevée comme partielle.
Telegram documente les séquences d’identifiants de messages distinctes. Ces numéros décrivent les observations ; les avis de suppression, les vérifications supplémentaires et l’enregistrement du journal d’administration expliquent pourquoi un numéro est absent là où Telegram le signale.
Lorsque Telegram cesse d’accepter le compte, l’enregistrement coverage.gap qui met fin à la surveillance
contient cause (account_banned, account_frozen, account_deleted, session_duplicated,
session_revoked, session_expired, session_ended ou not_authorized) et l’erreur Telegram
; verify.py indique la cause de la fin de la période.
La couverture combine les périodes d’observation enregistrées, les interruptions et les résultats des messages. Évaluez-la en fonction des discussions sélectionnées, de la période et de la politique relative aux pièces jointes ; revérifiez les résultats et les lacunes enregistrées pour déterminer dans quelle mesure les mises à jour du compte ont été observées.
Producteur#
Le manifeste signé des fichiers ZIP de preuves, des exportations de discussions, des journaux de témoins et de la déclaration des
fichiers de profil utilisateur contient producer : logiciel, version, projet (PhishDestroy),
page d’accueil et dépôt source. Le rapport HTML et le vérificateur affichent cet enregistrement signé
du producteur. Les hachages des fichiers source identifient l’arborescence source enregistrée à des fins de comparaison
avec une version de référence fiable. La provenance de l’exécution est vérifiée séparément par
l’attestation d’acquisition GitHub ou
les mesures Intel TDX, lorsqu’elles sont activées. Les archives créées avant
l’existence du champ producteur restent prises en charge et sont identifiées comme des enregistrements hérités.
Chaque enregistrement observation.started mentionne également le client Telegram qui a effectué l’observation : son api_id
(jamais le hachage), qu’il s’agisse d’une paire publique intégrée ou de l’application propre à l’opérateur,
la description du client envoyée dans la demande de connexion Telegram, ainsi que le type de route de connexion
avec le mode IP (sans adresse proxy ni secret). Le rapport et le fichier « custody.json » répertorient chaque
client et chaque itinéraire distincts avec leur date d’enregistrement, ainsi que les moments où aucun proxy répertorié n’a répondu
et où le fichier « Telegram » a détecté l’adresse du serveur. Les journaux enregistrés avant celui-ci le mentionnent.
Profils de personnes#
Un fichier de profil (tgwitness-dossier-v1, JSON) est généré sur demande à partir des enregistrements déjà présents
dans le journal pour une conversation donnée ; aucune donnée n’est récupérée depuis Telegram et le contenu du profil n’est jamais
enregistré dans le journal (l’activation et la désactivation des profils sont consignées sous la référence dossier.changed).
Pour chaque personne dont un message a été enregistré, il répertorie l’historique des noms et des noms d’utilisateur, les indicateurs Telegram
(bot, arnaque, faux, premium, vérifié, restreint, supprimé) tels qu’ils apparaissaient au moment de l’enregistrement, les
identifiants de photo de profil, le hachage SHA-256 et le hachage perceptuel (pHash, compatible avec imagehash.phash) de l’
avatar issu du cache local d’avatars contenant des avatars similaires, l’activité (premier et dernier message,
nombre de messages, partages modifiés et supprimés, messages par heure UTC), qui répond à qui, les autres discussions
de ce journal dans lesquels la personne a écrit, ainsi que les portefeuilles mentionnés (BTC, EVM, TRON, TON, LTC,
DOGE, XMR, SOL ; les adresses Base58Check sont validées par somme de contrôle), les numéros de téléphone, les noms d’utilisateur et les
liens, y compris les liens masqués derrière du texte.
Chaque fait indique les entrées du journal (seq) dont il est issu, et record_hashes contient le
hachage de chaque entrée référencée. La déclaration est signée avec la clé de l'espace de travail :
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
Vérifie la signature, valide l’exportation des preuves elle-même (signature, chaîne de hachages et fichiers) et s’assure que chaque enregistrement référencé existe tel quel dans cette exportation du même espace de travail. Les hachages des avatars sont signalés comme provenant du cache local (et non des enregistrements du journal). Les mentions sont des correspondances de motifs et des pistes à vérifier. Les profils sont activés pour chaque discussion, peuvent être exportés sous forme de fichier ZIP chiffré en AES-256 avec un mot de passe, et sont supprimés lorsqu’ils sont désactivés ou lorsque la discussion est supprimée des sources.
Témoin indépendant#
Un journal de témoin (tgwitness-witness-v1) et ses publications sur le canal sont vérifiés par rapport à une
exportation de preuves à l’aide de verify.py --witness … --channel … ; voir témoin indépendant.
À partir d’une adresse publique https://t.me/s/… ou https://telegram.me/s/…, le vérificateur lit
la date de chaque publication sur Telegram, et la date la plus ancienne d’une publication en tête de l’exportation
correspond à l’heure externe du dernier enregistrement. Les dates provenant de toute autre source constituent des métadonnées fournies.
Manifeste et points de contrôle#
Le fichier `manifest.json` inclut le format, l’heure d’exportation, la clé publique, l’empreinte digitale, la longueur du journal,
le hachage d’en-tête, la portée, le producteur, les limitations et le SHA-256 de chaque élément de contenu autre
que les fichiers manifest.json et manifest.sig eux-mêmes.
Le fichier `manifest.sig` correspond à la signature Ed25519 en base64 du manifeste JSON canonique.
Le vérificateur rejette les éléments inattendus ou manquants, les noms en double, les fichiers corrompus,
les séquences ou chaînes brisées, les signatures non valides et les incohérences avec un point de contrôle fourni.
Il n’extrait jamais les chemins d’accès aux archives. Il limite la taille totale déclarée non compressée à 4 GiB ;
--max-gib N permet de créer des archives plus volumineuses en augmentant la limite définie dans Plus d’outils → Paramètres.
Une archive volumineuse est vérifiée simultanément par plusieurs processus : les membres sont hachés en parallèle,
et après les 5 000 premiers enregistrements, le hachage du contenu et la signature de chaque enregistrement sont vérifiés
par des processus de travail tandis que le processus principal suit la chaîne, la couverture et les liaisons
dans l'ordre. --jobs N définit le nombre de processus ; par défaut, auto utilise un processus par CPU, avec
un maximum de 16, et --jobs 1 conserve tout dans un seul processus. Le résultat est le même dans les deux cas,
et toute modification est refusée avec le même message. Les hachages aux positions indiquées par les
points de contrôle conservés et les ancres de horodatage sont conservés pendant ce passage unique, de sorte que chaque ancre est
comparée sans relire le journal. Sur un ordinateur à 32 threads, une archive de 10,8 Go contenant
400 000 enregistrements a pris 58,9 s dans un seul processus, 15,2 s avec 4 et 8,4 s avec 16 ; un seul passage sur les
enregistrements dans l’ordre permet alors de fixer la limite.
Lancez la vérification à partir de votre version TgWitness installée ou d’un checkout validé. La copie incluse dans l’archive permet une utilisation portable ; comparez-la à votre installation de confiance avant de l’exécuter.
Un point de contrôle signe une déclaration contenant la clé publique, la longueur du journal, le
hachage de tête et l’heure de création. Il transporte également le dernier tour drand que l’espace de travail a
récupéré (drand_anchor
) : le collecteur interroge un relais drand via la
route externe de l’espace de travail avant chaque point de contrôle périodique ; ainsi, Hide IP, les proxys et une
route externe désactivée s’appliquent, et le point de contrôle lui-même ne se connecte jamais à l’extérieur. Le vérificateur peut vérifier
qu’une archive ultérieure contient le même préfixe. Avec --checkpoint
et --check-drand
, il confirme ce tour auprès des relais drand et signale que le point de contrôle a été signé
au plus tôt à l’heure du tour ; le tour ne modifie pas le niveau d’assurance. Conserver
le point de contrôle en dehors du collecteur, afin que la vérification ultérieure compare l’archive à une
référence conservée séparément de celle-ci. La clé du collecteur la signe, ce qui signifie qu’elle
ne lie les enregistrements à celle-ci que si le destinataire l’a obtenue avant l’archive, par le biais
d’un autre canal ; à elle seule, elle ne satisfait pas au minimum requis en matière de preuve.
Lecture d’un résultat de vérification#
Le vérificateur rend compte séparément de l’intégrité des archives, de la vérification de l’identité du signataire et des contrôles d’assurance.
Une signature valide indique que les octets n’ont pas été modifiés depuis leur
signature. L’opérateur transmet l’empreinte de la clé au destinataire par un canal distinct.
Sans --fingerprint, une archive intacte passe avec succès les contrôles de signature et de format
, signer_pinned: false, et la ligne finale commence par
EVIDENCE: minimum not met · missing: confirmed signer key.
Pour une politique d’archivage local automatisée qui nécessite un signataire épinglé et le minimum requis en matière de preuves :
python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence
Utilisez une empreinte conservée via le canal de confiance du destinataire. Un
témoin de confiance peut également épingler le collecteur via un journal attesté cohérent ; fournissez
--witness, --witness-fingerprint et --require-witness. --strict se termine avec le
statut 2 pour un signataire non épinglé ; un --require-tier ou --require evidence non satisfait entraîne également
une sortie avec le statut 2. --require evidence nécessite --fingerprint et une horodatation externe provenant d’un
tiers couvrant le dernier enregistrement.
Consultez signer_pinned, requirements_met et les résultats d’assurance, et non pas uniquement le
code de sortie. L’acquisition scellée utilise plutôt son
vérificateur d’attestation et sa politique approuvée pour authentifier le résumé de l’acquisition.
Périmètre de vérification#
La vérification porte sur l’archive et le mode de collecte utilisé pour la produire. Choisissez le mode dont la limite de confiance correspond au cas, puis conservez ses données d’entrée de vérification.
| Mode de collecte | Ce que vérifie le vérificateur | Données de vérification et périmètre de confiance |
|---|---|---|
| Espace de travail local | Enregistrer les signatures, la chaîne de hachages, le manifeste et les octets des pièces jointes | Empreinte digitale du collecteur conservée par le destinataire et horodatage externe provenant d’un tiers : reçus vérifiés selon la norme RFC 3161 ou OpenTimestamps, ou publications de témoins lues sur t.me. Les points de contrôle et les enregistrements de témoins conservés servent de justificatifs. |
| Espace de travail local avec un témoin indépendant | Vérification des archives et cohérence avec un préfixe de journal antérieur conservé par le témoin | Empreinte et enregistrements du témoin ; le registre de contrôle de clé du dépositaire indique qui détient la clé du témoin. Avec --channel https://t.me/s/…, les dates que Telegram a apposées sur les publications fournissent un temps externe |
| Capture GitHub Actions | Attestation GitHub du résumé de l'archive, du workflow approuvé et des commits du collecteur, du runner hébergé, de l'origine de la session/clé récente et de l'intégrité interne de l'archive | Politique de vérificateur de confiance, référentiel d’appelants et ensemble d’attestations GitHub ; la collecte s’effectue selon le workflow épinglé |
| Déploiement dans le cloud | Historique du cycle de vie et des accès du fournisseur, état du pare-feu et de Cloudflare, ainsi que le journal d'exécution signé du collecteur | Requêtes en lecture seule adressées au fournisseur et à Cloudflare ; la disponibilité des vérifications individuelles dépend du fournisseur. |
| Machine virtuelle confidentielle Intel TDX | Citer la signature et l'état de la plateforme, en établissant un lien avec la déclaration du collecteur, la composition et les mesures du système d'exploitation | Chaîne de confiance Intel et mesures de déploiement prévues ; conserver les résultats de chaque vérification TDX requise |
Lors d’une acquisition scellée, le collecteur agréé reçoit les données via une connexion Telegram authentifiée au sein de l’environnement vérifié. L’attestation lie l’archive à cette exécution ; la vérification porte donc aussi bien sur l’acquisition que sur l’intégrité ultérieure du fichier. Ce processus repose sur le code agréé et la chaîne de confiance de la plateforme mentionnée ci-dessus. La vérification des captures GitHub nécessite une session créée au cours de l’exécution et rejette les captures issues de sessions importées.
Le reçu d'exécution enregistre la version du collecteur, les hachages des fichiers et les paramètres de démarrage. La provenance GitHub et les mesures TDX permettent de vérifier l'environnement ; l'enregistrement de validation identifie les configurations testées.
D’où proviennent les messages ?#
Telegram transmet les messages à chaque client, y compris les applications officielles, au sein d’une session MTProto. La clé d’autorisation de la session est négociée par rapport à la clé de serveur fixe de Telegram, et chaque mise à jour est transmise sous forme chiffrée et fait l’objet d’un contrôle d’intégrité à l’aide de cette clé. Le collecteur reçoit les messages via la session authentifiée du compte et enregistre chaque observation dans le journal dès son arrivée, en indiquant les identifiants du chat, du message et de l’expéditeur, ainsi que la date attribuée par Telegram à chaque message. Dans les Actions et les déploiements Intel TDX, l’attestation lie également cette session et la clé de signature à l’exécution approuvée du collecteur.
Le journal enregistre la provenance de la clé d’autorisation. Une connexion par téléphone ou via un QR code,
ou une connexion indépendante à partir d’un fichier de session, écrit account.authorized avec
key_origin: "created" ; la collecte à partir d’un fichier .session importé, d’une clé TData ou JSON écrit
imported. Une clé importée existe également quelle que soit sa provenance. Les déploiements certifiés
refusent les clés importées.
L'origine Telegram d'un enregistrement repose sur la connexion authentifiée du compte, les
enregistrements de connexion et de capture dans le journal, les trames MTProto capturées mises en correspondance avec les entrées du journal
(tgwitness/forensics/), la date Telegram de chaque
message et, pour une capture certifiée, l'environnement d'exécution vérifié. Les signatures d’archive
préservent cet enregistrement en vue d’une vérification ultérieure. Les points de contrôle conservés fixent les limites antérieures du journal,
les enregistrements de couverture indiquent les résultats de la collecte, et les horodatages externes vérifiés
situent les octets validés dans le temps.
Pour un espace de travail local, le destinataire fournit des données d’entrée provenant d’un collecteur ou d’un témoin de confiance. Pour une acquisition scellée, la politique de confiance et l’attestation lient le résumé de l’archive à l’exécution approuvée du collecteur. Il s’agit de chemins de vérification différents ; signalez les vérifications effectuées pour le chemin sélectionné.
Pièces jointes#
Les fichiers sont identifiés par leur hachage SHA-256 dans le répertoire « media/ ». Un événement « media.saved » associe un hachage et une longueur en octets à un événement de message spécifique. Les noms de fichiers bruts constituent des métadonnées, et ne correspondent jamais à des chemins d’accès locaux. Les octets multimédias sont téléchargés de manière asynchrone ; une suppression immédiate peut donc empêcher leur capture. La collecte désactivée, les fichiers trop volumineux ou de taille inconnue, les échecs de téléchargement et les téléchargements interrompus apparaissent comme des résultats. Un plantage du processus peut laisser des fichiers partiels non référencés ; ceux-ci ne sont pas inclus dans les exportations.
L'exportateur ZIP vérifie la correspondance entre les fichiers multimédias stockés et leurs noms. Les exportations au format JSONL, CSV et HTML vérifient les signatures des événements mais ne contiennent pas les données multimédias. Les rapports dérivés sont fournis à titre pratique ; le fichier events.jsonl constitue la représentation officielle des événements.
Une exportation complète d'une conversation enregistre les pièces jointes, conformément aux paramètres de l'espace de travail, dans le répertoire
media/, sous le nom SHA-256. Chaque enregistrement de message dans chat.json indique le nom de son fichier (file,
file_sha256) ou la raison de son absence (file_status), ainsi que ce que le lecteur a vu
autour du texte : liens derrière le texte, origine du transfert, boutons de bot, signature, vues et
le compte à rebours de suppression automatique. verify.py vérifie que chaque fichier nommé figure dans le manifeste signé
sous ce hachage.
Collecte et traitement durables des justificatifs (0,2)#
Une tâche multimédia et la validation de l’événement de message s’effectuent en une seule transaction. La tâche stocke le descripteur du message TL d’origine ; l’observation signée associe son SHA-256, son compte et sa politique de taille. La récupération vérifie cette association avant le téléchargement. Elle ne récupère jamais le message actuel et ne le remplace pas silencieusement par une pièce jointe plus récente. Les tâches interrompues sont relancées, tandis qu’un échec permanent reste un résultat explicite.
Chaque espace de travail dispose de son propre journal et de sa propre identité de signature. Un événement process.started comprend un identifiant d’exécution, les horloges locales, les versions des dépendances, les hachages des fichiers source, le compte/la portée initiaux, ainsi que les paramètres de capture. Les signaux de vie (heartbeats) comprennent l’identifiant d’exécution, le temps monotone et l’état de la file d’attente. Le reçu d’exécution peut également être téléchargé sous la forme d’un document signé séparément. Pour la vérification de l’environnement d’exécution, associez-le à l’attestation GitHub ou aux contrôles TDX décrits dans Portée de la vérification.
Les points de contrôle automatiques sont conservés localement au démarrage, toutes les cinq minutes pendant l’ observation (Plus d’outils → Paramètres → Point de contrôle signé toutes les), et lors d’un arrêt ordonné. La vérification au démarrage et l’exportation comparent le journal au dernier point de contrôle local conservé. Cela permet de détecter une annulation de la base de données lorsque le point de contrôle subsiste. Une conservation indépendante maintient cette référence disponible en dehors de l’espace de travail ; un horodatage externe vérifié l’ancre en outre dans le temps.
Après un redémarrage, la position de mise à jour de Telegram enregistrée est reprise (catch_up_from dans observation.started) et les mises à jour manquées sont demandées. La position enregistrée ne couvre que les mises à jour dont le traitement est terminé ; par conséquent, les mises à jour encore en attente au moment de la fermeture de la connexion ou de l’arrêt du processus sont demandées à nouveau. Une vérification périodique recense message.recovered les messages manqués et message.missing_on_recheck lorsque Telegram ne renvoie plus de message enregistré ; ce dernier cas ne constitue pas un avis de suppression et ne mentionne ni l’auteur de la suppression ni l’heure.
Sauvegarde et restauration hors site (S3)#
La copie hors site (Paramètres → Notifications et copie hors site → Copie hors site, ou
Plus d’outils → Extras → Preuves et sauvegardes ; désactivée par défaut) télécharge les segments de journal, les fichiers conservés, les points de contrôle
avec leurs horodatages et les exportations de discussions terminées vers un stockage compatible S3, chiffrés avec
AES-256-GCM avant le téléchargement à l’aide d’une clé conservée dans le coffre-fort de l’espace de travail ; la conservation Object Lock s’applique
lorsque le compartiment la prend en charge. Sans la clé téléchargée, la copie ne peut pas être lue. Restaurez et vérifiez
à l’aide de python -m tgwitness.replica restore --key-file KEY.json --out DIR.
La restauration nécessite un répertoire ordinaire vide. Les téléchargements et les objets déchiffrés restent dans un espace de stockage temporaire privé jusqu’à ce que l’intégralité du journal et chaque point de contrôle conservé soient vérifiés. Les chemins d’accès aux objets non sécurisés, les plages de segments incohérentes et les journaux plus courts qu’un point de contrôle sont rejetés ; en cas d’échec de la vérification, aucun fichier restauré n’est publié. Les contrôles de conservation comparent le mode « Object Lock » et la date renvoyés avec le délai envoyé lors du téléchargement (tolérance d’arrondi d’une seconde). Un délai expiré, non valide ou raccourci n’est pas considéré comme vérifié. Le statut indique l’objet échantillonné dont la conservation a été relue pour ce cycle de téléchargement.
Les fichiers locaux manquants ou corrompus sont signalés comme une erreur du cycle et le curseur de fichier reste positionné avant ceux-ci, de sorte que le fichier soit réessayé lors du cycle suivant ; les fichiers, points de contrôle et exportations qui suivent sont tout de même copiés. La restauration vérifie toutes les références aux fichiers conservés par rapport aux hachages déchiffrés et aux tailles enregistrées. Les segments de journal identiques qui se chevauchent provenant de téléchargements interrompus sont dédupliqués ; les chevauchements conflictuels sont rejetés. Les points de contrôle créés au cours d’un téléchargement sont reportés jusqu’à ce que les enregistrements du journal qu’ils couvrent aient été copiés, de sorte qu’un passage terminé ne publie pas de point de contrôle avant son journal.
Exportation en continu d’instantanés#
Les exportations en continu utilisent un instantané de lecture SQLite stable. Son début peut être antérieur au journal en ligne actuel une fois le téléchargement terminé. Un point de contrôle créé après cet instantané peut indiquer à juste titre que l’archive est plus courte ; comparez-le à un point de contrôle situé au niveau ou avant le préfixe exporté, et non à un point de contrôle ultérieur choisi arbitrairement.
Préparation de la norme RFC 3161 et vérification des réponses (0.2)#
Le mode « Evidence » envoie uniquement la valeur SHA-256 de chaque point de contrôle signé aux autorités RFC 3161
répertoriées et aux calendriers OpenTimestamps, via la route de l’espace de travail et jamais via MTProxy.
Les horodatages sont activés par défaut dans chaque objectif de configuration ; les preuves relatives à un dossier enregistrent également le drand.
Les réponses sont conservées dans checkpoints/anchors/, exportées sous forme de .tsr et .ots fichiers sous anchors/,
et vérifiées par verify.py (--tsa-ca vérifie la signature TSA ; confirme les preuves OpenTimestamps
avec ots upgrade et ots verify).
Une autorité RFC 3161 qui échoue deux fois de suite attend avant la tentative suivante : un intervalle, puis
deux, quatre et ainsi de suite jusqu’à six heures, ou aussi longtemps que le spécifie son Retry-After, jusqu’à un jour. Un passage qui
ne trouve que des autorités en attente n’écrit aucun enregistrement ; sinon, anchor.completed les répertorie sous
deferred avec retry_at. Jusqu’à ce qu’elles répondent à nouveau, le panneau affiche les horodatages comme Dégradés.
Le panneau prépare une archive de requête contenant les octets canoniques du fichier checkpoint.json, une empreinte de message SHA-256 et un nonce aléatoire dans le fichier timestamp.tsq, ainsi que des sommes de contrôle et des instructions. Aucune requête réseau n’est effectuée ; le jeton renvoyé par l’autorité pour cette requête est l’horodatage.
python -m tgwitness.anchor verify vérifie la réponse par rapport aux octets du point de contrôle et à la requête d’origine, sans OpenSSL. Un fichier d’AC de confiance doit être indiqué explicitement ; les certificats inclus ne sont pas considérés automatiquement comme fiables. La vérification de la requête est facultative dans la CLI : conservez donc la requête et fournissez --request pour vérifier le nonce. Le résultat indique si elle a été vérifiée. La signature du point de contrôle du collecteur et le journal doivent toujours être vérifiés séparément avec l’empreinte de confiance du collecteur.
La vérification contrôle la signature de la réponse, les octets du point de contrôle et, lorsqu’elle est fournie,
la requête d’origine dans le cadre de la chaîne de confiance de l’autorité de certification spécifiée. Pour les horodatages obtenus en mode evidence, verify.py vérifie aussi les preuves OCSP ou
CRL stockées (révocation du certificat de signature).
Consultez la procédure et les résultats de validation.
Enregistrements facultatifs en mode « preuves » : appareils drand et Telegram#
Deux autres enregistrements peuvent s'exécuter lors des mêmes passages que les horodatages. Tous deux ne prennent effet que lorsque
le mode « Preuves » est activé. Les preuves relatives à une affaire activent drand ; sinon, les deux sont désactivés par défaut. Activez-les
sous « Plus d'outils » → « Extras » → « Preuves et sauvegardes » → Plus de témoins · facultatif,
ou "drand": true et "devices": true dans POST /api/evidence. L'échec de l'un n'interrompt pas l'
autre ni les horodatages ; le panneau affiche le dernier résultat de chacun sous le formulaire.
drand
(beacon.drand
). À chaque passage, le collecteur enregistre la dernière série de drand quicknet, le
générateur aléatoire public de la League of Entropy (une série toutes les 3 secondes), dans le journal : chain
,
round
, randomness
, signature
, round_time
et le relay
qui a répondu. Une série vérifiée
et imprévisible fournit une référence temporelle inférieure pour les données liées par hachage qui suivent.
Un horodatage vérifié sur un point de contrôle ultérieur fournit une référence temporelle supérieure. Ces vérifications
délimitent le contenu lié. Le collecteur interroge d’abord drand.cloudflare.com
, puis les relais de Protocol Labs, via la route de l’espace de travail, à raison d’une requête par passage.
verify.py
vérifie que chaque valeur aléatoire correspond au SHA-256
de sa signature et que le
temps de cycle est correct, puis signale les cycles, la plus longue période sans cycle et le retard
de l’horloge du collecteur par rapport à drand. --check-drand
compare les cycles avec un relais Cloudflare et un relais Protocol Labs, soit tous, soit un
échantillon aléatoire de 100 dans un journal complet ; un cycle qui diffère échoue à la vérification.
Appareils , Telegram, , account.devices. À chaque passage, le système lit les sessions du compte avec
account.getAuthorizations ; la liste Telegram s'affiche dans Paramètres → Appareils, et l'enregistre :
dans son intégralité lorsqu’elle a changé depuis le passage précédent, avec les hachages de session added et removed,
sinon uniquement son nombre et SHA-256. Le modèle de l’appareil, la plateforme, l’application et sa version,
la date de création et la dernière activité, le pays et la région sont conservés ; les adresses IP ne le sont pas, car
les exportations de preuves échappent à votre contrôle. La session du collecteur lui-même est active en permanence, de sorte que
seule l’activité des autres sessions est considérée comme un changement. Le verify.py indique la fréquence à laquelle la liste
a été enregistrée, ainsi que chaque nouvelle session et chaque session terminée. Il ne lit la liste que pendant que l’observation est en cours.
Ce qu’ils montrent : drand classe les enregistrements par ordre chronologique public, et la liste des appareils constitue la déclaration de Telegram transmise par le collecteur, signée par ce dernier comme tout autre enregistrement.
Journal de Cloudflare Gateway (cloudflare.gateway_dns). Pour un serveur dont la résolution s'effectue via
Cloudflare Gateway ( Gateway DNS ), chaque
pass copie ce que Gateway a enregistré depuis la copie précédente : un enregistrement par fenêtre de trois
heures au maximum avec from, until, location_id, le address du serveur lorsqu'il est défini, et le
queries en tant que [at, name, type, rcode, decision, colo], même en l'absence d'enregistrements. Configurez-le sous
Journal de la passerelle Cloudflare : compte, emplacement, adresse facultative et un jeton en lecture seule (lecture des données analytiques du compte
Analytics en lecture ; Zero Trust PII en lecture pour conserver une adresse d’un emplacement partagé). Le panneau les vérifie
à l’aide d’une seule requête avant l’enregistrement ; le jeton reste chiffré et n’apparaît jamais dans le journal.
verify.py répertorie les fenêtres, les noms les plus recherchés et les moments non couverts par une copie ; un enregistrement
dont le nombre ne correspond pas à ses requêtes échoue. Une fenêtre contenant plus d’une page de
requêtes en une seule seconde conserve cette page et indique que le reste est manquant. La copie est
la réponse de Cloudflare transmise par le collecteur, signée par ce dernier ; dans les 24 heures, toute personne disposant d’
un jeton en lecture seule peut la comparer avec celle de Cloudflare.