Skip to content

Commit 7a753d6

Browse files
committed
cmk transition
1 parent 9641ffa commit 7a753d6

File tree

2 files changed

+40
-1
lines changed

2 files changed

+40
-1
lines changed

articles/azure-netapp-files/configure-customer-managed-keys.md

Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,6 @@ The following diagram demonstrates how customer-managed keys work with Azure Net
2828

2929
## Considerations
3030

31-
* Customer-managed keys can only be configured on new volumes. You can't migrate existing volumes to customer-managed key encryption.
3231
* To create a volume using customer-managed keys, you must select the *Standard* network features. You can't use customer-managed key volumes with volume configured using Basic network features. Follow instructions in to [Set the Network Features option](configure-network-features.md#set-the-network-features-option) in the volume creation page.
3332
* For increased security, you can select the **Disable public access** option within the network settings of your key vault. When selecting this option, you must also select **Allow trusted Microsoft services to bypass this firewall** to permit the Azure NetApp Files service to access your encryption key.
3433
* Customer-managed keys support automatic Managed System Identity (MSI) certificate renewal. If your certificate is valid, you don't need to manually update it.
@@ -355,6 +354,42 @@ You can use an Azure Key Vault that is configured to use Azure role-based access
355354
* [Create an SMB volume](azure-netapp-files-create-volumes-smb.md)
356355
* [Create a dual-protocol volume](create-volumes-dual-protocol.md)
357356
357+
## <a name="transition"></a> Transition an Azure NetApp Files volume to customer-managed keys (preview)
358+
359+
Azure NetApp Files supports the ability to move existing volumes using platform-managed keys to customer-managed keys. Once you complete the transition, you cannot revert back to platform-managed keys.
360+
361+
### Register the feature
362+
363+
Encryption key transition for Azure NetApp Files is currently in preview. Before using this feature for the first time, you need to register it.
364+
365+
1. Register the feature:
366+
367+
```azurepowershell-interactive
368+
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigratePmkToCmk
369+
```
370+
371+
2. Check the status of the feature registration:
372+
373+
```azurepowershell-interactive
374+
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFMigratePmkToCmk
375+
```
376+
> [!NOTE]
377+
> The **RegistrationState** may be in the `Registering` state for up to 60 minutes before changing to `Registered`. Wait until the status is **Registered** before continuing.
378+
379+
You can also use [Azure CLI commands](/cli/azure/feature) `az feature register` and `az feature show` to register the feature and display the registration status.
380+
381+
### Transition volumes
382+
383+
>[!NOTE]
384+
>When you transition volumes to use customer-managed keys, you must perform the transition for every virtual network where your Azure NetApp Files account has volumes.
385+
386+
1. Ensure you [configured your Azure NetApp Files account to use customer-managed keys](#configure-a-netapp-account-to-use-customer-managed-keys).
387+
1. In the Azure portal, navigate to **Encryption**.
388+
1. Select the **CMK Migration** tab.
389+
1. From the drop-down menu, select the virtual network and key vault private endpoint you want to use.
390+
1. Azure generates a list of volumes to be encrypted by your customer-managed key.
391+
1. Select **Confirm** to initiate the migration.
392+
358393
## Rekey all volumes under a NetApp account
359394
360395
If you have already configured your NetApp account for customer-managed keys and have one or more volumes encrypted with customer-managed keys, you can change the key that is used to encrypt all volumes under the NetApp account. You can select any key that is in the same key vault. Changing key vaults isn't supported.

articles/azure-netapp-files/whats-new.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@ ms.author: anfdocs
1414

1515
Azure NetApp Files is updated regularly. This article provides a summary about the latest new features and enhancements.
1616

17+
* [Transition existing volumes to customer-managed keys](configure-customer-managed-keys.md#transition) (Preview)
18+
19+
<!-- PM text -->
20+
1721
## May 2024
1822

1923
* [Large volumes](large-volumes-requirements-considerations.md) are now generally available (GA) with support for [cross-zone replication](cross-zone-replication-requirements-considerations.md) and [cross-region replication](cross-region-replication-requirements-considerations.md).

0 commit comments

Comments
 (0)