Configura Azure Key Vault para CMEK

Esto crea una entidad de servicio en tu tenant de Entra para la aplicación cliente de CMEK de Anthropic. La aplicación no solicita permisos de Microsoft Graph; existe únicamente como un objetivo de federación para el acceso al plano de datos de Key Vault.

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

De la salida, captura el campo id. Este es el ID de objeto de la entidad de servicio en tu tenant, que usas cuando asignas el rol RBAC.

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

Si la entidad de servicio ya existe en tu tenant (de un intento anterior u otra integración), az ad sp create termina con un error de "already exists". En su lugar, obtén su ID de objeto:

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

Este paso no tiene equivalente en el Portal. Si no tienes la CLI de Azure instalada localmente, abre Cloud Shell desde la barra de navegación superior del Portal. Después de que el comando tenga éxito, puedes encontrar el ID de objeto de la entidad de servicio en Microsoft Entra ID > Enterprise applications borrando el filtro predeterminado de tipo de aplicación y buscando anthropic-cmek-client-us.

Azure Key Vault no admite el envoltorio de claves simétricas, por lo que la clave debe ser RSA (de 3072 bits o más) con wrapKey y unwrapKey en sus operaciones permitidas.

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

Para claves respaldadas por HSM, usa --kty RSA-HSM (requiere un vault con SKU Premium). Las claves RSA protegidas por software son aceptables para esta integración.

Desde el Portal, abre tu Key Vault, selecciona Keys y luego Generate/Import. Establece el tipo de clave en RSA y el tamaño en 3072 o más. Para restringir la clave solo a envolver y desenvolver, abre la versión de la clave, desplázate hasta Permitted operations y desmarca todo excepto Wrap Key y Unwrap Key.

Asigna el rol Key Vault Crypto User a la entidad de servicio del primer paso, con alcance a la clave individual en lugar de a todo el vault.

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

El rol integrado Key Vault Crypto User otorga operaciones criptográficas de clave (cifrar, descifrar, envolver, desenvolver, firmar, verificar) más lectura de clave en su alcance asignado. La restricción --ops wrapKey unwrapKey que estableciste en la clave en el paso anterior limita aún más cuáles de esas operaciones pueden tener éxito contra esta clave, por lo que en la práctica Anthropic solo puede envolver y desenvolver.

Desde el Portal, abre la clave (no el vault), selecciona su pestaña Access control (IAM), haz clic en Add > Add role assignment, selecciona Key Vault Crypto User y asígnalo a la entidad de servicio 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}"

Confirma que:

• rbac es true.
• purge es true. Si es false o null, habilita la protección contra purga en el vault antes de continuar. Sin ella, una clave eliminada temporalmente puede purgarse permanentemente durante la ventana de retención, haciendo que tus datos protegidos por CMEK sean irrecuperables.
• pub es "Enabled". Si es "Disabled", Anthropic no puede alcanzar el vault a través de su endpoint público del plano de datos y la validación falla.
• net es "Allow", o, si es "Deny", que ipRules incluya los rangos de salida de Anthropic (contacta a Anthropic para obtener la lista actual).
• uri es el URI del vault que usas cuando registras la clave.
• tenantId es el tenant que gobierna el vault. Usa este valor como tenant_id cuando registres la clave, no el tenant de tu suscripción actualmente activa (los dos pueden diferir en configuraciones entre tenants).