AdministraciónConfigurar CMEK

Agregar y adjuntar una clave de cifrado con la Admin API

Copy page



Crea, valida y adjunta una clave de cifrado administrada por el cliente con tres llamadas a la Admin API.

Estas llamadas funcionan en Claude Platform. En Claude Enterprise o Claude Platform on AWS, sigue tu página de configuración.

Crear una clave externa es lo que hace Add key en Claude Console, y validarla es lo que hace Verify.

Antes de comenzar

• Las "customer-managed encryption keys" (claves de cifrado administradas por el cliente), o CMEK, están activadas para tu organización.
• Tienes una clave de Admin API. Los ejemplos la leen desde ANTHROPIC_API_KEY.
• Creaste tu clave en AWS KMS, Google Cloud KMS o Azure Key Vault, y guardaste los valores que los pasos de configuración te indican copiar.
• Tienes un espacio de trabajo que retiene datos, idealmente uno nuevo, porque los datos existentes permanecen bajo la clave de Anthropic.

Crear, validar y adjuntar la clave

1. 1

   Crear la clave externa

   AWSGoogle CloudAzure

   AWS

   Reemplaza <friendly-name> con un nombre para mostrar y <key-arn-from-create-key-step> con el ARN de la clave.

   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}")

   El id en la respuesta es el ID de la clave externa. Cópialo para los dos pasos siguientes.

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

   
2. 2

   Valida la clave

   Reemplaza ekey_<id> con el ID de la clave externa.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

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

   Una respuesta correcta tiene este aspecto:

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

   

   Si status es failure, el campo error indica el motivo. Consulta Solucionar problemas de CMEK.

3. 3

   Adjunta la clave a un espacio de trabajo

   Reemplaza <workspace-id> por el ID del espacio de trabajo, que comienza con wrkspc_, y ekey_<id> por el ID de la clave externa.

   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}")

   La respuesta muestra el ID de la clave adjuntada en external_key_id. Si la solicitud se rechaza, busca el error.