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: articles/aks/aad-integration-v2.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,17 +7,17 @@ ms.topic: article
7
7
ms.date: 03/24/2020
8
8
---
9
9
10
-
# Integrate Azure Active Directory (AAD) v2.0 in Azure Kubernetes Service (Preview)
10
+
# Integrate Azure Active Directory v2.0 in Azure Kubernetes Service (Preview)
11
11
12
12
> [!Note]
13
-
> Existing AAD v1.0 clusters are not affected by the new AAD v2.0 feature for AKS.
13
+
> Existing Azure Active Directory v1.0 clusters are not affected by the new Azure Active Directory v2.0 feature for AKS.
14
14
15
-
AAD v2.0 is designed to simplify the AAD v1.0 experience, where users were required to create a client app, a server app, and required the AAD tenant to grant Directory Read permissions.
16
-
In the new version, the AKS resource provider manages the client and server apps for you. Instead of using a persistent "Application Permission," the AKS resource provider uses a "Delegated Permission" via an on-behalf-of flow to get an access token to Graph API. AAD v2.0 enabled clusters use a limited scoped Graph API privilege (GroupMembers.Read.All) to query group membership only when the overage indicator is present (when there are more than 250 group claims).
15
+
Azure Active Directory v2.0 is designed to simplify the Azure Active Directory v1.0 experience, where users were required to create a client app, a server app, and required the Azure Active Directory tenant to grant Directory Read permissions.
16
+
In the new version, the AKS resource provider manages the client and server apps for you. Instead of using a persistent "Application Permission," the AKS resource provider uses a "Delegated Permission" via an on-behalf-of flow to get an access token to Graph API. Azure Active Directory v2.0 enabled clusters use a limited scoped Graph API privilege (GroupMembers.Read.All) to query group membership only when the overage indicator is present (when there are more than 250 group claims).
17
17
18
18
## Limitations
19
19
20
-
* You can't currently upgrade an existing AAD v1.0 cluster to AAD v2.0.
20
+
* You can't currently upgrade an existing Azure Active Directory v1.0 cluster to Azure Active Directory v2.0.
21
21
22
22
> [!IMPORTANT]
23
23
> AKS preview features are available on a self-service, opt-in basis. Previews are provided "as-is" and "as available," and are excluded from the Service Level Agreements and limited warranty. AKS previews are partially covered by customer support on a best-effort basis. As such, these features are not meant for production use. For more information, see the following support articles:
@@ -90,22 +90,22 @@ Then, create an AKS cluster:
90
90
```azurecli-interactive
91
91
az aks create -g MyResourceGroup -n MyManagedCluster --enable-aad
92
92
```
93
-
The above command creates a three node AKS cluster, but the user, who created the cluster, by default, is not a member of a group that has access to this cluster. This user needs to create an AAD group, add themselves as a member of the group, and then update the cluster as shown below. Follow instructions [here](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-groups-create-azure-portal)
93
+
The above command creates a three node AKS cluster, but the user, who created the cluster, by default, is not a member of a group that has access to this cluster. This user needs to create an Azure Active Directory group, add themselves as a member of the group, and then update the cluster as shown below. Follow instructions [here](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-groups-create-azure-portal)
94
94
95
-
Once you've created a group and added yourself (and others) as a member, you can update the cluster with the aad group using the following command
95
+
Once you've created a group and added yourself (and others) as a member, you can update the cluster with the Azure Active Directory group using the following command
96
96
97
97
```azurecli-interactive
98
98
az aks update -g MyResourceGroup -n MyManagedCluster --enable-aad [--aad-admin-group-object-ids <id1,id2>] [--aad-tenant-id <id>]
99
99
```
100
-
Alternatively, if you first create a group and add members, you can enable the AAD group at create time using the following command,
100
+
Alternatively, if you first create a group and add members, you can enable the Azure Active Directory group at create time using the following command,
101
101
102
102
```azurecli-interactive
103
103
az aks create -g MyResourceGroup -n MyManagedCluster --enable-aad [--aad-admin-group-object-ids <id1,id2>] [--aad-tenant-id <id>]
104
104
```
105
105
106
-
A successful creation of an AAD v2 cluster has the following section in the response body
106
+
A successful creation of an Azure Active Directory v2 cluster has the following section in the response body
107
107
```
108
-
"aadProfile": {
108
+
"Azure Active DirectoryProfile": {
109
109
"adminGroupObjectIds": null,
110
110
"clientAppId": null,
111
111
"managed": true,
@@ -117,7 +117,7 @@ A successful creation of an AAD v2 cluster has the following section in the resp
117
117
118
118
The cluster is created within a few minutes.
119
119
120
-
## Accessing an AAD v1.0 enabled cluster
120
+
## Accessing an Azure Active Directory v1.0 enabled cluster
121
121
To get the admin credentials to access the cluster:
0 commit comments