Blank white background with no objects or features visible.

Olá, EMEA! A TrueFoundry está expandindo sua presença pela Europa, Oriente Médio e África. Leia mais. →

Identidade do Agente e Delegação On-Behalf-Of (OBO): Quem Está Realmente Chamando Suas Ferramentas?

Published: novembro 20, 2026

TL;DR:

Quando um agente de IA chama uma ferramenta, duas perguntas precisam ser respondidas ao mesmo tempo: para qual usuário isso é feito e qual agente está agindo? A maioria das configurações só consegue responder a uma delas.

  • Um agente não é um usuário e não é uma conta de serviço. Dê a ele o token do usuário e você perderá o agente na trilha de auditoria; dê a ele uma conta de serviço compartilhada e você perderá o usuário. Ambos quebram a autorização.
  • A delegação on-behalf-of (OBO) permite que um agente atue por um usuário específico e carregue ambas as identidades — o sistema downstream vê o usuário (sub) e o agente atuante (act).
  • O TrueFoundry carrega isso em dois cabeçalhos: o token do usuário em Authorization e o token de identidade do agente em x-tfy-agent-authorization. O token do usuário permanece inalterado de ponta a ponta; o token do agente é substituído a cada salto (hop).
  • A delegação é limitada por colaboradores. Um agente só pode agir por um usuário que concedeu acesso a ele, e alcançar um destino é uma concessão separada de ter permissão para agir por alguém.
  • Ele roda no gateway, em frente ao LLM Gateway, MCP Gateway e Agent Gateway, para que a autenticação de saída existente para suas ferramentas continue funcionando sem alterações. (A identidade do agente está em Beta.)

Por que um agente precisa de sua própria identidade

Dê a um agente autônomo acesso às suas ferramentas e você enfrentará imediatamente uma pergunta para a qual seu IAM nunca foi projetado: quando o agente lê um chamado no Zendesk ou consulta um banco de dados, quem fez isso? Existem três respostas usuais, e todas as três estão erradas.

  • Ele usa o token do usuário. O sistema downstream não consegue dizer que um agente esteve envolvido — cada ação parece ter sido feita diretamente pelo humano.
  • Ele usa uma conta de serviço compartilhada. Agora você não consegue dizer quais dados de qual usuário foram acessados; as solicitações de trinta pessoas se colapsam em um único principal.
  • Ele se passa pelo usuário (impersonation). O papel do agente na decisão fica oculto, que é exatamente o que um auditor perguntará primeiro.

Em cada caso, a trilha de auditoria fica incompleta, a autorização é grosseira e as políticas não conseguem distinguir uma ação humana de uma autônoma. A identidade do agente resolve isso tornando o agente um principal de primeira classe — um que pode agir como ele mesmo ou em nome de um usuário. Para uma visão mais ampla, veja o que é identidade de agente de IA e governança de agentes de IA.

O que "on behalf of" realmente significa

A delegação on-behalf-of é um token que carrega dois sujeitos. Construído sobre o padrão de troca de tokens RFC 8693, o token resultante define sub para o usuário e act para o agente — “este usuário, atuado por este agente”. As permissões nesse token (scp) são a interseção do que o usuário pode fazer e do que o agente tem permissão para fazer, de modo que um agente nunca pode expandir o alcance de um usuário.

Para uma cadeia de agentes, as claims act se aninham: um agente de dados atuando por um agente de pesquisa atuando por um usuário. Cada salto é registrado, de modo que o caminho completo de delegação fica visível no log de auditoria em vez de ser achatado em um único ator.

O usuário permanece constante a cada salto; o agente atuante muda.

Os dois cabeçalhos em cada requisição

No TrueFoundry, a identidade de um agente é criada quando você o registra — cada agente registrado tem exatamente uma identidade, e ela pode ser respaldada pelo TrueFoundry (o Gateway emite e assina o token) ou respaldada por um provedor de identidade como Okta ou Microsoft Entra. A identidade significa a mesma coisa de qualquer forma; apenas o emissor difere.

