Azure 受控執行個體 for Apache Cassandra 中的客戶管理金鑰

在 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,最新版本已經安裝了。

建立具有系統指派身份的叢集

  1. 請使用下列指令建立叢集。 將 <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
    
  2. 取得已建立叢集的身份資訊:

    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"
      }
    
  3. 在 Azure 入口網站中,前往您的金鑰保管庫並選擇存取原則。 接著選擇 「新增存取原則 」以建立您的金鑰存取原則。

    顯示 Azure 入口網站中存取原則窗格的螢幕截圖。

  4. 在金鑰權限中,選擇「取得」、「包裝」和「解除包裝」。 勾選「 選擇主體 」方塊以開啟 主體 窗格。 輸入您先前取得的叢集 principalId 值,然後選擇 選取 按鈕。 (在入口網站中,您也可以透過叢集名稱查詢叢集的主體識別碼。)

    螢幕截圖顯示為存取原則新增主體的範例。

    Warning

    請確認金鑰保險庫已啟用清除保護。 沒有它,資料中心部署將會失敗。

  5. 選擇 「新增 」以新增存取原則,然後選擇 「儲存」。

    螢幕擷取圖顯示儲存存取原則的按鈕。

  6. 要取得金鑰識別碼,請選擇 「金鑰」,然後選擇您的金鑰。

    螢幕截圖顯示選取鍵的窗格。

  7. 選擇目前版本。

    螢幕擷取圖顯示用於選取當前金鑰版本的方框。

  8. 將金鑰識別碼儲存以供日後使用。

    螢幕擷取畫面顯示將金鑰識別碼複製到剪貼簿。

  9. 建立資料中心時,請將 <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