Skip to content

Commit e295942

Browse files
committed
Update Key Rotation tutorial to improve performance KPIs
1 parent aaebd40 commit e295942

File tree

1 file changed

+16
-4
lines changed

1 file changed

+16
-4
lines changed

articles/key-vault/keys/how-to-configure-key-rotation.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,15 @@ ms.author: mbaldwin
1515

1616
## Overview
1717

18-
Automated key rotation in Key Vault allows users to configure Key Vault to automatically generate a new key version at a specified frequency. You can use rotation policy to configure rotation for each individual
19-
key. Our recommendation is to rotate encryption keys at least every two years to meet cryptographic best practices.
18+
Automated key rotation in [Key Vault](../general/overview.md) allows users to configure Key Vault to automatically generate a new key version at a specified frequency. For more information about how keys are versioned, see [Key Vault objects, identifiers, and versioning](../general/about-keys-secrets-certificates.md#objects-identifiers-and-versioning).
2019

21-
This feature enables end-to-end zero-touch rotation for encryption at rest for Azure services with customer-managed key (CMK) stored in Azure Key Vault. Please refer to specific Azure service documentation to see if the service covers end-to-end rotation.
20+
You can use rotation policy to configure rotation for each individual key. Our recommendation is to rotate encryption keys at least every two years to meet cryptographic best practices.
21+
22+
This feature enables end-to-end zero-touch rotation for encryption at rest for Azure services with customer-managed key (CMK) stored in Azure Key Vault. Please refer to specific Azure service documentation to see if the service covers end-to-end rotation.
23+
24+
For more information about data encryption in Azure, see:
25+
- [Azure Encryption at Rest](../../security/fundamentals/encryption-atrest.md#azure-encryption-at-rest-components)
26+
- [Azure services data encryption support table](../../security/fundamentals/encryption-models.md#supporting-services)
2227

2328
## Pricing
2429

@@ -50,6 +55,9 @@ Key rotation policy settings:
5055

5156
:::image type="content" source="../media/keys/key-rotation/key-rotation-1.png" alt-text="Rotation policy configuration":::
5257

58+
> [!IMPORTANT]
59+
> Key rotation generates a new key version of an existing key with new key material. Ensure that your data encryption solution uses versioned key uri to point to the same key material for encrypt/decrypt, wrap/unwrap operations to avoid disruption to your services. All Azure services are currently following that pattern for data encryption.
60+
5361
## Configure key rotation policy
5462

5563
Configure key rotation policy during key creation.
@@ -90,7 +98,8 @@ Save key rotation policy to a file. Key rotation policy example:
9098
}
9199
}
92100
```
93-
Set rotation policy on a key passing previously saved file.
101+
102+
Set rotation policy on a key passing previously saved file using Azure CLI [az keyvault key rotation-policy update](/cli/azure/keyvault/key/rotation-policy) command.
94103

95104
```azurecli
96105
az keyvault key rotation-policy update --vault-name <vault-name> --name <key-name> --value </path/to/policy.json>
@@ -106,6 +115,9 @@ Click 'Rotate Now' to invoke rotation.
106115
:::image type="content" source="../media/keys/key-rotation/key-rotation-4.png" alt-text="Rotation on-demand":::
107116

108117
### Azure CLI
118+
119+
Use Azure CLI [az keyvault key rotate](/cli/azure/keyvault/key#az-keyvault-key-rotate) command to rotate key.
120+
109121
```azurecli
110122
az keyvault key rotate --vault-name <vault-name> --name <key-name>
111123
```

0 commit comments

Comments
 (0)