为 CMEK 配置 AWS KMS

本指南将引导您将 AWS KMS 密钥配置为 Anthropic 组织的客户管理加密密钥（customer-managed encryption key，CMEK）。

前提条件

• 一个具有创建 KMS 密钥和设置密钥策略权限（kms:CreateKey 和 kms:PutKeyPolicy）的 AWS 账户。
• 您组织的 Anthropic Admin API 密钥。
• 已安装并通过身份验证的 AWS CLI。

Anthropic 的 Amazon 资源名称（ARN）

要让 Anthropic 使用您的加密密钥，您必须为 Anthropic 的 IAM 角色提供一个可用于加密数据的 KMS 密钥。Anthropic CMEK 的 ARN 为：

arn:aws:iam::915198916910:role/anthropic-cmek-client-us

加密密钥设置

1. 1

   使用跨账户密钥策略创建 KMS 密钥

   密钥策略授予 Anthropic 的 IAM 角色跨账户访问权限。需要三条语句：

   1. 账户根管理员： 标准的 KMS 模式。您的账户保留完全的管理控制权。
   2. Anthropic 加密和解密： kms:Encrypt 和 kms:Decrypt 操作，Anthropic 使用它们来加密和解密保护您工作区数据的数据密钥（信封加密）。
   3. Anthropic 描述： Anthropic 在启动时执行的元数据读取。它被单独授予，因为 DescribeKey 没有 EncryptionContext 参数，因此对此操作的 EncryptionContext 条件将始终拒绝。

   要查找您的 AWS 账户 ID，请运行 aws sts get-caller-identity --query Account --output text。

   在策略中，将 <AWS_ACCOUNT_ID> 替换为您的 AWS 账户 ID，将 <ORGANIZATION_UUID> 替换为您的组织 ID。kms:EncryptionContext:anthropic:org_uuid 上的 StringEquals 条件将密钥绑定到您的 Anthropic 组织，验证会拒绝没有该条件的密钥。要在多个 Anthropic 组织之间共享一个密钥，请在条件值中列出每个组织 ID。

   将策略保存为 key-policy.json。要改为在 AWS Console 中创建密钥，请将策略粘贴到那里，如本步骤后面所述。

   key-policy.json

   

   {
     "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 kms create-key \
     --region <REGION> \
     --description "Anthropic CMEK" \
     --key-usage ENCRYPT_DECRYPT \
     --policy file://key-policy.json

   

   从输出中捕获 KeyMetadata.Arn。在下一步注册密钥时您需要它。

   当您验证密钥或将其附加到工作区时，Anthropic 会验证密钥。每次验证都会向 CloudTrail 添加四个访问被拒绝错误。这些是预期的。如果您需要将它们过滤掉，请对以下所有三个值进行过滤。仅第一个值是不够的，因为任何调用者都可以设置它：

   • requestParameters.encryptionContext.associatedData：Y21lay12YWxpZGF0aW9u
   • userIdentity.accountId：915198916910
   • resources.ARN：arn:aws:kms:<REGION>:<AWS_ACCOUNT_ID>:key/<KEY_ID>

   您也可以从 AWS Console 创建密钥。选择具有加密和解密密钥用途的对称密钥、单区域密钥和 KMS 密钥材料来源。创建密钥向导在其 Review 步骤提交密钥策略：如果您在那里的密钥用途权限下添加 Anthropic 的账户 ID 915198916910，生成的策略会授予整个 Anthropic 账户更广泛的操作（例如 kms:ReEncrypt* 和 kms:GenerateDataKey*），且没有 EncryptionContext 条件，验证会拒绝它。为避免留下权限过大的密钥，请仅使用管理权限完成向导，然后打开密钥的 Key policy 选项卡，并将 JSON 替换为本步骤前面显示的 key-policy.json 策略。

   

   

   

   

向 Anthropic 注册密钥

您如何注册密钥取决于您使用的产品。

在 Claude Platform on AWS 上设置 CMEK

在 Claude Platform on AWS 上，CMEK 仅使用 AWS KMS 密钥，并且设置在以下方面与前面几节不同：

• 主体： 您的密钥策略授予访问权限的是 AWS 服务主体 aws-external-anthropic.amazonaws.com。不使用 Anthropic 的 IAM 角色和账户 ID，因此 Anthropic 的 ARN 不适用。
• 密钥要求： 密钥必须是具有加密和解密用途的对称 KMS 密钥、单区域，并且与您附加它的工作区位于同一 AWS 账户和区域。不支持跨账户密钥：密钥必须位于托管您组织的 AWS 账户中。注册密钥时会拒绝多区域密钥（以 mrk- 开头的密钥 ID）和别名 ARN；请使用密钥 ARN。
• 没有单独的验证步骤： 除了注册时对密钥 ARN 的这些检查外，密钥在您将其附加到工作区时进行验证。附加调用会以该工作区的分区 ID 作为加密上下文，针对密钥执行一次加密/解密往返，因此密钥策略问题会在附加时而不是注册时显现。因此 EncryptionContext 条件不需要全零条目。
• 您在何处管理密钥： 在 Claude Console 中注册和附加密钥，通过 AWS 以 Admin 角色登录。外部密钥端点在 Claude Platform on AWS 上也可用，通过 IAM 操作授权；在那里，密钥由其 KMS 密钥 ARN 而不是 ekey_ ID 标识。

前提条件

• 托管您的 Claude Platform on AWS 组织的 AWS 账户，具有创建 KMS 密钥和设置密钥策略的权限（kms:CreateKey 和 kms:PutKeyPolicy）。
• Claude Platform on AWS 的 Claude Console 中的 Admin 角色。请参阅使用 Claude Console。
• 对于您用于登录 Claude Console 的 IAM 主体：除了 aws-external-anthropic:AssumeConsole 之外，还需要您在那里执行的操作所对应的 IAM 操作，因为注册、列出和附加密钥都要经过 AWS 网关。注册密钥对应 RegisterKey（查看注册信息需要 ListKeys 和 GetKey），附加密钥对应 UpdateWorkspace 或 CreateWorkspace。外部密钥操作（以及 CreateWorkspace）是账户范围的，因此请在 Resource: "*" 上授予它们；仅限于工作区 ARN 的策略不包含它们。
• 对于将密钥附加到工作区的 IAM 主体（您登录 Claude Console 所用的身份）：密钥上的 kms:DescribeKey、kms:Encrypt 和 kms:Decrypt。附加密钥时，除了服务主体的访问权限外，还会检查您主体对密钥的访问权限。
• 可选，用于 Claude Console 中的密钥选择器：您登录所用主体的 kms:ListKeys 和 kms:DescribeKey。没有它们，请改为粘贴密钥 ARN。

创建 KMS 密钥

密钥策略包含三条语句：您账户的根管理员语句；一条允许 Claude Platform on AWS 服务主体加密、解密和生成数据密钥的语句；以及一条单独用于 kms:DescribeKey 的语句。加密语句带有一个可选的 EncryptionContext 条件，用于将密钥绑定到您列出的工作区。DescribeKey 需要单独授予，因为它没有 EncryptionContext 参数，所以在该操作上设置 EncryptionContext 条件将始终导致拒绝。

如果您计划使用此处所示的可选 EncryptionContext 条件，请先创建工作区（不使用密钥），复制其分区 ID，并用它替换 <compartment-uuid>。要在 Claude Console 中找到该 ID，请前往 Data retention 页面（platform.claude.com/settings/privacy），并从页面顶部的下拉菜单中选择工作区。该 ID 位于 Encryption key 下的 Compartment ID 字段中。您也可以从 Get Workspace 端点返回的 compartment_id 字段中读取它。如果您不打算使用该条件，请从该语句中删除 Condition 块。

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

aws kms create-key \
  --region <workspace-region> \
  --description "Anthropic CMEK (Claude Platform on AWS)" \
  --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\": \"AllowClaudePlatformOnAWSCrypto\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"Service\": \"aws-external-anthropic.amazonaws.com\"},
        \"Action\": [\"kms:Encrypt\", \"kms:Decrypt\", \"kms:GenerateDataKey\"],
        \"Resource\": \"*\",
        \"Condition\": {
          \"StringEquals\": {
            \"kms:EncryptionContext:anthropic:compartment_uuid\": [
              \"<compartment-uuid>\"
            ]
          }
        }
      },
      {
        \"Sid\": \"AllowClaudePlatformOnAWSDescribe\",
        \"Effect\": \"Allow\",
        \"Principal\": {\"Service\": \"aws-external-anthropic.amazonaws.com\"},
        \"Action\": \"kms:DescribeKey\",
        \"Resource\": \"*\"
      }
    ]
  }"

