Blank white background with no objects or features visible.

Bonjour, zone EMEA ! TrueFoundry étend sa présence en Europe, au Moyen-Orient et en Afrique. En savoir plus. →

Identité de l'agent et délégation On-Behalf-Of (OBO) : qui appelle vraiment vos outils ?

Published: novembre 20, 2026

En résumé :

Lorsqu'un agent IA appelle un outil, deux questions doivent trouver une réponse simultanée : pour quel utilisateur cet appel est-il effectué, et quel agent est en train d'agir ? La plupart des configurations ne peuvent répondre qu'à l'une d'entre elles.

  • Un agent n'est ni un utilisateur, ni un compte de service. Donnez-lui le token de l'utilisateur et vous perdez la trace de l'agent dans la piste d'audit ; donnez-lui un compte de service partagé et vous perdez l'utilisateur. Dans les deux cas, l'autorisation est compromise.
  • La délégation On-Behalf-Of (OBO) permet à un agent d'agir pour un utilisateur spécifique et de porter les deux identités — le système en aval voit l'utilisateur (sub) et l'agent agissant (act).
  • TrueFoundry achemine cela sur deux en-têtes : le token de l'utilisateur dans Authorization, et le token d'identité de l'agent dans x-tfy-agent-authorization. Le token utilisateur reste inchangé de bout en bout ; le token agent est remplacé à chaque saut.
  • La délégation est limitée par les collaborateurs. Un agent ne peut agir que pour un utilisateur qui lui a accordé l'accès, et atteindre une cible constitue une autorisation distincte de celle d'être autorisé à agir pour quelqu'un.
  • Elle s'exécute au niveau de la passerelle, devant l'LLM Gateway, l'MCP Gateway et l'Agent Gateway, de sorte que l'authentification sortante existante vers vos outils continue de fonctionner sans modification. (L'identité de l'agent est en Beta.)

Pourquoi un agent a besoin de sa propre identité

Donnez à un agent autonome l'accès à vos outils et vous serez immédiatement confronté à une question pour laquelle votre IAM n'a jamais été conçu : lorsque l'agent lit un ticket Zendesk ou interroge une base de données, qui a fait cela ? Il existe trois réponses habituelles, et toutes trois sont incorrectes.

  • Il utilise le token de l'utilisateur. Le système en aval ne peut pas savoir qu'un agent est intervenu — chaque action apparaît comme si l'humain l'avait effectuée directement.
  • Il utilise un compte de service partagé. Il devient alors impossible de savoir quelles données d'utilisateur ont été touchées ; les requêtes de trente personnes se confondent en un seul principal.
  • Il usurpe l'identité de l'utilisateur. Le rôle de l'agent dans la décision est masqué, ce qui est précisément la première chose sur laquelle un auditeur vous interrogera.

Dans chaque cas, la piste d'audit est incomplète, l'autorisation est grossière et la politique ne peut pas distinguer une action humaine d'une action autonome. L'identité de l'agent résout ce problème en faisant de l'agent un principal de premier ordre — un principal qui peut agir en son nom propre ou pour le compte d'un utilisateur. Pour une vue d'ensemble, consultez ce qu'est l'identité d'un agent IA et la gouvernance des agents IA.

Ce que signifie réellement « au nom de » (On Behalf Of)

La délégation On-Behalf-Of est un token qui transporte deux sujets. Basé sur le modèle d'échange de tokens RFC 8693, le token résultant définit sub sur l'utilisateur et act sur l'agent — « cet utilisateur, représenté par cet agent ». Les permissions sur ce token (scp) sont l'intersection de ce que l'utilisateur peut faire et de ce que l'agent est autorisé à faire, de sorte qu'un agent ne peut jamais élargir la portée des accès d'un utilisateur.

Pour une chaîne d'agents, les revendications act s'imbriquent : un agent de données agissant pour un agent de recherche agissant pour un utilisateur. Chaque saut est enregistré, de sorte que le chemin de délégation complet est visible dans le journal d'audit au lieu d'être aplati en un seul acteur.

L'utilisateur reste constant à chaque saut ; l'agent agissant change.

Les deux en-têtes sur chaque requête

Dans TrueFoundry, l'identité d'un agent est créée lorsque vous l'enregistrez — chaque agent enregistré possède exactement une identité, et celle-ci peut être adossée à TrueFoundry (la Gateway émet et signe le token) ou adossée à un fournisseur d'identité comme Okta ou Microsoft Entra. L'identité signifie la même chose dans les deux cas ; seul l'émetteur diffère.

