CMEK用のAzure Key Vaultの設定

これにより、AnthropicのCMEKクライアントアプリケーション用のサービスプリンシパルがEntraテナントに作成されます。このアプリケーションは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 > エンタープライズアプリケーションで、デフォルトのアプリケーションタイプフィルターをクリアしてanthropic-cmek-client-usを検索すると、サービスプリンシパルのオブジェクトIDを確認できます。

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を開き、キーを選択し、生成/インポートを選択します。キーの種類をRSAに、サイズを3072以上に設定します。キーをラップとアンラップのみに制限するには、キーバージョンを開き、許可される操作までスクロールし、Wrap KeyとUnwrap Key以外のすべてのチェックを外します。

最初の手順で作成したサービスプリンシパルに、ボールト全体ではなく個々のキーをスコープとして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から、（ボールトではなく）キーを開き、その**アクセス制御（IAM）**タブを選択し、追加 > ロールの割り当ての追加をクリックし、Key Vault Crypto Userを選択して、anthropic-cmek-client-usサービスプリンシパルに割り当てます。

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のエグレス範囲が含まれていること（最新のリストについてはAnthropicにお問い合わせください）。
• uriが、キーを登録する際に使用するボールトURIであること。
• tenantIdが、ボールトを管理するテナントであること。キーを登録する際は、現在アクティブなサブスクリプションのテナントではなく、この値をtenant_idとして使用してください（クロステナント構成では両者が異なる場合があります）。