Dossiers de preuves signés : prouver le parcours du code de l'IA
Matt · · Mis à jour le · 6 min de lecture · Produit
Ce que contient un dossier de preuves AI CodeOps, pourquoi nous le signons en Ed25519 sur du JSON canonique, et comment un auditeur le vérifie hors ligne sans nous croire sur parole.
Sur cette page
Tôt ou tard, quelqu'un pose à une équipe qui fait écrire son code par l'IA une question légitime : comment ce changement est-il arrivé en production ? Qui l'a demandé, quel modèle l'a écrit, qui l'a examiné, qu'est-ce qui a été testé, et qu'est-ce qui a été approuvé ?
Les réponses se trouvent déjà dans AI CodeOps. La session, les constats de revue, les exécutions de tests, les approbations et le journal d'audit y sont tous. Mais « connectez-vous à notre outil et cliquez un peu partout » n'est pas une réponse qu'un auditeur peut conserver, et une capture d'écran ne prouve rien. Nous livrons donc aujourd'hui les dossiers de preuves : un fichier signé par changement, qui contient les réponses et que n'importe qui peut vérifier, sans compte et sans nous faire confiance.
Ce que contient un dossier
Ouvrez Changes, choisissez un changement, puis sélectionnez Download evidence pack. Vous obtenez un fichier JSON avec :
- La tâche. Le prompt donné à l'IA, le modèle, le fournisseur et le niveau de modèles, ainsi que les fichiers de contexte.
- Les exécutions. La session et chaque exécution de suivi, avec le statut, les durées, les tokens et le coût, ainsi que le fournisseur et le modèle de chaque étape d'agent.
- Le résultat. Le résumé, la liste des fichiers modifiés et une empreinte SHA-256 du diff.
- Les approbations. Chaque demande d'approbation, qui pouvait l'approuver, et chaque vote avec son heure et sa note.
- Les décisions de politique. Chaque autorisation, refus ou demande d'approbation (allow, deny ou ask) prononcé par les politiques de l'espace de travail pendant le changement.
- Les constats et les tests. Les constats de revue avec la façon dont ils ont été triés, et les résultats de tests : réussis, en échec, ignorés, et la couverture.
- La livraison. La pull request, le déploiement et tout incident lié au changement.
- La piste d'audit. Les entrées du journal d'audit qui concernent l'un des éléments ci-dessus.
- Les personnes. L'adresse e-mail derrière chaque identifiant de compte du dossier, pour que le fichier se lise de façon autonome.
Le code lui-même ne figure pas dans le dossier. C'est un choix délibéré. Le code source est souvent ce qu'une entreprise possède de plus sensible, et un fichier de preuves a tendance à circuler par e-mail. L'empreinte du diff fait le lien à la place : calculez l'empreinte du diff de la pull request ; si elle correspond, le dossier décrit exactement ce code.
Télécharger un dossier nécessite l'accès à l'audit dans l'espace de travail. Les rôles Owner, Admin et Security Admin en disposent. Chaque téléchargement est lui-même enregistré dans le journal d'audit, pour que vous puissiez voir qui a exporté quoi. Le guide des dossiers de preuves donne le détail.
Pourquoi le signer
Un fichier JSON se modifie facilement. Si un dossier pouvait être changé après son téléchargement, il ne vaudrait pas plus qu'un tableur saisi par quelqu'un. C'est la signature qui en fait une preuve.
Chaque dossier comporte trois parties : une chaîne format, le payload avec tout ce qui précède, et une signature. La signature est une signature Ed25519 (RFC 8032) calculée sur le payload. Nous avons choisi Ed25519 parce que c'est un algorithme compact, rapide, sans paramètre à mal régler, et intégré aux bibliothèques standard que la plupart des gens ont déjà, dont le module de Node.js, Go, le paquet cryptography de Python et OpenSSL. Vous ne devriez pas avoir besoin de notre code pour vérifier nos affirmations.
Le JSON canonique
Signer du JSON comporte un piège. Les mêmes données peuvent s'écrire de bien des façons : clés dans un autre ordre, espaces en plus, saut de ligne. Si vous signez exactement les octets que nous avons envoyés, un simple réenregistrement par un éditeur de texte ou un outil JSON casse la signature, et vous ne pouvez plus distinguer un reformatage d'une falsification.
Nous signons donc plutôt la forme canonique du payload : les clés d'objet triées à tous les niveaux, et aucun espace blanc. Quel que soit l'outil qui resérialise le dossier, les octets canoniques sont les mêmes, et la signature reste valide. La fonction canonique tient en une dizaine de lignes :
const canonical = (v) =>
v === null || typeof v !== "object"
? JSON.stringify(v)
: Array.isArray(v)
? `[${v.map(canonical).join(",")}]`
: `{${Object.keys(v)
.sort()
.map((k) => `${JSON.stringify(k)}:${canonical(v[k])}`)
.join(",")}}`
Vérifier un dossier
Il y a deux façons de faire.
Dans le navigateur. Ouvrez /evidence/verify et choisissez le fichier. Aucun compte n'est nécessaire. La page vous indique si la signature est valide, quelle clé l'a produite, de quel changement il s'agit et quand le dossier a été créé.
Hors ligne. C'est la méthode qui compte pour un audit, parce qu'elle ne vous demande pas de faire confiance à notre vérificateur. Nos clés publiques sont publiées à /api/evidence?action=keys. Enregistrez-les une fois, puis exécutez sur le dossier un court script Node.js, qui figure dans le guide. Il met le payload sous forme canonique, retrouve la clé que le dossier désigne et vérifie la signature avec node:crypto. Si quiconque a modifié un seul caractère du payload, il affiche « NOT VERIFIED ».
Nous exécutons aussi ce même script du guide dans nos propres tests, sur un vrai dossier signé. Si le code et la documentation divergent un jour, ce sont nos tests qui échouent, pas votre audit.
Les clés, et combien de temps les dossiers restent valides
Chaque dossier désigne la clé qui l'a signé par un identifiant de clé : les 16 premiers caractères hexadécimaux du SHA-256 de la clé publique. La clé privée est générée à la première utilisation et stockée chiffrée.
Les clés ne sont jamais supprimées. Quand une clé est retirée, elle cesse de signer de nouveaux dossiers, mais sa moitié publique reste publiée, si bien que chaque dossier qu'elle a signé se vérifie toujours. Un dossier que vous téléchargez aujourd'hui devrait encore se vérifier dans plusieurs années.
Ce qu'un dossier ne prouve pas
Mieux vaut être précis. Un dossier prouve qu'AI CodeOps a enregistré ces faits sur ce changement, et que personne ne les a modifiés depuis. Il ne prouve pas que le code est correct, et il ne prouve rien sur les étapes qui se sont déroulées en dehors de la plateforme, comme un commit que quelqu'un aurait poussé directement sur la branche. L'empreinte du diff vous permet de vérifier que le code de la pull request est bien celui que décrit le dossier.
Dans ces limites, il donne à un auditeur ce qu'il obtient rarement avec du code écrit par l'IA : un fichier, par changement, qui montre tout le parcours du prompt à la production et peut être vérifié de façon indépendante. Si vous travaillez dans un secteur réglementé, la page consacrée aux secteurs réglementés montre comment les dossiers s'articulent avec les autres contrôles, la page sur l'audit et le RBAC décrit le journal d'audit dont ils sont tirés, et Où placer les approbations humaines dans un workflow de codage par IA explique les approbations qu'un dossier enregistre.
À retenir
- Un dossier de preuves, c'est un fichier JSON par changement : la tâche, les exécutions, les approbations, les décisions de politique, les constats, les tests, la livraison et la piste d'audit.
- Le code n'est pas dans le dossier ; une empreinte SHA-256 du diff relie le dossier à la pull request exacte.
- Il est signé en Ed25519 sur du JSON canonique : un reformatage ne casse pas la signature, toute modification la casse.
- N'importe qui peut le vérifier dans le navigateur sur /evidence/verify, ou hors ligne avec un court script Node.js et nos clés publiées.
- Il prouve ce qu'AI CodeOps a enregistré et que personne ne l'a modifié depuis, pas que le code est correct.
Voir aussi
- Dossiers de preuves
- Journaux d'audit, rôles et politiques pour le codage par IA
- AI CodeOps pour les secteurs réglementés
- Outils de revue de code par IA en 2026 : le comparatif honnête
- Pourquoi chaque changement de l'IA doit franchir une barrière
- Fin de la revue Gemini Code Assist : alternatives et migration
- Tous les articles du blog