AWS KMS für CMEK konfigurieren

Die Key Policy gewährt der IAM-Rolle von Anthropic kontoübergreifenden Zugriff. Drei Statements sind erforderlich:

1. Account root admin: das Standard-KMS-Muster. Dein Konto behält die volle administrative Kontrolle.
2. Anthropic encrypt and decrypt: die Aktionen kms:Encrypt und kms:Decrypt, die Anthropic verwendet, um die Data Keys zu verschlüsseln und zu entschlüsseln, die deine Workspace-Daten schützen (Envelope Encryption).
3. Anthropic describe: der Metadaten-Lesezugriff, den Anthropic beim Start durchführt. Er wird separat gewährt, weil DescribeKey keinen EncryptionContext-Parameter hat, sodass eine EncryptionContext-Bedingung für diese Aktion immer verweigern würde.

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\": \"*\"
      }
    ]
  }"

Notiere dir KeyMetadata.Arn aus der Ausgabe. Du benötigst ihn, wenn du den Schlüssel im nächsten Schritt registrierst.

Die EncryptionContext-Bedingung wird empfohlen, ist aber optional. Anthropic fügt die Compartment-ID deines Workspaces immer in den Encryption Context ein, sodass der Ciphertext unabhängig davon kryptografisch an dieses Compartment gebunden ist. Das Hinzufügen der Bedingung bietet Defense-in-Depth auf der IAM-Ebene. Um ohne sie zu starten, lasse den Condition-Block im AllowAnthropicCMEKCrypto-Statement weg und füge ihn später mit kms:PutKeyPolicy hinzu.

Du kannst den Schlüssel auch über die AWS Console erstellen. Wähle einen symmetrischen Schlüssel mit der Schlüsselverwendung „Encrypt and decrypt", einen Single-Region-Schlüssel und KMS als Key Material Origin. Der Create-Key-Assistent legt im Schritt Review eine Key Policy fest: Wenn du dort die Anthropic-Konto-ID 915198916910 unter den Key Usage Permissions hinzufügst, gewährt die generierte Policy dem gesamten Anthropic-Konto umfassendere Aktionen (wie kms:ReEncrypt* und kms:GenerateDataKey*) ohne EncryptionContext-Bedingung, und die Validierung würde trotzdem erfolgreich sein. Um keinen zu weit gefassten Schlüssel zu hinterlassen, schließe den Assistenten nur mit administrativen Berechtigungen ab, öffne dann den Tab Key policy des Schlüssels und ersetze das JSON durch die oben gezeigte rollenbezogene Policy (die drei Statements, die auf die Rolle anthropic-cmek-client-us beschränkt sind, mit der EncryptionContext-Bedingung).