ALLER AU CONTENU
AGENTS IA7 minAgents en production / Ép. 13 · Niveau 13-4

Identifiants d’agent : les tests d’échec à écrire en premier

Le jeton de votre agent a expiré il y a une minute. Votre API répond-elle 401, 500, ou pire, 200 ?

XIN
Scène nocturne en pixel art : un petit robot, devant une borne lumineuse, échange une grande clé maîtresse en laiton contre une minuscule clé turquoise reliée à son poignet par un fil de lumière, sous un sablier qui s’écoule.

EN 30 SECONDES

Un test d’échec est un test qui envoie une requête que votre montage doit refuser, et qui vérifie l’erreur exacte. Requêtes expirées, rejouées, au jeton volé, trop larges ou vers la mauvaise API : toutes y ont leur place. Écrivez-les avant le scénario où tout se passe bien.

À RETENIR · 3

  • Écrivez d’abord les tests d’échec. Requêtes expirées, rejouées, au jeton volé, trop larges ou vers la mauvaise API : toutes doivent être refusées avec la bonne erreur.
  • Avant un test de refus, vérifiez qu’un appel normal réussit. Sinon, un serveur qui refuse tout passe le test.
  • Des jetons courts et restreints limitent ce qu’un agent détourné peut atteindre, et pendant combien de temps. Ils n’empêchent pas l’injection de prompt.
Sur cette page

Les tests d’échec que j’écrirais avant de lancer l’agent

EN BREF Un montage d’identifiants est une affirmation sur ce qui échoue : j’écrirais donc les tests d’échec avant le scénario où tout se passe bien.

LES MOTS À CONNAÎTRE

Jeton d’accès
Un laissez-passer qu’une API accepte à la place d’un mot de passe. Il donne des droits limités et, dans cet épisode, expire en quelques minutes.
Périmètre (scope)
La liste des actions qu’un jeton autorise, par exemple lire des factures sans pouvoir créer de paiement.
Rejeu
Renvoyer une requête ou une preuve capturée, en espérant que le serveur l’accepte une seconde fois.

Je les ferais tourner en intégration continue (CI), à chaque modification du code. Ils viseraient un vrai serveur d’autorisation et une vraie API. Le test contrôle l’horloge.

Chaque test nomme l’erreur exacte, pas seulement « bloqué ».

Un 500 qui bloque la requête par accident est un bug qui attend de devenir un 200.

EN CLAIR

Ce sont des codes de statut HTTP : 500 signale une erreur du serveur, 200 un succès, 401 des identifiants absents ou invalides, 400 une requête incorrecte.

Chaque ligne ci-dessous envoie un Jeton d’accès Un laissez-passer qu’une API accepte à la place d’un mot de passe. Il donne des droits limités et, dans cet épisode, expire en quelques minutes. Voir le glossaire ou demande un Périmètre (scope) La liste des actions qu’un jeton autorise, par exemple lire des factures sans pouvoir créer de paiement. Voir le glossaire que le montage doit refuser. Les codes d’erreur sont mon choix, calqué sur la RFC 6749 et la RFC 8693.

Jeton utilisé après expiration
L’API
401 invalid_token
Preuve DPoP capturée puis rejouée
L’API, liste des preuves déjà vues
401 invalid_dpop_proof
Jeton récupéré dans un journal, utilisé avec une autre clé
L’API, contrôle de la clé
401 invalid_token
Jeton lié par DPoP envoyé comme simple jeton au porteur
L’API
401
Le sous-agent demande plus que son parent
Serveur d’autorisation
400 invalid_scope
Le sous-agent demande une API interdite
Serveur d’autorisation
400 invalid_target

OBJET OBTENU

Chaque refus est un test

Expiré, rejoué, volé, trop large, mauvaise API : chacun refusé, chacun avec son erreur exacte.

Coming up next: Un serveur qui refuse tout les réussit tous. Alors, qu’est-ce qui rend un refus probant ?

Tests de rejeu : pourquoi commencer par un appel normal

EN BREF Un test de rejeu ne prouve rien tant qu’un appel normal n’a pas réussi.

Un Rejeu Renvoyer une requête ou une preuve capturée, en espérant que le serveur l’accepte une seconde fois. Voir le glossaire se teste par un refus, mais un serveur qui refuse tout réussirait aussi ce test. Le test vérifie donc d’abord qu’un appel normal réussit.

ÉTAPE PAR ÉTAPE

