Documentation / 07
Telegram · Exporter et vérifier
Remettez des fichiers que le destinataire peut vérifier lui-même face à votre espace.
Nouveau avec les signatures et points de contrôle ? Modifiez un enregistrement d’exemple et voyez quelles vérifications le repèrent.
Vous souhaitez conserver une copie hors de portée du collecteur ? Rendez-vous dans la configuration S3, la fonction « Object Lock » ou la récupération vérifiée.
Conservez une référence fiable
Notez l'empreinte de la clé de l'espace de travail ailleurs que dans le collecteur. Pendant la collecte, activez le mode « evidence » afin que les points de contrôle soient horodatés selon les normes RFC 3161 et OpenTimestamps, ou exécutez un witness qui publie sur un canal public. Conservez également les points de contrôle signés ailleurs : le destinataire vérifie la clé, l'heure et un état antérieur du journal par rapport à ceux-ci.
Télécharger le fichier ZIP signé
Exports → ZIP de preuves signé. Il contient tout le journal et un manifeste de fichiers signé. Mettez en forme le rapport lisible dans Report studio, ou n’envoyez que des données choisies sous forme d’extrait de transmission.
Les rapports HTML, PDF et JSON portent leurs propres sceaux. Le CSV n’est qu’une copie de travail ; pour l’intégrité, prenez le CSV du ZIP vérifié.
Vérifiez à l'aide d'une copie fiable de TgWitness
Dans l’environnement du projet, avec votre propre empreinte et vos chemins :
python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence
Un test réussi affiche key_pinned: true et checkpoint_checked: true. --require evidence nécessite également une horodatation tierce pour le dernier enregistrement, telle qu’un horodatage vérifié : le point de contrôle est signé avec votre propre clé, il n’est donc pas suffisant à lui seul. Conservez ce résultat à côté de l’archive. Le point de contrôle doit se trouver à la fin de l’exportation ou avant celle-ci.
Utiliser le résultat de la vérification
- Fichiers : le manifeste lie leurs hachages, les signatures lient le journal. Tout changement se voit.
- Identité : l’empreinte que vous avez gardée prouve que c’est la clé attendue.
- État antérieur : un point de contrôle compare l’export avec un début de journal enregistré avant la transmission.
- Couverture : les lacunes, les résultats d’acquisition et un test envoyer → modifier → supprimer montrent ce que cette configuration a vraiment capté.
Détails : ce que la vérification prouve.
Configurer la copie hors site sur S3
Exports → Copie externe dans votre espace. Fonctionne avec AWS S3 et tout service compatible S3. Copie les segments du journal, les fichiers enregistrés, les points de contrôle avec leurs horodatages et les exports de chats terminés, chacun chiffré en AES-256-GCM avant de quitter le collecteur.
La démo en ligne montre ces réglages avec l’envoi désactivé. Ne saisissez de vrais identifiants que dans votre propre installation.

| Domaine | Que saisir ? |
|---|---|
| Point d'extrémité | URL du stockage, sans chemin de bucket ni identifiants. Exemple : https://s3.example.invalid. |
| Région | Ce que demande votre fournisseur. Par défaut us-east-1. |
| Compartiment | Un bucket existant où vous pouvez écrire. Exemple : example-case-backup. |
| Dossier dans le compartiment | Préfixe, par défaut tgwitness. Un préfixe par espace s’y ajoute. |
| Identifiant de la clé d'accès / Clé d'accès secrète | Les deux ensemble, stockées dans le coffre. Laissez-les vides plus tard pour les conserver. |
| Adresses au format « path » | Activé : endpoint/bucket. Désactivé : bucket.endpoint. Selon le fournisseur. |
| Intervalle de copie | De 1 à 1 440 minutes, 5 par défaut. Seulement pendant que l’application tourne. |
| Conservation des données par Object Lock | Jours et mode, si le bucket prend en charge Object Lock. Zéro garde la valeur par défaut du bucket. |
- Créez le bucket, remplissez destination et identifiants avec Conserver une copie externe décoché, puis cliquez sur Enregistrer la copie externe.
- Tester la connexion envoie un objet de test chiffré.
- Télécharger la clé de chiffrement et gardez-la loin du collecteur. Pas de clé, pas de récupération.
- Cochez Conserver une copie externe, enregistrez, puis Copier maintenant ou laissez la planification tourner.
Vérifier la conservation et suivre la progression de la copie
Dans Plus d’options, choisissez les jours de rétention et GOVERNANCE ou COMPLIANCE. TgWitness relit la rétention sur un objet envoyé et vous indique : confirmée, absente ou échec de vérification.
Le panneau affiche le dernier passage, le nombre d’objets, les octets, la limite du journal copié et les erreurs. Un fichier local manquant est signalé et retenté au passage suivant ; le reste continue d’être copié.
Les envois passent en direct, par SOCKS5 ou par HTTP. Avec un itinéraire uniquement MTProxy, la copie attend avec une erreur.
Conservez la clé de récupération à part
Le JSON de clé contient la clé de déchiffrement, la destination, le préfixe et l’empreinte de clé. Pour récupérer, il vous faut ce fichier plus des identifiants de stockage avec droit de lecture.
Endpoint, bucket ou préfixe changé ? Retéléchargez la clé. Une nouvelle copie démarre à la nouvelle destination ; les anciens exports restent où ils étaient.
Restauration et vérification sur un autre ordinateur
Il vous faut une installation de TgWitness de confiance, le JSON de clé, des identifiants en lecture seule et un dossier vide :
Windows PowerShell
$env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY'
$env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence
Linux / macOS
export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY'
export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY'
python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence
Tout est d’abord vérifié dans un dossier temporaire privé : le journal entier, les points de contrôle, les hachages et tailles des fichiers. Chemins dangereux, segments contradictoires ou journal plus court que son point de contrôle échouent, et alors rien n’est écrit.
En cas de succès, vous obtenez events.jsonl, media/, checkpoints/ et exports/. Gardez avec eux la sortie JSON de la commande et comparez avec les points de contrôle ou entrées du témoin que vous conservez vous-même.