Skip to content

Commit e8cea13

Browse files
committed
cleanup for cmk cross tenant release
1 parent 17efee4 commit e8cea13

File tree

3 files changed

+25
-123
lines changed

3 files changed

+25
-123
lines changed

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

Lines changed: 4 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.custom: references_regions, devx-track-azurecli, devx-track-azurepowershell
9-
ms.date: 04/18/2025
8+
ms.custom: devx-track-azurecli, devx-track-azurepowershell
9+
ms.date: 04/23/2025
1010
ms.author: anfdocs
1111
---
1212

@@ -26,6 +26,8 @@ The following diagram demonstrates how customer-managed keys work with Azure Net
2626
Customer-managed keys don't affect performance of Azure NetApp Files. Its only difference from platform-managed keys is how the key is managed.
2727
1. For read/write operations, Azure NetApp Files sends requests to Azure Key Vault to unwrap the account encryption key to perform encryption and decryption operations.
2828

29+
Cross-tenant customer-managed keys is available in all Azure NetApp Files supported regions.
30+
2931
## Considerations
3032

3133
* 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.
@@ -38,57 +40,6 @@ The following diagram demonstrates how customer-managed keys work with Azure Net
3840
* Azure NetApp Files supports customer-managed keys on source and data replication volumes with cross-region replication or cross-zone replication relationships.
3941
* Applying Azure network security groups (NSG) on the private link subnet to Azure Key Vault is supported for Azure NetApp Files customer-managed keys. NSGs don’t affect connectivity to private links unless a private endpoint network policy is enabled on the subnet.
4042

41-
## Supported regions
42-
43-
Azure NetApp Files customer-managed keys is supported for the following regions:
44-
45-
* Australia Central
46-
* Australia Central 2
47-
* Australia East
48-
* Australia Southeast
49-
* Brazil South
50-
* Brazil Southeast
51-
* Canada Central
52-
* Canada East
53-
* Central India
54-
* Central US
55-
* East Asia
56-
* East US
57-
* East US 2
58-
* France Central
59-
* Germany North
60-
* Germany West Central
61-
* Israel Central
62-
* Italy North
63-
* Japan East
64-
* Japan West
65-
* Korea Central
66-
* Korea South
67-
* North Central US
68-
* North Europe
69-
* Norway East
70-
* Norway West
71-
* Qatar Central
72-
* South Africa North
73-
* South Central US
74-
* South India
75-
* Southeast Asia
76-
* Spain Central
77-
* Sweden Central
78-
* Switzerland North
79-
* Switzerland West
80-
* UAE Central
81-
* UAE North
82-
* UK South
83-
* UK West
84-
* US Gov Arizona
85-
* US Gov Texas
86-
* US Gov Virginia
87-
* West Europe
88-
* West US
89-
* West US 2
90-
* West US 3
91-
9243
## Requirements
9344

9445
Before creating your first customer-managed key volume, you must set up:

articles/azure-netapp-files/customer-managed-keys-cross-tenant.md

Lines changed: 17 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,16 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
## ms.custom: references_regions
9-
ms.date: 12/19/2024
8+
ms.custom: devx-track-azurecli, devx-track-azurepowershell
9+
ms.date: 04/23/2025
1010
ms.author: anfdocs
1111
---
1212

1313
# Configure cross-tenant customer-managed keys for Azure NetApp Files volume encryption (preview)
1414

1515
Cross-tenant customer-managed keys (CMK) for Azure NetApp Files volume encryption allows service providers based on Azure to offer [customer-managed key encryption](configure-customer-managed-keys.md). In the cross-tenant scenario, the NetApp account resides in a tenant managed by an independent software vendor, while the key used for encryption of volumes in that NetApp account resides in a key vault in a tenant that you manage.
1616

17-
Cross-tenant CMK is supported in all regions where Azure NetApp Files is supported.
17+
Cross-tenant customer-managed keys is available in all Azure NetApp Files supported regions.
1818

1919
## Understand cross-tenant customer-managed keys
2020

@@ -32,60 +32,8 @@ Following these steps, you install the service provider's application in your te
3232

