Microsoft Entra Agent ID
Authentication

Agent identities, service principals, and applications

In brief

The article now distinguishes multi-instance and single-instance Agent IDs, including blueprint principals, client IDs, token flows, credentials, and Microsoft Graph creation guidance.

What Entra admins need to know

Administrators can use the correct setup and authentication guidance for each Agent ID instance mode.

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 identities, service principals, and applications

Agent identities are built on the same service principal infrastructure that applications use throughout Microsoft Entra, but they're a distinct object type. Standard service principals were designed for static, deterministic workloads and operate using their own credentials directly. Agent identities support one-to-one and one-to-many blueprint relationships, require an assigned sponsor, and generate agent-specific audit entries. Multi-instance blueprints also add a delegation model where the blueprint acquires tokens on behalf of each agent identity, support a one-to-many blueprint relationship, require an assigned sponsor, and generate agent-specific audit entries.Agent ID.

This article explains the following concepts:

  • The service principal types in the agent app model

Agent identity blueprint principal

Agent identityA multi-instance blueprint principals are created automatically whenneeds an agent identity blueprint is instantiatedprincipal in a tenant. Theseeach tenant where it operates. Managed creation experiences can create it automatically. When you create the blueprint through Microsoft Graph, create an agent blueprint principal. This service principals provideprincipal provides the runtime representation of the agent identity blueprint within the tenant's directory and enable the agent identityenables it to create Agent IDs and manage their lifecycle. A single-instance blueprint to perform operations, such as creating instances and managing lifecycle operations.doesn't have this principal.

The creation process involves consent operations that require permissions like AgentIdentity.Create and ServicePrincipal.Manage.OwnedBy. The agent identity blueprint principal enables the agent identity blueprint to obtain app-only tokens for Microsoft Graph calls necessary to create and manage agent identities. This process is essential because agent blueprints themselves can't directly obtain tokens for Microsoft Graph operations.

Agent identities are modeled as single-tenant service principals with a new "agent" subtype classification. This design uses existing Microsoft Entra ID service principal infrastructure while adding agent-specific behaviors and constraints.

Agent identities inherit their protocol properties from their parent agent identity blueprint through the ParentID relationship. Unlike standard service principals that operate independently, agent identitiesAgent IDs created from multi-instance blueprints require their parent agent identitythe blueprint for impersonation and token exchange operations. A single-instance Agent ID instead shares the blueprint's OAuth client ID and requests tokens directly. It can operate as a confidential client with a credential on the blueprint or as a public client without a client credential.

Agent identities can be granted permissions directly and appear in sign-in logs when tokens are issued for agent operations. They serve as the primary identity that customers reason about when managing agent permissions and access.

TheFor multi-instance blueprints, the agent identity blueprint principal creates agent identityAgent ID service principals by using Microsoft Graph calls with app-only tokens and appropriate roles. The creation process establishes the parent-child relationship and configures the necessary Federated Identity Credential (FIC)federated identity credential relationships for impersonation.

Agents built using application service principals

Impersonation model

Standard service principals operate using their own credentials and identity. Multi-instance Agent service principalsIDs use an impersonation model: the agent identity blueprint acquires tokens on behalf of each agentchild identity, so the agent identity appears as the client in the resulting token and in audit logs, even though the blueprint performed the actualinitial token exchange.

This separation means the blueprint holds the authentication credentials while the agent identity holds the permissions and the audit identity. A compromise of the blueprint's credentials affects all agent identities under it, which is why blueprint count is a security boundary decision.

A single-instance Agent ID doesn't use this impersonation step. It requests a token with the shared client ID, using a blueprint credential when the flow requires client authentication. For request examples, see Authenticate a single-instance agent identity.

Multi-instance relationship

Standard applications have a one-to-one relationship between application and service principal. TheIn multi-instance mode, the agent app model is one-to-many: a single agent identity blueprint can produce multiple agent identityAgent ID service principals within a tenant or across tenants. Each agent identityAgent ID sources its protocol properties from the blueprint but can hold its own permissions on downstream resources.

In single-instance mode, the relationship is one-to-one in each tenant. The blueprint and its Agent ID service principals share one OAuth client ID, and no blueprint principal is created.

Credential management

Standard service principals manage their own credentials (certificates, secrets, or managed identities) and use them to obtain tokens directly. For confidential Agent identitiesIDs, the blueprint holds the credentials. Multi-instance blueprints use them for impersonation; single-instance Agent IDs use them directly. Public-client Agent IDs don't manage credentials. The blueprint holds all credentials and uses them to impersonate each agent identity.send a client credential.

Managed identities are a supported credential type on blueprints (the most secure option for agents running on Azure), but they're a credential on the blueprint, not a replacement for the agent identity itself.

Permissions and role assignment

Agent service principals support both application permissions (for autonomous operations) and delegated permissions (for interactive, on-behalf-of operations). Permissions can be assigned directly to an agent identity or inheritedAgent ID. Multi-instance Agent IDs can also inherit permissions from the blueprint.blueprint principal.

When InheritDelegatedPermissions is enabled, agent identities inherit delegated permissions from the blueprint, which simplifies consent management across many agent identities. Use inherited permissions for the shared baseline and direct assignment for role-specific access.

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…