Microsoft Entra Agent ID
Authentication

Microsoft Entra Agent ID key concepts

In brief

The article now explains single- and multi-instance blueprints, token relationships, required identifiers, and blueprint principal creation. It notes that Microsoft Graph does not create a multi-instance blueprint principal automatically.

What Entra admins need to know

Use the correct tenant, client, and object IDs. When creating a multi-instance blueprint through Microsoft Graph, create its blueprint principal separately.

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.

Microsoft Entra Agent ID key concepts

The MicrosoftAn agent identity platform provides specializedlets an AI agent authenticate to APIs and other resources. Its agent identity constructs designed specifically for AI agents operating in enterprise environments. Theseblueprint holds authentication settings and credentials, while the agent identity constructs enable secure authenticationreceives access to resources. For example, an agent that reads a protected API needs a blueprint, an agent identity, and authorization patternspermission to call that differ from traditional user and application identities, addressing the unique requirements of autonomous AI systems.API.

This article explains those objects, the core concepts that formpeople who manage them, and the foundation ofidentifiers you record during setup. You don't need to create every object described here: follow Choose an agent integration path for your scenario.

An agent identity management:blueprint defines the configuration for one or more agent identities, agent identity blueprints,identities. In multi-instance mode, it provides a template for separate child identities. In single-instance mode, the blueprint and their supporting components. Understanding these concepts is essential for developers who need to implement secure, scalable authentication patterns for AI agents.

The agent identity architecture follows a hierarchical model where agent identity blueprints serve as templates for creating multiple agent instances, eachits one Agent ID share an OAuth client ID, with distinct identities and capabilities. This approach enables centralized management while providing the flexibility needed for diverse AI agent deployment scenarios.no blueprint principal.

Core identity concepts

Agent identity

An agent identity is the primary identity an AI agent uses to authenticate to systems and access resources. Unlike user accounts, agent identitiesCredentials, when needed, are configured on its blueprint rather than on the identity. Multi-instance Agent IDs authenticate through blueprint impersonation. Single-instance Agent IDs request tokens directly with the shared client ID; public clients don't have credentials of their own. They authenticate using tokens issued by their agent identity blueprint.send a client credential. For more information, see Agent identities.

Agent identity blueprint

An agent identity blueprint is an object in Microsoft Entra ID that serves as the templatedefines authentication settings and authentication foundationother configuration for one or more agent identities. The blueprint holds credentialsIts instance mode determines the identity relationship and uses them to acquire tokens on behalf of all agent identities created from it.token acquisition pattern. Policies and settings applied to a blueprint, such as Conditional Access, take effect for all its agent identities. For more information, see Agent identity blueprints.

Agent identity blueprint principal

When aA multi-instance blueprint is added to a tenant, Microsoft Entra createsneeds a corresponding principal object. An agent identity blueprint principal isin the tenant. Managed creation experiences can create both objects, but creating the blueprint through Microsoft EntraGraph doesn't create its principal. Follow Create an agent blueprint principal when you provision it yourself. This object that records athe blueprint's presence in athe tenant and enables it to acquire tokens and appear in audit logs. For more information, see Agent identity blueprint principals.A single-instance blueprint doesn't have a blueprint principal.

Traditional service principal (not recommended for AI agents)

The Microsoft Entra ID Auth SDK (sidecar) is a containerized web service that handles token acquisition, validation, and secure downstream API calls for agents registered in the Microsoft identity platform. It runs as a companion container alongside your application, allowing you to offload identity logic to a dedicated service. For more information, see Microsoft Entra ID Auth SDK (sidecar).

Record the identifiers for your scenario

Record these values as you complete setup. Use only the rows your tutorial needs; you don't need to create every object in these tables. An application (client) ID identifies an OAuth client or resource. An object ID identifies one directory object in one tenant. They aren't interchangeable, even when both are GUIDs.

Tenant and management client

The management client provisions and configures identities in the selected tenant. Its client ID isn't the agent's runtime client ID.

Agent ID identifierIdentifier sourceRequired operation or field
Tenant IDYour directory's Tenant ID.The authority and the tenant targeted by management requests.
Management client IDThe separate management app's Application (client) ID.Connect-MgGraph -ClientId. This isn't the agent's runtime client ID.

Blueprint and agent identities

Use object IDs for directory operations and client IDs for OAuth requests. Single-instance provisioning uses the blueprint object ID; fleet provisioning uses its client ID.

Agent ID identifierIdentifier sourceRequired operation or field
Blueprint object IDid in the blueprint creation response.Microsoft Graph /applications/{id} updates, including credentials, redirect URIs, and scopes. Single-instance provisioning also uses this value for agentIdentityBlueprintId.
Blueprint client IDappId in the blueprint creation response.Blueprint authentication and its api:// identifier URI. Fleet provisioning uses this value for agentIdentityBlueprintId.
Blueprint principal object IDid in the blueprint principal creation response. Fleet scenarios only.Operations on the blueprint's tenant service principal, including configured permission inheritance. Don't create this object for a single-instance agent.
Agent object IDid in the agent identity creation response.Microsoft Graph /servicePrincipals/{id}, assignments, and oauth2PermissionGrants.clientId. Despite that grant field's name, it takes the agent's service principal object ID, not its OAuth client ID.
Agent client IDappId on the agent identity.Runtime OAuth requests. A cloud or local single-instance agent shares its blueprint's client ID; a fleet identity has a separate client ID.

Resources and permissions

The resource client ID identifies the API. Permission grants use its service principal object ID; scope and role GUIDs identify the permissions within that resource.

Agent ID identifierIdentifier sourceRequired operation or field
Resource client IDThe downstream API application's appId.Token audience, scope URI, and requiredResourceAccess.resourceAppId.
Resource service principal object IDid of that API's service principal in the grant tenant.resourceId in permission grants. Don't substitute the resource client ID.
Delegated scope ID and valueThe API's oauth2PermissionScopes[].id and .value.The GUID goes in permission declarations; the value, such as read_data, goes in a scope request or delegated grant.
App role IDThe resource's appRoles[].id.Application-permission declarations and app role assignments.

Human users and dedicated agent users

Both values are directory object IDs, not client IDs. A dedicated agent-user account doesn't replace the human user in an OBO request.

Agent ID identifierIdentifier sourceRequired operation or field
Human user object IDThe signed-in user's directory id.User-specific consent and ownership or sponsorship when the procedure requires a user.
Agent-user object IDid returned when you create the optional dedicated agent user.Dedicated-agent-user operations, not human-user OBO requests.

Keep credentials separate from this worksheet. Never record access tokens, client secrets, private keys, or PFX passwords in source control or shared troubleshooting notes.

Next steps

Related content

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…