创建并存储 Always Encrypted 的列主密钥

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例

列主密钥是“始终加密”功能中使用的保护密钥的密钥,用于对列加密密钥进行加密。 列主密钥必须存储在受信任的密钥存储,并且这些密钥可供需要加密或解密数据的应用程序以及用于配置“始终加密”和管理“始终加密”密钥的工具访问。

本文详细介绍了选择密钥存储和为“始终加密”创建列主密钥。 有关详细概述,请参阅 Always Encrypted 密钥管理概述。

为你的列主密钥选择密钥存储

“始终加密”支持将“始终加密”列主密钥存储在多个密钥存储区中。 受支持的密钥存储因你使用的驱动程序和版本而异。

将考虑两种高级别密钥存储 - 本地密钥存储和集中式密钥存储。

本地密钥存储还是集中式密钥存储?

  • 本地密钥存储 - 仅供包含本地密钥存储的计算机上的应用程序使用。 换而言之,需要将密钥存储和密钥复制到运行你的应用程序的每台计算机。 本地密钥存储的一个示例为 Windows 证书存储。 使用本地密钥存储时,需要确保密钥存储存在于托管应用程序的每台计算机上,并且计算机中包含应用程序访问使用“始终加密”功能保护的数据所需的列主密钥。 当你第一次预配列主密钥,或者当你更改(轮换)密钥时,需要确保密钥部署到托管你的应用程序的所有计算机。

  • 集中式密钥存储 - 为多台计算机上的应用程序服务。 集中式密钥存储的一个示例是 Azure 密钥保管库。 集中式密钥存储通常使密钥管理更简单,因为你无需维护多台计算机上的列主密钥的多个副本。 确保将应用程序配置为连接到集中式密钥存储。

启用了“始终加密”的客户端驱动程序支持哪些密钥存储?

启用“始终加密”功能的客户端驱动程序为内置了对将“始终加密”功能集成到客户端应用程序的支持的 SQL Server 客户端驱动程序。 启用 Always Encrypted 的驱动程序包括几个常用密钥存储的内置提供者。 通过某些驱动程序,你还可以实施和注册自定义的列主密钥存储提供程序,这样即使没有内置的提供程序,你也可以使用任何密钥存储。 在决定使用内置提供者还是自定义提供者时,考虑如果使用内置提供者则通常意味着对应用程序的更改很少(在某些情况下,只需要更改数据库连接字符串)。

可用的内置提供者取决于选择哪些驱动程序、驱动程序版本和操作系统。 请参阅特定驱动程序的 Always Encrypted 文档来确定哪些现成的密钥存储受支持,以及驱动程序是否支持自定义的密钥存储提供程序 - 使用 Always Encrypted 开发应用程序。

SQL 工具支持哪些密钥存储?

SQL Server Management Studio、适用于 Visual Studio Code 的 MSSQL 扩展和 SQL Server PowerShell 模块支持存储在以下项中的列主密钥:

  • Azure 密钥保管库 中的密钥保管库和 托管 HSM。

    注意

    托管 HSM 需要 SSMS 18.9 或更高版本和 SqlServer PowerShell 模块版本 21.1.18235 或更高版本。 Visual Studio Code 目前不支持托管 HSM。

  • Windows 证书存储区。

  • 密钥存储(例如硬件安全模块),可提供新一代加密 (CNG) API 或加密 API (CAPI)。

在 Windows 证书存储中创建列主密钥

列主密钥可以是存储在 Windows 证书存储中的证书。 启用 Always Encrypted 的驱动程序不会验证到期日期或证书颁发机构链。 证书仅用作包含公钥和私钥的密钥对。

要成为有效的列主密钥,证书必须满足以下条件:

  • 是 X.509 证书。
  • 存储在以下两个证书存储位置之一:本地计算机或当前用户。 (若要在本地计算机证书存储位置中创建证书,必须是目标计算机上的管理员。)
  • 包含私钥(证书中密钥的推荐长度为 2048 位或更高)。
  • 为密钥交换而创建。

可以有多种方法来创建作为有效的列主密钥的证书,但最简单方法是创建自签名证书。

使用 PowerShell 创建自签名证书

