Configurer Azure Key Vault pour CMEK

Cela crée un principal de service dans votre locataire Entra pour l'application cliente CMEK d'Anthropic. L'application ne demande aucune autorisation Microsoft Graph ; elle existe uniquement comme cible de fédération pour l'accès au plan de données de Key Vault.

az ad sp create --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87

À partir de la sortie, capturez le champ id. Il s'agit de l'ID d'objet du principal de service dans votre locataire, que vous utilisez lorsque vous attribuez le rôle RBAC.

{
  "appId": "8635ae1a-3e5d-44e8-a4ed-e0f614466f87",
  "displayName": "anthropic-cmek-client-us",
  "id": "<sp-object-id>"
}

Si le principal de service existe déjà dans votre locataire (suite à une tentative précédente ou à une autre intégration), az ad sp create se termine avec une erreur « already exists ». Récupérez plutôt son ID d'objet :

az ad sp show --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87 --query id -o tsv

Cette étape n'a pas d'équivalent dans le Portail. Si vous n'avez pas la CLI Azure installée localement, ouvrez Cloud Shell depuis la barre de navigation supérieure du Portail. Une fois la commande réussie, vous pouvez trouver l'ID d'objet du principal de service dans Microsoft Entra ID > Enterprise applications en effaçant le filtre de type d'application par défaut et en recherchant anthropic-cmek-client-us.

Azure Key Vault ne prend pas en charge l'encapsulation de clé symétrique, donc la clé doit être RSA (3072 bits ou plus) avec wrapKey et unwrapKey dans ses opérations autorisées.

az keyvault key create \
  --vault-name <your-vault-name> \
  --name <your-key-name> \
  --kty RSA --size 3072 \
  --ops wrapKey unwrapKey

Pour les clés protégées par HSM, utilisez --kty RSA-HSM (nécessite un coffre de SKU Premium). Les clés RSA protégées par logiciel sont acceptables pour cette intégration.

Depuis le Portail, ouvrez votre Key Vault, sélectionnez Keys, puis Generate/Import. Définissez le type de clé sur RSA et la taille sur 3072 ou plus. Pour restreindre la clé à l'encapsulation et à la désencapsulation uniquement, ouvrez la version de la clé, faites défiler jusqu'à Permitted operations, et décochez tout sauf Wrap Key et Unwrap Key.

Attribuez le rôle Key Vault Crypto User au principal de service de la première étape, avec une portée limitée à la clé individuelle plutôt qu'à l'ensemble du coffre.

VAULT_ID=$(az keyvault show --name <your-vault-name> --query id -o tsv)

az role assignment create \
  --role "Key Vault Crypto User" \
  --assignee-object-id <sp-object-id> \
  --assignee-principal-type ServicePrincipal \
  --scope "${VAULT_ID}/keys/<your-key-name>"

Le rôle intégré Key Vault Crypto User accorde les opérations cryptographiques de clé (chiffrement, déchiffrement, encapsulation, désencapsulation, signature, vérification) ainsi que la lecture de clé sur sa portée attribuée. La restriction --ops wrapKey unwrapKey que vous avez définie sur la clé à l'étape précédente limite davantage lesquelles de ces opérations peuvent réussir sur cette clé, donc en pratique Anthropic ne peut qu'encapsuler et désencapsuler.

Depuis le Portail, ouvrez la clé (pas le coffre), sélectionnez son onglet Access control (IAM), cliquez sur Add > Add role assignment, sélectionnez Key Vault Crypto User, et attribuez-le au principal de service anthropic-cmek-client-us.

az keyvault show --name <your-vault-name> \
  --query "{rbac:properties.enableRbacAuthorization, purge:properties.enablePurgeProtection, pub:properties.publicNetworkAccess, net:properties.networkAcls.defaultAction, ipRules:properties.networkAcls.ipRules, uri:properties.vaultUri, tenantId:properties.tenantId}"

Confirmez que :

• rbac est true.
• purge est true. S'il est false ou null, activez la protection contre la purge sur le coffre avant de continuer. Sans elle, une clé supprimée de façon réversible peut être purgée de façon permanente pendant la fenêtre de rétention, rendant vos données protégées par CMEK irrécupérables.
• pub est "Enabled". S'il est "Disabled", Anthropic ne peut pas atteindre le coffre via son point de terminaison public du plan de données et la validation échoue.
• net est "Allow", ou, s'il est "Deny", que ipRules inclut les plages de sortie d'Anthropic (contactez Anthropic pour la liste actuelle).
• uri est l'URI du coffre que vous utilisez lorsque vous enregistrez la clé.
• tenantId est le locataire qui régit le coffre. Utilisez cette valeur comme tenant_id lorsque vous enregistrez la clé, et non le locataire de votre abonnement actuellement actif (les deux peuvent différer dans les configurations inter-locataires).