Skip to content

Commit 1c7df6f

Browse files
Merge pull request #283768 from jimmyca15/user/jimmyca/cmkRole
Add role details for App Configuration CMK setup.
2 parents df8f035 + 20eb80f commit 1c7df6f

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

articles/azure-app-configuration/concept-customer-managed-keys.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,9 @@ The following components are required to successfully enable the customer-manage
3636
After these resources are configured, use the following steps so that the Azure App Configuration can use the Key Vault key:
3737

3838
1. Assign a managed identity to the Azure App Configuration instance.
39-
1. Grant the identity `GET`, `WRAP`, and `UNWRAP` permissions in the target Key Vault's access policy.
39+
1. Grant permissions to the identity to be able to access the Key Vault key.
40+
* For Key Vault's with [Azure RBAC](../key-vault/general/rbac-guide.md) enabled, assign the identity the `Key Vault Crypto Service Encryption User` role on the target Key Vault.
41+
* For Key Vault's using access policy authorization, grant the identity `GET`, `WRAP`, and `UNWRAP` permissions in the target Key Vault's access policy.
4042

4143
## Enable customer-managed key encryption for your App Configuration store
4244

@@ -76,7 +78,19 @@ After these resources are configured, use the following steps so that the Azure
7678
}
7779
```
7880
79-
1. The managed identity of the Azure App Configuration instance needs access to the key to perform key validation, encryption, and decryption. The specific set of actions to which it needs access includes: `GET`, `WRAP`, and `UNWRAP` for keys. Granting access requires the principal ID of the App Configuration instance's managed identity. Replace the value shown below as `contoso-principalId` with the principal ID obtained in the previous step. Grant permission to the managed key by using the command line:
81+
1. The managed identity of the Azure App Configuration instance needs access to the key to perform key validation, encryption, and decryption. The specific set of actions to which it needs access includes: `GET`, `WRAP`, and `UNWRAP` for keys. These permissions can be granted by assigning the `Key Vault Crypto Service Encryption User` role for Azure RBAC enabled Key Vaults. For Key Vaults using access policy authorization, set the policy for the aforementioned key permissions. Granting access requires the principal ID of the App Configuration instance's managed identity. Replace the value shown below as `contoso-principalId` with the principal ID obtained in the previous step. Grant permission to the managed key by using the command line:
82+
83+
### [Azure RBAC](#tab/azurerbac)
84+
85+
For Key Vaults with Azure RBAC enabled, use the following command.
86+
87+
```azurecli
88+
az role assignment create --assignee contoso-principalId --role "Key Vault Crypto Service Encryption User" --scope key-vault-resource-id
89+
```
90+
91+
### [Access Policy](#tab/accesspolicy)
92+
93+
For Key Vaults using access policy authorization, use the following command.
8094
8195
```azurecli
8296
az keyvault set-policy -n contoso-vault --object-id contoso-principalId --key-permissions get wrapKey unwrapKey

0 commit comments

Comments
 (0)