Escolhendo como um agente prova quem é: respaldado pelo TrueFoundry ou respaldado pelo provedor de identidade. Fonte: documentação do TrueFoundry.

Cada requisição para o Gateway carrega então dois tokens bearer:

O cabeçalho Authorization é o token SSO do usuário e passa inalterado de ponta a ponta. O cabeçalho x-tfy-agent-authorization é o agente atuando no momento, e cada agente o substitui por sua própria identidade antes de chamar o próximo salto. Se o cabeçalho do agente estiver ausente, a requisição é apenas uma chamada de usuário comum, autorizada apenas nas permissões do usuário. O mesmo par de cabeçalhos funciona em todas as três superfícies — o LLM Gateway (/api/llm/chat/completions), o MCP Gateway (/mcp/<server>/server) e o Agent Gateway (/agent/<agent-name>).

Quem pode agir por quem: colaboradores

A delegação não é ilimitada. Ela é delimitada pelos colaboradores na etapa de Controle de Acesso do agente, que carregam duas funções (roles):

  • Agent Manager — pode editar o agente e sua configuração.
  • Agent Access — pode invocar o agente e ter ações executadas em seu nome por ele. Um usuário sem essa concessão não pode ser o sujeito de uma chamada delegada, mesmo que pudesse alcançar o destino diretamente.
Controle de Acesso: quem gerencia o agente e em nome de quem ele pode agir. Fonte: documentação do TrueFoundry.

Os colaboradores podem ser um usuário, uma equipe ou uma conta virtual — para que cargas de trabalho não humanas também possam delegar. Este é o degrau que impede que um agente atue silenciosamente por qualquer pessoa na organização: a delegação só funciona para identidades que a concederam explicitamente.

Alcançar o destino é uma concessão separada

Ter permissão para agir por um usuário é uma permissão. Ter permissão para alcançar uma determinada ferramenta é outra — e ambas devem ser válidas. Na lista de colaboradores de um MCP server, os agentes aparecem ao lado de usuários e equipes, com suas próprias funções: MCP Server User (chamar ferramentas) e MCP Server Manager (administrar).

Concedendo acesso de um agente a um servidor MCP, a partir da aba Agentes do seletor de colaboradores. Fonte: documentação do TrueFoundry.

Em um manifesto YAML, as mesmas concessões usam prefixos de sujeito, para que a intenção seja explícita:

Separar as duas concessões é o que torna o menor privilégio real: um agente através do qual seu usuário pode agir ainda não pode tocar em uma ferramenta na qual nunca foi adicionado. Isso espelha o modelo de autorização que cobrimos em o que é autorização MCP e autorização refinada.

Quer ver exatamente quem — e qual agente — chamou cada ferramenta?

Como uma chamada multi-hop é autorizada

A maneira mais clara de ver o modelo é acompanhar uma requisição. Jane faz uma pergunta a um agente planejador, que delega para um agente de pesquisa, que chama um MCP server do Zendesk. O token do usuário nunca muda; o token do agente muda, e o Gateway verifica cada salto com base em suas próprias concessões.

Salto (Hop)Authorizationx-tfy-agent-authorizationVerificações do Gateway
Jane → planner-agentJane(nenhum)Jane pode chamar o planner-agent?
planner-agent → research-agentJaneplanner-agentO planner pode chamar o research-agent e agir por Jane?
research-agent → Zendesk MCPJaneresearch-agentO research-agent é um colaborador no servidor e pode agir por Jane?

Cada agente é autorizado apenas em suas próprias concessões — ele nunca herda o alcance de quem o chamou. O lado de saída permanece inalterado: a autenticação existente do servidor MCP (OAuth2, uma chave de API compartilhada ou passthrough de token) continua funcionando sem reconfiguração. Tudo o que o Gateway adiciona é resolver o par (usuário, agente) e autorizá-lo.

