客户管理的加密密钥

claude "/claude-api tell me about customer-managed encryption keys"

"Customer-managed encryption key"（客户管理的加密密钥），即 CMEK，允许您在自己的 AWS KMS、Google Cloud KMS 或 Azure Key Vault 中配置加密密钥，并让 Anthropic 使用该密钥对特定工作区的静态数据进行加密。您保留对密钥的完全控制权，包括轮换、审计和撤销，并且 Anthropic 对您的密钥执行的密钥操作会记录在您的云服务提供商的审计日志中。

使用 CMEK 是可选的。符合条件的组织可以选择启用客户管理的加密密钥，以替代 Anthropic 提供的默认加密。如需激活 CMEK，请联系您的 Anthropic 客户团队。



工作原理

只有管理员可以配置 CMEK。在 Claude Platform 上，CMEK 的作用范围为每个工作区，并通过 Admin API 进行配置。在 Claude Enterprise 上，CMEK 的作用范围为每个组织，并在 claude.ai > Organization settings > Data and privacy 中进行配置。在这两种产品中，CMEK 均保护在密钥启用后写入的数据。现有数据（之前的聊天、文件和会话）仍使用 Anthropic 管理的密钥进行加密，不会使用您的密钥重新加密。

CMEK 管理员配置事件会显示在 Compliance API Activity Feed 中。Anthropic 对您的密钥执行的密钥操作（例如包装和解包数据密钥）不会显示在 Compliance API 中，而是显示在您的云服务提供商的审计日志中。

Anthropic 从其标准公共 IP 范围调用您的密钥管理服务。如果您按 IP 限制对密钥管理服务的访问，请允许 IP 地址中列出的地址。



前提条件

• 在将托管加密密钥的账户、项目或订阅中拥有云管理员访问权限。
• 在您的 Anthropic 组织中拥有管理员角色：在 Claude Platform 上需要 Claude Console 中的 Organization Admin 角色，或在 Claude Enterprise 上需要 Owner 或 Primary Owner 角色。
• 您的产品所需的数据保留配置：
  • Claude Platform： 为您的组织关闭零数据保留（ZDR）。已签订 ZDR 协议的组织可以改为至少为一个工作区开启 30 天数据保留；请参阅特定模型的数据保留要求。您只能将密钥附加到已启用数据保留的工作区。
  • Claude Enterprise： 为您的组织关闭 ZDR。



可用性和区域

CMEK 目前仅在美国区域可用，所有加密操作均在美国区域处理。目前尚不支持多区域密钥和欧盟密钥驻留。

在 Claude Platform on AWS 上，CMEK 仅支持 AWS KMS 密钥；无法注册 Google Cloud KMS 和 Azure Key Vault 密钥。请在 Claude Console 中创建、验证和附加密钥；external_keys API 端点目前在 Claude Platform on AWS 上不可用。密钥必须与其所附加的工作区位于同一 AWS 区域。

为了最大限度地降低延迟，请选择靠近 Anthropic 美国基础设施的区域：



CMEK 保护的内容

CMEK 涵盖的内容取决于您使用的产品。



加密的内容

Claude Platform

• 消息内容、文件和附件（包括随请求发送的内联附件和 Files API 上传的文件），以及 MCP 和工具配置。

Claude Enterprise

• 聊天内容，包括技能、插件和 Artifacts。
• 聊天附件和项目附件。
• CLI 上的 Claude Code，包括消息内容。
• Claude Desktop 中的 Cowork。
• Office 智能体。

在这两种产品中，备份和快照均继承该密钥。



禁用或修改的功能

启用 CMEK 后，某些功能会被关闭或发生重大修改。此列表并非详尽无遗；在启用 CMEK 之前，请与您的团队一起审阅。

Claude Platform

• Claude Console 中的 Workbench 被禁用。
• Compliance API 中返回原始内容（例如提示、响应和文件）的部分被禁用。
• 测试版和研究预览功能可能不受 CMEK 保护。这包括 Claude Managed Agents，这是一项整体被禁用的测试版功能，包括智能体记忆和智能体梦境。

Claude Enterprise

