Microsoft Entra Agent ID
Standards

Agent autonomous app OAuth flow - App-only protocol

In brief

The documentation now explains that single-instance Agent IDs request tokens directly, while multi-instance Agent IDs use the blueprint to impersonate a child identity. It also updates the actor/subject model and clarifies token audience and validation details.

What Entra admins need to know

Administrators configuring app-only Agent ID access can use the updated guidance to apply the correct token flow and permission model.

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.

Agent autonomous app OAuth flow - App-only protocol

App-only operations enable agent identities to act autonomously without user context, using client credentials flows. The agent identity (actor) is used to obtainboth the actor and subject. An administrator grants the application permissions required for the operation.

The protocol below describes multi-instance Agent IDs, where the blueprint impersonates a child identity. A single-instance Agent ID instead requests a token for itself (subject)directly with the shared client ID and a credential configured on the blueprint. It doesn't use the intermediate T1 token or fmi_path. To obtain this token, the agent identity blueprint impersonates the agent identity. Subjects use app-only access but are supposed to be only assigned the permissions necessary. Tenant administrators grant all permissions.For that request, see Request an app-only token for a single-instance Agent ID.

Agent identity blueprints can only impersonate their child agent identities. Only a single agent identity blueprint can impersonate an agent identity. An agent identity blueprint can impersonate many agent identities, but no agent identity can be owned by multiple blueprints. Agent identities are always single-tenant regardless of their parent Agent identity blueprint's tenancy model. Each agent identity operates within one tenant's security and policy boundaries.

&grant_type=client_credentials
```
  1. Microsoft Entra ID issues an app-only resource access token (TR) to the agent identity after validating T1. T1's audience is the token-exchange resource requested in step 1, not the blueprint. Microsoft Entra ID validates that T1 (aud) == Agentis bound to the blueprint and that its subject resolves to the child agent identity parent app == Agent identity blueprintperforming the exchange. The resource token represents the agent identity, not the blueprint.

Sequence diagram

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…