基于 Host Guardian Service 的 SQL Server 安全 enclave 演示:Always Encrypted 与 ContosoHR 应用实战指南
基于 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),导入步骤如下:
- 克隆/下载本仓库。
- 打开 SSMS 并连接 SQL Server 实例。
- 在对象资源管理器中右键点击 Databases,选择 Import Data-tier Application...。
- 定位 setup 文件夹 中的 ContosoHR bacpac 文件。
- 按向导完成导入,生成
ContosoHR数据库。
4. 配置 Contoso HR Web 应用
- 启动 Visual Studio,打开 source 文件夹 中的 ContosoHR 解决方案文件(
ContosoHR.sln)。 - 在解决方案资源管理器中,打开 ContosoHR 项目下的 appsettings.json。
- 找到 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"
- 确保 Data Source 关键字的值正确指向你的 SQL Server 实例(本机默认实例可写
.)。 - 将 <your HGS computer> 替换为 HGS 计算机的 DNS 名称或 IP 地址。
- 保存文件。
连接字符串中的三个 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 地址。
- 在 Visual Studio 中选择 Build > Build Solution 构建演示应用。
演示前准备:双 SSMS 实例 + 扩展事件会话
演示过程中你会使用 两个 SSMS 实例,分别扮演两个角色:
- DBA 实例:以 DBA 身份连接,可查看表结构与查询语句,但无密钥访问权。
- 安全管理员(Security Administrator)实例:配置 Always Encrypted 密钥并执行原地加密。
每次演示前按以下步骤准备:
准备 DBA 的 SSMS 实例
- 关闭所有正在运行的 SSMS 实例。
- 启动 SSMS,在 Connect to Server 对话框中:
- 主页输入服务器名(如
.连接本机默认实例),设置身份验证参数。 - 点击 Options >>,在 Connection Properties 标签页中输入数据库名 ContosoHR。
- 切换到 Always Encrypted 标签页,确保 Enable Always Encrypted 复选框 未选中(DBA 不启用列加密)。
- 点击 Connect。
- 主页输入服务器名(如
- 配置扩展事件会话以拦截应用查询:
- 按 Ctrl + O,在 Open File 对话框中定位到 tsql-scripts 文件夹,选择 CreateXESession.sql 并按 F5 执行。
- 在对象资源管理器中定位新建的 Demo 扩展事件会话:服务器 → Management / Extended Events / Sessions。
- 右键 Demo 会话并选择 Watch Live Data,打开 Demo Live Data 窗口。
- 关闭 CreateXESession.sql 查询标签页。
- 准备演示查询窗口:
- 在对象资源管理器中选中 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 实例
- 启动 SSMS,在 Connect to Server 对话框中:
- 主页输入服务器名,设置身份验证参数。
- 点击 Options >>,在 Connection Properties 标签页输入数据库名 ContosoHR。
- 切换到 Always Encrypted 标签页,勾选 Enable Always Encrypted 复选框,并输入证明 URL(HGS 地址)。
- 点击 Connect。
- 配置查询窗口:
- 在对象资源管理器中选中 ContosoHR 数据库。
- 按 Ctrl + O 打开 tsql-scripts 文件夹 中的 EncryptColumns.sql,先不执行。
运行 Web 应用
在 Visual Studio 中打开 source 文件夹 的 ContosoHR 解决方案,按 F5 运行。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 仅凭这样一条简单查询就能轻易窃取所有敏感数据。
第三步:检查应用发往数据库的明文查询
- 选中 Demo Live Data 窗口,其中应包含应用触发的若干事件。
- 若表格中没有 statement 列,右键表格头选择 Choose Columns...,把 statement 移到 Selected columns 并点击 OK。
- 双击最后一行 statement 列,查看应用发给数据库的最后一条查询。注意查询的 WHERE 子句包含对加密列的富计算:LIKE 谓词对 SSN 列做模式匹配、对 Salary 列做范围比较,ORDER BY 子句按 SSN 或 Salary 排序。
- 找到查询参数 @SSNSearchPattern、@MinSalary、@MaxSalary。此刻它们的值是 明文,因为参数对应的列尚未加密。
- 点击 OK 关闭语句窗口。
第四步:安全管理员预配列主密钥(CMK)
在安全管理员的 SSMS 实例中:
- 展开 ContosoHR 数据库节点,进入 Security / Always Encrypted Keys / Column Master Keys。
- 右键 Column Master Keys 文件夹,选择 New Column Master Key...。
- 输入列主密钥名称:CMK1。
- 密钥存储选择 Windows Certificate Store - Current User。
- 务必勾选 Allow enclave computations(允许 enclave 计算)——这是密钥可用于 enclave 解密的前提。
- 点击 Generate Certificate 生成作为列主密钥的新证书。
- 点击 OK。
第五步:安全管理员预配列加密密钥(CEK)
- 展开到 Security / Always Encrypted Keys / Column Encryption Keys。
- 右键 Column Encryption Keys 文件夹,选择 New Column Encryption Key...。
- 输入列加密密钥名称:CEK1。
- 选择 CMK1 作为保护 CEK1 的列主密钥。
- 点击 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 无法看到任何明文。
第八步:验证应用仍可过滤与排序
回到浏览器中的 Web 应用,移动滑块重置薪资过滤,再重新输入几位 SSN 数字,确认应用 依然可以按薪资和 SSN 过滤员工记录。这是 Always Encrypted with secure enclaves 区别于传统 Always Encrypted 的关键能力:加密后富查询依旧可用。
第九步:检查加密后的查询参数
- 在 DBA 的 SSMS 中选中 Demo Live Data 窗口。
- 双击最后一行 statement 列,查看应用发往数据库的最后一条查询。注意查询语句本身没有变化——仍包含对 SSN 的 LIKE 模式匹配、对 Salary 的范围比较,以及按 SSN/Salary 的 ORDER BY 排序。
- 找到 @SSNSearchPattern、@MinSalary、@MaxSalary 参数值。现在它们是 加密的:Web 应用内的客户端驱动会在把查询发送给数据库之前,透明地加密与加密列对应的参数。
- 点击 OK 关闭语句窗口。
这个步骤的演示意义在于:DBA 不仅无法访问数据库中的敏感数据,也看不到用于处理这些数据的查询参数明文——即使通过扩展事件抓包,看到的也只是密文参数,数据在客户端、传输链路与数据库三个层面都保持受控。
关键要点
- 安全 enclave 使敏感列可以原地加密,消除了为执行密码学运算而把数据搬出数据库的必要。
- Always Encrypted with secure enclaves 的独特价值:既能保护敏感数据免受高权限用户(包括组织内的 DBA)的窥探,又能在加密之后让应用继续在加密列上执行富查询(LIKE 模糊匹配、范围比较、排序)。
- 安全边界由 HGS 证明机制背书:只有通过证明的 enclave 才能获得列加密密钥并执行解密计算,密钥与数据在生命周期内均不落明文。
重置演示
在安全管理员的 SSMS 实例中依次执行:
- 打开并执行 tsql-scripts/DecryptColumns.sql——该脚本将
SSN、Salary(以及LastName)列以WITH (ONLINE = ON)在线方式还原为明文类型,并清除过程缓存。 - 打开并执行 tsql-scripts/DropKeys.sql——删除 CEK 与 CMK 密钥对象。
- 关闭两个 SSMS 窗口。
仓库脚本与源码索引
- 演示说明:sql-server-with-hgs/README.md
- 演示数据库:setup/contosohr.bacpac
- T-SQL 脚本目录:sql-server-with-hgs/tsql-scripts(含
CreateXESession.sql、EncryptColumns.sql、DecryptColumns.sql、ListAllEmployees.sql、QueryColumns.sql) - Web 应用源码:source/ContosoHR(连接字符串读取逻辑见 Startup.cs,默认配置见 appsettings.json)
- 系列演示入口:always-encrypted-with-secure-enclaves/README.md





