使用 Azure Key Vault 设置 CMEK

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

让 Claude Code 为您设置此功能

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

开始之前

在 Claude 中:

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

在 Azure 中:

  • 您可以在密钥保管库中创建密钥,并在其上分配 RBAC 角色。
  • 您可以在 Entra 租户中创建服务主体(Application Administrator、Cloud Application Administrator 或同等的自定义角色)。
  • 保管库已为 AuditEvent 日志类别配置诊断设置。如果没有该设置,Anthropic 对您的密钥执行的操作将不会留下任何审计记录。

在 Azure 中:创建密钥

如果验证或添加失败,请参阅 Azure Key Vault 的修复方法。

以下步骤会授予 Anthropic 的多租户应用程序对您的密钥的访问权限:

  • 名称: anthropic-cmek-client-us
  • 客户端 ID: 8635ae1a-3e5d-44e8-a4ed-e0f614466f87

请仅使用此客户端 ID 和名称,切勿使用通过电子邮件或聊天发送给您的客户端 ID 或名称。该应用程序不请求任何 Microsoft Graph 权限。

检查保管库

为获得最低延迟,请使用位于 northcentralus 或 eastus2 的保管库。首先在 Azure CLI 或 Cloud Shell 中运行以下命令:

示例代码
az keyvault show --name <your-vault-name> \
  --query "{rbac:properties.enableRbacAuthorization, purge:properties.enablePurgeProtection, pub:properties.publicNetworkAccess, net:properties.networkAcls.defaultAction, ipRules:properties.networkAcls.ipRules, uri:properties.vaultUri, tenantId:properties.tenantId}"
字段必须为
rbactrue
purgetrue。如果为 false 或 null,请先启用清除保护。启用后无法再次关闭。
pub"Enabled"。不支持专用终结点。
net"Allow",或 "Deny" 且 ipRules 中包含 Anthropic 的出站 IP 地址

复制 uri(保管库 URI)和 tenantId。

创建密钥并授予访问权限

在本页中,<ORGANIZATION_UUID> 是小写形式的您的 Anthropic 组织 ID。如需使用您已有的密钥,请先添加组织标签。

Azure 门户

创建 Anthropic 的服务主体

从门户的顶部导航栏打开 Cloud Shell。运行以下命令:

示例代码
az ad sp create --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87

如果该服务主体已存在,请继续执行下一步。

确认服务主体存在

前往 Microsoft Entra ID > Enterprise applications,并清除默认的应用程序类型筛选器。搜索 anthropic-cmek-client-us。

anthropic-cmek-client-us 的 Microsoft Entra 企业应用程序概览,显示其 Application ID 和 Object ID。

打开 Create a key 页面

打开您的密钥保管库并选择 Keys。点击 Generate/Import。

在您的保管库中创建 RSA 密钥

设置以下值:

  • Name: 密钥的名称
  • Key type: RSA
  • RSA key size: 3072 或更大

点击 Tags 旁边的链接。

添加组织标签

输入以下值:

  • Tag Name: anthropic-org-<ORGANIZATION_UUID>
  • Tag Value: true

点击 OK,然后点击 Create。

Azure Key Vault 的 Create a key 页面,显示 RSA、3072 密钥大小,以及设置为 true 的 anthropic-org 标签。

限制允许的操作

打开新密钥,然后打开其当前版本。在 Permitted operations 下,清除除 Wrap Key 和 Unwrap Key 之外的所有复选框。点击 Save。

Azure Key Vault 密钥版本,带有 1 个标签,且 Permitted operations 仅限 Wrap Key 和 Unwrap Key。

打开密钥的访问控制

打开密钥本身,而不是保管库。选择其 Access control (IAM) 选项卡,然后点击 Add > Add role assignment。

选择角色

在 Role 选项卡上,选择 Key Vault Crypto User。点击 Next。

添加 Anthropic 的服务主体

在 Members 选项卡上,点击 Select members。搜索 anthropic-cmek-client-us 并选择它。点击 Select,然后点击 Next。

审阅并分配

在 Review + assign 选项卡上,点击 Review + assign。

Azure CLI

创建 Anthropic 的服务主体

示例代码
az ad sp create --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87

从输出中复制 id 字段。

如果命令因 “already exists” 错误而退出,请改用以下命令获取 id:

示例代码
az ad sp show --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87 --query id -o tsv

在您的保管库中创建 RSA 密钥

示例代码
az keyvault key create \
  --vault-name <your-vault-name> \
  --name <your-key-name> \
  --kty RSA --size 3072 \
  --ops wrapKey unwrapKey \
  --tags anthropic-org-<ORGANIZATION_UUID>=true

替换占位符:

  • <your-vault-name>: 您的密钥保管库的名称
  • <your-key-name>: 密钥的名称
  • <ORGANIZATION_UUID>: 小写形式的您的 Anthropic 组织 ID

如需使用 HSM 支持的密钥,请使用 --kty RSA-HSM。

授予 Anthropic 服务主体对您的密钥的访问权限

示例代码
VAULT_ID=$(az keyvault show --name <your-vault-name> --query id -o tsv)

az role assignment create \
  --role "Key Vault Crypto User" \
  --assignee-object-id <sp-object-id> \
  --assignee-principal-type ServicePrincipal \
  --scope "${VAULT_ID}/keys/<your-key-name>"

替换占位符:

  • <your-vault-name>: 您的密钥保管库的名称
  • <sp-object-id>: 第一步中的 id 值
  • <your-key-name>: 密钥的名称

在 Claude 中添加密钥的人员需要保管库 URI、密钥名称和租户 ID。

为您已有的密钥添加组织标签

如果没有组织标签,验证将会失败。密钥必须是 RSA 类型,且大小为 3072 位或更大。

无需创建新密钥,而是在 Azure CLI 或 Cloud Shell 中运行以下命令。该命令会将密钥限制为 wrapKey 和 unwrapKey。它还会覆盖当前版本的标签,因此请将您想保留的所有标签以 name=value 形式列在 --tags 中。

示例代码
az keyvault key set-attributes \
  --vault-name <your-vault-name> \
  --name <your-key-name> \
  --ops wrapKey unwrapKey \
  --tags anthropic-org-<ORGANIZATION_UUID>=true

您仍然需要完成服务主体和角色分配步骤。

在 Claude 中:添加并附加密钥

如需在 Claude Platform 上通过脚本完成这一部分,请改为使用 Admin API。

Claude Platform

打开加密密钥设置

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

添加密钥

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

输入密钥详细信息

检查您的密钥是否带有对话框中显示的组织标签。输入 Vault URI、密钥名称和租户 ID,将客户端 ID 留空,然后点击添加。

验证密钥

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

将密钥附加到工作区

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

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

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

Claude Enterprise

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

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

打开加密密钥设置

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

添加密钥

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

输入密钥详细信息

检查您的密钥是否带有对话框中显示的组织标签。输入 Vault URI、密钥名称和租户 ID,将客户端 ID 留空,然后点击添加。

确认已添加密钥

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

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

文档内容持续同步更新