AdministraciónClaves de cifrado (CMEK)

Configurar Azure Key Vault para CMEK

Copy page



Usa Azure Key Vault para proporcionar una clave de cifrado para tu organización.

Esta guía explica cómo configurar una clave de Azure Key Vault como una clave de cifrado administrada por el cliente (CMEK) para tu organización de Anthropic.

Requisitos previos

• Un Azure Key Vault con autorización RBAC habilitada (enableRbacAuthorization: true) y acceso a la red pública permitido. Anthropic llama a tu vault a través del endpoint público del plano de datos; los endpoints privados no son compatibles.
• Protección contra purga habilitada (enablePurgeProtection: true) en el vault. Sin ella, una clave eliminada puede purgarse permanentemente durante la ventana de retención de eliminación temporal, causando la pérdida irreversible de tus datos protegidos por CMEK. La protección contra purga no se puede deshabilitar una vez habilitada.
• Permisos para crear claves en el vault y para asignar roles RBAC en él.
• Permisos para crear entidades de servicio en tu tenant de Entra (Application Administrator, Cloud Application Administrator, o un rol personalizado equivalente).
• Una clave de API de administrador de Anthropic para tu organización.
• La CLI az instalada y autenticada.
• Configuración de diagnóstico configurada en el vault para enrutar la categoría de registro AuditEvent a Log Analytics, una cuenta de almacenamiento o un centro de eventos. Azure Key Vault no emite registros de auditoría del plano de datos (como KeyWrap, KeyUnwrap y KeyGet) de forma predeterminada, por lo que sin esto no obtienes ningún rastro de auditoría para las operaciones de clave de Anthropic.

Información de la aplicación de Anthropic

Para que Anthropic use tu clave de cifrado, debes configurar un ID de aplicación multitenant y un nombre para mostrar de Anthropic. Esos valores son:

Configuración de la clave de cifrado

1. 1

   Dar consentimiento a la aplicación multitenant de Anthropic

   Esto crea una entidad de servicio en tu tenant de Entra para la aplicación cliente 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 sale 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 de tipo de aplicación predeterminado y buscando anthropic-cmek-client-us.

   

2. 2

   Crear una clave RSA en tu vault

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

   La opción --tags agrega la etiqueta de organización, anthropic-org-<ORGANIZATION_UUID> con el valor true, donde <ORGANIZATION_UUID> es el ID de tu organización de Anthropic en minúsculas. La etiqueta es necesaria para que Anthropic valide la clave.

   az keyvault key create \
     --vault-name <VAULT_NAME> \
     --name <KEY_NAME> \
     --kty RSA --size 3072 \
     --ops wrapKey unwrapKey \
     --tags anthropic-org-<ORGANIZATION_UUID>=true

   

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

   Desde el Portal, abre tu Key Vault, selecciona Keys, 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 ajustar y desajustar, abre la versión de la clave, desplázate hasta Permitted operations y desmarca todo excepto Wrap Key y Unwrap Key.

   En la página Create a key, también agrega la etiqueta de organización en Tags.

   

   

   Para compartir una clave entre varias organizaciones de Anthropic, agrega una etiqueta de este tipo por cada organización. Una versión de clave puede llevar como máximo 15 etiquetas, incluidas las tuyas.

3. 3

   Otorgar a la entidad de servicio de Anthropic acceso a tu clave

   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, ajustar, desajustar, firmar, verificar) más la lectura de clave en su alcance asignado. La restricción --ops wrapKey unwrapKey que estableciste en la clave en el paso anterior reduce 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 ajustar y desajustar.

   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.

   

4. 4

   Verificar la configuración de tu vault

   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).

Registrar la clave con Anthropic

La forma en que registras la clave depende del producto que uses.

Terraform

Para implementaciones de infraestructura como código, los mismos pasos se asignan a los proveedores azurerm y azuread.