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

创建和管理加密范围(预览)

· 52CE 我爱测

了解如何创建加密范围以在容器或 blob 级别隔离 blob 数据。

通过加密范围(预览),可在单个 blob 或容器级别管理加密。 加密范围将 blob 数据隔离在存储帐户内的安全 enclave 中。 可以使用加密范围在驻留在同一存储帐户中但属于不同客户的数据之间创建安全边界。 有关加密范围的详细信息,请参阅 Blob 存储(预览)的加密范围。

本文介绍如何创建加密范围。 本文还介绍如何在创建 blob 或容器时指定加密范围。

Note: 具有分层命名空间 (Azure Data Lake Storage Gen2) 的帐户尚不支持此功能。 若要了解详细信息,请参阅 Azure Data Lake Storage Gen2 中可用的 Blob 存储功能。

创建加密范围

你可以使用 Microsoft 管理的密钥或使用客户管理的密钥(存储在 Azure Key Vault 或 Azure Key Vault 托管硬件安全模型 (HSM) (preview) )来创建加密作用域。 若要使用客户托管的密钥创建加密作用域,必须先创建密钥保管库或托管 HSM,并添加要用于作用域的密钥。 Key vault 或托管 HSM 必须启用清除保护,并且必须与存储帐户位于同一区域。

创建加密范围时会自动启用它。 创建加密范围后,可以在创建 blob 时指定它。 还可以在创建容器时指定默认的加密范围,它将自动应用于容器中的所有 blob。

Portal

若要在 Azure 门户中创建加密范围,请执行以下步骤:

  1. 导航到 Azure 门户中的存储帐户。

  2. 选择“加密”设置。

  3. 选择“加密范围”选项卡。

  4. 单击“添加”按钮以添加新加密范围。

  5. 在“创建加密范围”窗格输入新范围的名称。

  6. 选择加密的类型,Microsoft 托管密钥或客户管理的密钥 。

    • 如果选择了“Microsoft 管理的密钥”,请单击“创建”以创建加密范围 。
    • 如果已选择 " 客户管理的密钥",请指定要用于此加密作用域的密钥保管库或托管 HSM、密钥和密钥版本,如下图所示。

    显示如何在 Azure 门户中创建加密范围的屏幕截图

PowerShell

要使用 PowerShell 创建加密范围,请首先安装 Az.Storage 预览模块版本。 建议使用最新的预览版本,但 1.13.4 预览版及更高版本中也支持加密范围。 删除其他版本的 Az.Storage 模块。

以下命令安装 Az.Storage 2.1.1-preview 模块:

Install-Module -Name Az.Storage -RequiredVersion 2.1.1-preview -AllowPrerelease

创建受 Microsoft 托管密钥保护的加密范围

若要创建受 Microsoft 托管密钥保护的新加密范围,请使用 -StorageEncryption 参数调用 New-AzStorageEncryptionScope 命令。

请务必将示例中的占位符值替换为你自己的值:

$rgName = "<resource-group>"
$accountName = "<storage-account>"
$scopeName1 = "customer1scope"

New-AzStorageEncryptionScope -ResourceGroupName $rgName `
    -AccountName $accountName `
    -EncryptionScopeName $scopeName1 `
    -StorageEncryption

创建由客户管理的密钥保护的加密范围

若要创建由存储在密钥保管库或托管 HSM 中的客户托管密钥保护的新加密范围,请首先为存储帐户配置客户管理的密钥。 必须将托管标识分配给存储帐户,然后使用托管标识为密钥保管库或托管 HSM 配置访问策略,以便存储帐户有权访问它。

若要配置客户管理的密钥以便与加密作用域一起使用,必须在密钥保管库或托管 HSM 上启用清除保护。 密钥保管库或托管 HSM 必须位于存储帐户所在的同一区域。

请务必将示例中的占位符值替换为你自己的值:

$rgName = "<resource-group>"
$accountName = "<storage-account>"
$keyVaultName = "<key-vault>"
$keyUri = "<key-uri-with-version>"
$scopeName2 = "customer2scope"


# Assign a system managed identity to the storage account.
$storageAccount = Set-AzStorageAccount -ResourceGroupName $rgName `
    -Name $accountName `
    -AssignIdentity

# Configure the access policy for the key vault.
Set-AzKeyVaultAccessPolicy `
    -VaultName $keyVaultName `
    -ObjectId $storageAccount.Identity.PrincipalId `
    -PermissionsToKeys wrapkey,unwrapkey,get

