Skip to content

Commit d7fe741

Browse files
Resolve comments
1 parent ea4bff4 commit d7fe741

File tree

1 file changed

+11
-22
lines changed

1 file changed

+11
-22
lines changed

articles/azure-app-configuration/reference-kubernetes-provider.md

Lines changed: 11 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,13 @@ The `spec.target` property has the following child property.
3232
|---|---|---|---|
3333
|configMapName|The name of the ConfigMap to be created|true|string|
3434

35-
If the `spec.auth` property isn't set, the system-assigned managed identity is used. It has the following child properties. Only one authentication method should be set.
35+
The `spec.auth` property isn't required if the connection string of your App Configuration store is provided by setting the `spec.connectionStringReference` property. Otherwise, the [DefaultAzureCredential](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/azidentity#DefaultAzureCredential) is used for authentication and it will try an ordered list of credential types.
3636

3737
|Name|Description|Required|Type|
3838
|---|---|---|---|
39-
|managedIdentityClientId|The Client ID of user-assigned managed identity|false|string|
4039
|servicePrincipalReference|The name of the Kubernetes Secret that contains the credentials of a service principal|false|string|
4140
|workloadIdentity|The settings for using workload identity|false|object|
41+
|managedIdentityClientId|The Client ID of user-assigned managed identity of VMSS. The absence of this property indicates that system-assigned managed identity should be attempted during authentication if another credential type doesn't take priority|false|string|
4242

4343
The `spec.auth.workloadIdentity` property has the following child property.
4444

@@ -79,19 +79,19 @@ If the `spec.keyValues.keyVaults.auth` property isn't set, the system-assigned m
7979

8080
|Name|Description|Required|Type|
8181
|---|---|---|---|
82-
|managedIdentityClientId|The client ID of a user-assigned managed identity used for authentication with vaults that don't have individual authentication methods specified|false|string|
8382
|servicePrincipalReference|The name of the Kubernetes Secret that contains the credentials of a service principal used for authentication with vaults that don't have individual authentication methods specified|false|string|
84-
|workloadIdentity|The settings of the workload identity used for authentication with vaults that don't have individual authentication methods specified, it has same child property with `spec.auth.workloadIdentity`|false|object|
83+
|workloadIdentity|The settings of the workload identity used for authentication with vaults that don't have individual authentication methods specified. It has the same child properties as `spec.auth.workloadIdentity`|false|object|
84+
|managedIdentityClientId|The client ID of a user-assigned managed identity of VMSS used for authentication with vaults that don't have individual authentication methods specified. The absence of this property indicates that system-assigned managed identity should be attempted during authentication if another credential type doesn't take priority|false|string|
8585
|vaults|The authentication methods for individual vaults|false|object array|
8686

8787
The authentication method of each *vault* can be specified with the following properties. One of `managedIdentityClientId`, `servicePrincipalReference` or `workloadIdentity` must be provided.
8888

8989
|Name|Description|Required|Type|
9090
|---|---|---|---|
9191
|uri|The URI of a vault|true|string|
92-
|managedIdentityClientId|The client ID of a user-assigned managed identity used for authentication with a vault|false|string|
9392
|servicePrincipalReference|The name of the Kubernetes Secret that contains the credentials of a service principal used for authentication with a vault|false|string|
94-
|workloadIdentity|The settings of the workload identity used for authentication with a vault, it has same child property with `spec.auth.workloadIdentity`|false|object|
93+
|workloadIdentity|The settings of the workload identity used for authentication with a vault. It has the same child properties as `spec.auth.workloadIdentity`|false|object|
94+
|managedIdentityClientId|The client ID of a user-assigned managed identity of VMSS used for authentication with a vault|false|string|
9595

9696
The `spec.keyValues.refresh` property has the following child properties.
9797

@@ -111,9 +111,9 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
111111

112112
### Authentication
113113

114-
#### Use System-Assigned Managed Identity
114+
#### Use System-Assigned Managed Identity of VMSS
115115

116-
1. [Enable the system-assigned managed identity in the virtual machine scale set](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#enable-system-assigned-managed-identity-on-an-existing-virtual-machine-scale-set) used by the Azure Kubernetes Service (AKS) cluster.
116+
1. [Enable the system-assigned managed identity in the virtual machine scale set (VMSS)](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#enable-system-assigned-managed-identity-on-an-existing-virtual-machine-scale-set) used by the Azure Kubernetes Service (AKS) cluster.
117117

118118
1. [Grant the system-assigned managed identity **App Configuration Data Reader** role](/azure/azure-app-configuration/howto-integrate-azure-managed-service-identity#grant-access-to-app-configuration) in Azure App Configuration.
119119

@@ -130,11 +130,11 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
130130
configMapName: configmap-created-by-appconfig-provider
131131
```
132132
133-
#### Use User-Assigned Managed Identity at cluster level
133+
#### Use User-Assigned Managed Identity of VMSS
134134
135135
1. [Create a user-assigned managed identity](/azure/active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities#create-a-user-assigned-managed-identity) and note down its client ID after creation.
136136
137-
1. [Assign the user-assigned managed identity to the virtual machine scale set](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#user-assigned-managed-identity) used by the Azure Kubernetes Service (AKS) cluster.
137+
1. [Assign the user-assigned managed identity to the virtual machine scale set (VMSS)](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#user-assigned-managed-identity) used by the Azure Kubernetes Service (AKS) cluster.
138138
139139
1. [Grant the user-assigned managed identity **App Configuration Data Reader** role](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#user-assigned-managed-identity) in Azure App Configuration.
140140
@@ -178,17 +178,6 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
178178

179179
#### Use workload identity
180180

181-
1. Explicitly use workload identity while install the Azure App Configuration Kubernetes Provider by helm
182-
183-
``` bash
184-
helm install azureappconfiguration.kubernetesprovider \
185-
oci://mcr.microsoft.com/azure-app-configuration/helmchart/kubernetes-provider \
186-
--version 1.0.0-preview4 \
187-
--namespace azappconfig-system \
188-
--create-namespace \
189-
--set workloadIdentity.enabled=true
190-
```
191-
192181
1. [Enable Workload Identity](/azure/aks/workload-identity-deploy-cluster#update-an-existing-aks-cluster) on the Azure Kubernetes Service (AKS) cluster.
193182

194183
1. [Get the OIDC issuer URL](/azure/aks/workload-identity-deploy-cluster#retrieve-the-oidc-issuer-url) of the AKS cluster.
@@ -198,7 +187,7 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
198187
1. Create the federated identity credential between the managed identity, OIDC issuer, and subject using the Azure CLI.
199188

200189
``` azurecli
201-
az identity federated-credential create --name ${FEDERATED_IDENTITY_CREDENTIAL_NAME} --identity-name "${USER_ASSIGNED_IDENTITY_NAME}" --resource-group "${RESOURCE_GROUP}" --issuer "${AKS_OIDC_ISSUER}" --subject system:serviceaccount:azappconfig-system:az-appconfig-k8s-provider --audience api://AzureADTokenExchange
190+
az identity federated-credential create --name "${FEDERATED_IDENTITY_CREDENTIAL_NAME}" --identity-name "${USER_ASSIGNED_IDENTITY_NAME}" --resource-group "${RESOURCE_GROUP}" --issuer "${AKS_OIDC_ISSUER}" --subject system:serviceaccount:azappconfig-system:az-appconfig-k8s-provider --audience api://AzureADTokenExchange
202191
```
203192

204193
1. [Grant the user-assigned managed identity **App Configuration Data Reader** role](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#user-assigned-managed-identity) in Azure App Configuration.

0 commit comments

Comments
 (0)