3333
With these three parameters, the service provider provisions Azure resources in tenant 1 that can be encrypted with the customer-managed key in tenant 2.
3434

35-
36-
<!--
37-
## Supported regions
38-
39-
Azure NetApp Files cross-tenant customer-managed keys for volume encryption is supported for the following regions:
40-
41-
- Australia Central
42-
- Australia Central 2
43-
- Australia East
44-
- Australia Southeast
45-
- Brazil South
46-
- Brazil Southeast
47-
- Canada Central
48-
- Canada East
49-
- Central India
50-
- Central US
51-
- East Asia
52-
- East US
53-
- East US 2
54-
- France Central
55-
- Germany North
56-
- Germany West Central
57-
- Israel Central
58-
- Italy North
59-
- Japan East
60-
- Japan West
61-
- Korea Central
62-
- Korea South
63-
- North Central US
64-
- North Europe
65-
- Norway East
66-
- Norway West
67-
- Qatar Central
68-
- South Africa North
69-
- South Central US
70-
- South India
71-
- Southeast Asia
72-
- Spain Central
73-
- Sweden Central
74-
- Switzerland North
75-
- Switzerland West
76-
- UAE Central
77-
- UAE North
78-
- UK South
79-
- UK West
80-
- West Europe
81-
- West US
82-
- West US 2
83-
- West US 3
84-
-->
85-
8635
## Register the feature
8736

88-
8937
This feature is currently in preview. You need to register the feature before using it for the first time. After registration, the feature is enabled and works in the background. No UI control is required.
9038

