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/azure-app-configuration/reference-kubernetes-provider.md
+9-60Lines changed: 9 additions & 60 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,19 +40,12 @@ If the `spec.target.configMapData` property is not set, the generated ConfigMap
40
40
|type|The setting that indicates how the retrieved data is constructed in the generated ConfigMap. The allowed values include `default`, `json`, `yaml` and `properties`|optional|string|
41
41
|key|The key name of the retrieved data when the `type` is set to `json`, `yaml` or `properties`. Set it to the file name if the ConfigMap is set up to be consumed as a mounted file|conditional|string|
42
42
43
-
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, one of the identities, service principal, workload identity, or managed identity, will be used for authentication. The `spec.auth`has the following child properties. Only one of them should be specified. If none of them are set, the system-assigned managed identity of the virtual machine scale set will be used.
43
+
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.
44
44
45
45
|Name|Description|Required|Type|
46
46
|---|---|---|---|
47
+
|managedIdentityClientId|The Client ID of user-assigned managed identity|false|string|
47
48
|servicePrincipalReference|The name of the Kubernetes Secret that contains the credentials of a service principal|false|string|
48
-
|workloadIdentity|The settings for using workload identity|false|object|
49
-
|managedIdentityClientId|The Client ID of user-assigned managed identity of virtual machine scale set|false|string|
50
-
51
-
The `spec.auth.workloadIdentity` property has the following child property.
52
-
53
-
|Name|Description|Required|Type|
54
-
|---|---|---|---|
55
-
|managedIdentityClientId|The Client ID of the user-assigned managed identity associated with the workload identity|true|string|
56
49
57
50
The `spec.keyValues` has the following child properties. The `spec.keyValues.keyVaults` property is required if any Key Vault references are expected to be downloaded.
58
51
@@ -87,19 +80,17 @@ If the `spec.keyValues.keyVaults.auth` property isn't set, the system-assigned m
87
80
88
81
|Name|Description|Required|Type|
89
82
|---|---|---|---|
83
+
|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|
90
84
|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|
91
-
|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|
92
-
|managedIdentityClientId|The client ID of a user-assigned managed identity of virtual machine scale set used for authentication with vaults that don't have individual authentication methods specified|false|string|
93
85
|vaults|The authentication methods for individual vaults|false|object array|
94
86
95
-
The authentication method of each *vault* can be specified with the following properties. One of `managedIdentityClientId`, `servicePrincipalReference` or `workloadIdentity` must be provided.
87
+
The authentication method of each *vault* can be specified with the following properties. One of `managedIdentityClientId` and `servicePrincipalReference` must be provided.
96
88
97
89
|Name|Description|Required|Type|
98
90
|---|---|---|---|
99
91
|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|
100
93
|servicePrincipalReference|The name of the Kubernetes Secret that contains the credentials of a service principal used for authentication with a vault|false|string|
101
-
|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|
102
-
|managedIdentityClientId|The client ID of a user-assigned managed identity of virtual machine scale set used for authentication with a vault|false|string|
103
94
104
95
The `spec.keyValues.refresh` property has the following child properties.
105
96
@@ -119,12 +110,10 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
119
110
120
111
### Authentication
121
112
122
-
#### Use system-assigned managed identity of virtual machine scale set
113
+
#### Use System-Assigned Managed Identity
123
114
124
115
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.
125
-
126
116
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.
127
-
128
117
1. Deploy the following sample `AzureAppConfigurationProvider` resource to the AKS cluster.
129
118
130
119
```yaml
@@ -138,14 +127,11 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
#### Use user-assigned managed identity of virtual machine scale set
130
+
#### Use User-Assigned Managed Identity
142
131
143
132
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.
144
-
145
133
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.
146
-
147
134
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.
148
-
149
135
1. Set the `spec.auth.managedIdentityClientId` property to the client ID of the user-assigned managed identity in the following sample `AzureAppConfigurationProvider` resource and deploy it to the AKS cluster.
150
136
151
137
``` yaml
@@ -161,14 +147,11 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
1. [Create a Service Principal](/azure/active-directory/develop/howto-create-service-principal-portal)
167
-
168
153
1. [Grant the service principal **App Configuration Data Reader** role](/azure/azure-app-configuration/howto-integrate-azure-managed-service-identity#grant-access-to-app-configuration) in Azure App Configuration.
169
-
170
154
1. Create a Kubernetes Secret in the same namespace as the `AzureAppConfigurationProvider` resource and add *azure_client_id*, *azure_client_secret*, and *azure_tenant_id* of the service principal to the Secret.
171
-
172
155
1. Set the `spec.auth.servicePrincipalReference` property to the name of the Secret in the following sample `AzureAppConfigurationProvider` resource and deploy it to the Kubernetes cluster.
173
156
174
157
``` yaml
@@ -184,42 +167,9 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
1. [Enable Workload Identity](/azure/aks/workload-identity-deploy-cluster#update-an-existing-aks-cluster) on the Azure Kubernetes Service (AKS) cluster.
190
-
191
-
1. [Get the OIDC issuer URL](/azure/aks/workload-identity-deploy-cluster#retrieve-the-oidc-issuer-url) of the AKS cluster.
192
-
193
-
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.
194
-
195
-
1. Create the federated identity credential between the managed identity, OIDC issuer, and subject using the Azure CLI.
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.
202
-
203
-
1. Set the `spec.auth.workloadIdentity.managedIdentityClientId` property to the client ID of the user-assigned managed identity in the following sample `AzureAppConfigurationProvider` resource and deploy it to the AKS cluster.
1. Create a Kubernetes Secret in the same namespace as the `AzureAppConfigurationProvider` resource and add Azure App Configuration connection string with key *azure_app_configuration_connection_string* in the Secret.
222
-
223
173
1. Set the `spec.connectionStringReference` property to the name of the Secret in the following sample `AzureAppConfigurationProvider` resource and deploy it to the Kubernetes cluster.
224
174
225
175
``` yaml
@@ -232,7 +182,6 @@ The `spec.keyValues.refresh.monitoring.keyValues` is an array of objects, which
0 commit comments