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 ?

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.
OBJET OBTENU
Chaque refus est un test
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
Étape 1. Appel normal. Le test appelle l’API avec un jeton neuf et une preuve DPoP fraîche.
- Appel normal Le test appelle l’API avec un jeton neuf et une preuve DPoP fraîche.
- Ça marche L’API répond 200. Un refus ensuite sera donc un vrai refus.
- Rejeu : refusé Le test renvoie la même preuve. L’API a déjà vu son identifiant : 401 invalid_dpop_proof.
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
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
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 besoinSuivre les notes techniques
Recevez les nouveaux articles sur l’IA en production et les smart contracts par email.