大网数据广告活动
Azure 存储与备份

使用存储在 Azure Key Vault 中的客户管理的密钥配置加密

· 52CE 我爱测

了解如何使用 Azure 门户、PowerShell 或 Azure CLI,通过存储在 Azure Key Vault 中的客户管理的密钥配置 Azure 存储加密。

Azure 存储对静态存储帐户中的所有数据进行加密。 默认情况下,数据使用 Microsoft 管理的密钥进行加密。 为了更进一步控制加密密钥,你可以管理自己的密钥。 客户托管的密钥必须存储在 Azure Key Vault 或 Key Vault 托管硬件安全模型 (HSM) (预览版) 中。

本文介绍了如何使用 Azure 门户、PowerShell 或 Azure CLI,通过存储在密钥保管库中的客户管理的密钥配置加密。 若要了解如何使用托管 HSM 中存储的客户托管密钥配置加密,请参阅 使用 Azure Key Vault 托管 hsm (preview) 中存储的客户托管密钥配置加密 。

Note: Azure Key Vault 和 Azure Key Vault 托管 HSM 支持相同的 Api 和管理接口进行配置。

配置密钥保管库

你可以使用新的或现有的密钥保管库来存储客户管理的密钥。 存储帐户和 Key Vault 必须在同一个区域中,但可以在不同的订阅中。

使用带有 Azure 存储加密的客户管理的密钥需要为密钥保管库启用软删除和清除保护。 创建新密钥保管库时,默认会启用软删除,并且无法禁用。 你可以在创建密钥保管库时或创建后启用清除保护。

Azure 门户

若要了解如何使用 Azure 门户创建密钥保管库,请参阅快速入门:使用 Azure 门户创建密钥保管库。 创建密钥保管库时,选择“启用清除保护”,如下图所示。

若要在现有密钥保管库上启用清除保护,请执行以下步骤:

  1. 在 Azure 门户中导航到密钥保管库。
  2. 在“设置”下面,选择“属性”。
  3. 在“清除保护”部分,选择“启用清除保护” 。

PowerShell

若要使用 PowerShell 创建新密钥保管库,请安装 Az. KeyVault PowerShell 模块的版本 2.0.0 或更高版本。 然后调用 New-AzKeyVault 来创建新密钥保管库。 在 Az.KeyVault 模块的版本 2.0.0 和更高版本中,当创建新密钥保管库时,默认会启用软删除。

以下示例将创建一个启用了软删除和清除保护的新密钥保管库。 请记得将括号中的占位符值替换为你自己的值。

$keyVault = New-AzKeyVault -Name <key-vault> `
    -ResourceGroupName <resource_group> `
    -Location <location> `
    -EnablePurgeProtection

若要了解如何使用 PowerShell 在现有密钥保管库上启用清除保护,请参阅如何在 PowerShell 中使用软删除。

接下来,向存储帐户分配系统分配的托管标识。 将使用此托管标识授予存储帐户访问 Key Vault 的权限。 有关系统分配的托管标识的详细信息,请参阅什么是 Azure 资源托管标识?。

若要使用 PowerShell 分配托管标识,请调用 Set-AzStorageAccount:

$storageAccount = Set-AzStorageAccount -ResourceGroupName <resource_group> `
    -Name <storage-account> `
    -AssignIdentity

最后,配置密钥保管库的访问策略,使存储帐户有权访问密钥保管库。 此步骤使用前面分配给存储帐户的托管标识。

若要设置密钥保管库的访问策略,请调用 Set-AzKeyVaultAccessPolicy:

Set-AzKeyVaultAccessPolicy `
    -VaultName $keyVault.VaultName `
    -ObjectId $storageAccount.Identity.PrincipalId `
    -PermissionsToKeys wrapkey,unwrapkey,get

Azure CLI

若要使用 Azure CLI 创建新的 Key Vault,请调用 az keyvault create。 请记得将括号中的占位符值替换为你自己的值:

az keyvault create \
    --name <key-vault> \
    --resource-group <resource_group> \
    --location <region> \
    --enable-purge-protection

若要了解如何使用 Azure CLI 在现有密钥保管库上启用清除保护,请参阅如何在 Azure CLI 中使用软删除。

