管理CMEK をセットアップする

Admin APIで暗号化キーを追加してアタッチする

Copy page



3回のAdmin API呼び出しで、カスタマー管理の暗号化キーを作成、検証、アタッチします。

これらの呼び出しはClaude Platformで機能します。Claude EnterpriseまたはClaude Platform on AWSでは、お客様のセットアップページの手順に従ってください。

外部キーの作成はClaude ConsoleのAdd keyが行う処理であり、その検証はVerifyが行う処理です。

始める前に

• 「customer-managed encryption keys」（カスタマー管理の暗号化キー）、すなわちCMEKがお客様の組織で有効になっていること。
• Admin APIキーを持っていること。サンプルではANTHROPIC_API_KEYから読み取ります。
• AWS KMS、Google Cloud KMS、またはAzure Key Vaultでお客様のキーを作成し、セットアップ手順でコピーするよう指示された値を控えていること。
• データを保持するワークスペースがあること。既存のデータはAnthropicのキーのもとに残るため、新しいワークスペースが理想的です。

キーを作成、検証、アタッチする

1. 1

   外部キーを作成する

   AWSGoogle CloudAzure

   AWS

   <friendly-name>を表示名に、<key-arn-from-create-key-step>をキーARNに置き換えてください。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   external_key = client.organization.external_keys.create(
       display_name="<friendly-name>",
       geo="us",
       provider_config={"type": "aws", "kms_arn": "<key-arn-from-create-key-step>"},
   )
   
   print(f"id: {external_key.id}")
   print(f"display_name: {external_key.display_name}")

   レスポンス内のidが外部キーIDです。次の2つのステップで使用するためにコピーしてください。

   {
     "type": "external_key",
     "id": "ekey_<id>",
     "display_name": "<friendly-name>"
   }

   
2. 2

   キーを検証する

   ekey_<id>を外部キーIDに置き換えてください。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   validation = client.organization.external_keys.validate("ekey_<id>")
   
   print(f"status: {validation.status}")
   print(f"error: {validation.error}")

   成功した場合のレスポンスは次のようになります。

   { "type": "external_key_validation", "status": "success", "error": null }

   

   statusがfailureの場合、errorフィールドにその理由が示されます。CMEKのトラブルシューティングを参照してください。

3. 3

   キーをワークスペースにアタッチする

   <workspace-id>をwrkspc_で始まるワークスペースIDに、ekey_<id>を外部キーIDに置き換えてください。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   client = anthropic.Anthropic()
   
   workspace = client.organization.workspaces.update(
       "<workspace-id>", external_key_id="ekey_<id>"
   )
   
   print(f"id: {workspace.id}")
   print(f"external_key_id: {workspace.external_key_id}")

   レスポンスのexternal_key_idには、アタッチされたキーのIDが表示されます。リクエストが拒否された場合は、エラーを確認してください。