基于 Host Guardian Service 的 SQL Server 安全 enclave 演示:Always Encrypted 与 ContosoHR 应用实战指南

原创2026-09-24 17:18:111,645 阅读
文章标签:示例工程数据库教程后端

基于 Host Guardian Service 的 SQL Server 安全 enclave 演示:Always Encrypted 与 ContosoHR 应用实战指南

本指南以 SQL Server 2019 及以上版本中的 Always Encrypted with secure enclaves(安全 enclave 的始终加密) 为核心主题,讲解如何借助 Windows Host Guardian Service(HGS) 完成 enclave 证明(attestation),并通过对 Contoso HR 人事系统的完整演示,展示敏感列原地加密、DBA 无法读取明文、应用仍可执行 LIKE 模糊匹配与范围查询的完整链路。读者将掌握 HGS 与 SQL Server 的双机环境搭建、连接字符串的 enclave 参数配置、SSMS 双角色演示编排,以及加密前后查询行为的对比验证方法。

演示概览与适用环境

本演示位于仓库 samples/features/security/always-encrypted-with-secure-enclaves/sql-server-with-hgs,是 Always Encrypted with secure enclaves 系列演示 中面向 本地 SQL Server + HGS 证明 的分支(同一目录下还有 Azure SQL Database 的 SGX/VBS 分支与无证明的 SQL Server 分支)。

项目 说明
适用版本 SQL Server 2019 或更高版本
核心特性 Always Encrypted with secure enclaves(安全 enclave 始终加密)
演示工作负载 人力资源(HR)应用 ContosoHR
编程语言 C#(ASP.NET Core Web 应用)、Transact-SQL
作者 Jakub Szymaszek

演示整体由三部分构成:承载 ContosoHR 数据库与 Web 应用的 SQL Server 计算机、执行 enclave 证明的 HGS 计算机,以及 SQL Server 内置的 安全 enclave(利用基于虚拟化的安全特性,在内存中解密列并执行计算)。HGS 通过证明 SQL Server 实例上的 enclave 确实运行在受信任硬件上,才允许其接收列加密密钥并执行富查询。

开始之前:两台计算机的前置条件

演示要求两台机器(可以是虚拟机):

  • SQL Server 计算机:安装 SQL Server 2019 或更高版本,并满足 Always Encrypted enclave 的 SQL Server 计算机要求(如 VBS/HGS 所需的硬件虚拟化支持)。此外还需安装 Visual Studio 2019 或更高版本,用于编译和运行示例 Web 应用。
  • HGS 计算机:承载 Windows Host Guardian Service,为 enclave 证明提供证明服务,其硬件与配置要求详见 HGS 计算机要求。

两个角色分离正是本演示的价值所在:DBA 拥有数据库的完全访问权,却无法接触加密密钥;密钥持有者是独立的 Security Administrator,而证明信任则由 HGS 独立裁决。

环境搭建四步走

1. 配置 SQL Server 计算机的主机证明

按照《Tutorial: Getting started with Always Encrypted with secure enclaves using SSMS》的 Step 1–2(配置 HGS 计算机),在 HGS 上注册 SQL Server 计算机的主机信息。HGS 将基于该主机身份验证 enclave 的可信度,这是后续连接字符串中 Attestation Protocol=HGS 与 Enclave Attestation Url 能够生效的前提。

2. 在 SQL Server 实例中启用安全 enclave

按照上述教程的 Step 3,在 SQL Server 实例上启用 Always Encrypted with secure enclaves。启用后,实例内的列加密密钥可被发送到 enclave 中参与计算。

3. 导入 ContosoHR 演示数据库

仓库在 setup 文件夹 提供了现成的 ContosoHR bacpac 文件(contosohr.bacpac),导入步骤如下:

  1. 克隆/下载本仓库。
  2. 打开 SSMS 并连接 SQL Server 实例。
  3. 在对象资源管理器中右键点击 Databases,选择 Import Data-tier Application...。
  4. 定位 setup 文件夹 中的 ContosoHR bacpac 文件。
  5. 按向导完成导入,生成 ContosoHR 数据库。

