# Telegram · Format des preuves

Canonical page: https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/

Contenu du fichier ZIP signé, types d’enregistrements, accusés de réception, profils des utilisateurs, copies hors site et vérification hors ligne.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/fr/llms.txt)

Translation coverage: this edition includes material from the English original.

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](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentation](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Preuves et vérification](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

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](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) pour connaître la configuration et les limites de confiance.

**Sur cette page**

- [Qu'est-ce qui est signé ?](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#what-is-signed)
- [Comparaison des exportations de discussions](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#comparing-chat-exports)
- [Transfert de l'enquête](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#investigation-handoff)
- [Extrait de transfert](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#handover-extract)
- [Rapports lisibles](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#readable-reports)
- [Canonisation des événements](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#event-canonicalization)
- [Sémantique des acteurs](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#actor-semantics)
- [Couverture : continuité, lacunes et identifiants non observés](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)
- [Producteur](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#producer)
- [Profils des personnes](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#people-profiles)
- [Témoin indépendant](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#independent-witness)
- [Manifeste et points de contrôle](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#manifest-and-checkpoints)
- [Portée de la vérification](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#verification-scope)
- [Pièces jointes](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#attachments)
- [Collecte et traitement durables des reçus (0.2)](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#durable-collection-and-process-receipts-02)
- Préparation [RFC 3161 et vérification des réponses (0.2)](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)
- [Enregistrements facultatifs en mode preuves : drand et appareils Telegram](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)

## 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](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#readable-reports)) | 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

1. 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](https://phishdestroy.io/tgwitness/fr/docs/reference/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](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md).
2. 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.
3. 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.
4. 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 evidence
   ```

   L’empreinte digitale et l’horodatage vérifié de la dernière entrée satisfont aux critères minimaux de preuve ; sinon, `--require evidence` se 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 renvoie `key_pinned: true` et `checkpoint_checked: true` lorsque 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).
   ```

   1. 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 `.tgwpw` utilise scrypt et AES-256-GCM et s’ouvre avec la commande `unseal-password` du 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.
   2. Pour horodater un point de contrôle en dehors du mode de preuve, suivez la [procédure RFC 3161](https://phishdestroy.io/tgwitness/fr/docs/reference/timestamp/) 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.

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](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#verification-scope) pour connaître les hypothèses de confiance et [les résultats](https://phishdestroy.io/tgwitness/fr/docs/reference/verification/) [de validation](https://phishdestroy.io/tgwitness/fr/docs/reference/verification/) 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.html` ou `messages/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és `format`, `report`, `seal`) : le sceau signe le SHA-256 du JSON canonique du `report`, 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.240684792623320047764573196045913242332` et 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 dans `TGWITNESS_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é sous `report.original` dans 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](https://phishdestroy.io/tgwitness/fr/docs/reference/translation/).

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_at`l'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](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#own-actions).

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.started` et 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](https://phishdestroy.io/tgwitness/fr/docs/reference/accounts/#witness-probe). Lorsque l’option [Chats strictement sélectionnés](https://phishdestroy.io/tgwitness/fr/docs/reference/collection/#strict-chosen-chats) est activée (`scope.strict` dans `observation.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](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md).

**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 par `deletion.unscoped` sont 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](https://core.telegram.org/api/updates#message-id-sequences). 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) ou [les mesures Intel TDX](https://phishdestroy.io/tgwitness/fr/docs/reference/high-assurance/), 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](https://phishdestroy.io/tgwitness/fr/docs/reference/witness/). À 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | 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](https://phishdestroy.io/tgwitness/fr/docs/reference/high-assurance/) | 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](https://phishdestroy.io/tgwitness/fr/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-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/`](https://github.com/phishdestroy/TgWitness/tree/main/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](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/#verification-scope).

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](https://phishdestroy.io/tgwitness/fr/docs/reference/timestamp/#signing-certificate-revocation)). Consultez la [procédure](https://phishdestroy.io/tgwitness/fr/docs/reference/timestamp/) et [les résultats de validation](https://phishdestroy.io/tgwitness/fr/docs/reference/verification/).

## 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](https://phishdestroy.io/tgwitness/fr/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)), 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.