9139
1. Register the feature:
@@ -106,9 +54,9 @@ You can also use [Azure CLI commands](/cli/azure/feature) `az feature register`
10654
10755
## Configure cross-tenant customer-managed keys for Azure NetApp Files
10856
109-
Cross-tenant CMK is currently only supported for the REST API.
57+
The configuration process for cross-tenant customer-managed keys has portions that can only be completed using the REST API and Azure CLI.
11058
111-
## Configure a NetApp account to use a key from a vault in another tenant.
59+
## Configure a NetApp account to use a key from a vault in another tenant
11260
11361
1. Create the application registration.
11462
1. Navigate to Microsoft Entra ID in the Azure portal
@@ -133,7 +81,7 @@ Cross-tenant CMK is currently only supported for the REST API.
13381
1. Choose **Select a managed identity**. From the pane, select the subscription. Under **Managed identity**, select **User-assigned managed identity**. In the Select box, search for the managed identity you created earlier, then choose **Select** at the bottom of the pane.
13482
1. Under Credential details, provide a name and optional description for the credential. Select **Add**.
13583
1. Create a private endpoint to your key vault:
136-
1. Have the customer share the full Azure ResourceId of their Key Vault. <!-- huh? -->
84+
1. Share the full Azure ResourceId of their Key Vault. <!-- huh? -->
13785
1. Navigate to **Private Endpoints**.
13886
1. Select **+ Create**.
13987
1. Choose your subscription and resource group, and enter a name for the Private Endpoint, then select **Next > Resource**.
@@ -147,9 +95,9 @@ Cross-tenant CMK is currently only supported for the REST API.
14795
### Authorize access to the key vault
14896
14997
1. Install the service provider application in the customer tenant
150-
1. Get the Admin Consent URL from the provider for their cross-tenant application. In our example the URL would look like: `https://login.microsoftonline.com/<tenant1 tenantId>/adminconsent/client_id=<client/application ID for the cross tenant-application>`. This opens a login page where you enter your credentials. Once you enter your credentials, you may see an error stating there's no redirect URL configured. This is OK.
98+
1. Get the Admin Consent URL from the provider for their cross-tenant application. In our example the URL would look like: `https://login.microsoftonline.com/<tenant1-tenantId>/adminconsent/client_id=<client/application ID for the cross tenant-application>`. This opens a login page where you enter your credentials. Once you enter your credentials, you may see an error stating there's no redirect URL configured; this is OK.
15199
1. Grant the service provider application access to the key vault.
152-
1. Navigate to your key vault. Select Access Control (IAM) from the left pane.
100+
1. Navigate to your key vault. Select **Access Control (IAM)** from the left pane.
153101
1. Under Grant access to this resource, select **Add role assignment**.
154102
1. Search for then select **Key Vault Crypto User**.
155103
1. Under Members, select **User, group, or service principal**.
@@ -162,10 +110,13 @@ Cross-tenant CMK is currently only supported for the REST API.
162110
163111
### Configure the NetApp account to use your keys
164112
165-
1. You must use the `az rest` command to configure your NetApp account to use CMK in a different tenant. Issue the following command:
113+
>[!NOTE]
114+
>Using the `az rest` command is the only supported way to to configure your NetApp account to use CMK in a different tenant.
115+
116+
1. With the `az rest` command, configure the NetApp account to use CMK in a different tenant:
166117
167118
```azurecli
168-
az rest --method put --uri "/subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.NetApp/netAppAccounts/<NetApp Account name>?api-version=2024-01-01-preview" --body
119+
az rest --method put --uri "/subscriptions/<subscription Id>/resourceGroups/<resourceGroupName>/providers/Microsoft.NetApp/netAppAccounts/<NetAppAccountName>?api-version=2024-01-01-preview" --body
169120
'{  \"properties\":
170121
{    \"encryption\":
171122
{      \"keySource\": \"Microsoft.KeyVault\", \"keyVaultProperties\":
@@ -186,10 +137,12 @@ Cross-tenant CMK is currently only supported for the REST API.
186137
```
187138
Once you have sent the `az rest` command, your NetApp Account has been successfully configured with cross-tenant CMK.
188139
189-
190140
### Create a volume
191141
192-
1. To create a volume using cross-tenant CMK, you must use the Azure CLI. Issue the following command:
142+
>[!NOTE]
143+
>To create a volume using cross-tenant CMK, you must use the Azure CLI.
144+
145+
1. Create the volume using the CLI:
193146
194147
```azurecli
195148
az netappfiles volume create -g <resource group name> --account-name <NetApp account name> --pool-name <pool name> --name <volume name> -l southcentralus --service-level premium --usage-threshold 100 --file-path "<file path>" --vnet <virtual network name> --subnet default --network-features Standard --encryption-key-source Microsoft.KeyVault --kv-private-endpoint-id <full resource ID to the private endpoint to the customer's vault> --debug

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

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,20 @@ author: b-hchen
66
ms.service: azure-netapp-files
77
ms.custom: linux-related-content
88
ms.topic: overview
9-
ms.date: 04/16/2025
9+
ms.date: 04/23/2025
1010
ms.author: anfdocs
1111
---
1212

1313
# What's new in Azure NetApp Files
1414

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

17-
* [Cross-tenant customer-managed keys for Azure NetApp Files volume encryption](customer-managed-keys-cross-tenant.md) (preview)
18-
17+
## April 2025
1918

20-
Cross-tenant customer-managed keys enables you to manage you own keys across different tenancies. In scenarios such as ISP/user configurations, it ensures that the end user retains full control of their keys, rather than the ISP. This capability grants SaaS providers with flexibility to offer customizable key management options.
19+
* [Cross-tenant customer-managed keys for Azure NetApp Files volume encryption](customer-managed-keys-cross-tenant.md) (preview)
2120

22-
<!-- It is available in all CMK regions. This feature is currently in preview. -->
2321

24-
## April 2025
22+
Cross-tenant customer-managed keys for Azure NetApp Files volume encryption enables you to manage your own keys across different tenancies. In scenarios such as SaaS provider/user configurations, this feature ensures the end user retains full control of their keys rather than the SaaS provider. This capability provides SaaS providers with the flexibility to offer customers customizable key management options. This feature is available in all Azure NetApp Files supported regions. This feature is currently in preview.
2523

2624
* [New volume usage metrics:](azure-netapp-files-metrics.md#volumes) Volume Inodes Quota, Volume Inodes Total, Volume Inodes Used
2725

0 commit comments

Comments
 (0)