Onde as equipes erram nisso

  • Tratar uma conta de serviço compartilhada como "identidade do agente". Uma conta de serviço representa o agente como ele mesmo, mas não pode agir por ninguém — então você ainda não consegue responder de quem foram os dados acessados. A delegação é todo o propósito.
  • Assumir que alcançar uma ferramenta implica permissão para agir por um usuário. São concessões separadas. Um agente que é colaborador em um servidor ainda precisa de uma concessão Agent Access para o usuário específico pelo qual ele afirma agir.
  • Permitir que o modelo leia seu próprio token de identidade. Um agente com prompt que possa revelar seu token x-tfy-agent-authorization pode sofrer impersonation. Mantenha-o fora do controle de versão e fora de qualquer coisa que o modelo possa ler.
  • Achetar a cadeia. Se um sistema multiagente se colapsa em uma única conta de serviço, as claims aninhadas act são perdidas e seu log de auditoria não consegue reconstruir quem fez o quê. Preserve a cadeia de delegação salto por salto.

Um exemplo prático

Uma equipe de automação de suporte executa um agente planejador que se distribui para agentes especialistas, um dos quais lê chamados do Zendesk. Eles querem três coisas: o solicitante humano em cada ação, o agente específico que agiu e nenhum agente capaz de alcançar uma ferramenta para a qual não recebeu permissão explícita.

  1. Registre cada agente para que ele obtenha sua própria identidade — respaldada pelo TrueFoundry neste caso, já que eles próprios constroem e executam os agentes.
  2. No Controle de Acesso de cada agente, adicione a equipe de suporte como Agent Access para que os agentes possam agir por esses usuários.
  3. No MCP server do Zendesk, adicione apenas o agente leitor de chamados como MCP Server User — o planejador nunca toca no Zendesk diretamente.
  4. Envie requisições com o token do usuário em Authorization e o token do agente em x-tfy-agent-authorization; permita que cada agente insira o seu próprio.
  5. Leia o log de auditoria: cada leitura do Zendesk mostra o solicitante, o agente atuante e a cadeia completa de delegação.

O limite real: isso governa quem pode agir por quem e alcançar o quê. Não substitui as credenciais de saída do próprio MCP server — elas permanecem onde estão, o que é exatamente o motivo pelo qual a adoção não exige refazer a estrutura das suas ferramentas.

Pontos de atenção importantes

  • A identidade do agente está em Beta — o comportamento e a configuração ainda podem mudar, portanto, fixe-se ao fluxo documentado e verifique novamente antes de uma implantação ampla.
  • Agentes respaldados por provedores de identidade também devem ser registrados no IdP (Okta ou Entra); agentes respaldados pelo TrueFoundry não precisam de registro externo.
  • Chamadas negadas retornam 403, nomeando o principal recusado e o motivo — um usuário sem uma concessão Agent Access é rejeitado para chamadas delegadas mesmo quando poderia alcançar o destino diretamente.
  • As permissões em um token OBO são a interseção dos escopos do usuário e do agente, portanto, restringir qualquer um dos lados restringe a chamada delegada. Uma política de negação (forbid) se sobrepõe a uma de permissão (permit).
  • Delegação e alcançabilidade são independentes — audite ambas as concessões, não apenas uma, quando algo for inesperadamente negado (ou inesperadamente permitido).

As três maneiras pelas quais um agente obtém seu token OBO

Sob o modelo de dois cabeçalhos, a questão de quem realiza a troca de tokens tem três respostas, definidas pelo tipo de identidade do agente. Elas equilibram a conveniência em relação a onde a confiança e os segredos residem.

ModoQuem realiza a troca OBORegistro externo no IdPMelhor quando
Managed credentialsTrueFoundrySim (Okta ou Azure AD)Você quer que o gateway armazene e atualize o cliente OAuth do agente
Federated tokenO próprio agenteSimO agente já executa sua própria troca e envia o token OBO
Virtual accountNão necessárioNãoVocê quer delegação governada sem nenhum registro no IdP

