為 CMEK 設定 Azure Key Vault

claude "/claude-api help me configure a customer-managed encryption key with Azure Key Vault"

本指南將逐步說明如何將 Azure Key Vault 金鑰設定為您 Anthropic 組織的 customer-managed encryption key（客戶管理的加密金鑰），即 CMEK。

先決條件

• 一個已啟用 RBAC 授權（enableRbacAuthorization: true）且允許公用網路存取的 Azure Key Vault。Anthropic 會透過公用資料平面端點呼叫您的保存庫；不支援私人端點。
• 保存庫上已啟用清除保護（enablePurgeProtection: true）。若未啟用，已刪除的金鑰可能會在虛刪除保留期間內被永久清除，導致受 CMEK 保護的資料無法挽回地遺失。清除保護一旦啟用便無法停用。
• 在保存庫中建立金鑰以及在其上指派 RBAC 角色的權限。
• 在您的 Entra 租用戶中建立服務主體的權限（Application Administrator、Cloud Application Administrator 或同等的自訂角色）。
• 您組織的 Anthropic Admin API 金鑰。
• 已安裝並完成驗證的 az CLI。
• 保存庫上已設定診斷設定（Diagnostic Settings），將 AuditEvent 記錄類別路由至 Log Analytics、儲存體帳戶或事件中樞。Azure Key Vault 預設不會發出資料平面稽核記錄（例如 KeyWrap、KeyUnwrap 和 KeyGet），因此若未設定，您將無法取得 Anthropic 金鑰操作的稽核軌跡。

Anthropic 應用程式資訊

若要讓 Anthropic 使用您的加密金鑰，您必須設定 Anthropic 多租用戶應用程式 ID 與顯示名稱。這些值如下：

加密金鑰設定

1. 1

   同意 Anthropic 多租用戶應用程式

   此步驟會在您的 Entra 租用戶中為 Anthropic 的 CMEK 用戶端應用程式建立一個服務主體。該應用程式不會要求任何 Microsoft Graph 權限；它僅作為 Key Vault 資料平面存取的同盟目標而存在。

   az ad sp create --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87

   

   從輸出中擷取 id 欄位。這是該服務主體在您租用戶中的物件 ID，您在指派 RBAC 角色時會用到它。

   {
     "appId": "8635ae1a-3e5d-44e8-a4ed-e0f614466f87",
     "displayName": "anthropic-cmek-client-us",
     "id": "<sp-object-id>"
   }

   

   如果該服務主體已存在於您的租用戶中（來自先前的嘗試或其他整合），az ad sp create 會以「already exists」錯誤結束。請改為擷取其物件 ID：

   az ad sp show --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87 --query id -o tsv

   

   此步驟沒有對應的 Portal 操作。如果您本機未安裝 Azure CLI，請從 Portal 頂端導覽列開啟 Cloud Shell。指令成功後，您可以在 Microsoft Entra ID > Enterprise applications 中清除預設的應用程式類型篩選條件並搜尋 anthropic-cmek-client-us，以找到該服務主體的物件 ID。

   

2. 2

   在您的保存庫中建立 RSA 金鑰

   Azure Key Vault 不支援對稱金鑰包裝，因此金鑰必須為 RSA（3072 位元或更大），且其允許的操作中須包含 wrapKey 與 unwrapKey。

   az keyvault key create \
     --vault-name <your-vault-name> \
     --name <your-key-name> \
     --kty RSA --size 3072 \
     --ops wrapKey unwrapKey

   

   若要使用 HSM 支援的金鑰，請使用 --kty RSA-HSM（需要 Premium SKU 的保存庫）。此整合可接受軟體保護的 RSA 金鑰。

   在 Portal 中，開啟您的 Key Vault，選取 Keys，然後選取 Generate/Import。將金鑰類型設為 RSA，大小設為 3072 或更大。若要將金鑰限制為僅能包裝與解除包裝，請開啟該金鑰版本，捲動至 Permitted operations，並取消勾選除 Wrap Key 與 Unwrap Key 以外的所有項目。

   

   

3. 3

   授予 Anthropic 服務主體存取您金鑰的權限

   將 Key Vault Crypto User 角色指派給第一個步驟中的服務主體，範圍限定於個別金鑰而非整個保存庫。

   VAULT_ID=$(az keyvault show --name <your-vault-name> --query id -o tsv)
   
   az role assignment create \
     --role "Key Vault Crypto User" \
     --assignee-object-id <sp-object-id> \
     --assignee-principal-type ServicePrincipal \
     --scope "${VAULT_ID}/keys/<your-key-name>"

   

   內建的 Key Vault Crypto User 角色會在其指派範圍內授予金鑰密碼編譯操作（加密、解密、包裝、解除包裝、簽署、驗證）以及金鑰讀取權限。您在上一步驟中對金鑰設定的 --ops wrapKey unwrapKey 限制會進一步縮小這些操作中哪些能對此金鑰成功執行，因此實務上 Anthropic 只能進行包裝與解除包裝。

   在 Portal 中，開啟該金鑰（而非保存庫），選取其 Access control (IAM) 索引標籤，按一下 Add > Add role assignment，選取 Key Vault Crypto User，並將其指派給 anthropic-cmek-client-us 服務主體。

   

4. 4

   驗證您的保存庫設定

   az keyvault show --name <your-vault-name> \
     --query "{rbac:properties.enableRbacAuthorization, purge:properties.enablePurgeProtection, pub:properties.publicNetworkAccess, net:properties.networkAcls.defaultAction, ipRules:properties.networkAcls.ipRules, uri:properties.vaultUri, tenantId:properties.tenantId}"

   

   請確認：

   • rbac 為 true。
   • purge 為 true。若為 false 或 null，請在繼續之前於保存庫上啟用清除保護。若未啟用，虛刪除的金鑰可能會在保留期間內被永久清除，使您受 CMEK 保護的資料無法復原。
   • pub 為 "Enabled"。若為 "Disabled"，Anthropic 將無法透過公用資料平面端點連線至保存庫，驗證會失敗。
   • net 為 "Allow"；或者若為 "Deny"，則 ipRules 須包含 Anthropic 的輸出 IP 範圍（請聯絡 Anthropic 取得最新清單）。
   • uri 是您註冊金鑰時所使用的保存庫 URI。
   • tenantId 是管理該保存庫的租用戶。註冊金鑰時請使用此值作為 tenant_id，而非您目前作用中訂用帳戶的租用戶（在跨租用戶設定中兩者可能不同）。

向 Anthropic 註冊金鑰

註冊金鑰的方式取決於您使用的產品。

Terraform

對於基礎架構即程式碼（infrastructure-as-code）的部署，相同的步驟可對應至 azurerm 與 azuread 提供者。