接下来,使用 -KeyvaultEncryption 参数调用 New-AzStorageEncryptionScope 命令,并指定密钥 URI。 请确保在密钥 URI 上包括密钥版本。 请务必将示例中的占位符值替换为你自己的值:

New-AzStorageEncryptionScope -ResourceGroupName $rgName `
    -AccountName $accountName `
    -EncryptionScopeName $scopeName2 `
    -KeyUri $keyUri `
    -KeyvaultEncryption

Azure CLI

若要使用 Azure CLI 创建加密范围,请先安装 Azure CLI 2.4.0 或更高版本。

创建受 Microsoft 托管密钥保护的加密范围

若要创建受 Microsoft 托管密钥保护的新加密范围,请调用 az storage account encryption-scope create 命令,并将 --key-source 参数指定为 Microsoft.Storage。 请务必将占位符值替换为你自己的值:

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

创建由客户管理的密钥保护的加密范围

若要创建受 Microsoft 托管密钥保护的新加密范围,请调用 az storage account encryption-scope create 命令,并将 --key-source 参数指定为 Microsoft.Storage。 请务必将占位符值替换为你自己的值:

若要在密钥保管库或托管 HSM 中创建受客户管理的密钥保护的新加密范围,请首先为存储帐户配置客户管理的密钥。 必须为存储帐户分配一个托管标识,然后使用该托管标识配置密钥保管库的访问策略,使存储帐户有权访问该密钥保管库。 有关详细信息,请参阅用于 Azure 存储加密的客户管理的密钥。

若要配置客户管理的密钥以便与加密作用域一起使用,必须在密钥保管库或托管 HSM 上启用清除保护。 密钥保管库或托管 HSM 必须位于存储帐户所在的同一区域。

请务必将示例中的占位符值替换为你自己的值:

az login
az account set --subscription <subscription-id>

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

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

接下来,使用 --key-uri 参数调用 az storage account encryption-scope create 命令,并指定密钥 URI。 请确保在密钥 URI 上包括密钥版本。 请务必将示例中的占位符值替换为你自己的值:

az storage account encryption-scope create \
    --resource-group <resource-group> \
    --account-name <storage-account> \
    --name <scope> \
    --key-source Microsoft.KeyVault \
    --key-uri <key-uri>

若要了解如何使用密钥保管库中的客户管理的密钥来配置 Azure 存储加密,请参阅使用 Azure Key Vault 中存储的客户管理的密钥配置加密。 若要在托管 HSM 中配置客户管理的密钥,请参阅 使用 Azure Key Vault 托管 hsm (预览版) 中存储的客户托管密钥配置加密 。

列出存储帐户的加密范围

Portal

若要在 Azure 门户中查看存储帐户的加密范围,请导航到该存储帐户的“加密范围”设置。 在此窗格中,你可以启用或禁用加密范围,或者更改加密范围的密钥。

PowerShell

若要使用 PowerShell 列出存储帐户可用的加密范围,请调用 Get-AzStorageEncryptionScope 命令。 请务必将示例中的占位符值替换为你自己的值:

