大网数据广告活动
Azure 身份与安全

Azure Key Vault 恢复概述

· 52CE 我爱测

Key Vault 恢复功能旨在防止意外删除或恶意删除密钥保管库以及其中存储的机密、密钥和证书。

本文介绍了 Azure Key Vault 的两项恢复功能:软删除和清除保护。 本文档概述了这两项功能,并演示了如何通过 Azure 门户、Azure CLI 和 Azure PowerShell 对其进行管理。

有关 Key Vault 的详细信息,请参阅

先决条件

  • Azure 订阅 - 免费创建订阅

  • PowerShell 模块。

  • Azure CLI

  • Key Vault - 可以使用 Azure 门户、Azure CLI 或 Azure PowerShell 进行创建

  • 用户需要在订阅级别 (以下权限,) 才能在软删除保管库中执行操作:

    权限 说明
    Microsoft.KeyVault/locations/deletedVaults/read 查看软删除的密钥保管库的属性
    Microsoft.KeyVault/locations/deletedVaults/purge/action 清除软删除的密钥保管库

什么是软删除和清除保护

软删除 和清除保护是两种不同的密钥保管库恢复功能。

Important: 启用软删除对于确保密钥保管库和凭据不被意外删除是至关重要的。 但是,启用软删除会被视为一项重大更改,因为它可能要求你更改应用程序逻辑或提供对服务主体的其他权限。 使用以下说明打开软删除之前,请确保你的应用程序与此文档的更改兼容 。

“软删除”旨在防止意外删除密钥保管库以及存储在密钥保管库中的密钥、机密以及证书。 可以将软删除视为回收站。 密钥保管库或密钥保管库对象在删除后,会在可供用户配置的保持期内或默认的 90 天内保持可恢复状态。 还可以清除处于软删除状态的密钥保管库,这意味着它们会被永久删除。 这样便可以重新创建具有相同名称的密钥保管库和密钥保管库对象。 恢复和删除密钥保管库与对象都需要提升的访问策略权限。 软删除一旦启用就无法禁用。

必须注意的是,密钥保管库名称是全局独一无二的,因此你无法创建与处于软删除状态的密钥保管库同名的密钥保管库。 类似地,密钥、机密和证书的名称在密钥保管库中是独一无二的。 你将无法使用处于软删除状态的机密、密钥或证书的名称创建另一个机密、密钥或证书。

“清除保护”旨在防止恶意内部成员删除你的密钥保管库、密钥、机密和证书。 可以将此视为一个带有基于时间的锁的回收站。 你可以在可配置的保持期内随时恢复项。 在保持期结束之前,你将无法永久删除或清除密钥保管库。 保持期结束后,系统会自动清除密钥保管库或密钥保管库对象。

Note: “清除保护”旨在使管理员角色或权限不能重写、禁用或绕过清除保护。 一旦启用清除保护,任何人(包括 Microsoft)都不能禁用或重写它。 这意味着,在重复使用密钥保管库名称之前,必须恢复已删除的密钥保管库或等待保持期结束。

有关软删除的详细信息,请参阅 Azure Key Vault 软删除概述

Azure 门户

验证是否对密钥保管库启用了软删除,并在未启用软删除的情况下将其启用

  1. 登录到 Azure 门户。
  2. 选择密钥保管库。
  3. 单击“属性”边栏选项卡。
  4. 验证软删除旁边的单选按钮是否已设置为“启用恢复”。
  5. 如果未对密钥保管库启用软删除,请单击该单选按钮以启用软删除,然后单击“保存”。

向服务主体授予清除和恢复已删除机密所需的访问权限

  1. 登录到 Azure 门户。
  2. 选择密钥保管库。
  3. 单击“访问策略”边栏选项卡。
  4. 在表中,找到要授予其访问权限的安全主体所在的行(或添加新的安全主体)。
  5. 单击密钥、证书和机密的下拉列表。
  6. 滚动到下拉列表底部,然后单击“恢复”和“清除”
  7. 安全主体还需要“获取”和“列出”功能才能执行大多数操作。