4. 配置 Contoso HR Web 应用

  1. 启动 Visual Studio,打开 source 文件夹 中的 ContosoHR 解决方案文件(ContosoHR.sln)。
  2. 在解决方案资源管理器中,打开 ContosoHR 项目下的 appsettings.json。
  3. 找到 Web 应用的数据库连接字符串,它应与下面格式一致:
"ContosoHRDatabase": "Data Source=.;Initial Catalog=ContosoHR;Column Encryption Setting=Enabled;Attestation Protocol=HGS;Enclave Attestation Url=http://<your HGS computer>/Attestation;Integrated Security=true"
  1. 确保 Data Source 关键字的值正确指向你的 SQL Server 实例(本机默认实例可写 .)。
  2. 将 <your HGS computer> 替换为 HGS 计算机的 DNS 名称或 IP 地址。
  3. 保存文件。

连接字符串中的三个 enclave 相关关键字是整个演示的关键:Column Encryption Setting=Enabled 让客户端驱动启用列加密;Attestation Protocol=HGS 指定使用 Host Guardian Service 证明协议;Enclave Attestation Url 指向 HGS 的证明服务地址。仓库源码中,该连接字符串在 Startup.cs 中通过 Configuration.GetConnectionString("ContosoHRDatabase") 读取并注入 EF Core 与连接管理逻辑。注意 source/ContosoHR/appsettings.json 默认携带的是面向 Azure SQL Database 的 AAS 证明参数,本地 HGS 演示需按上文改为 Attestation Protocol=HGS 并指向本地 HGS 地址。

  1. 在 Visual Studio 中选择 Build > Build Solution 构建演示应用。

演示前准备:双 SSMS 实例 + 扩展事件会话

演示过程中你会使用 两个 SSMS 实例,分别扮演两个角色:

  • DBA 实例:以 DBA 身份连接,可查看表结构与查询语句,但无密钥访问权。
  • 安全管理员(Security Administrator)实例:配置 Always Encrypted 密钥并执行原地加密。

每次演示前按以下步骤准备:

准备 DBA 的 SSMS 实例

  1. 关闭所有正在运行的 SSMS 实例。
  2. 启动 SSMS,在 Connect to Server 对话框中:
    • 主页输入服务器名(如 . 连接本机默认实例),设置身份验证参数。
    • 点击 Options >>,在 Connection Properties 标签页中输入数据库名 ContosoHR。
    • 切换到 Always Encrypted 标签页,确保 Enable Always Encrypted 复选框 未选中(DBA 不启用列加密)。
    • 点击 Connect。
  3. 配置扩展事件会话以拦截应用查询:
    • 按 Ctrl + O,在 Open File 对话框中定位到 tsql-scripts 文件夹,选择 CreateXESession.sql 并按 F5 执行。
    • 在对象资源管理器中定位新建的 Demo 扩展事件会话:服务器 → Management / Extended Events / Sessions。
    • 右键 Demo 会话并选择 Watch Live Data,打开 Demo Live Data 窗口。
    • 关闭 CreateXESession.sql 查询标签页。
  4. 准备演示查询窗口:
    • 在对象资源管理器中选中 ContosoHR 数据库,按 Ctrl + O 打开 tsql-scripts 文件夹 中的 ListAllEmployees.sql,先不执行。
    • 同样打开 QueryColumns.sql,先不执行。

CreateXESession.sql 的底层实现(见 tsql-scripts/CreateXESession.sql)在服务器级创建名为 Demo 的事件会话:监听 sqlserver.rpc_completed 事件,同时收集数据流与语句文本(collect_data_stream=(1), collect_statement=(1)),并附加 sqlserver.sql_text 动作;过滤条件要求 SQL 文本包含 SSN 且数据库名为 ContosoHR,并排除 sp_reset_connection 系统调用。这样只有应用针对 ContosoHR 的 SSN 相关查询才会进入观察窗口。

