Microsoft Entra Agent ID
Monitoring

How are agent identities created?

In brief

The documentation now states that agent identity blueprint principals cannot create agent identities or agent user accounts until an administrator grants the corresponding permissions. It also corrects the delegated permission name to `AgentIdentity.ReadWrite.All`.

What Entra admins need to know

Administrators must grant the required permissions before blueprint principals can create identities or user accounts.

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 an IAM or security administrator, I want to understand how agent identities are created so that I can monitor and control their introduction into my tenant.

  • Indicates a managed experience channel

When an agent identity blueprint is added to your tenant through one of theFor fleet blueprints, managed experiences,creation experiences also create an agent identity blueprint principal object is also created in the tenant. ThisAn administrator can grant this principal is assigned privilegespermissions to create agent identities and agents' user accounts in the tenant.accounts. If an agent identityyou create a fleet blueprint is addeddirectly through the Microsoft Graph API, CLI, PowerShell, or Infrastructure as Code tools channels, the associated principal must be manually created.a tool that doesn't provision its principal, create that principal explicitly. The cloud and local agent provisioning procedure doesn't use a blueprint principal.

In addition to the channels listed in the previous table, any system with an agent identity blueprint principal in your tenant becomes a channel for the agent identity and agent's user account creation:

Scenario Permissions required
User creates agent identity via Microsoft Entra admin center, Microsoft Graph, or PowerShell/CLI User must be assigned Agent ID Developer, Agent ID Administrator, or AI Administrator role.
Client creates agent identity via Microsoft Graph, using delegated permissions User must be assigned Agent ID Administrator role. Client must be granted AgentIdentity.Create.All or AgentIdentity.ReadWrite.AlAll delegated permission.
Client creates agent identity via Microsoft Graph, using delegated permissions User must be an owner of the agent identity blueprint or agent identity blueprint principal (owners added at any time have this permission). Client must be granted AgentIdentity.Create.All, AgentIdentity.ReadWrite.All, or AgentIdentity.ReadWrite.ManagedBy delegated permission. No Agent ID role is required.
Client creates agent identity via Microsoft Graph, using application permissions Client must be granted AgentIdentity.Create.All application permission.

Agent identity blueprint principals

Once anAn agent identity blueprint principal is created in your tenant, the principal is assigned privileges tocan't create agent identities andor agents' user accounts. Theaccounts until an administrator grants it the corresponding permission. Once granted, the principal can also update and delete any of the identities it creates. The following table describes permissions that can be given to these principals:

Entity Permission Comments
Agent identity AgentIdentity.CreateAsManager (application permission) ThisA Microsoft Entra ID administrator must grant this permission is automatically granted to anyan agent identity blueprint principal in the tenant. It allowsprincipal. Once granted, the principal tocan create agent identities, and update and delete the agent identities it creates. ThisThe permission can't be revoked. To prevent a principal from creating agent identities, you must disable it or remove the principal from the tenant. Principals are limited to a maximum of 250 agent identity creations.
Agent's user account AgentIdUser.ReadWrite.IdentityParentedBy (application permission) A Microsoft Entra ID administrator must grant this permission to an agent identity blueprint principal. Once granted, the principal can create agents' user accounts, and update and delete any users it creates. The permission can be revoked.

Administrators can control agent identity creation viathrough this channel by limitingchoosing which agent identity blueprints are added to their tenant as agent identity blueprint principals.principals receive these permissions. For more information on these permissions, see Agent identity permissions reference.

Auditing and monitoring agent identity creation

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…