AdministraçãoChaves de criptografia (CMEK)

Configurar o Azure Key Vault para CMEK

Copy page



Use o Azure Key Vault para fornecer uma chave de criptografia para sua organização.

Este guia orienta a configuração de uma chave do Azure Key Vault como uma chave de criptografia gerenciada pelo cliente (CMEK) para sua organização Anthropic.

Pré-requisitos

• Um Azure Key Vault com autorização RBAC habilitada (enableRbacAuthorization: true) e acesso de rede pública permitido. A Anthropic chama seu vault pelo endpoint público do plano de dados; endpoints privados não são suportados.
• Proteção contra limpeza habilitada (enablePurgeProtection: true) no vault. Sem ela, uma chave excluída pode ser permanentemente limpa durante a janela de retenção de exclusão reversível, causando perda irreversível dos seus dados protegidos por CMEK. A proteção contra limpeza não pode ser desabilitada depois de habilitada.
• Permissões para criar chaves no vault e atribuir funções RBAC nele.
• Permissões para criar entidades de serviço no seu locatário Entra (Application Administrator, Cloud Application Administrator ou uma função personalizada equivalente).
• Uma chave de API de Admin da Anthropic para sua organização.
• A CLI az instalada e autenticada.
• Configurações de diagnóstico configuradas no vault para rotear a categoria de log AuditEvent para o Log Analytics, uma conta de armazenamento ou um hub de eventos. O Azure Key Vault não emite logs de auditoria do plano de dados (como KeyWrap, KeyUnwrap e KeyGet) por padrão, então sem isso você não obtém nenhuma trilha de auditoria para as operações de chave da Anthropic.

Informações do aplicativo Anthropic

Para que a Anthropic use sua chave de criptografia, você deve configurar um ID de aplicativo multilocatário da Anthropic e um nome de exibição. Esses valores são:

Configuração da chave de criptografia

1. 1

   Consentir com o aplicativo multilocatário da Anthropic

   Isso cria uma entidade de serviço no seu locatário Entra para o aplicativo cliente 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

   

   Na saída, capture o campo id. Este é o ID de objeto da entidade de serviço no seu locatário, 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 a entidade de serviço já existir no seu locatário (de uma tentativa anterior ou de outra integração), az ad sp create sai com um erro de "já existe". Em vez disso, busque seu ID de objeto:

   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 ID de objeto da entidade de serviço em Microsoft Entra ID > Aplicativos empresariais limpando o filtro de tipo de aplicativo padrão e pesquisando por anthropic-cmek-client-us.

   

2. 2

   Criar uma chave RSA no seu vault

   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.

   A opção --tags adiciona a tag da organização, anthropic-org-<ORGANIZATION_UUID> com o valor true, onde <ORGANIZATION_UUID> é o ID da sua organização Anthropic em minúsculas. A tag é necessária para que a Anthropic valide a chave.

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

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

   Na página Create a key, adicione também a tag da organização em Tags.

   

   

   Para compartilhar uma chave entre várias organizações Anthropic, adicione uma tag dessas para cada organização. Uma versão de chave pode ter no máximo 15 tags, incluindo as suas próprias.

3. 3

   Conceder à entidade de serviço da Anthropic acesso à sua chave

   Atribua a função Key Vault Crypto User à entidade de serviço da primeira etapa, com escopo para a chave individual em vez de todo o 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>"

   

   A função interna Key Vault Crypto User concede operações criptográficas de chave (criptografar, descriptografar, encapsular, desencapsular, assinar, verificar) mais leitura de chave no seu 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 ser bem-sucedidas contra esta chave, então, na prática, a Anthropic só pode encapsular e desencapsular.

   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 à entidade de serviço anthropic-cmek-client-us.

   

4. 4

   Verificar a configuração do seu 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}"

   

   Confirme que:

   • rbac é true.
   • purge é true. Se for false ou null, habilite a proteção contra limpeza no vault antes de prosseguir. Sem ela, uma chave excluída de forma reversível pode ser permanentemente limpa durante a janela de retenção, tornando seus dados protegidos por CMEK irrecuperáveis.
   • pub é "Enabled". Se for "Disabled", a Anthropic não pode 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 a lista atual).
   • uri é o URI do vault que você usa ao registrar a chave.
   • tenantId é o locatário que governa o vault. Use este valor como tenant_id ao registrar a chave, não o locatário da sua assinatura atualmente ativa (os dois podem diferir em configurações entre locatários).

Registrar a chave com a Anthropic

Como você registra a chave depende de qual produto você usa.

Terraform

Para implantações de infraestrutura como código, as mesmas etapas mapeiam para os provedores azurerm e azuread.