列出、恢复或清除软删除的密钥保管库

  1. 登录到 Azure 门户。
  2. 单击页面顶部的搜索栏。
  3. 在“最近使用的服务”下,单击“Key Vault”。 不要单击单个密钥保管库。
  4. 在屏幕顶部,单击“管理已删除的保管库”选项
  5. 此时会在屏幕右侧打开一个上下文窗格。
  6. 选择订阅。
  7. 如果已软删除 key vault,它将显示在右侧的上下文窗格中。
  8. 如果保管库过多,可以单击上下文窗格底部的“加载更多”,也可以使用 CLI 或 PowerShell 来获取结果。
  9. 找到要恢复或清除的保管库后,选中其旁边的复选框。
  10. 如果要恢复密钥保管库,请选择上下文窗格底部的“恢复”选项。
  11. 如果要永久删除密钥保管库,请选择“清除”选项。

列出、恢复或清除已软删除的机密、密钥和证书

  1. 登录到 Azure 门户。
  2. 选择密钥保管库。
  3. 选择与要管理的机密类型(密钥、机密或证书)对应的边栏选项卡。
  4. 在屏幕顶部,单击“管理已删除项(密钥、机密或证书)”
  5. 此时会在屏幕右侧显示一个上下文窗格。
  6. 如果机密、密钥或证书未显示在此列表中,则表明它没有处于软删除状态。
  7. 选择要管理的机密、密钥或证书。
  8. 选择上下文窗格底部用于恢复或清除的选项。

Azure CLI

Key Vault (CLI)

  • 验证密钥保管库是否已启用软删除

    az keyvault show --subscription {SUBSCRIPTION ID} -g {RESOURCE GROUP} -n {VAULT NAME}
    
  • 在密钥保管库上启用软删除

    默认情况下,所有新的密钥保管库均已启用软删除。 如果当前有未启用软删除的密钥保管库,请使用以下命令启用软删除。

    az keyvault update --subscription {SUBSCRIPTION ID} -g {RESOURCE GROUP} -n {VAULT NAME} --enable-soft-delete true
    
  • 删除密钥保管库(在启用了软删除的情况下可以恢复)

    az keyvault delete --subscription {SUBSCRIPTION ID} -g {RESOURCE GROUP} -n {VAULT NAME}
    
  • 列出所有已软删除的密钥保管库

    az keyvault list-deleted --subscription {SUBSCRIPTION ID} --resource-type vault
    
  • 恢复已软删除的密钥保管库

    az keyvault recover --subscription {SUBSCRIPTION ID} -n {VAULT NAME}
    
  • 清除已软删除的密钥保管库(警告!此操作会永久删除你的密钥保管库)

    az keyvault purge --subscription {SUBSCRIPTION ID} -n {VAULT NAME}
    
  • 对密钥保管库启用清除保护

    az keyvault update --subscription {SUBSCRIPTION ID} -g {RESOURCE GROUP} -n {VAULT NAME} --enable-purge-protection true
    

证书 (CLI)

  • 授予清除和恢复证书所需的访问权限

    az keyvault set-policy --upn user@contoso.com --subscription {SUBSCRIPTION ID} -g {RESOURCE GROUP} -n {VAULT NAME}  --certificate-permissions recover purge
    
  • 删除证书

    az keyvault certificate delete --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {CERTIFICATE NAME}
    
  • 列出已删除的证书

    az keyvault certificate list-deleted --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME}
    
  • 恢复已删除的证书

    az keyvault certificate recover --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {CERTIFICATE NAME}
    
  • 清除已软删除的证书(警告!此操作会永久删除你的证书)

    az keyvault certificate purge --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {CERTIFICATE NAME}
    

密钥 (CLI)

  • 授予清除和恢复密钥所需的访问权限

    az keyvault set-policy --upn user@contoso.com --subscription {SUBSCRIPTION ID} -g {RESOURCE GROUP} -n {VAULT NAME}  --key-permissions recover purge
    
  • 删除密钥

    az keyvault key delete --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {KEY NAME}
    
  • 列出已删除的密钥

    az keyvault key list-deleted --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME}
    
  • 恢复已删除的密钥

    az keyvault key recover --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {KEY NAME}
    
  • 清除已软删除的密钥(警告!此操作会永久删除你的密钥)

    az keyvault key purge --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {KEY NAME}
    