Choisir comment un agent prouve son identité : adossé à TrueFoundry ou adossé à un fournisseur d'identité. Source : documentation TrueFoundry.

Chaque requête adressée à la Gateway transporte ensuite deux tokens bearer :

L'en-tête Authorization est le token SSO de l'utilisateur et passe sans modification de bout en bout. L'en-tête x-tfy-agent-authorization représente l'agent agissant actuellement, et chaque agent le remplace par sa propre identité avant d'appeler le saut suivant. Si l'en-tête de l'agent est absent, la requête est simplement un appel utilisateur ordinaire, autorisé sur les seules permissions de l'utilisateur. La même paire d'en-têtes fonctionne sur les trois surfaces — l'LLM Gateway (/api/llm/chat/completions), l'MCP Gateway (/mcp/<server>/server) et l'Agent Gateway (/agent/<agent-name>).

Qui peut agir pour qui : les collaborateurs

La délégation n'est pas illimitée. Elle est restreinte par les collaborateurs définis à l'étape Access Control de l'agent, qui comportent deux rôles :

  • Agent Manager — peut modifier l'agent et sa configuration.
  • Agent Access — peut invoquer l'agent et voir des actions exécutées en son nom par celui-ci. Un utilisateur ne disposant pas de cette attribution ne peut pas être le sujet d'un appel délégué, même s'il pouvait atteindre la cible directement lui-même.
Contrôle d'accès : qui gère l'agent et pour le compte de qui il peut agir. Source : documentation TrueFoundry.

Les collaborateurs peuvent être un utilisateur, une équipe ou un compte virtuel — ainsi, les charges de travail non humaines peuvent également déléguer. C'est le niveau qui empêche un agent d'agir discrètement pour n'importe qui dans l'organisation : la délégation ne fonctionne que pour les identités qui l'ont explicitement accordée.

Atteindre la cible est une autorisation distincte

Être autorisé à agir pour un utilisateur est une permission. Être autorisé à atteindre un outil donné en est une autre — et les deux doivent être valides. Sur la liste des collaborateurs d'un serveur MCP, les agents apparaissent aux côtés des utilisateurs et des équipes, avec leurs propres rôles : MCP Server User (appeler les outils) et MCP Server Manager (administrer).

Accorder à un agent l'accès à un serveur MCP, depuis l'onglet Agents du sélecteur de collaborateurs. Source : documentation TrueFoundry.

Dans un manifeste YAML, les mêmes attributions utilisent des préfixes de sujet, afin que l'intention soit explicite :

Séparer les deux attributions est ce qui rend le moindre privilège effectif : un agent par le biais duquel votre utilisateur peut agir ne peut toujours pas toucher à un outil auquel il n'a jamais été ajouté. Cela reflète le modèle d'autorisation que nous abordons dans ce qu'est l'autorisation MCP et l'autorisation fine.

Vous voulez savoir exactement qui — et quel agent — a appelé chaque outil ?

Comment un appel multi-sauts est autorisé

La façon la plus claire de comprendre le modèle est de suivre une requête. Jane sollicite un agent planificateur, qui délègue à un agent de recherche, lequel appelle un serveur MCP Zendesk. Le token utilisateur ne change jamais ; le token agent change, et la Gateway vérifie chaque saut selon ses propres attributions.

SautAuthorizationx-tfy-agent-authorizationVérifications de la Gateway
Jane → planner-agentJane(aucun)Jane peut-elle appeler planner-agent ?
planner-agent → research-agentJaneplanner-agentPlanner peut-il appeler research-agent et agir pour Jane ?
research-agent → Zendesk MCPJaneresearch-agentResearch-agent est-il un collaborateur sur le serveur, et peut-il agir pour Jane ?

Chaque agent est autorisé uniquement sur ses propres attributions — il n'hérite jamais de la portée de son appelant. Le côté sortant reste inchangé : l'authentification existante du serveur MCP (OAuth2, une clé API partagée ou le passage de token) continue de fonctionner sans reconfigurations. Tout ce que la Gateway ajoute, c'est la résolution du couple (user, agent) et son autorisation.

