Identidade do Agente e Delegação On-Behalf-Of (OBO): Quem Está Realmente Chamando Suas Ferramentas?
.webp)
Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
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.

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.

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.

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).

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.
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.
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-authorizationpode 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
actsã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.
- 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.
- 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.
- No MCP server do Zendesk, adicione apenas o agente leitor de chamados como MCP Server User — o planejador nunca toca no Zendesk diretamente.
- Envie requisições com o token do usuário em
Authorizatione o token do agente emx-tfy-agent-authorization; permita que cada agente insira o seu próprio. - 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.
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:
- Resolve a identidade do par (usuário, agente) a partir dos dois cabeçalhos.
- RBAC — usuário: o usuário deve ser um colaborador no servidor MCP.
- RBAC — agente: o agente também deve ser um colaborador (seu sujeito é
agent:<agent-name>). - Escopo da ferramenta: a ferramenta solicitada deve estar na lista opcional de ferramentas do agente, se houver uma definida.
- Política: políticas Cedar opcionais são executadas, onde um forbid sempre se sobrepõe a um permit.
- 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
- O que é Identidade de Agente de IA? — o conceito sobre o qual isso se constrói
- Governança de Agentes de IA: Cinco Pilares que Você Constrói, Não Escreve — onde a identidade se posiciona na pilha
- Autenticação MCP Explicada — identidade de entrada e credenciais de saída
- O que é Autorização MCP? — o modelo de autorização por trás das concessões
- TrueFoundry Junta-se ao Ecossistema Cross App Access da Okta — acesso de agente governado por identidade com seu IdP existente
- Agent Gateway vs LLM Gateway — por que o caminho multi-hop precisa de seu próprio ponto de controle
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.
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.














.webp)







