轮换并撤销客户管理的密钥

本文是由四部分构成的教程系列文章中的第三部分。 第一部分 概述了客户管理的密钥、其功能,以及在注册表上启用客户管理的密钥之前的注意事项。 第二部分介绍了如何使用 Azure CLI、Azure 门户或 Azure 资源管理器模板启用客户管理的密钥。 本文介绍如何轮换、更新和撤销客户管理的密钥。

轮换客户管理的密钥

若要轮换密钥,可以在Azure 密钥保管库或Azure 密钥保管库托管 HSM 中更新密钥版本,也可以创建新密钥。 在轮换密钥时,可以指定用于创建注册表的同一标识。

可选:

  • 配置新的用户分配的标识以访问密钥。
  • 启用并指定注册表的系统分配托管标识。

注意

若要在门户中启用注册表的系统分配的标识,请选择 “设置” “标识”,并将系统分配的标识的状态设置为 “启用”。

确保标识具有对密钥存储的必需访问权限。 有关密钥保管库,请参阅 启用托管标识以访问密钥保管库。 对于托管 HSM,请在密钥范围内分配 Managed HSM Crypto Service Encryption User 本地 RBAC 角色。

使用 Azure CLI 创建或更新密钥版本

若要在密钥保管库中创建新的密钥版本,请运行 az keyvault key create 命令:

# Create new version of existing key
az keyvault key create \
  --name <key-name> \
  --vault-name <key-vault-name>

若要在托管 HSM 中创建新的密钥版本,请使用 --hsm-name 参数:

az keyvault key create \
  --name <key-name> \
  --hsm-name <managed-hsm-name> \
  --kty RSA-HSM \
  --ops wrapKey unwrapKey

如果将注册表配置为检测密钥版本更新,则客户管理的密钥会在一小时内自动更新,无论密钥存储在 密钥保管库 还是托管 HSM 中。

如果将注册表配置为为新密钥版本手动更新,请运行 az-acr-encryption-rotate-key 命令。 传递新密钥 ID 以及你想要配置的标识。

提示

运行 az-acr-encryption-rotate-key 时,可以传递带版本的密钥 ID 或不带版本的密钥 ID。 如果使用不带版本的密钥 ID,则会将注册表配置为自动检测以后的密钥版本更新。

若要手动更新客户管理的密钥版本,可采用三种做法:

  • 轮换密钥并使用托管标识的客户端 ID。

    如果使用的是来自其他密钥保管库的密钥,请验证标识是否具有 get、wrap 和 unwrap 权限。 对于托管 HSM,请验证标识在密钥范围内是否具有 Managed HSM Crypto Service Encryption User 角色。

    az acr encryption rotate-key \
      --name <registry-name> \
      --key-encryption-key <new-key-id> \
      --identity <client ID of a managed identity>
    
  • 轮换密钥并使用用户分配的标识。

    在使用用户分配的标识之前,请验证是否为其分配了所需的密钥保管库权限或托管 HSM 本地 RBAC 角色。

    az acr encryption rotate-key \
      --name <registry-name> \
      --key-encryption-key <new-key-id> \
      --identity <id of user assigned identity>
    
  • 轮换密钥并使用系统分配的标识。

    在使用系统分配的标识之前,请验证是否为其分配了所需的密钥保管库权限或托管 HSM 本地 RBAC 角色。

    az acr encryption rotate-key \
      --name <registry-name> \
      --key-encryption-key <new-key-id> \
      --identity [system]
    

使用 Azure 门户创建或更新密钥版本

使用注册表的加密设置更新客户管理的密钥的密钥保管库或托管 HSM 密钥和标识设置。

例如,若要配置新密钥,请执行以下操作:

  1. 在门户中,转到你的注册表页。

  2. 在“设置”下,选择“加密”“更改密钥”。

    Azure 门户中加密密钥选项的屏幕截图。

  3. 在 Encryption 中,选择以下选项之一:

    • 选择 从 密钥保管库 中选择,然后选择现有的 key vault 或托管 HSM 和密钥。 选择“ 新建 ”以创建密钥保管库和密钥。 你选择的密钥不带版本,可启用自动密钥轮换。

    • 选择 输入密钥 URI,并直接提供 密钥保管库 或托管 HSM 密钥标识符。 可以提供带版本的密钥 URI(用于必须手动轮换的密钥)或不带版本的密钥 URI(启用自动密钥轮换)。

  4. 完成密钥选择,然后选择 保存。

撤销客户管理的密钥

可以通过删除注册表标识对密钥的访问权限或删除密钥来撤销客户管理的加密密钥。

撤销对密钥保管库中的密钥的访问权限

若要更改注册表使用的托管标识的访问策略,请运行 az-keyvault-delete-policy 命令:

az keyvault delete-policy \
  --resource-group <resource-group-name> \
  --name <key-vault-name> \
  --object-id <identity-principal-id>

如果key vault使用 Azure RBAC 而不是访问策略,请删除适用的密钥保管库角色分配。

撤消对托管 HSM 中密钥的访问权限

托管 HSM 不支持密钥保管库访问策略。 删除注册表标识的本地 RBAC 分配。 使用创建分配的相同范围。 以下示例删除键范围的分派:

az keyvault role assignment delete \
  --hsm-name <managed-hsm-name> \
  --role "Managed HSM Crypto Service Encryption User" \
  --assignee-object-id <identity-principal-id> \
  --scope /keys/<key-name>

在 / 或 /keys/<key-name> 创建的分配不会被指定 /keys 的命令删除。

删除加密密钥

若要从密钥保管库中删除密钥,请运行 az-keyvault-key-delete 命令。 此操作需要 keys/delete 权限。

az keyvault key delete \
  --vault-name <key-vault-name> \
  --name <key-name>

若要从托管 HSM 中删除密钥,请使用 --hsm-name 参数:

az keyvault key delete \
  --hsm-name <managed-hsm-name> \
  --name <key-name>

注意

撤销客户管理的密钥将阻止对所有 registry 数据的访问。 如果你启用访问密钥或还原已删除密钥的权限,注册表将选取该密钥,然后你可以重新获取对已加密注册表数据的访问控制权。

后续步骤

请继续阅读下一篇文章了解如何排查常见问题,例如删除托管标识时发生的错误、403 错误和意外删除密钥的问题。