• 对话历史搜索被禁用。对话标题已加密，因此按标题或内容搜索不会返回任何结果。
• 跨大量文件的搜索速度变慢。
• Analytics API 和产品内分析功能降级。某些使用情况视图和报告可能不完整。
• 审计日志导出被禁用。
• 用于临时文件交换的签名 URL 被禁用。这些 URL 支持 claude.ai 管理员数据导出和 Claude Code Remote 文件流程（例如屏幕截图更新）。
• 对于属于受 CMEK 保护的组织的用户，个人偏好设置在同一父级下的所有组织中均被禁用。不属于受 CMEK 保护的组织的用户仍可在所有组织中使用个人偏好设置。



未加密的内容

这些功能仍然可用，但其数据不会使用您的密钥进行加密。您可以在"设置"中禁用任何不适合您使用场景的功能。

Claude Platform

• 非静态数据（例如缓存）以及 TTL 短于 24 小时的数据。
• Activity Feed、审计日志和遥测网络流量（例如 OTEL），以便客户即使在密钥被撤销后也能保持合规性。

Claude Enterprise

• Claude Code Desktop、网页版 Claude Code 和 Claude for Slack。Anthropic 建议在管理控制台中禁用任何不适合您使用场景的功能。
• 测试版和研究预览功能可能不受 CMEK 保护，并可能在 CMEK 组织中出现故障，例如 Claude Security 和 Claude Design。
• "设置 > 隐私"下的按需数据导出。

在这两种产品中，您组织中用户的账户数据（例如姓名、电子邮件地址和个人资料图片）不会使用您的密钥进行加密。



功能支持

启用 CMEK 后，以下 Claude Platform API 和工具会使用您的密钥存储静态数据：



密钥之外的有限保留

在三种特定情况下，Anthropic 可能会在 Anthropic 管理的加密下保留特定记录：

• Anthropic 依法必须保留记录的情况（例如，根据 18 U.S.C. § 2258A 向 NCMEC 报告的材料）。
• 存在严重伤害的紧急风险（例如，CBRNE 武器开发、攻击性网络攻击或迫在眉睫的暴力威胁）。
• 违反 Anthropic 商业服务条款第 D.4 节或客户与 Anthropic 签订的其他适用协议中的同等条款。

除 CSAM 筛查外，保留需要人工审核员的明确决定，并遵循 Anthropic 的商业数据保留政策。对于每次保留实例，都会生成相应的 Compliance API Activity Feed 事件，并附带说明保留目的的原因代码。有关详细信息，请参阅 CMEK 内容保留。安全筛查元数据（源自 Anthropic 自动安全扫描的记录，例如模式标识符和匹配指示符，而非对话内容）在 Anthropic 管理的加密下保留，并在密钥撤销后仍可读取。



限制

• 不可逆操作： 一旦密钥附加到工作区，就无法分离或更换。在 Claude Platform 上，附加密钥还会锁定该工作区的数据保留设置：您无法关闭该工作区的 30 天数据保留，如需恢复零数据保留，则需要创建新的工作区并将流量迁移到新工作区。在同一密钥内轮换密钥材料（例如，AWS KMS 自动轮换、Cloud KMS 轮换计划或 Azure Key Vault 轮换策略）是透明支持的，无需在 Anthropic 中进行任何更改。切换到不同的密钥需要使用新密钥创建新的工作区并迁移您的数据。撤销或禁用密钥会使该工作区中所有受 CMEK 保护的数据永久无法访问，且没有回退路径。
• 无追溯加密： CMEK 仅保护在密钥启用后写入的数据。
• 延迟： 包装或解包数据密钥的操作需要往返调用您的密钥管理服务，这可能会为读取或写入静态数据的操作增加少量延迟。
• 撤销延迟： 密钥撤销最多可能需要一小时（缓存 TTL）。在此窗口期内已在处理中的请求可能会继续成功。
• KMS 成本： CMEK 需要在第三方密钥管理服务（AWS KMS、Google Cloud KMS 或 Azure Key Vault）中拥有密钥，这可能会产生由您的 KMS 提供商单独计费的费用。



配置您的提供商

请按照您所使用的密钥管理服务的指南进行操作。