관리CMEK 설정

Admin API로 암호화 키 추가 및 연결하기

Copy page



세 번의 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입니다. 다음 두 단계에서 사용할 수 있도록 복사하세요.

   {
     "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가 표시됩니다. 요청이 거부되면 오류를 확인하세요.