使用 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}"
| 字段 | 必须为 |
|---|---|
rbac | true |
purge | true。如果为 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。

打开 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。

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

打开密钥的访问控制
打开密钥本身,而不是保管库。选择其 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 故障排除。
将密钥附加到工作区
- 在数据保留页面顶部,从下拉菜单中选择工作区。
- 在加密密钥下,选择密钥并点击保存。
- 选中复选框以确认您已阅读 CMEK 文档,然后点击确认。
您会看到工作区设置已更新。 一旦您的密钥生效,您的云服务提供商的审计日志中就会显示 Anthropic 对您的密钥的调用。
在 ZDR 组织中,选择工作区后,请选择标准数据保留,以便显示加密密钥。点击保存后,在数据保留条款上点击接受。
Claude Enterprise
在 Claude Enterprise 上,CMEK 适用于整个组织,并且您只能添加一个密钥。
添加密钥会为每位用户关闭或更改某些功能。如需先试用 CMEK,请使用单独的组织。
打开加密密钥设置
前往 claude.ai > 组织设置 > 数据与隐私,找到加密密钥。
添加密钥
点击添加密钥。输入显示名称并选择 Azure Key Vault。勾选复选框以确认您已阅读 CMEK 文档,然后点击继续。
输入密钥详细信息
检查您的密钥是否带有对话框中显示的组织标签。输入 Vault URI、密钥名称和租户 ID,将客户端 ID 留空,然后点击添加。
确认已添加密钥
检查最多可能需要 30 秒。当出现已配置加密密钥。 时,点击完成。如果改为出现无法添加加密密钥。,请查找原因并重试。
您的密钥保护从那时起写入的数据。请告知您的用户哪些功能发生了变化。