接下来,向存储帐户分配系统分配的托管标识。 将使用此托管标识授予存储帐户访问 Key Vault 的权限。 有关系统分配的托管标识的详细信息,请参阅什么是 Azure 资源托管标识?。

若要使用 Azure CLI 分配托管标识,请调用 az storage account update:

az storage account update \
    --name <storage-account> \
    --resource-group <resource_group> \
    --assign-identity

最后,配置密钥保管库的访问策略,使存储帐户有权访问密钥保管库。 此步骤使用前面分配给存储帐户的托管标识。

若要设置密钥保管库的访问策略,请调用 az keyvault set-policy:

storage_account_principal=$(az storage account show \
    --name <storage-account> \
    --resource-group <resource-group> \
    --query identity.principalId \
    --output tsv)
az keyvault set-policy \
    --name <key-vault> \
    --resource-group <resource_group>
    --object-id $storage_account_principal \
    --key-permissions get unwrapKey wrapKey

添加密钥

接下来,在密钥保管库中添加密钥。

Azure 存储加密支持2048、3072和4096大小的 RSA 和 RSA-HSM 密钥。 有关密钥的详细信息,请参阅关于密钥。

Azure 门户

若要了解如何使用 Azure 门户添加密钥,请参阅快速入门:使用 Azure 门户在 Azure Key Vault 中设置和检索密钥中的说明创建密钥保管库。

PowerShell

若要使用 PowerShell 添加密钥,请调用 Add-AzKeyVaultKey。 请记得将括号中的占位符值替换为自己的值,并使用前面示例中定义的变量。

$key = Add-AzKeyVaultKey -VaultName $keyVault.VaultName `
    -Name <key> `
    -Destination 'Software'

Azure CLI

若要使用 Azure CLI 添加密钥,请调用 az keyvault key create。 请记得将括号中的占位符值替换为你自己的值。

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

配置使用客户管理的密钥进行加密

接下来,请将 Azure 存储帐户配置为通过 Azure Key Vault 使用客户管理的密钥,然后指定要与存储帐户关联的密钥。

使用客户管理的密钥配置加密时,只要关联的密钥保管库中有新版本可用,就可以选择自动更新用于 Azure 存储加密的密钥版本。 也可显式指定在手动更新密钥版本之前用于加密的密钥版本。

Note: 若要轮换密钥,请在 Azure Key Vault 中创建密钥的新版本。 Azure 存储不会处理 Azure Key Vault 中的密钥轮换,因此你需要手动轮换密钥,或创建一个函数以便按计划轮换密钥。

配置加密以自动更新密钥版本

Azure 存储可以自动更新客户管理的密钥(用于加密),以使用最新密钥版本。 当在 Azure Key Vault 中轮换客户管理的密钥时,Azure 存储会自动开始将最新版本的密钥用于加密。

Azure 门户

若要在 Azure 门户中配置客户管理的密钥并自动更新密钥版本,请执行以下步骤:

  1. 导航到存储帐户。

  2. 在存储帐户的“设置”边栏选项卡上,单击“加密”。 默认情况下,密钥管理设置为 Microsoft 托管密钥,如下图所示。

    显示加密选项的门户屏幕截图

  3. 选择 " 客户托管密钥 " 选项。

  4. 选择“从 Key Vault 中选择”选项。

  5. 选择“选择密钥保管库和密钥”。

  6. 选择包含要使用的密钥的密钥保管库。

  7. 从密钥保管库中选择密钥。

    屏幕截图,显示如何选择密钥保管库和密钥

  8. 保存所做更改。

指定密钥后,Azure 门户会指示启用密钥版本的自动更新,并显示当前用于加密的密钥版本。

PowerShell

若要使用 PowerShell 配置客户管理的密钥并自动更新密钥版本,请安装 Az.Storage 模块 2.0.0 版或更高版本。

若要自动更新客户管理密钥的密钥版本,请在使用客户管理的密钥为存储帐户配置加密时省略密钥版本。 调用 AzStorageAccount 以更新存储帐户的加密设置(如以下示例所示),并包含 -KeyvaultEncryption 选项,以便为存储帐户启用客户管理的密钥。

