Configurer AWS KMS pour CMEK

La stratégie de clé accorde au rôle IAM d'Anthropic un accès inter-comptes. Trois instructions sont requises :

1. Administrateur racine du compte : le modèle KMS standard. Votre compte conserve le contrôle administratif complet.
2. Chiffrement et déchiffrement Anthropic : les actions kms:Encrypt et kms:Decrypt, qu'Anthropic utilise pour chiffrer et déchiffrer les clés de données qui protègent les données de votre espace de travail (chiffrement d'enveloppe).
3. Description Anthropic : la lecture de métadonnées qu'Anthropic effectue au démarrage. Elle est accordée séparément car DescribeKey n'a pas de paramètre EncryptionContext, donc une condition EncryptionContext sur cette action entraînerait toujours un refus.

export YOUR_ACCOUNT=$(aws sts get-caller-identity --query Account --output text)

aws kms create-key \
  --region <region> \
  --description "Anthropic CMEK" \
  --key-usage ENCRYPT_DECRYPT \
  --policy "{
    \"Version\": \"2012-10-17\",
    \"Statement\": [
      {
        \"Sid\": \"AccountRootAdmin\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"AWS\": \"arn:aws:iam::${YOUR_ACCOUNT}:root\"},
        \"Action\": \"kms:*\",
        \"Resource\": \"*\"
      },
      {
        \"Sid\": \"AllowAnthropicCMEKCrypto\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"AWS\": \"arn:aws:iam::915198916910:role/anthropic-cmek-client-us\"},
        \"Action\": [\"kms:Encrypt\", \"kms:Decrypt\"],
        \"Resource\": \"*\",
        \"Condition\": {
          \"StringEquals\": {
            \"kms:EncryptionContext:anthropic:compartment_uuid\": \"<compartment-uuid>\"
          }
        }
      },
      {
        \"Sid\": \"AllowAnthropicCMEKDescribe\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"AWS\": \"arn:aws:iam::915198916910:role/anthropic-cmek-client-us\"},
        \"Action\": \"kms:DescribeKey\",
        \"Resource\": \"*\"
      }
    ]
  }"

Récupérez KeyMetadata.Arn dans la sortie. Vous en aurez besoin lors de l'enregistrement de la clé à l'étape suivante.

La condition EncryptionContext est recommandée mais facultative. Anthropic inclut toujours l'ID de compartiment de votre espace de travail dans le contexte de chiffrement, de sorte que le texte chiffré est cryptographiquement lié à ce compartiment dans tous les cas. L'ajout de la condition fournit une défense en profondeur au niveau de la couche IAM. Pour commencer sans elle, omettez le bloc Condition de l'instruction AllowAnthropicCMEKCrypto et ajoutez-le ultérieurement avec kms:PutKeyPolicy.

Vous pouvez également créer la clé depuis la console AWS. Choisissez une clé symétrique avec l'utilisation de clé « encrypt and decrypt » (chiffrer et déchiffrer), une clé mono-région et l'origine du matériel de clé KMS. L'assistant de création de clé valide une stratégie de clé à son étape Review : si vous ajoutez l'ID de compte Anthropic 915198916910 sous les autorisations d'utilisation de la clé à cet endroit, la stratégie générée accorde à l'ensemble du compte Anthropic des actions plus larges (telles que kms:ReEncrypt* et kms:GenerateDataKey*) sans condition EncryptionContext, et la validation réussirait quand même avec celle-ci. Pour éviter de laisser une clé trop permissive, terminez l'assistant avec uniquement les autorisations administratives, puis ouvrez l'onglet Key policy de la clé et remplacez le JSON par la stratégie limitée au rôle présentée ci-dessus (les trois instructions limitées au rôle anthropic-cmek-client-us, avec la condition EncryptionContext).

Créez une configuration de clé externe via l'API Admin.

curl -sS https://api.anthropic.com/v1/organizations/external_keys \
  -H "x-api-key: <anthropic-admin-api-key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "display_name": "<friendly-name>",
    "geo": "us",
    "provider_config": {
      "type": "aws",
      "kms_arn": "<key-arn-from-step-1>",
      "role_arn": "arn:aws:iam::915198916910:role/anthropic-cmek-client-us"
    }
  }'

La réponse contient l'ID de clé externe :

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

Déclenchez un aller-retour de chiffrement et déchiffrement sur votre clé.

curl -sS -X POST https://api.anthropic.com/v1/organizations/external_keys/ekey_<id>/validate \
  -H "x-api-key: <anthropic-admin-api-key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" -d '{}'

Une réponse réussie ressemble à ceci :

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

Si la validation échoue, les causes courantes sont :

• Incompatibilité du contexte de chiffrement : si vous avez conservé la condition EncryptionContext dans la stratégie de clé, vérifiez que vous avez remplacé <compartment-uuid> par l'ID de compartiment réel de votre espace de travail (voir étape 1). Une valeur incorrecte ou non substituée amène KMS à renvoyer une AccessDeniedException opaque. Pour écarter cette cause, supprimez temporairement le bloc Condition de l'instruction AllowAnthropicCMEKCrypto et relancez la validation.
• Stratégies de contrôle des ressources (RCP) : si votre organisation AWS dispose d'une RCP qui refuse les opérations KMS lorsque aws:PrincipalOrgID ne correspond pas à votre organisation, elle bloque le rôle inter-comptes d'Anthropic. La RCP nécessite une exception pour cette clé ou pour l'ARN du rôle d'Anthropic. Les stratégies de contrôle des services ne s'appliquent pas ici, car elles ne sont pas évaluées pour les principaux externes appelant via des stratégies basées sur les ressources.
• Accès accordé via IAM au lieu de la stratégie de clé : l'accès KMS inter-comptes doit être accordé dans la stratégie de clé elle-même, et non via une stratégie IAM dans votre compte. Vérifiez avec aws kms get-key-policy --key-id <id> --policy-name default.
• Incompatibilité de région : vérifiez que la région de la clé est l'une de celles dans lesquelles Anthropic opère pour le niveau géographique que vous avez configuré.