客户管理的加密密钥

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 客户团队。



工作原理

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

CMEK 配置事件会出现在 Compliance API 活动源中。Anthropic 对您的密钥执行的密钥操作（例如包装和解包数据密钥）不会出现在 Compliance API 中；它们会出现在您的云提供商的审计日志中。

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



前提条件

• 在将托管加密密钥的账户、项目或订阅中创建加密密钥和管理密钥访问的权限。
• 在 Claude Platform 上拥有 Claude Console 中的组织管理员角色，或在 Claude Enterprise 上拥有所有者或主要所有者角色。
• 数据保留配置：对于 Claude Platform 和 Claude Enterprise，CMEK 都允许与零数据保留（ZDR）一起使用。



可用性和区域

CMEK 目前仅在美国区域可用，所有加密操作都在美国区域处理。

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

为了最小化延迟，请选择靠近 Anthropic 美国基础设施的区域：



CMEK 保护的内容

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



已加密

Claude Platform

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

Claude Enterprise

• 聊天内容，包括技能、插件和 artifacts。
• 聊天附件和项目附件。
• CLI 上的 Claude Code，包括消息内容。
• Claude Desktop 中的 Cowork。
• Office 代理。
• Claude in Chrome。

在这两种产品上，备份和快照都会继承该密钥。



已禁用或已修改

启用 CMEK 后，某些功能会被关闭或大幅修改。此列表并不详尽；请在启用 CMEK 之前与您的团队一起审查。

Claude Platform

• Claude Console 中的 Workbench 被禁用。
• Compliance API 中返回原始内容（例如提示、响应和文件）的部分被禁用。
• Beta 和研究预览功能可能不在 CMEK 的覆盖范围内。这包括 Claude Managed Agents，这是一项整体被禁用的 beta 功能，包括代理记忆和代理梦境。

Claude Enterprise

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



未加密

这些功能仍然可用，但其数据不会在您的密钥下加密。您可以在设置中禁用任何不适合您用例的功能。

Claude Platform

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

Claude Enterprise

• Claude Code Desktop、网页版 Claude Code 和 Claude in Slack。Anthropic 建议在管理控制台中禁用其中任何不适合您用例的功能。
• Beta 和研究预览功能可能不在 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 活动源事件，其中包含传达保留目的的原因代码。有关详细信息，请参阅 CMEK 内容保留。安全筛查元数据（源自 Anthropic 自动安全扫描的记录，例如模式标识符和匹配指示符，而非对话内容）在 Anthropic 管理的加密下保留，并在密钥撤销后仍可读取。



限制

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



配置您的提供商

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