准备安全管理员的 SSMS 实例

  1. 启动 SSMS,在 Connect to Server 对话框中:
    • 主页输入服务器名,设置身份验证参数。
    • 点击 Options >>,在 Connection Properties 标签页输入数据库名 ContosoHR。
    • 切换到 Always Encrypted 标签页,勾选 Enable Always Encrypted 复选框,并输入证明 URL(HGS 地址)。
    • 点击 Connect。
  2. 配置查询窗口:
    • 在对象资源管理器中选中 ContosoHR 数据库。
    • 按 Ctrl + O 打开 tsql-scripts 文件夹 中的 EncryptColumns.sql,先不执行。

运行 Web 应用

在 Visual Studio 中打开 source 文件夹 的 ContosoHR 解决方案,按 F5 运行。Contoso HR Web 应用会在浏览器中打开。

Contoso HR Web 应用界面

演示步骤:从明文到密文的全过程

第一步:展示应用的富查询能力

浏览器中的 Contoso HR 应用可以显示员工记录,并按 薪资 或 SSN(社会安全号) 的片段过滤员工:拖动薪资滑块、在搜索框输入几位 SSN 数字即可过滤;点击 Ssn 或 Salary 表头可按对应列排序。注意此时所有列都是明文,应用展示的是普通查询能力。

第二步:以 DBA 视角查看明文数据

切回 DBA 的 SSMS,选中 ListAllEmployees.sql 标签页按 F5 执行。该脚本(tsql-scripts/ListAllEmployees.sql)只是简单的 SELECT [EmployeeID], [SSN], [FirstName], [LastName], [Salary] FROM [dbo].[Employees]。此时 DBA 能看到 SSN 与 Salary 的全部明文——演示点在于:加密前,一个恶意 DBA 仅凭这样一条简单查询就能轻易窃取所有敏感数据。

加密前 DBA 看到明文结果

第三步:检查应用发往数据库的明文查询

  1. 选中 Demo Live Data 窗口,其中应包含应用触发的若干事件。
  2. 若表格中没有 statement 列,右键表格头选择 Choose Columns...,把 statement 移到 Selected columns 并点击 OK。
  3. 双击最后一行 statement 列,查看应用发给数据库的最后一条查询。注意查询的 WHERE 子句包含对加密列的富计算:LIKE 谓词对 SSN 列做模式匹配、对 Salary 列做范围比较,ORDER BY 子句按 SSN 或 Salary 排序。
  4. 找到查询参数 @SSNSearchPattern、@MinSalary、@MaxSalary。此刻它们的值是 明文,因为参数对应的列尚未加密。

加密前的查询参数为明文

  1. 点击 OK 关闭语句窗口。

第四步:安全管理员预配列主密钥(CMK)

在安全管理员的 SSMS 实例中:

  1. 展开 ContosoHR 数据库节点,进入 Security / Always Encrypted Keys / Column Master Keys。
  2. 右键 Column Master Keys 文件夹,选择 New Column Master Key...。
  3. 输入列主密钥名称:CMK1。
  4. 密钥存储选择 Windows Certificate Store - Current User。
  5. 务必勾选 Allow enclave computations(允许 enclave 计算)——这是密钥可用于 enclave 解密的前提。
  6. 点击 Generate Certificate 生成作为列主密钥的新证书。
  7. 点击 OK。

新建列主密钥 CMK1

第五步:安全管理员预配列加密密钥(CEK)

  1. 展开到 Security / Always Encrypted Keys / Column Encryption Keys。
  2. 右键 Column Encryption Keys 文件夹,选择 New Column Encryption Key...。
  3. 输入列加密密钥名称:CEK1。
  4. 选择 CMK1 作为保护 CEK1 的列主密钥。
  5. 点击 OK。

第六步:利用安全 enclave 原地加密 SSN 与 Salary 列

在安全管理员的 SSMS 实例中,选中 EncryptColumns.sql 标签页并按 F5 执行。该脚本(tsql-scripts/EncryptColumns.sql)展示了两条核心 DDL:

