Configure o Azure Key Vault para CMEK

Isso cria um service principal no seu tenant do Entra para o aplicativo cliente de CMEK da Anthropic. O aplicativo não solicita permissões do Microsoft Graph; ele existe apenas como um alvo de federação para acesso ao plano de dados do Key Vault.

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

Da saída, capture o campo id. Este é o object ID do service principal no seu tenant, que você usa ao atribuir a função RBAC.

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

Se o service principal já existir no seu tenant (de uma tentativa anterior ou de outra integração), az ad sp create termina com um erro "already exists". Em vez disso, obtenha seu object ID:

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

Esta etapa não tem equivalente no Portal. Se você não tiver a CLI do Azure instalada localmente, abra o Cloud Shell na barra de navegação superior do Portal. Depois que o comando for bem-sucedido, você pode encontrar o object ID do service principal em Microsoft Entra ID > Enterprise applications, limpando o filtro padrão de tipo de aplicativo e pesquisando por anthropic-cmek-client-us.

O Azure Key Vault não suporta encapsulamento de chave simétrica, então a chave deve ser RSA (3072 bits ou maior) com wrapKey e unwrapKey em suas operações permitidas.

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

Para chaves com suporte de HSM, use --kty RSA-HSM (requer um vault com SKU Premium). Chaves RSA protegidas por software são aceitáveis para esta integração.

No Portal, abra seu Key Vault, selecione Keys e depois Generate/Import. Defina o tipo de chave como RSA e o tamanho como 3072 ou maior. Para restringir a chave apenas a wrap e unwrap, abra a versão da chave, role até Permitted operations e desmarque tudo exceto Wrap Key e Unwrap Key.

Atribua a função Key Vault Crypto User ao service principal da primeira etapa, com escopo na chave individual em vez de no vault inteiro.

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

A função integrada Key Vault Crypto User concede operações criptográficas de chave (encrypt, decrypt, wrap, unwrap, sign, verify) mais leitura de chave no escopo atribuído. A restrição --ops wrapKey unwrapKey que você definiu na chave na etapa anterior restringe ainda mais quais dessas operações podem ter sucesso nesta chave, então na prática a Anthropic só pode fazer wrap e unwrap.

No Portal, abra a chave (não o vault), selecione sua aba Access control (IAM), clique em Add > Add role assignment, selecione Key Vault Crypto User e atribua-a ao service principal 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}"

Confirme que:

• rbac é true.
• purge é true. Se for false ou null, habilite a proteção contra exclusão permanente no vault antes de prosseguir. Sem ela, uma chave excluída de forma reversível pode ser permanentemente eliminada durante a janela de retenção, tornando seus dados protegidos por CMEK irrecuperáveis.
• pub é "Enabled". Se for "Disabled", a Anthropic não consegue alcançar o vault pelo seu endpoint público do plano de dados e a validação falha.
• net é "Allow", ou, se for "Deny", que ipRules inclua os intervalos de saída da Anthropic (entre em contato com a Anthropic para obter a lista atual).
• uri é o URI do vault que você usa ao registrar a chave.
• tenantId é o tenant que governa o vault. Use este valor como tenant_id ao registrar a chave, não o tenant da sua assinatura atualmente ativa (os dois podem diferir em configurações entre tenants).