Là où les équipes se trompent

  • Traiter un compte de service partagé comme une « identité d'agent ». Un compte de service représente l'agent en tant que lui-même, mais il ne peut agir pour le compte de personne — vous ne pouvez donc toujours pas répondre à la question de savoir quelles données ont été touchées. La délégation est le principe même de la démarche.
  • Supposer qu'atteindre un outil implique la permission d'agir pour un utilisateur. Ce sont des attributions distinctes. Un agent qui est collaborateur sur un serveur a toujours besoin d'une attribution Agent Access pour l'utilisateur spécifique pour lequel il prétend agir.
  • Laisser le modèle lire son propre token d'identité. Un agent prompté qui peut divulguer son token x-tfy-agent-authorization peut être usurpé. Gardez-le hors du contrôle de code source et hors de tout ce que le modèle peut lire.
  • Aplatir la chaîne. Si un système multi-agents se réduit à un seul compte de service, les revendications act imbriquées sont perdues et votre journal d'audit ne peut plus reconstruire qui a fait quoi. Préservez la chaîne de délégation saut par saut.

Un exemple concret

Une équipe d'automatisation du support gère un agent planificateur qui distribue les tâches à des agents spécialisés, dont l'un lit les tickets depuis Zendesk. Ils veulent trois choses : le demandeur humain sur chaque action, l'agent spécifique qui a agi, et aucun agent capable d'atteindre un outil qui ne lui a pas été explicitement accordé.

  1. Enregistrez chaque agent afin qu'il obtienne sa propre identité — pris en charge par TrueFoundry ici, puisqu'ils construisent et exécutent les agents eux-mêmes.
  2. Sur l'Access Control de chaque agent, ajoutez l'équipe de support en tant qu'Agent Access afin que les agents puissent agir pour ces utilisateurs.
  3. Sur le serveur MCP Zendesk, ajoutez uniquement l'agent lecteur de tickets en tant que MCP Server User — le planificateur ne touche jamais directement à Zendesk.
  4. Envoyez les requêtes avec le token utilisateur dans Authorization et le token agent dans x-tfy-agent-authorization ; laissez chaque agent substituer le sien.
  5. Lisez le journal d'audit : chaque lecture Zendesk montre le demandeur, l'agent agissant et la chaîne de délégation complète.

La limite honnête : cela régit qui peut agir pour qui et atteindre quoi. Cela ne remplace pas les identifiants sortants propres au serveur MCP — ceux-ci restent là où ils sont, ce qui est exactement la raison pour laquelle l'adoption ne nécessite pas de recâbler vos outils.

Pièges à connaître

  • L'identité d'agent est en Beta — le comportement et la configuration peuvent encore changer, alors fixez-vous au flux documenté et vérifiez à nouveau avant un déploiement large.
  • Les agents adossés à un fournisseur d'identité doivent également être enregistrés dans l'IdP (Okta ou Entra) ; les agents adossés à TrueFoundry n'ont besoin d'aucun enregistrement externe.
  • Les appels refusés renvoient 403, nommant le principal refusé et la raison — un utilisateur auquel il manque une attribution Agent Access est rejeté pour les appels délégués même lorsqu'il pourrait atteindre la cible directement.
  • Les permissions sur un token OBO sont l'intersection des scopes de l'utilisateur et de l'agent, donc restreindre l'un ou l'autre côté restreint l'appel délégué. Une politique d'interdiction (forbid) l'emporte sur une autorisation (permit).
  • La délégation et l'accessibilité sont indépendantes — auditez les deux attributions, pas seulement une seule, lorsque quelque chose est refusé de manière inattendue (ou autorisé de manière inattendue).

Les trois façons pour un agent d'obtenir son token OBO

Sous le modèle à deux en-têtes, la question de savoir qui effectue l'échange de token a trois réponses, définies par le type d'identité de l'agent. Elles mettent en balance la commodité et le lieu où résident la confiance et les secrets.

ModeQui effectue l'échange OBOEnregistrement IdP externeIdéal quand
Identifiants gérésTrueFoundryOui (Okta ou Azure AD)Vous voulez que la gateway détienne et rafraîchisse le client OAuth de l'agent
Token fédéréL'agent lui-mêmeOuiL'agent exécute déjà son propre échange et envoie le token OBO
Compte virtuelPas nécessaireNonVous voulez une délégation gouvernée sans aucun enregistrement IdP