ALTER TABLE [dbo].[Employees]
ALTER COLUMN [SSN] char COLLATE Latin1_General_BIN2
ENCRYPTED WITH (COLUMN_ENCRYPTION_KEY = [CEK1], ENCRYPTION_TYPE = Randomized, ALGORITHM = 'AEAD_AES_256_CBC_HMAC_SHA_256') NOT NULL;

ALTER TABLE [dbo].[Employees]
ALTER COLUMN [Salary] [Money]
ENCRYPTED WITH (COLUMN_ENCRYPTION_KEY = [CEK1], ENCRYPTION_TYPE = Randomized, ALGORITHM = 'AEAD_AES_256_CBC_HMAC_SHA_256') NOT NULL;

ALTER DATABASE SCOPED CONFIGURATION CLEAR PROCEDURE_CACHE;

要点解读:

  • ALTER COLUMN ... ENCRYPTED WITH 就地完成加密,无需将数据导出数据库,这正是 secure enclave 的价值——加解密操作全部在 enclave 内完成。
  • COLLATE Latin1_General_BIN2:SSN 列需使用 BIN2 排序规则以支持确定性的比较运算。
  • ENCRYPTION_TYPE = Randomized 与 ALGORITHM = 'AEAD_AES_256_CBC_HMAC_SHA_256':使用随机化加密与 AES-256 认证加密算法。
  • 最后的 ALTER DATABASE SCOPED CONFIGURATION CLEAR PROCEDURE_CACHE 用于清除过程缓存,确保后续查询按新加密元数据重新编译。

第七步:DBA 再次查询——看到的是密文

切回 DBA 的 SSMS,再次对 ListAllEmployees.sql 按 F5。现在 SSN 与 Salary 列显示为加密数据:两列已加密,DBA 无法看到任何明文。

加密后 DBA 只能看到密文

第八步:验证应用仍可过滤与排序

回到浏览器中的 Web 应用,移动滑块重置薪资过滤,再重新输入几位 SSN 数字,确认应用 依然可以按薪资和 SSN 过滤员工记录。这是 Always Encrypted with secure enclaves 区别于传统 Always Encrypted 的关键能力:加密后富查询依旧可用。

第九步:检查加密后的查询参数

  1. 在 DBA 的 SSMS 中选中 Demo Live Data 窗口。
  2. 双击最后一行 statement 列,查看应用发往数据库的最后一条查询。注意查询语句本身没有变化——仍包含对 SSN 的 LIKE 模式匹配、对 Salary 的范围比较,以及按 SSN/Salary 的 ORDER BY 排序。
  3. 找到 @SSNSearchPattern、@MinSalary、@MaxSalary 参数值。现在它们是 加密的:Web 应用内的客户端驱动会在把查询发送给数据库之前,透明地加密与加密列对应的参数。

加密后的查询参数已被客户端透明加密

  1. 点击 OK 关闭语句窗口。

这个步骤的演示意义在于:DBA 不仅无法访问数据库中的敏感数据,也看不到用于处理这些数据的查询参数明文——即使通过扩展事件抓包,看到的也只是密文参数,数据在客户端、传输链路与数据库三个层面都保持受控。

关键要点

  • 安全 enclave 使敏感列可以原地加密,消除了为执行密码学运算而把数据搬出数据库的必要。
  • Always Encrypted with secure enclaves 的独特价值:既能保护敏感数据免受高权限用户(包括组织内的 DBA)的窥探,又能在加密之后让应用继续在加密列上执行富查询(LIKE 模糊匹配、范围比较、排序)。
  • 安全边界由 HGS 证明机制背书:只有通过证明的 enclave 才能获得列加密密钥并执行解密计算,密钥与数据在生命周期内均不落明文。

重置演示

在安全管理员的 SSMS 实例中依次执行:

  1. 打开并执行 tsql-scripts/DecryptColumns.sql——该脚本将 SSN、Salary(以及 LastName)列以 WITH (ONLINE = ON) 在线方式还原为明文类型,并清除过程缓存。
  2. 打开并执行 tsql-scripts/DropKeys.sql——删除 CEK 与 CMK 密钥对象。
  3. 关闭两个 SSMS 窗口。

仓库脚本与源码索引

登录后查看全文
sql-server-samples