机密 (CLI)

  • 授予清除和恢复机密所需的访问权限

    az keyvault set-policy --upn user@contoso.com --subscription {SUBSCRIPTION ID} -g {RESOURCE GROUP} -n {VAULT NAME}  --secret-permissions recover purge
    
  • 删除机密

    az keyvault secret delete --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {SECRET NAME}
    
  • 列出已删除的机密

    az keyvault secret list-deleted --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME}
    
  • 恢复已删除的机密

    az keyvault secret recover --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {SECRET NAME}
    
  • 清除已软删除的机密(警告!此操作会永久删除你的机密)

    az keyvault secret purge --subscription {SUBSCRIPTION ID} --vault-name {VAULT NAME} --name {SECRET NAME}
    

Azure PowerShell

Key Vault (PowerShell)

  • 验证密钥保管库是否已启用软删除

    Get-AzKeyVault -VaultName "ContosoVault"
    
  • 删除密钥保管库

    Remove-AzKeyVault -VaultName 'ContosoVault'
    
  • 列出所有已软删除的密钥保管库

    Get-AzKeyVault -InRemovedState
    
  • 恢复已软删除的密钥保管库

    Undo-AzKeyVaultRemoval -VaultName ContosoVault -ResourceGroupName ContosoRG -Location westus
    
  • 清除已软删除的密钥保管库(警告!此操作会永久删除你的密钥保管库)

    Remove-AzKeyVault -VaultName ContosoVault -InRemovedState -Location westus
    
  • 对密钥保管库启用清除保护

    ($resource = Get-AzResource -ResourceId (Get-AzKeyVault -VaultName "ContosoVault").ResourceId).Properties | Add-Member -MemberType "NoteProperty" -Name "enablePurgeProtection" -Value "true"
    
    Set-AzResource -resourceid $resource.ResourceId -Properties $resource.Properties
    

证书 (PowerShell)

  • 授予恢复和清除证书所需的权限

    Set-AzKeyVaultAccessPolicy -VaultName ContosoVault -UserPrincipalName user@contoso.com -PermissionsToCertificates recover,purge
    
  • 删除证书

    Remove-AzKeyVaultCertificate -VaultName ContosoVault -Name 'MyCert'
    
  • 列出密钥保管库中所有已删除的证书

    Get-AzKeyVaultCertificate -VaultName ContosoVault -InRemovedState
    
  • 恢复处于已删除状态的证书

    Undo-AzKeyVaultCertificateRemoval -VaultName ContosoVault -Name 'MyCert'
    
  • 清除已软删除的证书(警告!此操作会永久删除你的证书)

    Remove-AzKeyVaultcertificate -VaultName ContosoVault -Name 'MyCert' -InRemovedState
    

密钥 (PowerShell)

  • 授予恢复和清除密钥所需的权限

    Set-AzKeyVaultAccessPolicy -VaultName ContosoVault -UserPrincipalName user@contoso.com -PermissionsToKeys recover,purge
    
  • 删除密钥

    Remove-AzKeyVaultKey -VaultName ContosoVault -Name 'MyKey'
    
  • 列出密钥保管库中所有已删除的证书

    Get-AzKeyVaultKey -VaultName ContosoVault -InRemovedState
    
  • 恢复已软删除的密钥

    Undo-AzKeyVaultKeyRemoval -VaultName ContosoVault -Name ContosoFirstKey
    
  • 清除已软删除的密钥(警告!此操作会永久删除你的密钥)

    Remove-AzKeyVaultKey -VaultName ContosoVault -Name ContosoFirstKey -InRemovedState
    

机密 (PowerShell)

  • 授予恢复和清除机密所需的权限

    Set-AzKeyVaultAccessPolicy -VaultName ContosoVault -UserPrincipalName user@contoso.com -PermissionsToSecrets recover,purge
    
  • 删除名为 SQLPassword 的机密

    Remove-AzKeyVaultSecret -VaultName ContosoVault -name SQLPassword
    
  • 列出密钥保管库中所有已删除的机密

    Get-AzKeyVaultSecret -VaultName ContosoVault -InRemovedState
    
  • 恢复处于已删除状态的机密

    Undo-AzKeyVaultSecretRemoval -VaultName ContosoVault -Name SQLPAssword
    
  • 清除处于已删除状态的机密(警告!此操作会永久删除你的密钥)

    Remove-AzKeyVaultSecret -VaultName ContosoVault -InRemovedState -name SQLPassword
    

后续步骤

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 msmbaldwin)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 09/30/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。