Get-AzStorageEncryptionScope -ResourceGroupName $rgName `
    -StorageAccountName $accountName

若要按存储帐户列出资源组中的所有加密范围,请使用管道语法:

Get-AzStorageAccount -ResourceGroupName $rgName | Get-AzStorageEncryptionScope

Azure CLI

若要列出可用于 Azure CLI 的存储帐户的加密范围,请调用 az storage account encryption-scope list 命令。 请务必将示例中的占位符值替换为你自己的值:

az storage account encryption-scope list \
    --account-name <storage-account> \
    --resource-group <resource-group>

创建具有默认加密范围的容器

创建容器时,可以指定默认的加密范围。 默认情况下,该容器中的 blob 将使用该范围。

除非容器配置为要求所有 blob 使用其默认范围,否则可以使用其自己的加密范围创建单个 blob。

Portal

若要在 Azure 门户中创建具有默认加密范围的容器,请先创建加密范围,如创建加密范围中所述。 接下来,请按照以下步骤创建容器:

  1. 导航到存储帐户中的容器列表,然后选择“添加”按钮创建一个新容器。

  2. 在“新容器”窗格中展开“高级”设置 。

  3. 在“加密范围”下拉列表中,为容器选择默认的加密范围。

  4. 若要要求容器中的所有 blob 使用默认加密范围,请选中“对容器中的所有 blob 使用此加密范围”的复选框。 如果选中此复选框,则容器中的单个 blob 无法重写默认的加密范围。

    显示具有默认加密范围的容器的屏幕截图

PowerShell

要使用 PowerShell 创建具有默认加密范围的容器,请调用 New-AzRmStorageContainer 命令,并指定 -DefaultEncryptionScope 参数的范围。 New-AzRmStorageContainer 命令使用 Azure 存储资源提供程序创建一个容器,使用该容器可配置加密范围和其他资源管理操作。

若要强制容器中的所有 blob 使用容器的默认范围,请将 -PreventEncryptionScopeOverride 参数设置为 true。

$containerName1 = "container1"
$containerName2 = "container2"

# Create a container with a default encryption scope that cannot be overridden.
New-AzRmStorageContainer -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -Name $containerName1 `
    -DefaultEncryptionScope $scopeName1 `
    -PreventEncryptionScopeOverride $true

Azure CLI

若要使用 Azure CLI 创建具有默认加密范围的容器,请调用 az storage container create 命令,并指定 --default-encryption-scope 参数的范围。 若要强制容器中的所有 blob 使用容器的默认范围,请将 --prevent-encryption-scope-override 参数设置为 true。

下面的示例使用 Azure AD 帐户授权操作创建容器。 还可以使用帐户访问密钥。 有关详细信息,请参阅使用 Azure CLI 授权访问 blob 或队列数据。

az storage container create \
    --account-name <storage-account> \
    --resource-group <resource-group> \
    --name <container> \
    --default-encryption-scope <scope> \
    --prevent-encryption-scope-override true \
    --auth-mode login

如果客户端在将 blob 上传到具有默认加密范围的容器时尝试指定范围,并且容器配置为阻止 blob 重写默认范围,则操作将失败,并显示一条消息,指示容器加密策略禁止该请求。

上传具有加密范围的 blob

上传 blob 时,可以指定该 blob 的加密范围,或者使用容器的默认加密范围(如果已指定)。

Portal

若要上传具有 Azure 门户中指定的加密范围的 blob,请首先按照创建加密范围中所述创建加密范围。 接下来,请按照以下步骤创建 blob:

  1. 导航到要将 blob 上传到的容器。

  2. 选择“上传”按钮,然后找到要上传的 blob。

  3. 在“上传 blob”窗格中展开“高级”设置 。

  4. 找到“加密范围”下拉部分。 默认情况下,将使用容器的默认加密范围(如果已指定)创建 blob。 如果容器要求 blob 使用默认加密范围,则禁用此部分。

  5. 若要为要上传的 blob 指定其他范围,请选择“选择现有范围”,然后从下拉列表中选择所需的范围。

    显示如何上传具有加密范围的 blob 的屏幕截图

PowerShell

若要上传使用 PowerShell 指定加密范围的 blob,请调用 Set-AzStorageBlobContent 命令并提供该 blob 的加密范围。

$containerName2 = "container2"
$localSrcFile = "C:\temp\helloworld.txt"
$ctx = (Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $accountName).Context

# Create a new container with no default scope defined.
New-AzStorageContainer -Name $containerName2 -Context $ctx
# Upload a block upload with an encryption scope specified.
Set-AzStorageBlobContent -Context $ctx -Container $containerName2 -File $localSrcFile -Blob "helloworld.txt" -BlobType Block -EncryptionScope $scopeName2

Azure CLI

若要上传使用 Azure CLI 指定加密范围的 blob,请调用 az storage blob upload 命令并提供该 blob 的加密范围。

如果使用 Azure Cloud Shell,请按照 上传 blob 中所述的步骤在根目录中创建文件。 然后,可以使用以下示例将此文件上传到 blob。

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --file <file> \
    --name <file> \
    --encryption-scope <scope>

更改范围的加密密钥

若要将保护加密作用域的密钥从 Microsoft 托管的密钥更改为客户托管的密钥,请首先确保已启用客户管理的密钥,Azure Key Vault 或 Key Vault HSM 用于存储帐户。 有关详细信息,请参阅使用 Azure Key Vault 中存储的客户管理的密钥配置加密或使用 Azure Key Vault 中存储的客户管理的密钥配置加密。

Portal

若要更改保护 Azure 门户范围的密钥,请执行以下步骤:

  1. 导航到“加密范围”选项卡,查看存储帐户的加密范围列表。
  2. 选择要修改的范围旁边的“更多”按钮。
  3. 在“编辑加密范围”窗格中,可以将加密类型从 Microsoft 托管密钥更改为客户管理的密钥,反之亦然。
  4. 要选择新的客户管理的密钥,请选择“使用新密钥”并指定密钥保管库、密钥和密钥版本。

PowerShell

若要使用 PowerShell 将保护加密范围的密钥从客户管理的密钥更改为 Microsoft 托管密钥,请调用 Update-AzStorageEncryptionScope 命令并传入 -StorageEncryption 参数:

Update-AzStorageEncryptionScope -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -EncryptionScopeName $scopeName2 `
    -StorageEncryption

