Microsoft Entra Agent ID
Authentication

Agent Tokens

In brief

The documentation now describes agent identities as token actors and subjects, supports delegated permissions through direct assignment or blueprint inheritance, and links to updated token-validation guidance.

What Entra admins need to know

Review the revised token claims, permission inheritance, and validation guidance when implementing or troubleshooting agent access.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

#customer-intent: As a developer working with agent applications, I want to understand how tokens work in the Microsoft agent identity platform, so that I can properly implement authentication, authorization, and security patterns in my agent solutions.

  • Identity type claims (idtyp): Distinguish between user and application contexts, enabling appropriate policy application and security enforcement.

  • Identity relationship claims (xms_idrel): Describe the relationship between the token subject and the resource tenant, supporting multi-tenancymultitenancy and guest access scenarios.

Token flow patterns

Tokens in user delegation scenarios

User delegation scenarios enable agent applicationsagents to operate on behalf of users. In this scenario, tokens preserveA downstream access token preserves the user's identity while identifyingas the subject and identifies the agent identity blueprint as the acting entity. The on-behalf-of (OBO) protocol requiresactor. For a multi-instance agent, the incoming user token audience to matchtargets the blueprint's client ID. For a single-instance agent, it targets the client ID. However, forID shared by the blueprint and agent identity (agent ID),identity. The downstream token targets the incoming token hasAPI being called, not the audience of the agent identity blueprint.agent. In this scenario, tokens have the following key characteristics:

  • Maintain user identity context throughout operations
  • Include delegated permissions granted to the agent identityidentity, directly or through supported blueprint inheritance.
  • Enable policy evaluation at both user and application levels
  • Support both interactive and background operations

Tokens in application-only scenarios

Application-only scenarios represent autonomous operations where agent identity blueprintsidentities act on their own behalf without user context.

In this scenario, tokens have the following key characteristics:

  • Represent the agent identity blueprint's own identityas both actor and subject.
  • Include application-level permissions directly assigned by the tenant administrator
  • Enable unscoped access within granted permission boundaries. Delegated permissions aren't applied.
  • Support fully autonomous background operations
  • Include scoped delegated permissions
  • Require explicit assignment to agent identities

In this scenario,the blueprint exchange pattern, the agent identity blueprint impersonates the agent identity, which then impersonates the assigned agent's user account. Access is scoped to delegated permissions assigned to the agent identity, ensuring the agent can't exceed its granted permissions even when operating with user context. The agent's user account can only be used when assigned to an agent identity and can't authenticate independently.

Nonagentic API integration

Tenancy models and token behavior

All tokens contain a tenant ID (tid) representing the organization's tenant. Tokens are bounded within the tenant of the agent identity. Each agent identity receives tokens scoped to its operational tenant. Agent identities can't access resources outside their assigned customer tenant. PermissionSupported permission inheritance flows directly from parentapplies to multi-instance blueprint-to-child entities.exchanges; a single-instance agent has direct grants and no blueprint principal.

Token validation

Clients using agent identities are expected to treat the access tokens issued to them to use at resource servers as opaque, and not try to parse them. However, resource servers that receive access tokens issued to agents need to parse the tokens to validate them and extract claims for authorization purposes.

Use the API's authentication middleware to validate the token before reading claims. For framework setup and permission enforcement, see Secure a web API with Microsoft Entra ID.

Resource servers should validate agent tokens by:

  • Verifying standard OAuth claims (aud, exp, iss)
  • Apply appropriate conditional access policies
  • Generate accurate audit logs

Example of the validation process would be to do the following actions:

  • Check if a token was issued for an agent identity and for which agent blueprint.

    HttpContext.User.GetParentAgentBlueprint()
    
  • Check if a token was issued for an agent's user account identity.

    HttpContext.User.IsAgentUserIdentity()
    

These two extensions methods, apply to both ClaimsIdentity and ClaimsPrincipal.[!INCLUDE Validate tokens from agent identities]

Audit and logging integration

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…