从输出中捕获 KeyMetadata.Arn。在注册密钥时您需要它。

EncryptionContext 条件是可选的。为某个工作区发起的每次加密、解密和数据密钥调用（包括附加时的检查）都会将该工作区的分区 ID 作为 anthropic:compartment_uuid 携带，因此该条件需列出您要附加密钥的每个工作区的分区 ID，且不需要全零条目。添加该条件还会在 IAM 层将密钥绑定到您列出的工作区。由于分区 ID 只有在其工作区存在后才会存在，因此顺序为：创建工作区，将其分区 ID 放入条件中（在创建密钥时，或之后通过 kms:PutKeyPolicy），然后附加密钥。在将密钥附加到每个额外的工作区之前，请以相同方式添加该工作区的分区 ID。如果要在不使用该条件的情况下开始，请从 AllowClaudePlatformOnAWSCrypto 语句中删除 Condition 块；如果之后再添加该条件，请包含该密钥已附加到的每个工作区的分区 ID。

您可以使用 aws:SourceArn 条件进一步限制这两条服务主体语句。该服务在使用您的密钥进行的每次调用中，都会将工作区的 ARN（arn:aws:aws-external-anthropic:<region>:<account-id>:workspace/<workspace-id>）作为源 ARN 传递，因此 "ArnLike": {"aws:SourceArn": "arn:aws:aws-external-anthropic:*:<account-id>:workspace/*"} 会将授权限制为您自己 AWS 账户中的工作区，而完整工作区 ARN 的列表则会将其限制为这些工作区。此条件不是必需的；仅凭 EncryptionContext 条件就能将密钥绑定到您列出的工作区。