接下来,调用 Update-AzStorageEncryptionScope 命令并传入 -KeyUri 和 -KeyvaultEncryption 参数:

Update-AzStorageEncryptionScope -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -EncryptionScopeName $scopeName1 `
    -KeyUri $keyUri `
    -KeyvaultEncryption

Azure CLI

若要使用 Azure CLI 将保护加密范围的密钥从客户管理的密钥更改为 Microsoft 托管密钥,请调用 az storage account encryption-scope update 命令并传入值为 Microsoft.Storage 的 --key-source 参数:

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

接下来,调用 az storage account encryption-scope update 命令,传入 --key-uri 参数,并传入值为 Microsoft.KeyVault 的 --key-source 参数:

az storage account encryption-scope update \
    --resource-group <resource-group> \
    --account-name <storage-account> \
    --name <scope> \
    --key-source Microsoft.KeyVault \
    --key-uri <key-uri>

禁用加密范围

禁用加密范围后,将不再为此付费。 禁用不需要的任何加密范围以避免不必要的费用。 有关详细信息,请参阅静态数据的 Azure 存储加密。

Portal

若要在 Azure 门户中禁用加密范围,请导航到该存储帐户的“加密范围”设置,选择所需的加密范围,然后选择“禁用” 。

PowerShell

若要使用 PowerShell 禁用加密范围,请调用 Update-AzStorageEncryptionScope 命令,并包括值为 disabled 的 -State 参数,如以下示例中所示。 若要重新启用加密范围,请调用相同的命令,并将 -State 参数设置为 enabled。 请务必将示例中的占位符值替换为你自己的值:

Update-AzStorageEncryptionScope -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -EncryptionScopeName $scopeName1 `
    -State disabled

Azure CLI

若要使用 Azure CLI 禁用加密范围,请调用 az storage account encryption-scope update 命令,并包括值为 Disabled 的 --state 参数,如以下示例中所示。 若要重新启用加密范围,请调用相同的命令,并将 --state 参数设置为 Enabled。 请务必将示例中的占位符值替换为你自己的值:

az storage account encryption-scope update \
    --account-name <storage-account> \
    --resource-group <resource-group> \
    --name <scope> \
    --state Disabled

后续步骤

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

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

资料来源与适用范围

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

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

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