请记得将括号中的占位符值替换为自己的值,并使用前面示例中定义的变量。

Set-AzStorageAccount -ResourceGroupName $storageAccount.ResourceGroupName `
    -AccountName $storageAccount.StorageAccountName `
    -KeyvaultEncryption `
    -KeyName $key.Name `
    -KeyVaultUri $keyVault.VaultUri

Azure CLI

若要使用 Azure CLI 配置客户管理的密钥并自动更新密钥版本,请安装 Azure CLI 2.4.0 版本或更高版本。 有关详细信息,请参阅安装 Azure CLI。

若要自动更新客户管理的密钥的密钥版本,请在使用存储帐户的客户管理的密钥配置加密时省略密钥版本。 请调用 az storage account update,以便更新存储帐户的加密设置,如以下示例所示。 包括 --encryption-key-source 参数并将其设置为 Microsoft.Keyvault 即可为帐户启用客户管理的密钥。

请记得将括号中的占位符值替换为你自己的值。

key_vault_uri=$(az keyvault show \
    --name <key-vault> \
    --resource-group <resource_group> \
    --query properties.vaultUri \
    --output tsv)
az storage account update
    --name <storage-account> \
    --resource-group <resource_group> \
    --encryption-key-name <key> \
    --encryption-key-source Microsoft.Keyvault \
    --encryption-key-vault $key_vault_uri

为手动更新密钥版本配置加密

如果希望手动更新密钥版本,请在使用客户管理的密钥配置加密时显式指定该版本。 在这种情况下,当在密钥库中创建新版本时,Azure 存储将不会自动更新密钥版本。若要使用新的密钥版本,必须手动更新用于 Azure 存储加密的版本。

Azure 门户

若要在 Azure 门户中配置客户管理的密钥并手动更新密钥版本,请指定密钥 URI,包括版本。 若要将某个密钥指定为 URI,请执行下列步骤:

  1. 若要在 Azure 门户中查找密钥 URI,请导航到 Key Vault,然后选择“密钥”设置。 选择所需的密钥,然后单击该密钥以查看其版本。 选择一个密钥版本,查看该版本的设置。

  2. 复制“密钥标识符”字段的值(提供 URI)。

    显示 Key Vault 密钥 URI 的屏幕截图

  3. 在存储帐户的“加密密钥”设置中,选择“输入密钥 URI”选项。

  4. 将复制的 URI 粘贴到“密钥 URI”字段中。 从 URI 中省略密钥版本,以启用自动更新密钥版本。

    显示如何输入密钥 URI 的屏幕截图

  5. 指定包含密钥保管库的订阅。

  6. 保存所做更改。

PowerShell

若要配置客户管理的密钥并手动更新密钥版本,请在为存储帐户配置加密时显式提供密钥版本。 调用 AzStorageAccount 以更新存储帐户的加密设置(如以下示例所示),并包含 -KeyvaultEncryption 选项,以便为存储帐户启用客户管理的密钥。

请记得将括号中的占位符值替换为自己的值,并使用前面示例中定义的变量。