Diagramme de séquence : 2 participants : Test d’échec, API du grand livreDiagramme de séquence : 2 participants : Test d’échec, API du grand livre. Étape 1 : Test d’échec vers API du grand livre, Appel avec une preuve fraîche. Étape 2 : API du grand livre vers Test d’échec, 200 : ça marche. Étape 3 : Test d’échec vers API du grand livre, Même preuve, à nouveau.TEST D’ÉCHEC > API DU GRANDLIVREAppel avec une preuve fraîcheAPI DU GRAND LIVRE > TESTD’ÉCHEC200 : ça marcheTEST D’ÉCHEC > API DU GRANDLIVREMême preuve, à nouveau

Étape 1. Appel normal. Le test appelle l’API avec un jeton neuf et une preuve DPoP fraîche.

Choisissez une étape pour la voir bouger
  1. Appel normal Le test appelle l’API avec un jeton neuf et une preuve DPoP fraîche.
  2. Ça marche L’API répond 200. Un refus ensuite sera donc un vrai refus.
  3. Rejeu : refusé Le test renvoie la même preuve. L’API a déjà vu son identifiant : 401 invalid_dpop_proof.
Illustratif. Le test de rejeu, message par message.

La RFC 9449 indique que les serveurs peuvent conserver le jti de chaque preuve DPoP et refuser les répétitions. Le jti est l’identifiant unique de chaque preuve. C’est une mesure possible, pas une obligation.

OBJET OBTENU

Obligatoire là où l’on écrit

Dans mon montage, le contrôle des jti est obligatoire sur tout point d’accès qui écrit.

La RFC 9449 signale aussi elle-même une faiblesse. Un attaquant qui contrôle le client peut fabriquer à l’avance des preuves pour des points d’accès précis, pour une date aussi lointaine qu’il le souhaite, en choisissant la date (iat) de la preuve qu’il signe avec sa clé.

ATTENTION

Les nonces du serveur, des valeurs fraîches et imprévisibles qu’il donne et attend en retour, ferment cette porte.

Gardez les résultats de ces tests avec les actions de l’agent, dans un journal où l’on ne fait qu’ajouter des lignes. C’est le principe de l’épisode sur prouver le travail d’un agent à un auditeur.

Cet épisode traite des systèmes que vous contrôlez. Qui a autorisé l’agent, c’est l’objet de l’épisode l’épisode Know Your Agent. Comment une contrepartie vérifie à quel agent elle parle, c’est l’objet de l’épisode sur vérifier une Agent Card et ERC-8004, une proposition de standard Ethereum encore à l’état de brouillon (Draft).

FAQ

Non : il limite ce qu’un agent détourné peut atteindre, et pendant combien de temps. L’agent peut toujours abuser de son jeton restreint jusqu’à l’expiration. Les actions lourdes de conséquences exigent toujours une approbation hors du modèle : l’épisode 4 fait des identifiants de courte durée une couche parmi quatre.

mTLS convient quand la session TLS de l’agent atteint l’API sans rupture, comme dans votre service mesh, ou derrière un proxy qui transmet le certificat d’une manière que vous jugez fiable. DPoP, porté par un en-tête HTTP, résiste aux passerelles qui interrompent le TLS. Dans mon montage, DPoP a des contrôles anti-rejeu : jti suivis, nonces sur les routes sensibles.

Une clé d’API classique reste valable des mois et donne accès à tout ce que le compte peut atteindre. Quiconque la copie peut s’en servir. Dans un agent, elle peut finir dans des journaux, elle est transmise à chaque sous-agent, et une injection de prompt suffit pour que le modèle la lise.

NIVEAU TERMINÉ

Ce que vous savez maintenant

  • Quels refus tester : requêtes expirées, rejouées, au jeton volé, trop larges ou vers la mauvaise API, chacune avec son erreur exacte.
  • Pourquoi un test de rejeu commence par un appel qui marche : sinon, un serveur qui refuse tout passe le test.

Vérifiez par vous-même

Touchez ou cliquez une question pour voir la réponse.

Votre test de jeton expiré reçoit un 500, et la requête est bloquée. Le test passe-t-il ?

Non. Il doit s’attendre à un 401 invalid_token. Un 500 qui bloque par accident aujourd’hui est un bug qui peut devenir un 200 demain.

Vous avez fini tous les niveaux publiés de cette série. Retour à la carte de la série

Adam Boudjemaa
Adam Boudjemaa

Ingénieur web3 x IA, ancien CTO d’Integra. Auteur nommé (1 sur 5) d’ERC-3643, premier auteur d’ERC-6960, co-auteur d’ERC-7410 et co-auteur d’ERC-8203, encore à l’état de brouillon.

Un projet à livrer ou un poste à pourvoir ?

Parlons de votre besoin

Mon travail entre web3 et IAMes outils open source

Suivre les notes techniques

Recevez les nouveaux articles sur l’IA en production et les smart contracts par email.