Configure HSM customer-managed keys for DBFS using the Azure portal

You can use the Azure portal to configure your own encryption key to encrypt the workspace storage account. This article describes how to configure your own key from Azure Key Vault Managed HSM. For instructions on using a key from Azure Key Vault vaults, see Configure customer-managed keys for DBFS using the Azure portal.

For more information about customer-managed keys for DBFS, see Customer-managed keys for DBFS root.

Create an Azure Key Vault Managed HSM and an HSM key

You can use an existing Azure Key Vault Managed HSM or create and activate a new one following Quickstart: Provision and activate a Managed HSM using Azure CLI. The Azure Key Vault Managed HSM must have Purge Protection enabled.

To create an HSM key, follow Create an HSM key.

Prepare the workspace storage account

1. Go to your Azure Databricks service resource in the Azure portal.

2. In the left menu, under Automation, select Export template.

3. Click Deploy.

4. Click Edit template, search for prepareEncryption, and modify the vault to true type. For example:

     "prepareEncryption": {
              "type": "Bool",
              "value": "true"
           }
   

5. Click Save.

6. Click Review + Create to deploy the change.

7. On the right, under Essentials, click JSON View.

8. Search for storageAccountIdentity, and copy the principalId.

Configure the Managed HSM role assignment

1. Go to your Managed HSM resource in the Azure portal.
2. In the left menu, under Settings, select Local RBAC.
3. Click Add.
4. In the Role field, select Managed HSM Crypto Service Encryption User.
5. In the Scope field, select All keys (/).
6. In the Security principal field, enter the principalId of the workspace storage account in the search bar. Select the result.
7. Click Create.
8. In the left menu, under Settings, select Keys and select your key.
9. In the Key Identifier field, copy the text.

Encrypt the workspace storage account using your HSM key

1. Go to your Azure Databricks service resource in the Azure portal.
2. In the left menu, under Settings, select Encryption.
3. Select Use your own key, enter your Managed HSM key's Key Identifier, and select the Subscription that contains the key.
4. Click Save to save your key configuration.

Regenerate (rotate) keys

When you regenerate a key, you must return to the Encryption page in your Azure Databricks service resource, update the Key Identifier field with your new key identifier, and click Save. This applies to new versions of the same key as well as new keys.