En identifiants gérés, le client OAuth de l'agent est enregistré dans l'IdP et TrueFoundry stocke ses identifiants en tant que secrets, puis effectue l'échange avec le token de l'utilisateur comme token sujet, et met en cache et rafraîchit le résultat. En token fédéré, l'agent effectue l'échange en dehors de TrueFoundry et envoie le token OBO finalisé, que la gateway valide avec jwks_uri, l'émetteur, l'audience et un agent_claim (act.sub par défaut) avant de le faire correspondre au registre — une correspondance échouée renvoie 403. En compte virtuel, l'appelant envoie deux tokens, Authorization: Bearer <virtual-account-token> et X-TFY-User-Token: <user-sso-token>, et le contexte utilisateur est porté par l'authentification sortante propre à TrueFoundry plutôt que par un token OBO émis par un IdP ; les serveurs qui exigent spécifiquement des tokens RFC 8693 standards doivent utiliser l'un des deux autres modes.

Comment la gateway autorise le couple

Résoudre l'identité (user, agent) est la première étape, pas toute l'histoire. Une fois le couple connu, la requête exécute une courte évaluation avant que quoi que ce soit n'atteigne l'outil, et chaque couche ne peut que restreindre l'accès :

  1. Résoudre l'identité (user, agent) à partir des deux en-têtes.
  2. RBAC — utilisateur : l'utilisateur doit être un collaborateur sur le serveur MCP.
  3. RBAC — agent : l'agent doit aussi être un collaborateur (son sujet est agent:<agent-name>).
  4. Scope de l'outil : l'outil demandé doit être dans la liste optionnelle d'outils de l'agent, si une liste est définie.
  5. Politique : des politiques Cedar optionnelles s'exécutent, où une interdiction (forbid) l'emporte toujours sur une autorisation (permit).
  6. Transmettre au serveur MCP avec sa propre authentification sortante.

C'est pourquoi la délégation est sécurisée par construction : la portée propre du token OBO est déjà l'intersection des permissions de l'utilisateur et de l'agent, puis quatre attributions indépendantes doivent chacune donner leur accord avant que l'appel ne passe. Restreindre n'importe laquelle — supprimer le rôle de collaborateur de l'utilisateur, retirer l'agent, réduire la liste des outils ou ajouter une interdiction Cedar — restreint l'appel délégué. La ligne d'audit complète enregistre l'utilisateur, l'agent, le mode d'identité, la chaîne de délégation, le serveur et l'outil, les décisions RBAC et Cedar, les scopes utilisés et le statut.

Lectures connexes

Conclusion

Un agent qui emprunte le token d'un utilisateur ou se cache derrière un compte de service est une faille qui ne demande qu'à être trouvée — par un auditeur ou par un attaquant. L'identité d'agent la comble en faisant de l'agent un principal à part entière, et la délégation au nom de (on-behalf-of) permet à ce principal d'agir pour un utilisateur spécifique tout en véhiculant les deux identités, saut après saut.

La mécanique est délibérément simple : deux en-têtes, deux types d'attributions et une vérification d'autorisation au niveau de la gateway. Le token utilisateur reste constant, l'agent agissant change, et chaque appel d'outil répond aux deux questions à la fois — quel utilisateur et quel agent. C'est ce qui rend un système autonome auditable plutôt que simplement fonctionnel.

Donnez à chaque agent une identité et voyez qui a vraiment appelé chaque tool.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

INSCRIVEZ-VOUS
Table des matières

Gouvernez, déployez et suivez l'IA dans votre propre infrastructure

Réservez un séjour de 30 minutes avec notre Expert en IA

Réservez une démo

Le moyen le plus rapide de créer, de gérer et de faire évoluer votre IA

Démo du livre
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Découvrez-en plus

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

Grok 4.3 on Amazon Bedrock: We Routed Four Frontier Models Through One Gateway and Measured the Cost

Outils LLM
comparaison
novembre 20, 2026
|
5 min de lecture

Alternatives au bifrost : les meilleurs outils que vous pouvez envisager en 2026

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

GPT-6.1 Terra : API, benchmarks, tarification et mode d'emploi

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

GPT-5.1 vs GPT-5 : 9 améliorations majeures à connaître

LLM et GenAI
Aucun article n'a été trouvé.
Faites un rapide tour d'horizon des produits
Commencer la visite guidée du produit
Visite guidée du produit