Skip to content

Commit f0a9530

Browse files
committed
add key rotation and other updates
1 parent a5b9a30 commit f0a9530

8 files changed

+20
-15
lines changed

articles/hpc-cache/customer-keys.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: How to use Azure Key Vault with Azure HPC Cache to control encrypti
44
author: ekpgh
55
ms.service: hpc-cache
66
ms.topic: conceptual
7-
ms.date: 03/19/2020
7+
ms.date: 04/06/2020
88
ms.author: rohogue
99
---
1010

@@ -29,7 +29,7 @@ There are three steps to enable customer-managed key encryption for Azure HPC Ca
2929

3030
Encryption is not completely set up until after you authorize it from the newly created cache (step 3). This is because you must pass the cache's identity to the key vault to make it an authorized user. You can't do this before creating the cache, because the identity does not exist until the cache is created.
3131

32-
After you create the cache, you cannot change between customer-managed keys and Microsoft-managed keys. However, if your cache uses customer-managed keys you can change the encryption key, the key version, and the key vault as needed.
32+
After you create the cache, you cannot change between customer-managed keys and Microsoft-managed keys. However, if your cache uses customer-managed keys you can [change](#update-key-settings) the encryption key, the key version, and the key vault as needed.
3333

3434
## Understand key vault and key requirements
3535

@@ -41,7 +41,7 @@ Key vault properties:
4141
* **Region** - The key vault must be in the same region as the Azure HPC Cache.
4242
* **Pricing tier** - Standard tier is sufficient for use with Azure HPC Cache.
4343
* **Soft delete** - Azure HPC Cache will enable soft delete if it is not already configured on the key vault.
44-
* **Purge protection** - Azure HPC Cache will enable purge protection if it is not already active.
44+
* **Purge protection** - Purge protection must be enabled.
4545
* **Access policy** - Default settings are sufficient.
4646
* **Network connectivity** - Azure HPC Cache must be able to access the key vault regardless of the endpoint settings you choose.
4747

@@ -107,15 +107,29 @@ The cache shows the status **Waiting for key**. Click the **Enable encryption**
107107

108108
![screenshot of cache overview page in portal, with a banner message at the top that asks the user to enable encryption by clicking yes](media/draft-enable-keyvault.png)
109109

110-
Click the **Yes** button to authorize the cache to use the encryption key. This action also enables soft-delete and purge protection on the key vault.
110+
Click the **Yes** button to authorize the cache to use the encryption key. This action also enables soft-delete and purge protection (if not already enabled) on the key vault.<!-- xxx problem? xxx -->
111111

112112
![screenshot of cache overview page in portal, with a banner message at the top that asks the user to enable encryption by clicking yes](media/draft-enable-keyvault-banner.png)
113113

114114
After the cache requests access to the key vault, it can create and encrypt the disks that store cached data.
115115

116116
After you authorize encryption, Azure HPC Cache goes through several more minutes of setup to create the encrypted disks and related infrastructure.
117117

118-
<!-- add info about rotating keys when it's available -->
118+
## Update key settings
119+
120+
You can change the key vault, key, or key version for your cache from the Azure portal. Click the cache's **Encryption** settings link to open the **Customer key settings** page. (You cannot change a cache between customer-managed keys and system-managed keys.)
121+
122+
![screenshot of "Customer keys setting" page, reached by clicking Settings > Encryption from the cache overview page in the Azure portal](media/draft-customer-key-settings.png)
123+
124+
Click the **Change key** link to open the key selector.
125+
126+
![screenshot of "select key from Azure Key Vault" page with three drop-down selectors to choose key vault, key, and version](media/draft-select-new-key.png)
127+
128+
Key vaults in the same subscription and same region as this cache are shown in the list.
129+
130+
After you choose the new encryption key values, click **Save**<!--not in screenshot - verify -->. A confirmation page appears with the new values. Click **Save** at the top of the confirmation page to finalize the selection.
131+
132+
![screenshot of confirmation page with Save button at top left](media/draft-save-new-key.png)
119133

120134
## Read more about customer-managed keys in Azure
121135

articles/hpc-cache/hpc-cache-create.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Use the Azure portal to create your cache.
1818

1919
![screenshot of project details page in Azure portal](media/hpc-cache-create-basics.png)
2020

21-
In **Project Details**, select the subscription and resource group that will host the cache. Make sure the subscription is on the [access](hpc-cache-prereqs.md#azure-subscription) list.
21+
In **Project Details**, select the subscription and resource group that will host the cache.
2222

2323
In **Service Details**, set the cache name and these other attributes:
2424

articles/hpc-cache/hpc-cache-overview.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -62,12 +62,6 @@ The [customer-managed keys feature](customer-keys.md) is supported only in these
6262

6363
Check the [Azure HPC Cache product page](https://azure.microsoft.com/services/hpc-cache) for the latest availability information.
6464

65-
## Service availability
66-
67-
You must request access for each subscription you will use with Azure HPC Cache. This restriction helps ensure service quality in the initial months of general availability.
68-
69-
Request access by filling out [this form](https://aka.ms/onboard-hpc-cache). After your subscription is added to the access list, you can create caches.
70-
7165
## Next steps
7266

7367
* Read the [Azure HPC Cache product page](https://azure.microsoft.com/services/hpc-cache) to learn more about its capabilities

articles/hpc-cache/hpc-cache-prereqs.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,6 @@ Before using the Azure portal to create a new Azure HPC Cache, make sure your en
1616

1717
A paid subscription is recommended.
1818

19-
> [!NOTE]
20-
> During the first several months of the GA release, the Azure HPC Cache team must add your subscription to the access list before it can be used to create a cache instance. This procedure helps ensure that each customer gets high-quality responsiveness from their caches. Fill out [this form](https://aka.ms/onboard-hpc-cache) to request access.
21-
2219
## Network infrastructure
2320

2421
Two network-related prerequisites should be set up before you can use your cache:
1.2 KB
Loading
192 KB
Loading
181 KB
Loading
82.7 KB
Loading

0 commit comments

Comments
 (0)