AI CodeOps

Dossiers de preuves

Téléchargez un enregistrement signé de la façon dont un changement a été réalisé (tâche, modèles, approbations, constats, tests, livraison) et vérifiez-le dans le navigateur ou hors ligne.

Un dossier de preuves est un enregistrement signé de la façon dont un changement a été réalisé dans AI CodeOps. Il est destiné aux auditeurs, aux revues de conformité et aux clients qui doivent montrer comment du code écrit par l'IA a atteint la production.

Ce que contient un dossier

Pour un changement (Develop → Changes, puis un changement) :

  • La tâche : le prompt donné à l'IA, le modèle, le fournisseur et le niveau, 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é, les fichiers modifiés et une empreinte SHA-256 du diff. Le code lui-même n'est pas inclus ; l'empreinte vous permet de le rapprocher de la pull request.
  • Approbations : chaque demande d'approbation, qui l'a demandée (pour l'approbation propre à une session, le membre qui a lancé la session), qui pouvait approuver (eligibleApprovers : les approbateurs qu'elle désignait et les rôles autorisés à décider), qui a effectivement approuvé ou rejeté (approvedBy et rejectedBy), et chaque vote (votes).
  • Chaque vote : votes comporte une entrée par vote, dans l'ordre où ils ont été exprimés : le compte du votant (accountID), son rôle dans l'espace de travail (role), le vote (approve ou reject), l'heure (decidedAt) et la note. roleAsOf indique de quelle date provient le rôle : vote est le rôle enregistré au moment où le vote a été exprimé ; export est le rôle détenu au moment où le dossier a été produit, utilisé pour les votes exprimés avant que les rôles soient enregistrés, et null si le votant a depuis quitté l'espace de travail. selfApproval vaut true lorsque le votant a approuvé un changement qu'il avait lui-même lancé, et selfApprovalAllowedBy indique pourquoi cela était autorisé. gateOverride porte le motif donné par le votant, et ce que disait la vérification de livraison, lorsqu'il a approuvé un changement dont la vérification de livraison échouait. La liste brute decisions est toujours là, inchangée. Les deux ne contiennent que le tour en cours : lorsqu'une approbation est rouverte, par exemple après la modification d'un changement approuvé, ils sont vidés, et les votes précédents restent dans la section audit du dossier sous forme d'entrées approval.decided.
  • Décisions de politique : chaque allow, deny ou ask que les politiques de l'espace de travail ont rendu pendant le changement.
  • Constats et tests : les constats de la revue avec leur tri, et les résultats des tests (réussis, échoués, ignorés, couverture).
  • Livraison : la pull request, le déploiement et tout incident lié au changement.
  • La piste d'audit : les entrées du journal d'audit concernant tout ce qui précède.
  • Personnes : l'adresse e-mail associée à chaque identifiant de compte du dossier.

Télécharger un dossier

Ouvrez Changes, choisissez un changement et sélectionnez Download evidence pack. Il vous faut l'accès à l'audit dans l'espace de travail : les rôles Owner, Admin et Security Admin l'ont. Chaque téléchargement est enregistré dans le journal d'audit de l'espace de travail.

Vérifier un dossier dans le navigateur

Ouvrez /evidence/verify et choisissez le fichier. Aucun compte n'est nécessaire. La page vous indique si la signature correspond et quelle clé l'a signé.

Vérifier un dossier hors ligne

Vous n'êtes pas obligé de faire confiance à notre vérificateur. La signature du dossier est une signature Ed25519 du JSON canonique de son payload : clés d'objet triées à chaque niveau, sans espaces. Les clés publiques de la plateforme se trouvent à /api/evidence?action=keys. Avec Node.js 20 ou une version ultérieure :

// verify-evidence.mjs <pack.json> <keys.json>
import { readFileSync } from "node:fs"
import { createPublicKey, verify } from "node:crypto"

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(",")}}`

const pack = JSON.parse(readFileSync(process.argv[2], "utf8"))
const { keys } = JSON.parse(readFileSync(process.argv[3], "utf8"))
const key = keys.find((k) => k.kid === pack.signature.kid)
if (!key) throw new Error(`unknown key ${pack.signature.kid}`)
const ok = verify(
  null,
  Buffer.from(canonical(pack.payload)),
  createPublicKey(key.publicKey),
  Buffer.from(pack.signature.value, "base64url"),
)
console.log(ok ? "VERIFIED" : "NOT VERIFIED: the pack was altered")

Enregistrez les clés une fois, puis exécutez le script :

curl -o keys.json "https://console.aicodeops.dev/api/evidence?action=keys"
node verify-evidence.mjs evidence-chg_....json keys.json

Clés et rotation

Les clés ne sont jamais supprimées. Lorsqu'une clé est retirée, elle cesse de signer de nouveaux dossiers, et les dossiers qu'elle a signés restent vérifiables. Conservez une copie de keys.json avec vos archives d'audit si vous voulez une vérification qui ne dépende pas de l'accès à la plateforme.

Étapes suivantes

Questions fréquentes

Le dossier contient-il notre code source ?

Non. Il liste les fichiers modifiés et une empreinte SHA-256 du diff, ce qui vous permet de le rapprocher de la pull request sans que le code quitte votre dépôt.

Les anciens dossiers sont-ils encore vérifiables après le retrait d'une clé ?

Oui. Les clés ne sont jamais supprimées. Une clé retirée cesse de signer de nouveaux dossiers, et les dossiers qu'elle a signés restent vérifiables.

Cette page vous a-t-elle été utile ?