Em managed credentials, o cliente OAuth do agente é registrado no IdP e o TrueFoundry armazena suas credenciais como segredos, realizando a troca com o token do usuário como o subject token, além de armazenar em cache e atualizar o resultado. Em federated token, o agente faz a troca fora do TrueFoundry e envia o token OBO finalizado, o qual o gateway valida com jwks_uri, emissor, público (audience) e um agent_claim (padrão act.sub) antes de corresponder ao registro — uma falha na correspondência retorna 403. Em virtual account, o chamador envia dois tokens, Authorization: Bearer <virtual-account-token> e X-TFY-User-Token: <user-sso-token>, e o contexto do usuário é carregado pela própria autenticação de saída do TrueFoundry em vez de um token OBO emitido pelo IdP; servidores que exigem especificamente tokens RFC 8693 padrão devem usar um dos outros dois modos.

Como o gateway autoriza o par

Resolver a identidade do par (usuário, agente) é a primeira etapa, não a história toda. Uma vez conhecido o par, a requisição passa por uma breve avaliação antes que qualquer coisa alcance a ferramenta, e cada camada só pode estreitar o acesso:

  1. Resolve a identidade do par (usuário, agente) a partir dos dois cabeçalhos.
  2. RBAC — usuário: o usuário deve ser um colaborador no servidor MCP.
  3. RBAC — agente: o agente também deve ser um colaborador (seu sujeito é agent:<agent-name>).
  4. Escopo da ferramenta: a ferramenta solicitada deve estar na lista opcional de ferramentas do agente, se houver uma definida.
  5. Política: políticas Cedar opcionais são executadas, onde um forbid sempre se sobrepõe a um permit.
  6. Encaminha para o servidor MCP com sua própria autenticação de saída.

É por isso que a delegação é segura por construção: o próprio escopo do token OBO já é a interseção das permissões do usuário e do agente, e então quatro concessões independentes precisam concordar antes que a chamada seja concluída. Restringir qualquer uma — remover a função de colaborador do usuário, remover o agente, reduzir a lista de ferramentas ou adicionar um forbid no Cedar — restringe a chamada delegada. A linha completa de auditoria registra o usuário, o agente, o modo de identidade, a cadeia de delegação, o servidor e a ferramenta, as decisões do RBAC e do Cedar, os escopos utilizados e o status.

Leituras relacionadas

Conclusão

Um agente que toma emprestado o token de um usuário ou se esconde atrás de uma conta de serviço é uma brecha esperando para ser encontrada — por um auditor ou por um atacante. A identidade do agente fecha isso tornando o agente um principal por direito próprio, e a delegação on-behalf-of permite que esse principal atue por um usuário específico enquanto carrega ambas as identidades adiante, salto após salto.

A mecânica é deliberadamente simples: dois cabeçalhos, dois tipos de concessão e uma verificação de autorização no gateway. O token do usuário permanece constante, o agente atuante muda e cada chamada de ferramenta responde a ambas as perguntas de uma só vez — qual usuário e qual agente. É isso que torna um sistema autônomo auditável em vez de meramente funcional.

Dê uma identidade a cada agente e veja quem realmente chamou cada ferramenta.

Try now.

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

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
novembro 20, 2026
|
5 min read

Grok 4.3 no Amazon Bedrock: Roteamos Quatro Modelos de Fronteira por um Único Gateway e Medimos o Custo

Ferramentas de LLM
comparação
novembro 20, 2026
|
5 min read

GPT-6.1 Terra: API, Benchmarks, Preço & Como Usar

No items found.
TrueFoundry AI gateway is an enterprise alternative to Bifrost and Portkey
novembro 20, 2026
|
5 min read

Bifrost vs Portkey: Precificação, Recursos de Gateway e Adequação Enterprise Comparados

No items found.
novembro 20, 2026
|
5 min read

Evolução do Machine Learning: Um Mergulho Profundo na Jornada de Savin

True ML Talks
No items found.
Take a quick product tour
Start Product Tour
Product Tour