您也可以从 AWS Console 创建密钥：在工作区的区域中，选择具有加密和解密密钥用途的对称密钥、单区域密钥和 KMS 密钥材料来源。在创建密钥向导中将密钥用途权限留空，然后打开密钥的 Key policy 选项卡，并将 JSON 替换为此处显示的策略。

注册并附加密钥

1. 1

   注册密钥

   在 Claude Console 中，前往 Data retention 页面（platform.claude.com/settings/privacy）。如果您没有看到 Encryption keys，请从页面顶部的下拉菜单中选择 Organization。在 Encryption keys 下，单击 Add key。输入显示名称，然后从密钥选择器中选择密钥，或选择 Enter ARN manually 并粘贴密钥 ARN，然后单击 Add。密钥必须位于托管您组织的 AWS 账户中；不支持跨账户密钥。选择器会列出您账户中位于您组织某个区域内的已启用、客户管理、对称、单区域密钥；对于选择器未列出的密钥，请输入 ARN。只有当您登录所用的主体可以调用 kms:ListKeys 和 kms:DescribeKey 时，选择器才会列出密钥。

2. 2

   将密钥附加到工作区

   请在向新工作区发送任何请求之前将密钥附加到该工作区。对于已在接收请求的工作区，密钥可能需要最多一天才能生效。在 Claude Console 中，前往 Data retention 页面（platform.claude.com/settings/privacy），并从页面顶部的下拉菜单中选择工作区。在 Encryption key 下，选择密钥，单击 Save 并确认。您也可以在 Claude Console 中创建工作区时选择密钥，但前提是您的密钥策略尚未指定特定工作区（没有 EncryptionContext 条件），因为工作区的分区 ID 是在创建时分配的。附加后，工作区的密钥无法更改。

   这是密钥被验证的时刻：附加调用会检查您主体对密钥的访问权限，并以工作区的分区 ID 作为加密上下文针对密钥执行一次加密/解密往返，因此密钥策略或您主体权限的问题会在该调用上显现为错误。如果附加因 KMS 访问错误而失败，请检查以下内容：

   • 密钥策略命名了 aws-external-anthropic.amazonaws.com 服务主体，并授予 kms:Encrypt、kms:Decrypt 和 kms:GenerateDataKey，以及在一条没有 EncryptionContext 条件的单独语句中的 kms:DescribeKey。
   • 任何 EncryptionContext 条件都包含此工作区的分区 ID，并且您添加的任何 aws:SourceArn 条件都与此工作区的 ARN 匹配。
   • 密钥已启用、单区域，并且与工作区位于同一 AWS 账户和区域。
   • 您登录所用的主体在密钥上具有 kms:DescribeKey、kms:Encrypt 和 kms:Decrypt。
   • 您的 AWS 组织中没有服务控制策略或资源控制策略阻止服务主体或您的主体使用密钥。
   • 如果策略看起来正确但附加仍然失败，请在密钥所在账户的 CloudTrail 中查找被拒绝的 kms: 事件（其中会显示调用主体，对于加密调用还会显示加密上下文），然后使用 kms:PutKeyPolicy 更正条件并重试。

Terraform

对于基础设施即代码部署，相同的步骤映射到带有 aws_kms_key 和 aws_kms_alias 资源的 aws 提供程序。