排查具有安全 enclave 的 Always Encrypted 的常见问题

适用于:Windows Azure SQL 数据库上的 SQL Server 2019 (15.x) 及更高版本

本文介绍如何识别并解决在使用带有安全区域的 Always Encrypted 运行 Transact-SQL (TSQL) 语句时可能遇到的常见问题。

若要详细了解如何使用安全 enclave 运行查询,请参阅使用安全 enclave 运行 Transact-SQL 语句。

数据库连接错误

要使用安全 Enclave 运行语句,需要启用 Always Encrypted 并为数据库连接指定证明协议和证明 URL(如适用),详见 运行使用安全 Enclave 的语句的先决条件。 但如果指定了证明协议,但 Azure SQL 数据库或目标 SQL Server 实例中的数据库不支持安全 Enclave 或配置有误,则连接将失败。

使用 Microsoft Azure 证明服务时发生的证明错误

注意

本节仅适用于具有 Intel SGX Enclave 的 Azure SQL 数据库。

在客户端驱动程序向 Azure SQL 逻辑服务器提交 T-SQL 语句以供执行之前,驱动程序会使用 Microsoft Azure 证明触发以下 enclave 证明工作流。

  1. 客户端驱动程序将数据库连接中指定的证明 URL 传递给 Azure SQL 逻辑服务器。
  2. Azure SQL 逻辑服务器收集有关 enclave 及其承载环境以及 enclave 内运行的代码的证据。 然后,服务器将证明请求发送给证明 URL 中引用的证明提供程序。
  3. 证明提供程序根据配置的策略验证证据,并为 Azure SQL 逻辑服务器颁发证明令牌。 证明提供程序使用其私钥对证明令牌进行签名。
  4. Azure SQL 逻辑服务器将证明令牌发送到客户端驱动程序。
  5. 客户端通过指定的证明 URL 与证明提供程序联系以检索其公钥,并验证证明令牌中的签名。

由于配置错误,上述工作流的各个步骤均可能发生错误。 常见的证明错误、相应的根本原因以及建议的故障排除步骤如下:

  • Azure SQL 逻辑服务器无法连接到证明 URL 指定的 Azure 证明中的证明提供程序(上述工作流的步骤 2)。 可能的原因包括:
    • 证明 URL 不正确或不完整。 有关详细信息,请参阅确定证明策略的证明 URL。
    • 已意外删除证明提供程序。
    • 已为证明提供程序配置了防火墙,但该防火墙不允许访问 Microsoft 服务。
    • 间歇性网络错误导致证明提供程序不可用。
  • Azure SQL 逻辑服务器无权向证明提供程序发送证明请求。 确保您的证明服务提供程序管理员已将数据库服务器添加到“Attestation Reader”角色中。
  • 证明策略的验证失败(上述工作流的步骤 3)。
    • 证明策略错误可能是根本原因。 确保使用的是 Microsoft 推荐的策略。 有关详细信息,请参阅创建并配置证明提供程序。
    • 由于安全入侵危及了服务器端安全隔离区,策略验证也可能失败。
  • 客户端应用程序无法连接到证明提供程序且无法检索公共签名密钥(步骤 5 中)。 可能的原因包括:
    • 应用程序与证明提供程序之间的防火墙配置可能会阻止连接。 若要对受阻的连接进行故障排除,请验证是否可以连接到证明提供程序的 OpenId 终结点。 例如,在托管应用程序的计算机上通过 Web 浏览器查看是否可以连接到 OpenID 终结点。 有关详细信息,请参阅元数据配置 - Get。

使用主机监护服务时出现证明错误

注意

本节仅适用于 SQL Server 2019 (15.x) 及更高版本。

在客户端驱动程序向 SQL Server 提交 T-SQL 语句以供执行之前,驱动程序会使用主机保护者服务 (HGS) 触发以下 Enclave 证明工作流。

  1. 客户端驱动程序调用 SQL Server 来启动证明。
  2. SQL Server 会收集有关其 Enclave、其宿主环境以及 Enclave 内运行的代码的证据。 SQL Server 会向注册了托管 SQL Server 的计算机的 HGS 实例请求运行状况证书。 有关详细信息,请参阅向主机保护者服务注册计算机。
  3. HGS 会验证证据,并向 SQL Server 颁发运行状况证书。 HGS 使用其私钥对健康证书进行签名。
  4. SQL Server 将运行状况证书发送给客户端驱动程序。
  5. 客户端驱动程序通过为数据库连接指定的证明 URL 与 HGS 联系,以检索 HGS 公共密钥。 客户端驱动程序在健康证书中验证签名。

由于配置错误,上述工作流的各个步骤均可能发生错误。 部分常见的证明错误、相应的根本原因以及建议的故障排除步骤如下:

  • 由于间歇性网络错误,SQL Server 无法连接到 HGS(上述工作流的步骤 2)。 要对连接问题进行故障排除,SQL Server 计算机的管理员应验证该计算机是否可以连接到 HGS 计算机。
  • 步骤 3 中的验证失败。 要排查验证方面的问题:
    • SQL Server 计算机管理员应与客户端应用程序管理员协作,确认 SQL Server 计算机是否已注册到与客户端侧证明 URL 中引用的实例相同的 HGS 实例。
    • SQL Server 计算机管理员应确认 SQL Server 计算机能够成功完成证明,具体操作请按照 步骤 5:确认主机能够成功完成证明 中的说明进行。
  • 客户端应用程序无法连接到 HGS 且无法检索其公共签名密钥(步骤 5 中)。 原因可能是:
    • 应用程序与证明提供程序之间的某一防火墙配置可能会阻止连接。 验证托管应用的计算机是否可以连接到 HGS 计算机。

就地加密错误

此部分列出了使用 ALTER TABLE/ALTER COLUMN 进行就地加密时可能会遇到的常见错误(以及前面各部分中介绍的证明错误)。 有关详细信息,请参阅使用具有安全 enclave 的 Always Encrypted 就地配置列加密。

  • 你尝试用于加密、解密或重新加密数据的列加密密钥不是启用了 Enclave 的密钥。 有关就地加密先决条件的详细信息,请参阅先决条件。 若要详细了解如何预配已启用 enclave 的密钥,请参阅预配已启用 enclave 的密钥。
  • 你尚未为该数据库连接启用 Always Encrypted 和安全区域计算。 请参阅使用安全区域运行语句的先决条件。
  • ALTER TABLE / ALTER COLUMN 语句会触发加密操作,并且会更改列数据类型或通过与当前排序规则代码页不同的代码页设置排序规则。 禁止将加密操作与数据类型或排序规则页面更改结合起来。 若要解决该问题,请使用独立语句;一个语句用于更改数据类型或排序规则代码页,另一个语句用于实现就地加密。

使用安全区域运行机密 DML 查询时出错

本节列出了使用安全隔离区运行机密 DML 查询时可能遇到的常见错误(除前面章节中介绍的证明错误外)。

后续步骤