Configurar o AWS KMS para CMEK

A política de chave concede acesso entre contas à função IAM da Anthropic. Três declarações são necessárias:

1. Administrador root da conta: o padrão standard do KMS. Sua conta mantém controle administrativo total.
2. Criptografar e descriptografar da Anthropic: as ações kms:Encrypt e kms:Decrypt, que a Anthropic usa para criptografar e descriptografar as chaves de dados que protegem os dados do seu workspace (criptografia de envelope).
3. Describe da Anthropic: a leitura de metadados que a Anthropic executa na inicialização. É concedida separadamente porque DescribeKey não tem o parâmetro EncryptionContext, então uma condição EncryptionContext nessa ação sempre resultaria em negação.

export YOUR_ACCOUNT=$(aws sts get-caller-identity --query Account --output text)

aws kms create-key \
  --region <region> \
  --description "Anthropic CMEK" \
  --key-usage ENCRYPT_DECRYPT \
  --policy "{
    \"Version\": \"2012-10-17\",
    \"Statement\": [
      {
        \"Sid\": \"AccountRootAdmin\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"AWS\": \"arn:aws:iam::${YOUR_ACCOUNT}:root\"},
        \"Action\": \"kms:*\",
        \"Resource\": \"*\"
      },
      {
        \"Sid\": \"AllowAnthropicCMEKCrypto\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"AWS\": \"arn:aws:iam::915198916910:role/anthropic-cmek-client-us\"},
        \"Action\": [\"kms:Encrypt\", \"kms:Decrypt\"],
        \"Resource\": \"*\",
        \"Condition\": {
          \"StringEquals\": {
            \"kms:EncryptionContext:anthropic:compartment_uuid\": \"<compartment-uuid>\"
          }
        }
      },
      {
        \"Sid\": \"AllowAnthropicCMEKDescribe\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"AWS\": \"arn:aws:iam::915198916910:role/anthropic-cmek-client-us\"},
        \"Action\": \"kms:DescribeKey\",
        \"Resource\": \"*\"
      }
    ]
  }"

Capture KeyMetadata.Arn da saída. Você precisará dele ao registrar a chave na próxima etapa.

A condição EncryptionContext é recomendada, mas opcional. A Anthropic sempre inclui o ID de compartimento do seu workspace no contexto de criptografia, então o texto cifrado fica criptograficamente vinculado a esse compartimento de qualquer forma. Adicionar a condição fornece defesa em profundidade na camada IAM. Para começar sem ela, omita o bloco Condition da declaração AllowAnthropicCMEKCrypto e adicione-o posteriormente com kms:PutKeyPolicy.

Você também pode criar a chave pelo AWS Console. Escolha uma chave simétrica com uso de chave para criptografar e descriptografar, uma chave de região única e origem de material de chave KMS. O assistente de criação de chave confirma uma política de chave na etapa Review: se você adicionar o ID da conta da Anthropic 915198916910 nas permissões de uso de chave nessa etapa, a política gerada concede à conta inteira da Anthropic ações mais amplas (como kms:ReEncrypt* e kms:GenerateDataKey*) sem nenhuma condição EncryptionContext, e a validação ainda seria bem-sucedida com ela. Para evitar deixar uma chave com permissões excessivas, conclua o assistente apenas com permissões administrativas e, em seguida, abra a aba Key policy da chave e substitua o JSON pela política com escopo de função mostrada acima (as três declarações com escopo para a função anthropic-cmek-client-us, com a condição EncryptionContext).

Crie uma configuração de chave externa por meio da Admin API.

curl -sS https://api.anthropic.com/v1/organizations/external_keys \
  -H "x-api-key: <anthropic-admin-api-key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "display_name": "<friendly-name>",
    "geo": "us",
    "provider_config": {
      "type": "aws",
      "kms_arn": "<key-arn-from-step-1>",
      "role_arn": "arn:aws:iam::915198916910:role/anthropic-cmek-client-us"
    }
  }'

A resposta contém o ID da chave externa:

{
  "type": "external_key",
  "id": "ekey_<id>",
  "display_name": "<friendly-name>"
}

Acione uma operação completa de criptografia e descriptografia na sua chave.

curl -sS -X POST https://api.anthropic.com/v1/organizations/external_keys/ekey_<id>/validate \
  -H "x-api-key: <anthropic-admin-api-key>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" -d '{}'

Uma resposta bem-sucedida tem esta aparência:

{ "type": "external_key_validation", "status": "success", "error": null }

Se a validação falhar, as causas comuns são:

• Incompatibilidade de contexto de criptografia: se você manteve a condição EncryptionContext na política de chave, confirme que substituiu <compartment-uuid> pelo ID de compartimento real do seu workspace (veja a etapa 1). Um valor incorreto ou não substituído faz o KMS retornar um AccessDeniedException opaco. Para descartar essa causa, remova temporariamente o bloco Condition da declaração AllowAnthropicCMEKCrypto e valide novamente.
• Resource control policies (RCPs): se sua organização AWS tiver uma RCP que nega operações KMS quando aws:PrincipalOrgID não corresponde à sua organização, ela bloqueia a função entre contas da Anthropic. A RCP precisa de uma exceção para essa chave ou para o ARN da função da Anthropic. Service control policies não se aplicam aqui, porque não são avaliadas para principals externos que fazem chamadas por meio de políticas baseadas em recursos.
• Acesso concedido via IAM em vez da política de chave: o acesso KMS entre contas deve ser concedido na própria política de chave, não por meio de uma política IAM na sua conta. Verifique com aws kms get-key-policy --key-id <id> --policy-name default.
• Incompatibilidade de região: confirme que a região da chave é uma em que a Anthropic opera para o nível geográfico que você configurou.