使用 AWS KMS 设置 CMEK

创建 AWS KMS 密钥,授予 Anthropic 对该密钥的访问权限,并在 Claude Platform 或 Claude Enterprise 中使用它。

让 Claude Code 为您设置此功能

示例代码
/claude-api 帮我使用 AWS KMS 配置客户管理的加密密钥

如果您的 Claude Console 侧边栏显示账户管理方 AWS,请改为按照在 Claude Platform on AWS 上设置 CMEK 进行操作。

开始之前

在 Claude 中:

  • 客户管理的加密密钥(CMEK)已为您的组织开启。
  • 您已获得您的 Anthropic 组织 ID,即不带 org_ 前缀的 UUID。您可以从 Claude Console 中的组织复制它,也可以从 claude.ai 上的组织设置 > 组织与访问权限复制它。创建密钥的人需要此 ID。
  • 您是 Claude Platform 上的组织管理员,或 Claude Enterprise 上的所有者或主要所有者。
  • 在 Claude Platform 上,您拥有一个保留数据的工作区,最好是新的工作区,因为现有数据仍受 Anthropic 的密钥保护。
  • 在 Claude Enterprise 上,您了解哪些功能会关闭或发生变化。

在 AWS 中:

  • 您可以创建 AWS KMS 密钥并设置其密钥策略(kms:CreateKey 和 kms:PutKeyPolicy)。
  • 对 AWS KMS 访问的任何 IP 限制都允许 Anthropic 的出站 IP 地址。

在 AWS 中:创建密钥

如果验证或添加失败,请参阅 AWS KMS 的修复方法。

编写密钥策略

此策略授予 Anthropic 的 IAM 角色对您的密钥的访问权限。请仅使用本页发布的角色 ARN,切勿使用通过电子邮件或聊天发送的 ARN。将策略复制到文本编辑器中:

示例代码
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AccountRootAdmin",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::<AWS_ACCOUNT_ID>: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:org_uuid": ["<ORGANIZATION_UUID>"]
        }
      }
    },
    {
      "Sid": "AllowAnthropicCMEKDescribe",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::915198916910:role/anthropic-cmek-client-us"
      },
      "Action": "kms:DescribeKey",
      "Resource": "*"
    }
  ]
}

将 <AWS_ACCOUNT_ID> 替换为您的 AWS 账户 ID,将 <ORGANIZATION_UUID> 替换为您的 Anthropic 组织 ID。请保留 kms:EncryptionContext:anthropic:org_uuid 条件,否则验证会失败。

您还可以通过列出工作区的分区 ID 来将密钥限制为特定工作区。如果您要替换已保护 Claude 数据的密钥上的策略,请再添加一条策略语句。

创建密钥

您可以在任何 AWS 商业区域中创建密钥。为获得最低延迟,请使用 us-east-2。

要使用您在 AWS KMS 中已有的密钥,请替换其密钥策略。

AWS Console

打开 Create key 向导

打开 AWS KMS 控制台,并切换到该密钥所在的区域。转到 Customer managed keys,然后点击 Create key。

Configure key

确保已选择以下选项:

  • Key type: Symmetric
  • Key usage: Encrypt and decrypt
  • Advanced options > Key material origin: KMS
  • Advanced options > Regionality: Single-Region key

点击 Next。

AWS KMS 的 Configure key 步骤,已选择 Symmetric 密钥类型、Encrypt and decrypt 密钥用法和 Single-Region key。

Add labels

为该密钥输入一个 Alias,例如 anthropic-cmek。点击 Next。

AWS KMS 的 Add labels 步骤,别名为 anthropic-cmek,描述为 Anthropic CMEK。

Define key administrative permissions

不要选择任何密钥管理员。您的密钥策略已授予您的 AWS 账户完全的管理控制权。点击 Next。

AWS KMS 的 Define key administrative permissions 步骤,列出了可以管理该密钥的 IAM 角色。

Define key usage permissions

不要选择任何密钥用户,也不要在 Other AWS accounts 下添加任何内容。您的密钥策略已授予所需的访问权限。点击 Next。

Edit key policy

点击 Edit。用您的密钥策略替换整个策略,然后点击 Next。

Review

点击 Finish。

复制您的密钥的 ARN

在 Customer managed keys 中,打开新密钥并复制其 ARN。在 Claude 中添加该密钥的人员需要用到它。

AWS CLI

将您的密钥策略保存为 key-policy.json,然后创建密钥。将 <REGION> 替换为该密钥所在的区域。

示例代码
aws kms create-key \
  --region <REGION> \
  --description "Anthropic CMEK" \
  --key-usage ENCRYPT_DECRYPT \
  --policy file://key-policy.json

从输出中复制 KeyMetadata.Arn。在 Claude 中添加该密钥的人员需要用到此 ARN。

在 Claude 中每次检查密钥都会向 CloudTrail 添加四个预期的拒绝访问错误。您可以将它们过滤掉。

在 Claude 中:添加并附加密钥

要在 Claude Platform 上通过脚本完成这部分操作,请改为使用 Admin API。

Claude Platform

打开加密密钥设置

在 Claude Console 中,打开数据保留页面上的加密密钥。如果该部分不存在,请从顶部的下拉菜单中选择组织。

添加密钥

在加密密钥下,点击添加密钥。输入显示名称,选择 AWS KMS,然后点击继续。

输入密钥 ARN

检查您的密钥策略是否包含对话框中显示的密钥策略的组织 ID。将密钥 ARN 粘贴到 KMS 密钥 ARN 中,然后点击添加。

验证密钥

在加密密钥列表中,点击密钥旁边的验证。检查通过时会显示已连接。如果显示的是连接失败,请参阅 CMEK 故障排除。

将密钥附加到工作区

  1. 在数据保留页面顶部,从下拉菜单中选择工作区。
  2. 在加密密钥下,选择密钥并点击保存。
  3. 选中复选框以确认您已阅读 CMEK 文档,然后点击确认。

您会看到工作区设置已更新。 一旦您的密钥生效,您的云服务提供商的审计日志中就会显示 Anthropic 对您的密钥的调用。

在 ZDR 组织中,选择工作区后,请选择标准数据保留,以便显示加密密钥。点击保存后,在数据保留条款上点击接受。

Claude Enterprise

在 Claude Enterprise 上,CMEK 适用于整个组织,并且您只能添加一个密钥。

添加密钥会为每位用户关闭或更改某些功能。如需先试用 CMEK,请使用单独的组织。

打开加密密钥设置

前往 claude.ai > 组织设置 > 数据与隐私,找到加密密钥。

添加密钥

点击添加密钥。输入显示名称并选择 AWS KMS。选中复选框以确认您已阅读 CMEK 文档,然后点击继续。

输入密钥 ARN

检查您的密钥策略是否包含对话框中显示的密钥策略的组织 ID。将密钥 ARN 粘贴到 KMS 密钥 ARN 中,然后点击添加。

确认已添加密钥

检查最多可能需要 30 秒。当出现已配置加密密钥。 时,点击完成。如果改为出现无法添加加密密钥。,请查找原因并重试。

您的密钥保护从那时起写入的数据。请告知您的用户哪些功能发生了变化。

文档内容持续同步更新