使用 New-SelfSignedCertificate cmdlet 创建自签名证书。 以下示例演示如何生成可以用作“始终加密”功能的列主密钥的证书。

# New-SelfSignedCertificate is a Windows PowerShell cmdlet that creates a self-signed certificate. The below examples show how to generate a certificate that can be used as a column master key for Always Encrypted.
$cert = New-SelfSignedCertificate -Subject "AlwaysEncryptedCert" -CertStoreLocation Cert:CurrentUser\My -KeyExportPolicy Exportable -Type DocumentEncryptionCert -KeyUsage KeyEncipherment -KeySpec KeyExchange -KeyLength 2048 

# To create a certificate in the local machine certificate store location you need to run the cmdlet as an administrator.
$cert = New-SelfSignedCertificate -Subject "AlwaysEncryptedCert" -CertStoreLocation Cert:LocalMachine\My -KeyExportPolicy Exportable -Type DocumentEncryptionCert -KeyUsage KeyEncipherment -KeySpec KeyExchange -KeyLength 2048

使用 SQL Server Management Studio (SSMS) 创建自签名证书

有关详细信息,请参阅使用 SQL Server Management Studio 预配 Always Encrypted 密钥。 有关使用 SSMS 并将 Always Encrypted 密钥存储在 Windows 证书存储中的分步教程,请参阅 Always Encrypted Wizard tutorial (Windows Certificate Store)。

向应用程序和用户提供证书

如果列主密钥是存储在本地计算机证书存储位置的一个证书,你需要导出包含私钥的证书并将其导入到托管应用程序(预期要加密或解密存储在加密列中的数据)的所有计算机,或用于配置“始终加密”功能和管理“始终加密”密钥的工具。 此外,每个用户必须被授予本地计算机证书存储位置中存储的证书的读取权限,以便能够使用该证书作为列主密钥。

如果列主密钥是存储在当前用户证书存储位置的一个证书,你需要导出包含私钥的证书并将其导入到运行应用程序(预期要加密或解密存储在加密列中的数据)的所有用户帐户的当前用户证书存储位置,或用于配置“始终加密”功能和管理“始终加密”密钥(包含这些应用程序/工具的所有计算机上的密钥)的工具。 无需任何权限配置 - 登录计算机后,用户可以访问其当前用户证书存储位置的所有证书。

使用 PowerShell

使用 Import-PfxCertificate 和 Export-PfxCertificate cmdlet 导入和导出证书。

使用 Microsoft 管理控制台

若要向用户授予存储在本地计算机证书存储位置的证书的读取权限,请执行以下步骤:

  1. 打开命令提示符,并键入 mmc。
  2. 在 MMC 控制台的“文件”菜单上,单击“添加/删除管理单元”。
  3. 在“添加/删除管理单元”对话框中,单击“添加”。
  4. 在“添加独立管理单元”对话框中,单击“证书”,再单击“添加”。
  5. 在“证书”管理单元对话框中,单击“计算机帐户”,再单击“完成”。
  6. 在“添加独立管理单元”对话框中,单击“关闭”。
  7. 在“添加/删除管理单元”对话框中,单击“确定”。
  8. 在 证书管理单元中,在 证书>个人 文件夹中找到该证书,右键单击该证书,指向 所有任务,然后单击 管理私钥。
  9. 在“安全”对话框中,根据需要添加用户帐户的读取权限。

在 Azure 密钥保管库 中创建列主密钥

Azure 密钥保管库 有助于保护加密密钥和机密,可方便地用于存储 Always Encrypted 的列主密钥,尤其是当你的应用程序在 Azure 中托管时。 若要在 Azure 密钥保管库中创建密钥,需要有 Azure 订阅 和 Azure 密钥保管库。 密钥可以存储在密钥保管库中,也可以存储在托管 HSM 中。 若要成为有效的列主密钥,Azure 密钥保管库 中托管的密钥必须是 RSA 密钥。

使用 Azure CLI、Azure portal 或 PowerShell

有关如何在密钥保管库中创建密钥的信息,请参阅:

有关如何在托管 HSM 中创建密钥的信息,请参阅:

SQL Server Management Studio (SSMS)

有关如何使用 SSMS 在 Azure 密钥保管库 中的密钥保管库或托管 HSM 中创建列主密钥的详细信息,请参阅使用 SQL Server Management Studio 预配 Always Encrypted 密钥。 有关使用 SSMS 并将 Always Encrypted 密钥存储在密钥保管库中的分步教程,请参阅 Always Encrypted 向导教程 (Azure 密钥保管库)。

使 Azure 密钥保管库 密钥可供应用程序和用户使用

若要访问加密列,应用程序需要能够访问 Azure 密钥保管库,而且它还需要对列主密钥具有特定权限,以对保护该列的列加密密钥进行解密。

若要管理 Always Encrypted 的密钥,你需要有权在 Azure 密钥保管库 中列出和创建列主密钥,以及使用密钥执行加密操作。

Key Vault

如果要将列主密钥存储在密钥保管库中,并且使用角色权限进行授权:

  • 应用程序的标识所属的角色需要允许对密钥保管库执行以下数据平面操作:

    • Microsoft.KeyVault/vaults/keys/decrypt/action
    • Microsoft.KeyVault/vaults/keys/read
    • Microsoft.KeyVault/vaults/keys/verify/action

    向应用程序授予所需权限的最简单方法是将其标识添加到密钥保管库加密用户角色。 还可以创建具有所需权限的自定义角色。

  • 管理 Always Encrypted 密钥的用户需要属于允许对密钥保管库执行以下数据平面操作的角色:

    • Microsoft.KeyVault/vaults/keys/create/action
    • Microsoft.KeyVault/vaults/keys/decrypt/action
    • Microsoft.KeyVault/vaults/keys/encrypt/action
    • Microsoft.KeyVault/vaults/keys/read
    • Microsoft.KeyVault/vaults/keys/sign/action
    • Microsoft.KeyVault/vaults/keys/verify/action

    向用户授予所需权限的最简单方法是将用户添加到密钥保管库加密用户角色。 还可以创建具有所需权限的自定义角色。

如果您将列主密钥存储在密钥保管库中,并且使用访问策略进行授权:

  • 应用程序的标识需要在密钥保管库上具有以下访问策略权限:get、unwrapKey 和 verify。
  • 管理 Always Encrypted 密钥的用户需要在密钥保管库上具有以下访问策略权限:create、get、list、sign、unwrapKey、wrapKey、verify。

有关如何为密钥保管库配置身份验证和授权的常规信息,请参阅授权安全主体访问 密钥保管库。

托管式硬件安全模块

应用程序的标识需要属于允许对托管 HSM 执行以下数据平面操作的角色:

  • Microsoft.KeyVault/managedHsm/keys/decrypt/action
  • Microsoft.KeyVault/managedHsm/keys/read/action
  • Microsoft.KeyVault/managedHsm/keys/verify/action

Microsoft 建议创建一个仅包含上述权限的自定义角色。

管理 Always Encrypted 密钥的用户需要属于允许对密钥执行以下数据平面操作的角色:

  • Microsoft.KeyVault/managedHsm/keys/create/action
  • Microsoft.KeyVault/managedHsm/keys/decrypt/action
  • Microsoft.KeyVault/managedHsm/keys/encrypt/action
  • Microsoft.KeyVault/managedHsm/keys/read
  • Microsoft.KeyVault/managedHsm/keys/sign/action
  • Microsoft.KeyVault/managedHsm/keys/verify/action

向用户授予上述权限的最简单方法是将用户添加到托管 HSM 加密用户角色。 还可以创建具有所需权限的自定义角色。

有关托管 HSM 的访问控制的详细信息,请参阅:

利用CNG在硬件安全模块中创建列主密钥

Always Encrypted 功能的列主密钥可以存储在实现下一代加密技术 (CNG) API 的密钥存储中。 通常,这种类型的存储是一种硬件安全模块 (HSM)。 HSM 是一种保护并管理数字密钥,以及提供加密处理的物理设备。 HSM 通常以插件卡或外部设备的形式直接连接到一台计算机(本地 HSM)或网络服务器。

若要使 HSM 可用于指定计算机上的应用程序,必须在该计算机上安装并配置实现 CNG 的密钥存储提供者 (KSP)。 Always Encrypted 客户端驱动程序(即驱动程序中的列主密钥存储提供程序)使用 KSP 对由存储在密钥存储中的列主密钥保护的列加密密钥进行加密和解密。

Windows 包括 Microsoft 软件密钥存储提供者 - 可用于测试目的的基于软件的 KSP。 请参阅 《CNG Key Storage Providers》(CNG 密钥存储提供者)。

使用 CNG 或 KSP 在密钥存储中创建列主密钥

列主密钥应为使用 RSA 算法的非对称密钥(公钥/私钥对)。 建议的密钥长度为 2048 或更高。

使用HSM专用工具配合CNG

请参阅您的 HSM 文档。

使用 PowerShell 配合 CNG

可以通过 .NET API 使用 PowerShell 中的 CNG 在密钥存储中创建密钥。

$cngProviderName = "Microsoft Software Key Storage Provider" # If you have an HSM, you can use a KSP for your HSM instead of a Microsoft KSP
$cngAlgorithmName = "RSA"
$cngKeySize = 2048 # Recommended key size for Always Encrypted column master keys
$cngKeyName = "AlwaysEncryptedKey" # Name identifying your new key in the KSP
$cngProvider = New-Object System.Security.Cryptography.CngProvider($cngProviderName)
$cngKeyParams = New-Object System.Security.Cryptography.CngKeyCreationParameters
$cngKeyParams.provider = $cngProvider
$cngKeyParams.KeyCreationOptions = [System.Security.Cryptography.CngKeyCreationOptions]::OverwriteExistingKey
$keySizeProperty = New-Object System.Security.Cryptography.CngProperty("Length", [System.BitConverter]::GetBytes($cngKeySize), [System.Security.Cryptography.CngPropertyOptions]::None);
$cngKeyParams.Parameters.Add($keySizeProperty)
$cngAlgorithm = New-Object System.Security.Cryptography.CngAlgorithm($cngAlgorithmName)
$cngKey = [System.Security.Cryptography.CngKey]::Create($cngAlgorithm, $cngKeyName, $cngKeyParams)

使用 SQL Server Management Studio

请参阅使用 SQL Server Management Studio 预配 Always Encrypted 密钥。

让 CNG 密钥向应用和用户开放

请参阅 HSM 和 KSP 文档,了解如何在计算机上配置 KSP,以及如何向应用程序和用户授予访问 HSM 的权限。

利用 CAPI 在硬件安全模块中创建列主密钥

“始终加密”功能的列主密钥可以存储在实现加密 API (CAPI) 的密钥存储中。 通常,此类存储是一种硬件安全模块 (HSM) - 一种保护并管理数字密钥,以及提供加密处理的物理设备。 HSM 通常以插件卡或外部设备的形式直接连接到一台计算机(本地 HSM)或网络服务器。

若要使 HSM 可用于指定计算机上的应用程序,必须在该计算机上安装并配置实现 CAPI 的加密服务提供程序 (CSP)。 始终加密客户端驱动程序(即驱动程序内部的列主密钥存储提供程序)使用 CSP 对受存储在密钥存储中的列主密钥保护的列加密密钥进行加密和解密。

注意

CAPI 是一个旧的、已弃用的 API。 如果 HSM 可以使用 KSP,则应使用它,而不是 CSP/CAPI。

CSP 必须支持要用于“始终加密”功能的 RSA 算法。

Windows 包含以下基于软件的(不受 HSM 支持)支持 RSA 且可用于测试的 CSP:Microsoft 增强 RSA 和 AES 加密提供程序。

使用 CAPI 或 CSP 在密钥存储中创建列主密钥

列主密钥应为使用 RSA 算法的非对称密钥(公钥/私钥对)。 建议的密钥长度为 2048 或更高。

使用 HSM 专用工具配合 CAPI

请参阅您的 HSM 文档。

使用 SQL Server Management Studio (SSMS)

请参阅使用 SQL Server Management Studio 预配 Always Encrypted 密钥。

让应用程序和用户能够获得CAPI密钥

请参阅 HSM 和 CSP 的相关文档,了解如何在计算机上配置 CSP,以及如何向应用程序和用户授予访问 HSM 的权限。