You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/introduction-entra-agent-id/includes/1-introduction.md
+5Lines changed: 5 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,6 +15,11 @@ Each of these agents needs an identity to authenticate and access resources secu
15
15
16
16
Microsoft Entra Agent ID addresses these challenges by providing specialized identity types designed for AI agents.
17
17
18
+
## Availability
19
+
20
+
> [!NOTE]
21
+
> Microsoft Entra Agent ID is part of **Microsoft Agent 365**, which reaches general availability on May 1, 2026.
22
+
18
23
## Content description
19
24
20
25
In this module, you learn about Microsoft Entra Agent ID and how it differs from other identity types like service principals and managed identities. You explore which Microsoft products automatically create agent identities and how to view and manage them through the Microsoft Entra admin center. You also learn about the roles required to manage agent identities and how to query them programmatically using Microsoft Graph.
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/introduction-entra-agent-id/includes/4-navigate-admin-center-view-agents.md
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,8 @@
1
1
The Microsoft Entra admin center provides a centralized interface to view and manage your agent identities. This experience allows you to search, filter, sort, and take actions on agent identities across your organization.
2
2
3
+
> [!IMPORTANT]
4
+
> The **Agent ID** menu in the Microsoft Entra admin center is only visible if your tenant has Microsoft Entra Agent ID enabled through **Microsoft Agent 365**. This requires a Microsoft 365 Copilot license with the Frontier program enabled. If you don't see the Agent ID section, contact your administrator to verify licensing and Frontier access.
5
+
3
6
## Prerequisites for viewing agent identities
4
7
5
8
To view agent identities in your Microsoft Entra tenant, you need:
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/introduction-entra-agent-id/includes/5-understand-access-permissions.md
+5-3Lines changed: 5 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,9 +21,11 @@ To manage agent identities (create, update, disable, delete), you need one of th
21
21
22
22
### Roles for creating agent identity blueprints
23
23
24
-
To create agent identity blueprints, you need:
25
-
-**Agent ID Developer** role or **Agent ID Administrator** role
26
-
-**Privileged Role Administrator** role (required to grant certain permissions to blueprints)
24
+
Creating agent identity blueprints requires different roles depending on the type of permissions being configured:
25
+
26
+
-**Agent ID Developer** or **Agent ID Administrator** — to create blueprints and blueprint principals
27
+
-**Privileged Role Administrator** — required to grant Microsoft Graph **application** permissions to the blueprint (used for autonomous, app-only agent scenarios)
28
+
-**Cloud Application Administrator** or **Application Administrator** — required to grant Microsoft Graph **delegated** permissions to the blueprint (used for interactive agents acting on behalf of a user)
|**Blueprint**|`agentIdentityBlueprint`| v1.0 (GA) | Template defining the agent identity type and permissions |
21
+
|**Blueprint principal**|`agentIdentityBlueprintPrincipal`| v1.0 (GA) | Record of blueprint's addition to a tenant |
22
+
|**Agent identity**|`agentIdentity`| v1.0 (GA) | Primary identity for authentication |
23
+
|**Agent user**|`agentUser`| Beta only | Optional account for scenarios requiring a user object |
24
+
|**Agent registry**|`agentRegistry`| Beta only | Centralized repository for agent management |
25
+
26
+
> [!WARNING]
27
+
> The `agentUser` and `agentRegistry` resources are only available under the Microsoft Graph `/beta` endpoint. Beta APIs are subject to change and are not supported for use in production applications.
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/introduction-entra-agent-id/index.yml
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ metadata:
4
4
title: Introduction to Microsoft Entra Agent ID
5
5
description: "Learn about Microsoft Entra Agent ID, a specialized identity type designed for AI agents. Understand how agent identities differ from other identity types, which Microsoft products use them, and how to view and manage them in the Microsoft Entra admin center."
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/plan-implement-administer-conditional-access/includes/1-introduction.md
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
Conditional Access gives a fine granularity of control over which users can perform specific activities, access resources, and ensure data and systems are safe.
1
+
Conditional Access gives a fine granularity of control over which users and identities can perform specific activities, access resources, and ensure data and systems are safe. With the introduction of Microsoft Entra Agent ID, that control now extends to AI agents — you apply the same Zero Trust principles to agent identities that you apply to users and workload identities.
2
2
3
3
## Learning objectives
4
4
@@ -11,3 +11,4 @@ In this module, you will:
11
11
- Implement application controls.
12
12
- Implement session management.
13
13
- Configure continuous access evaluation.
14
+
- Identify how agent identities are protected using Conditional Access.
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/plan-implement-administer-conditional-access/includes/2-plan-security-defaults.md
+17-8Lines changed: 17 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,9 @@ Managing security can be difficult with common identity-related attacks like pas
10
10
11
11
## Availability
12
12
13
-
Microsoft security defaults are available to everyone. The goal is to ensure that all organizations have a basic level of security enabled at no extra cost. You turn on security defaults in the Azure portal. If your tenant was created on or after October 22, 2019, it is possible security defaults are already enabled in your tenant. To protect all of our users, the security defaults feature is being rolled out to all new tenants created.
13
+
Microsoft security defaults are available to everyone. The goal is to ensure that all organizations have a basic level of security enabled at no extra cost. If your tenant was created on or after October 22, 2019, security defaults might already be enabled. To protect all users, security defaults are enabled on all new tenants at creation.
14
+
15
+
To enable or disable security defaults, sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a Conditional Access Administrator, then browse to **Entra ID** > **Overview** > **Properties**, and select **Manage security defaults**.
14
16
15
17
### Who's it for?
16
18
@@ -24,23 +26,30 @@ Microsoft security defaults are available to everyone. The goal is to ensure tha
All users in your tenant must register for multifactor authentication (MFA) in the form of the Multifactor Authentication. Users have 14 days to register for multifactor authentication within Microsoft Entra ID by using the Microsoft Authenticator app. After the 14 days have passed, the user won't be able to sign in until registration is completed. A user's 14-day period begins after their first successful interactive sign-in after enabling security defaults.
29
+
All users in your tenant must register for multifactor authentication (MFA) using the Microsoft Authenticator app. Registration is required immediately — there is no grace period. When users sign in after security defaults are enabled, they're prompted to register before they can access any resources. The MFA prompt uses number matching, where users enter a number displayed on screen into the Microsoft Authenticator app, which helps prevent MFA fatigue attacks.
28
30
29
31
### Protecting administrators
30
32
31
33
Users with privileged access have increased access to your environment. Due to the power these accounts have, you should treat them with special care. One common method to improve the protection of privileged accounts is to require a stronger form of account verification for sign-in. In Microsoft Entra ID, you can get a stronger account verification by requiring multifactor authentication.
32
34
33
-
After registration with Multifactor Authentication is finished, the following nine Microsoft Entra administrator roles will be required to perform additional authentication every time they sign in:
35
+
After registration with multifactor authentication is finished, the following Microsoft Entra administrator roles are required to perform additional authentication every time they sign in:
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/plan-implement-administer-conditional-access/includes/4-plan-conditional-access-policies.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,6 +34,8 @@ Some common questions about assignments, access controls, and session controls:
34
34
- Access controls: Do you want to grant access to resources by implementing requirements such as MFA, devices marked as compliant, or Microsoft Entra hybrid joined devices?
35
35
- Session controls: Do you want to control access to cloud apps by implementing requirements such as app enforced permissions or Conditional Access App Control?
36
36
37
+
With the introduction of Microsoft Entra Agent ID, agent identities are now first-class principals in Microsoft Entra ID. Like users or service principals, agents can be targeted by Conditional Access policies — allowing you to apply the same Zero Trust controls to AI agents that you apply to human identities. You treat agent identities similarly to how you treat workload identities: scope policies by identity type, enforce appropriate access controls, and exclude emergency or trusted agents where necessary.
38
+
37
39
### Access token issuance
38
40
39
41
Access tokens enable clients to securely call protected web APIs, and they're used by web APIs to perform authentication and authorization. Per the OAuth specification, access tokens are opaque strings without a set format. Some identity providers (IDPs) use GUIDs; others use encrypted blobs. The Microsoft identity platform uses a variety of access token formats depending on the configuration of the API that accepts the token.
Copy file name to clipboardExpand all lines: learn-pr/wwl-sci/plan-implement-administer-conditional-access/includes/5-implement-conditional-access-policies-controls-assignments.md
+23-14Lines changed: 23 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,18 +1,22 @@
1
-
Visual Studio App Center supports Microsoft Entra Conditional Access, an advanced feature of Microsoft Entra ID that enables you to specify detailed policies that control who can access your resources. Using Conditional Access, you can protect your applications by limiting users' access based on things like group, device type, location, and role.
1
+
Conditional Access is an advanced capability of Microsoft Entra ID that enables you to specify detailed policies that control who can access your resources. Using Conditional Access, you can protect your applications by limiting users' access based on signals like group membership, device compliance, network location, and sign-in risk.
2
2
3
-
## Setting up Conditional Access
3
+
## Create a Conditional Access policy
4
4
5
-
This is an abbreviated guide to setting up Conditional Access. Full documentation is available at [What is Conditional Access?](/entra/identity/conditional-access/overview).
5
+
This is an abbreviated guide to creating a Conditional Access policy. Full documentation is available at [What is Conditional Access?](/entra/identity/conditional-access/overview).
6
6
7
-
In the Azure portal, open your Active Directory tenant, then open the **Security** settings, and select **Conditional Access**.
7
+
To create a new policy:
8
8
9
-
In **Conditional Access** settings, select **New policy** to create a policy.
9
+
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a Conditional Access Administrator.
10
+
2. Browse to **Protection** > **Conditional Access**.
11
+
3. Select **+ New policy**.
12
+
4. Give the policy a meaningful name.
13
+
5. Configure **Assignments** — select the users, groups, or roles the policy applies to.
14
+
6. Configure **Target resources** — select the cloud apps or user actions the policy covers.
15
+
7. Configure any additional **Conditions** such as sign-in risk, device platform, or location.
16
+
8. Under **Access controls**, configure the **Grant** or **Session** controls to apply.
17
+
9. Set **Enable policy** to **Report-only** to test impact before enabling, then select **Create**.
10
18
11
-
:::image type="content" source="../media/conditional-access-2.png" alt-text="Screenshot of the Microsoft Entra Conditional Access screen, listing policies that currently exist.":::
12
-
13
-
In **New policy** settings, select **Cloud apps or actions** and select **Visual Studio App Center** as the target of the policy. Then select the other conditions that you want to apply, enable the policy, and select **Create** to save it.
14
-
15
-
:::image type="content" source="../media/conditional-access-1.png" alt-text="Screenshot of the Microsoft Entra Conditional Access: Cloud apps or actions page for configuration.":::
19
+
Microsoft recommends starting all new policies in report-only mode. Monitor sign-in logs to verify expected behavior before switching the policy to **On**.
16
20
17
21
## Sign-in risk-based Conditional Access
18
22
@@ -36,14 +40,17 @@ Securing when and how users register for multifactor authentication and self-ser
36
40
37
41
The following policy applies to all selected users who attempt to register using the combined registration experience, and it blocks access unless they are connecting from a location marked as a trusted network.
38
42
39
-
1. In the **Microsoft Entra admin center**, browse to **Identity**, then **Protection**, and then **Conditional Access**.
43
+
1. In the **Microsoft Entra admin center**, browse to **Protection**, then **Conditional Access**.
40
44
2. Select **+ Create new policy**.
41
45
3. In **Name**, Enter a Name for this policy. For example, **Combined Security Info Registration on Trusted Networks**.
42
46
4. Under **Assignments**, select **Users and groups**, and select the users and groups you want this policy to apply to.
43
47
44
48
1. Under **Exclude**, select **Users and groups** and choose your organization's emergency access or break-glass accounts.
45
49
2. Select **Done**.
46
50
51
+
> [!NOTE]
52
+
> If you were targeting AI agents instead of users, you would select **Workload identities** in the Assignments area and choose your agent identity from Microsoft Entra Agent ID at this step. The rest of the policy structure remains the same.
53
+
47
54
5. Under **Cloud apps or actions**, select **User actions**, check **Register security information**.
48
55
6. Under **Conditions**, select **Locations**.
49
56
@@ -80,7 +87,7 @@ With the location condition in Conditional Access, you can control access to you
80
87
### Define locations
81
88
82
89
1. Sign in to the **Microsoft Entra admin portal** as a Security Administrator, or Conditional Access Administrator.
83
-
2. Browse to **Identity**, then **Protection**, then **Conditional Access**, and then **Named locations**.
90
+
2. Browse to **Protection**, then **Conditional Access**, then **Named locations**.
84
91
3. Choose **New location**.
85
92
4. Give your location a name.
86
93
5. Choose **IP ranges** if you know the specific externally accessible IPv4 address ranges that make up that location or **Countries/Regions**.
@@ -94,7 +101,7 @@ With the location condition in Conditional Access, you can control access to you
94
101
### Create a Conditional Access policy
95
102
96
103
1. Sign in to the **Microsoft Entra admin center** as a Security Administrator, or Conditional Access Administrator.
97
-
2. Browse to **Identity**, then **Protection**, and then **Conditional Access**.
104
+
2. Browse to **Protection**, then **Conditional Access**.
98
105
3. Select **+ Create new policy**.
99
106
4. Give your policy a name. We recommend that organizations create a meaningful standard for the names of their policies.
100
107
5. Under **Assignments**, select **Users and groups.**
@@ -131,7 +138,7 @@ This policy compliance information is forwarded to Microsoft Entra ID where Cond
131
138
The following steps will help create a Conditional Access policy to require devices accessing resources be marked as compliant with your organization's Intune compliance policies.
132
139
133
140
1. Sign in to the **Microsoft Entra admin center** as a Security Administrator, or Conditional Access Administrator.
134
-
2. Browse to **Identity**, then **Protection**, and then **Conditional Access**.
141
+
2. Browse to **Protection**, then **Conditional Access**.
135
142
3. Select **+ Create new policy**.
136
143
4. Give your policy a name. We recommend that organizations create a meaningful standard for the names of their policies.
137
144
5. Under **Assignments**, select **Users and groups.**
@@ -178,6 +185,8 @@ Conditional Access policies are powerful tools. We recommend excluding the follo
178
185
179
186
- If your organization has these accounts in use in scripts or code, consider replacing them with managed identities. As a temporary workaround, you can exclude these specific accounts from the baseline policy.
180
187
188
+
-**Agent identities**: AI agents registered in Microsoft Entra Agent ID can be targeted by or excluded from Conditional Access policies just like service principals. Ensure any trusted agents that require uninterrupted access are explicitly excluded, and review agent-targeted policies alongside your workload identity policies.
189
+
181
190
## Conditional Access Terms of Use (TOU)
182
191
183
192
:::image type="content" source="../media/create-terms-identity-governance.png" alt-text="Screenshot of the Identity Governance dialog to create new Terms of Use for your cloud solutions.":::
0 commit comments