排查客户管理的密钥问题

本文是由四部分构成的教程系列文章中的第四部分。 第一部分 概述了客户管理的密钥、其功能和注意事项,然后再在注册表上启用一个密钥。 第二部分介绍了如何使用 Azure CLI、Azure 门户或 Azure 资源管理器模板启用客户管理的密钥。 第三部分介绍如何轮换、更新、撤销客户管理的密钥。 本文帮助你排查和解决客户管理的密钥的常见问题。

移除托管标识时出错

如果你尝试移除用户分配的托管标识或系统分配的托管标识(用于为注册表配置加密),则可能会看到错误:

Azure resource '/subscriptions/xxxx/resourcegroups/myGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry' does not have access to identity 'xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx' Try forcibly adding the identity to the registry <registry name>. For more information on bring your own key, please visit 'https://docs.azure.cn/container-registry/container-registry-customer-managed-keys'.

无法更改(轮换)加密密钥。 解决步骤取决于用于加密的标识类型。

移除用户分配的标识

如果尝试移除用户分配的标识时收到错误,请执行以下步骤:

  1. 使用 az acr identity assign 命令重新分配用户分配的标识。

  2. 传递用户分配的标识的资源 ID,或在标识与注册表位于同一资源组中时使用该标识的名称。

    例如:

    az acr identity assign -n myRegistry \
       --identities "/subscriptions/mysubscription/resourcegroups/myresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity"
    
  3. 更改密钥并分配其他标识。

  4. 现在,可以删除原始的用户分配标识。

移除系统分配的托管标识

如果尝试移除系统分配的标识时收到错误,请创建 Azure 支持票证以帮助还原标识。

启用密钥存储防火墙后出错

如果在创建加密注册表后启用 密钥保管库 或托管 HSM 防火墙、虚拟网络或专用终结点,则可能会在映像导入或自动密钥轮换时看到 HTTP 403 或其他错误。 确保密钥存储的网络配置允许Azure 容器注册表访问密钥。 有关托管 HSM 网络选项,请参阅 托管 HSM 的网络安全性。

如果Azure 容器注册表可以访问托管 HSM,但门户密钥选取器无法列出密钥,请确保客户端位于配置的网络边界内,或使用 Enter key URI。 受信任的服务旁路不会通过托管 HSM 防火墙授予门户客户端访问权限。

更正网络配置后,重新配置最初用于加密的托管标识和密钥。 请参阅轮换客户管理的密钥中的步骤。

如果问题持续出现,请联系 Azure Support。

使用托管 HSM 密钥时出错

如果在托管 HSM 中存储加密密钥时注册表创建、密钥轮换或映像操作失败,请检查以下要求:

  • 已预配并激活托管 HSM。 在激活完成之前,数据平面操作(包括密钥创建和角色分配)不可用。

  • 密钥是支持 wrapKey 和 unwrapKey 操作的 RSA-HSM 键。

  • 注册表的托管标识具有 Managed HSM Crypto Service Encryption User 本地 RBAC 角色。 为实现最小权限原则,请在 /keys/<key-name> 处分配角色。

  • 密钥 URI 使用 HTTPS 并具有格式 https://<managed-hsm-name>.<managed-hsm-dns-suffix>/keys/<key-name> 或 https://<managed-hsm-name>.<managed-hsm-dns-suffix>/keys/<key-name>/<version>。

  • URI 标识密钥。 不支持机密、证书或其他托管 HSM 对象路径的 URI。

若要验证特定密钥的角色分配,请运行:

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

托管 HSM 本地 RBAC 更改可能需要几分钟才能传播。 如果角色分配正确,但验证仍然失败,请等待传播并重试注册表操作。

身份过期错误

附加到注册表的标识设置为自动更新以避免过期。 如果取消标识与注册表的关联,则会出现一条错误消息,说明不能删除用于 CMK 的标识。 尝试删除标识会危及标识的自动续订。 在标识过期(通常为三个月)前,构件拉取/推送操作都一直可以正常运行。 标识过期后,你会看到 HTTP 403,以及错误消息“与注册表关联的标识处于非活动状态。” 这可能是由于尝试了删除标识。 请手动重新分配身份。

必须显式将标识重新分配回容器注册表。

  1. 运行 az acr identity assign 命令以手动重新分配标识。

    • 例如,
    az acr identity assign -n myRegistry \
    --identities "/subscriptions/mysubscription/resourcegroups/myresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity"
    

意外删除密钥存储或密钥

删除密钥保管库或托管 HSM 资源,或用于加密注册表的密钥,使注册表的内容不可访问。 如果在密钥保管库中启用 软删除 ,则可以恢复已删除的保管库或密钥保管库对象并恢复注册表操作。 托管 HSM 还支持软删除恢复,但在处于软删除状态时,它仍会产生费用。

Azure Policy 对客户管理密钥注册表的补救失败

具有“修改”效果的Azure Policy分配(例如,内置策略Configure container registries to disable ARM audience token authentication.)无法自动修正使用客户管理的密钥加密的注册表。 修正任务失败,注册表仍不合规。 修正部署报告了一个类似于以下内容的 BadRequest 错误:

Invalid encryption key vault property specified for registry <registry-name>. Property Identity and KeyIdentifier must be set when encryption is enabled. For more information on customer-managed keys, please visit 'https://docs.azure.cn/container-registry/container-registry-customer-managed-keys'.

此错误是一个已知限制:当前不支持在使用客户管理的密钥加密的注册表上进行自动 Modify 修复。 重新提交注册表配置时,修正无法保留受保护的密钥保管库设置,因此注册表会因上述错误而拒绝该更新并保持不合规状态。

若要使注册表符合要求,请设置策略直接针对的属性,而不是依赖自动修正。 设置属性只会更改一个设置,并使加密配置保持不变,因此注册表接受更新。 使用与要修正的策略对应的命令。

对于 Configure container registries to disable ARM audience token authentication. 策略,请运行:

az acr config authentication-as-arm update \
    -r myregistry \
    --resource-group myResourceGroup \
    --status disabled

运行命令后,触发策略符合性扫描或等待下一次评估。 然后,注册表将报告为合规。 自动修正任务可能仍显示使用客户管理的密钥加密的注册表的 “失败 ”状态。 直接设置属性后,该状态不会影响注册表的合规性。

后续步骤

有关删除和恢复方案,请参阅: