AdministrationConfigurer CMEK

Ajouter et associer une clé de chiffrement avec l'Admin API

Copy page



Créez, validez et associez une clé de chiffrement gérée par le client avec trois appels à l'Admin API.

Ces appels fonctionnent sur Claude Platform. Sur Claude Enterprise ou Claude Platform on AWS, suivez votre page de configuration.

Créer une clé externe correspond à ce que fait Add key dans la Claude Console, et la valider correspond à ce que fait Verify.

Avant de commencer

• Les « customer-managed encryption keys » (clés de chiffrement gérées par le client), ou CMEK, sont activées pour votre organisation.
• Vous disposez d'une clé API Admin. Les exemples la lisent depuis ANTHROPIC_API_KEY.
• Vous avez créé votre clé dans AWS KMS, Google Cloud KMS ou Azure Key Vault, et vous avez gardé les valeurs que les étapes de configuration vous demandent de copier.
• Vous disposez d'un espace de travail qui conserve les données, idéalement un nouveau, car les données existantes restent sous la clé d'Anthropic.

Créer, valider et associer la clé

1. 1

   Créer la clé externe

   AWSGoogle CloudAzure

   AWS

   Remplacez <friendly-name> par un nom d'affichage et <key-arn-from-create-key-step> par l'ARN de la clé.

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

   L'id dans la réponse est l'ID de la clé externe. Copiez-le pour les deux étapes suivantes.

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

   
2. 2

   Valider la clé

   Remplacez ekey_<id> par l'ID de la clé externe.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

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

   Une réponse réussie ressemble à ceci :

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

   

   Si status vaut failure, le champ error en indique la raison. Consultez Résoudre les problèmes liés à CMEK.

3. 3

   Associer la clé à un espace de travail

   Remplacez <workspace-id> par l'ID de l'espace de travail, qui commence par wrkspc_, et ekey_<id> par l'ID de la clé externe.

   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 réponse indique l'ID de la clé associée dans external_key_id. Si la requête est refusée, recherchez l'erreur.