Set-AzStorageAccount -ResourceGroupName $storageAccount.ResourceGroupName `
    -AccountName $storageAccount.StorageAccountName `
    -KeyvaultEncryption `
    -KeyName $key.Name `
    -KeyVersion $key.Version `
    -KeyVaultUri $keyVault.VaultUri

手动更新密钥版本时,需要更新存储帐户的加密设置以使用新版本。 首先调用 Get-AzKeyVaultKey 以获取最新密钥版本。 然后调用 Set-AzStorageAccount 来更新存储帐户的加密设置,以使用该密钥的新版本,如前面示例所示。

Azure CLI

若要配置客户管理的密钥并手动更新密钥版本,请在为存储帐户配置加密时显式提供密钥版本。 请调用 az storage account update,以便更新存储帐户的加密设置,如以下示例所示。 包括 --encryption-key-source 参数并将其设置为 Microsoft.Keyvault 即可为帐户启用客户管理的密钥。

请记得将括号中的占位符值替换为你自己的值。

key_vault_uri=$(az keyvault show \
    --name <key-vault> \
    --resource-group <resource_group> \
    --query properties.vaultUri \
    --output tsv)
key_version=$(az keyvault key list-versions \
    --name <key> \
    --vault-name <key-vault> \
    --query [-1].kid \
    --output tsv | cut -d '/' -f 6)
az storage account update
    --name <storage-account> \
    --resource-group <resource_group> \
    --encryption-key-name <key> \
    --encryption-key-version $key_version \
    --encryption-key-source Microsoft.Keyvault \
    --encryption-key-vault $key_vault_uri

手动更新密钥版本时,需要更新存储帐户的加密设置以使用新版本。 首先,通过调用 az keyvault show 查询 Key Vault URI,并通过调用 az keyvault key list-versions 查询密钥版本。 然后调用 az storage account update 来更新存储帐户的加密设置,以使用新的密钥版本,如上一示例所示。


更改密钥

你可以在任何时候更改用于 Azure 存储加密的密钥。

Azure 门户

若要使用 Azure 门户更改密钥,请执行以下步骤:

  1. 导航到你的存储帐户,并显示“加密”设置。
  2. 选择密钥保管库并选择一个新密钥。
  3. 保存更改。

PowerShell

若要使用 PowerShell 更改密钥,请调用 Set-AzStorageAccount(如使用客户管理的密钥配置加密中所示),并提供新的密钥名称和版本。 如果新密钥位于不同的密钥保管库中,则还必须更新密钥保管库 URI。

Azure CLI

若要使用 Azure CLI 更改密钥,请调用 az storage account update(如使用客户托管密钥配置加密中所示),并提供新的密钥名称和版本。 如果新密钥位于不同的密钥保管库中,则还必须更新密钥保管库 URI。


撤销客户托管密钥

撤消客户管理的密钥会删除存储帐户和密钥保管库之间的关联。

Azure 门户

若要使用 Azure 门户撤消客户管理的密钥,请按照禁用客户管理的密钥中所述禁用该密钥。

PowerShell

可以通过删除密钥保管库访问策略来撤销客户管理的密钥。 若要使用 PowerShell 撤销客户托管密钥,请调用 Remove-AzKeyVaultAccessPolicy 命令,如下例所示。 请记得将括号中的占位符值替换为自己的值,并使用前面示例中定义的变量。

Remove-AzKeyVaultAccessPolicy -VaultName $keyVault.VaultName `
    -ObjectId $storageAccount.Identity.PrincipalId `

Azure CLI

可以通过删除密钥保管库访问策略来撤销客户管理的密钥。 若要使用 Azure CLI 撤销客户托管密钥,请调用 az keyvault delete-policy 命令,如下例所示。 请记得将括号中的占位符值替换为自己的值,并使用前面示例中定义的变量。

az keyvault delete-policy \
    --name <key-vault> \
    --object-id $storage_account_principal

禁用客户托管密钥

禁用客户托管密钥时,将再次使用 Microsoft 托管密钥对存储帐户进行加密。

Azure 门户

若要在 Azure 门户中禁用客户管理的密钥,请执行以下步骤:

  1. 导航到你的存储帐户,并显示“加密”设置。
  2. 取消选中“使用自己的密钥”设置旁边的复选框。

PowerShell

若要使用 PowerShell 禁用客户管理的密钥,请使用 -StorageEncryption 选项调用 Set-AzStorageAccount,如下例所示。 请记得将括号中的占位符值替换为自己的值,并使用前面示例中定义的变量。

Set-AzStorageAccount -ResourceGroupName $storageAccount.ResourceGroupName `
    -AccountName $storageAccount.StorageAccountName `
    -StorageEncryption  

Azure CLI

若要使用 Azure CLI 禁用客户托管密钥,请调用 az storage account update 并将 --encryption-key-source parameter 设置为 Microsoft.Storage,如下例所示。 请记得将括号中的占位符值替换为自己的值,并使用前面示例中定义的变量。

az storage account update
    --name <storage-account> \
    --resource-group <resource_group> \
    --encryption-key-source Microsoft.Storage

后续步骤

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

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

资料来源与适用范围

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

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

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