在 Apache Cassandra 的 Azure 受控執行個體 中,你可以使用自己的金鑰加密磁碟上的資料。 本文說明如何使用 Azure Key Vault 實作客戶管理的金鑰。
Prerequisites
使用 Azure Key Vault 設定祕密。 如需更多資訊,請參閱〈關於 Azure Key Vault 祕密〉。
在您的資源群組中部署虛擬網路。
將網路貢獻者角色指派給 Azure Cosmos DB 服務主體。 請使用下列命令:
az role assignment create \ --assignee a232010e-820c-4083-83bb-3ace5fc29d0b \ --role 4d97b98b-1d4f-4787-a291-c67834d212e7 \ --scope /subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>為您的虛擬網路套用適當角色,有助於在部署 Apache Cassandra 叢集Azure 受控執行個體時避免失敗。 如需更多資訊,請參閱使用Azure CLI為 Apache Cassandra 叢集建立Azure 受控執行個體。
本文需要 Azure CLI 2.30.0 版或更新版本。 如果你用的是 Azure Cloud Shell,最新版本已經安裝了。
建立具有系統指派身份的叢集
請使用下列指令建立叢集。 將
<subscriptionID>、<resourceGroupName>、<vnetName>和<subnetName>取代為適當的值。subnet="/subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>/subnets/<subnetName>" cluster="thvankra-cmk-test-wcus" group="thvankra-nova-cmk-test" region="westcentralus" password="PlaceholderPassword" az managed-cassandra cluster create \ --identity-type SystemAssigned \ --resource-group $group \ --location $region \ --cluster-name $cluster \ --delegated-management-subnet-id $subnet \ --initial-cassandra-admin-password $password取得已建立叢集的身份資訊:
az managed-cassandra cluster show -c $cluster -g $group輸出包含一個身分識別區段,如下列範例所示。 複製該
principalId值以供日後使用。"identity": { "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222", "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "type": "SystemAssigned" }在 Azure 入口網站中,前往您的金鑰保管庫並選擇存取原則。 接著選擇 「新增存取原則 」以建立您的金鑰存取原則。
在金鑰權限中,選擇「取得」、「包裝」和「解除包裝」。 勾選「 選擇主體 」方塊以開啟 主體 窗格。 輸入您先前取得的叢集
principalId值,然後選擇 選取 按鈕。 (在入口網站中,您也可以透過叢集名稱查詢叢集的主體識別碼。)Warning
請確認金鑰保險庫已啟用清除保護。 沒有它,資料中心部署將會失敗。
選擇 「新增 」以新增存取原則,然後選擇 「儲存」。
要取得金鑰識別碼,請選擇 「金鑰」,然後選擇您的金鑰。
選擇目前版本。
將金鑰識別碼儲存以供日後使用。
建立資料中心時,請將
<key identifier>替換為相同的金鑰(即您在前一步複製的 URI),用於受管理磁碟(managed-disk-customer-key-uri)與備份儲存(backup-storage-customer-key-uri)加密。 請使用先前使用的相同值subnet。managedDiskKeyUri = "<key identifier>" backupStorageKeyUri = "<key identifier>" group="thvankra-nova-cmk-test" region="westcentralus" cluster="thvankra-cmk-test-2" dc="dc1" nodecount=3 subnet="/subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>/subnets/<subnetName>" az managed-cassandra datacenter create \ --resource-group $group \ --cluster-name $cluster \ --data-center-name $dc \ --managed-disk-customer-key-uri $managedDiskKeyUri \ --backup-storage-customer-key-uri $backupStorageKeyUri \ --node-count $nodecount \ --delegated-subnet-id $subnet \ --data-center-location $region \ --sku Standard_DS14_v2
您也可以為沒有身分資訊的現有叢集指派身分:
az managed-cassandra cluster update --identity-type SystemAssigned -g $group -c $cluster
旋轉鑰匙
若要更新金鑰,請使用此指令:
managedDiskKeyUri = "<key identifier>"
backupStorageKeyUri = "<key identifier>"
az managed-cassandra datacenter update \
--resource-group $group \
--cluster-name $cluster \
--data-center-name $dc \
--managed-disk-customer-key-uri $managedDiskKeyUri \
--backup-storage-customer-key-uri $backupStorageKeyUri