Manage Agent Identities Admin
In brief
The documentation now explains permission inheritance prerequisites, distinguishes requested access from granted consent, links to current limitations, and clarifies that the Graph example returns only service principal sign-in events.
What Entra admins need to know
Administrators get clearer guidance for configuring inherited permissions and interpreting agent sign-in data.
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 IT administrator, I want a unified guide for managing agent identities in my organization so that I can efficiently view, govern, monitor, and secure agents across the full management lifecycle.
Configure inheritable permissions for blueprints
Inheritable permissions letcan make permissions granted to a blueprint principal available to its agent identities automatically inherit OAuth 2.0identities. The current Microsoft Graph beta reference documents delegated scope inheritance through inheritableScopes. The broader Agent ID permission scopes from their parent blueprint. When you configuremodel also describes application-role inheritance, but the public Graph reference doesn't define an application-role property or payload. Confirm Graph support before relying on application-role inheritance.
Inheritance requires both a resource app to be configured as inheritable and the permission to be granted to the blueprint principal. Required resource access declares requested permissions on a blueprint, newly created agent identities receive a base set of scopes without requiring interactive user or adminfor consent prompts.review; it doesn't grant access by itself. For static consent, include the permission in required resource access. For dynamic consent, explicitly request the permission. For details, see Inheritable permissions and required resource access and the Microsoft Graph inheritablePermission resource.
Two inheritance patterns are supported per resource app:
Start with enumerated scopes using only essential permissions, then expand as needed. This approach follows the principle of least privilege and makes it easier to audit which permissions agents actually use.
Key limits:
Maximum of 10 resource apps per blueprint.- For
enumerated scopes, maximum of 40 scopes per resource app. Some high-privilege scopes are blocked bycurrent API constraints and platformpolicy and can't be inherited.
Inheritable permissions are configured via the inheritablePermissions navigation property on the agentIdentityBlueprint application resource using Microsoft Graph. For step-by-step API examples (add, update, delete), see Configure inheritable permissions for agent identity blueprints.
- Agent type: Choose from Agent ID user, Agent Identity, Agent Identity Blueprint, or Not Agentic.
- Is Agent: Choose from No or Yes.
You can also retrieve agentThis Microsoft Graph example retrieves only service principal sign-in events using Microsoft Graph:for agent identities. It doesn't return every sign-in type associated with agents; see Microsoft Entra Agent ID logs for the other log types and filtering options.
GET https://graph.microsoft.com/beta/auditLogs/signIns?$filter=signInEventTypes/any(t: t eq 'servicePrincipal') and agent/agentType eq 'AgentIdentity'
@@ -3,8 +3,9 @@ title: Manage agent identities in your organization titleSuffix: Microsoft Entra Agent ID description: Learn how to manage agent identities across your organization. View, disable, govern, and monitor agents using the Microsoft Entra admin center and Conditional Access. ms.topic: how-to-ms.date: 05/01/2026+ms.date: 11/06/2026 ms.custom: msecd-doc-authoring-108+ai-usage: ai-assisted #customer intent: As an IT administrator, I want a unified guide for managing agent identities in my organization so that I can efficiently view, govern, monitor, and secure agents across the full management lifecycle. @@ -62,7 +63,9 @@ For detailed instructions, see [View and manage agent identity blueprints in you ## Configure inheritable permissions for blueprints -Inheritable permissions let agent identities automatically inherit OAuth 2.0 delegated permission scopes from their parent blueprint. When you configure inheritable permissions on a blueprint, newly created agent identities receive a base set of scopes without requiring interactive user or admin consent prompts.+Inheritable permissions can make permissions granted to a blueprint principal available to its agent identities. The current Microsoft Graph beta reference documents delegated scope inheritance through `inheritableScopes`. The broader Agent ID permission model also describes application-role inheritance, but the public Graph reference doesn't define an application-role property or payload. Confirm Graph support before relying on application-role inheritance.++Inheritance requires both a resource app to be configured as inheritable and the permission to be granted to the blueprint principal. Required resource access declares requested permissions for consent review; it doesn't grant access by itself. For static consent, include the permission in required resource access. For dynamic consent, explicitly request the permission. For details, see [Inheritable permissions and required resource access](concept-inheritable-permissions.md) and the [Microsoft Graph `inheritablePermission` resource](/graph/api/resources/inheritablepermission?view=graph-rest-beta&preserve-view=true). Two inheritance patterns are supported per resource app: @@ -73,11 +76,7 @@ Two inheritance patterns are supported per resource app: Start with enumerated scopes using only essential permissions, then expand as needed. This approach follows the principle of least privilege and makes it easier to audit which permissions agents actually use. -Key limits:--- Maximum of 10 resource apps per blueprint.-- For enumerated scopes, maximum of 40 scopes per resource app.-- Some high-privilege scopes are blocked by platform policy and can't be inherited.+For current API constraints and platform restrictions, see [Inheritable permissions limitations](configure-inheritable-permissions-blueprints.md#inheritable-permissions-limitations). Inheritable permissions are configured via the `inheritablePermissions` navigation property on the `agentIdentityBlueprint` application resource using Microsoft Graph. For step-by-step API examples (add, update, delete), see [Configure inheritable permissions for agent identity blueprints](configure-inheritable-permissions-blueprints.md). @@ -114,7 +113,7 @@ To view agent sign-in logs: - **Agent type**: Choose from **Agent ID user**, **Agent Identity**, **Agent Identity Blueprint**, or **Not Agentic**. - **Is Agent**: Choose from **No** or **Yes**. -You can also retrieve agent sign-in events using Microsoft Graph:+This Microsoft Graph example retrieves only service principal sign-in events for agent identities. It doesn't return every sign-in type associated with agents; see [Microsoft Entra Agent ID logs](sign-in-audit-logs-agents.md) for the other log types and filtering options. ```http GET https://graph.microsoft.com/beta/auditLogs/signIns?$filter=signInEventTypes/any(t: t eq 'servicePrincipal') and agent/agentType eq 'AgentIdentity' 