Skip to content

Commit b0fdd5a

Browse files
committed
cmk changes & imgs
1 parent d469610 commit b0fdd5a

File tree

6 files changed

+17
-36
lines changed

6 files changed

+17
-36
lines changed

articles/data-explorer/customer-managed-keys-portal.md

Lines changed: 17 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.author: orspodek
66
ms.reviewer: itsagui
77
ms.service: data-explorer
88
ms.topic: conceptual
9-
ms.date: 03/25/2020
9+
ms.date: 03/26/2020
1010
---
1111

1212
# Configure customer-managed-keys using the Azure Portal
@@ -18,52 +18,33 @@ ms.date: 03/25/2020
1818
1919
[!INCLUDE [data-explorer-configure-customer-managed-keys](../../includes/data-explorer-configure-customer-managed-keys.md)]
2020

21-
## Enable customer-managed keys in the Azure Portal
21+
## Enable encryption with customer-managed keys in the Azure Portal
2222

23-
This section shows you how to enable customer-managed keys encryption using the Azure portal.
23+
This article shows you how to enable customer-managed keys encryption using the Azure portal. By default, Azure Data Explorer encryption uses Microsoft-managed keys. Configure your Azure Data Explorer cluster to use customer-managed keys and specify the key to associate with the cluster.
2424

25-
### Prerequisites
25+
1. In the [Azure portal](https://portal.azure.com/), go to your [Azure Data Explorer cluster](create-cluster-database-portal.md#create-a-cluster) resource.
26+
1. Select **Settings** > **Encryption** in left pane of portal.
27+
1. In the **Encryption** pane, select **On** for the **Customer-managed key** setting.
28+
1. Click **Select Key**
2629

27-
* An Azure subscription. Create a [free Azure account](https://azure.microsoft.com/free/).
28-
* [A cluster and database](create-cluster-database-portal.md).
29-
* [Configure managed identities for your Azure Data Explorer cluster](managed-identities.md)
30+
![Configure customer managed keys](media/customer-managed-key-portal/cmk-encryption-setting.png)
3031

31-
### Configure cluster
32+
1. In the **Select key from Azure Key Vault** window, select an existing **Key vault** from the dropdown list. If you select **Create new** to [create a new Key Vault](/azure/key-vault/quick-create-portal#create-a-vault), you'll be routed to the **Create Key Vault** screen.
3233

33-
By default, Azure Data Explorer encryption uses Microsoft-managed keys. Configure your Azure Data Explorer cluster to use customer-managed keys and specify the key to associate with the cluster.
34-
35-
Configure encryption with customer-managed keys
36-
37-
You can configure customer-managed keys for your Azure Data Explorer cluster.
38-
1. In the Azure portal, go to your Azure Data Explorer cluster resource. Under the Settings heading, select Encryption.
39-
2. In the Encryption window, select **On** for the Customer-managed key setting.
40-
3. Click Select Key
41-
42-
![Show databases command](media/customer-managed-key-portal/.png)
43-
44-
4. In the **Select key from Azure Key Vault** screen you can either create a new Key Vault or select an existing one.
45-
1. If you choose to create a new Key Vault you'll be routed to the **Create Key Vault** screen where you can create a new Key Vault resource following these instructions. (link to create a key vault)
46-
2. If you choose an existing Key Vault you need to either create a new key select an existing key.
47-
3. Once you have a key you need to select a version.
48-
5. Either select **Key** or **create new** ?from Azure Key Vault screen.
49-
1. Select **Version**.
34+
1. Select **Key**
35+
1. Select **Version**
5036
1. Click **Select**
51-
6. Select Save.
52-
53-
## screenshot
5437

55-
By enabling customer-managed key for your Azure Data Explorer cluster behind the scenes you'll be creating a system assigned identity for the cluster if it does not have one.
56-
In addition you'll be providing the required view permissions to Azure Data Explorer cluster on the selected Key Vault and get the Key Vault properties. (see c# doc)
57-
(3 steps done as part of process)
38+
![Select key from Azure Key Vault](media/customer-managed-key-portal/cmk-key-vault.png)
5839

59-
when CMK creation succeeds, get success message in notification.
40+
1. In the **Encrytion** pane that now contains your key, select **Save**. When CMK creation succeeds, you will see a success message in **Notifications**.
6041

61-
Note
62-
Select **Off** to remove the customer managed key after it has been created.
42+
![Save customer managed key](media/customer-managed-key-portal/cmk-encryption-setting.png)
6343

64-
## Update the key version
44+
By enabling customer-managed keys for your Azure Data Explorer cluster, you'll be creating a system assigned identity for the cluster if one doesn't exist. In addition, you'll be providing the required view permissions to your Azure Data Explorer cluster on the selected Key Vault and get the Key Vault properties.
6545

66-
When you create a new version of a key, you'll need to update the cluster to use the new version. First, call `Get-AzKeyVaultKey` to get the latest version of the key. Then update the cluster's key vault properties to use the new version of the key, as shown in [Configure cluster](#configure-cluster).
46+
> [!NOTE]
47+
> Select **Off** to remove the customer managed key after it has been created.
6748
6849
## Next steps
6950

18.8 KB
Loading
123 KB
Loading
-27.2 KB
Loading
Binary file not shown.

0 commit comments

Comments
 (0)