You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## Enable customer-managed keys in the Azure Portal
21
+
## Enable encryption with customer-managed keys in the Azure Portal
22
22
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.
24
24
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**
26
29
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)
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.
32
33
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.
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**
50
36
1. Click **Select**
51
-
6. Select Save.
52
-
53
-
## screenshot
54
37
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
+

58
39
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**.
60
41
61
-
Note
62
-
Select **Off** to remove the customer managed key after it has been created.
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.
65
45
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.
0 commit comments