Microsoft.Data.SqlClient 中的加密和证书验证

下载 ADO.NET

使用传输层安全(TLS)来加密你的应用与SQL Server之间的流量。 保持服务器证书验证开启以验证服务器身份。 没有身份验证的加密无法防止冒充服务器的 中间 攻击者。

Microsoft.Data.SqlClient 默认为 Encrypt=Mandatory 和 TrustServerCertificate=false。 Encrypt=true 是 Mandatory 的同义词。 对于远程连接,明确请求这些设置并配置服务器证书,客户端可以验证:

Server=tcp:<server>,1433;Database=<database>;Integrated Security=true;Encrypt=true;TrustServerCertificate=false;MultiSubnetFailover=true;

替换占位符,使用服务器和应用环境支持的 认证方法 。 关于Microsoft Fabric中的Azure SQL或SQL数据库,请参见Microsoft Entra认证。

选择加密模式

Encrypt 控制客户端是否需要加密。 服务器也可能要求加密。 下表说明了在未启用证书固定时的当前行为:

客户端设置 服务器要求 证书验证 结果
Encrypt=Optional 或 false 它不会强制加密。 都没有,无论是否有 TrustServerCertificate。 只有登录包是加密的。 后续的流量则没有加密。
Encrypt=Optional;TrustServerCertificate=false 强制加密。 信任链、有效性和服务器名称。 所有流量都经过加密。 无效证书会导致连接失败。
Encrypt=Optional;TrustServerCertificate=true 强制加密。 被绕过了。 所有流量都被加密了,但服务器的身份没有被验证。
Encrypt=Mandatory;TrustServerCertificate=false 任一设置。 信任链、有效性和服务器名称。 所有流量都经过加密。 无效证书会导致连接失败。
Encrypt=Mandatory;TrustServerCertificate=true 任一设置。 被绕过了。 所有流量都被加密了,但服务器的身份没有被验证。
Encrypt=Strict 支持表格数据流(TDS)8.0。 必填。 TrustServerCertificate 无法绕过它。 TLS 在 TDS 消息之前启动。 不支持的服务器或无效证书会导致连接失败。

使用 Mandatory 与不支持 TDS 8.0 的服务器建立加密连接。 当你的终端支持TDS 8.0,包括SQL Server 2022(16.x)及更高版本时,请使用Strict。 TDS 8.0支持 TLS 1.2 和 TLS 1.3;它不需要 TLS 1.3。 协商后的 TLS 版本还取决于客户端、服务器和操作系统的配置。

Optional 不是解决证书错误的办法。 当服务器不需要加密时,应用数据可能会保持未加密。

配置可验证服务器证书

对于普通证书验证:

  1. 配置符合SQL Server证书要求的证书。
  2. 在证书的主题备用名称(SAN)中包含客户端用于连接的名称。
  3. 将签发证书的证书颁发机构以及任何所需的中间证书设为每个客户端主机或容器上的受信任证书。
  4. 将 SQL Server 配置为使用该证书,并在客户端中保留 TrustServerCertificate=false。
  5. 计划证书到期前续期,包括名称或签发机构的任何变更。

公共或企业证书授权机构的证书可以满足这些要求。 企业证书在Linux容器内或独立开发者电脑上并不会自动被信任。

通过别名连接

如果连接使用了证书中没有的域名系统(DNS)别名,首先考虑签发包含该别名的证书。 或者,将证书中的预期名称设置为 HostNameInCertificate :

Server=tcp:sql-alias.contoso.com,1433;Database=<database>;Integrated Security=true;Encrypt=true;TrustServerCertificate=false;HostNameInCertificate=sql-server.contoso.com;MultiSubnetFailover=true;

HostNameInCertificate 替换 SqlClient 在证书验证过程中所期望的服务器名称。 从7.1.2和7.0.4版本开始,证书中不存在的值即使服务器名称与证书匹配,连接也会失败。 6.1.8 版本仅在使用托管网络时强制执行此操作。 它不会改变网络目的地,也不会绕过信任链和过期检查。 当服务器名称已经与证书匹配时,保持未设置。

固定特定服务器证书

ServerCertificate 提供本地证书文件,用于与服务器证书的精确比对。 支持的格式为隐私增强邮件 (PEM) 和可辨别编码规则 (DER),包括 .cer 证书文件。 将其与 Encrypt=Strict 或 Encrypt=Mandatory 一起使用,并保留 TrustServerCertificate=false。

Server=tcp:<server>,1433;Database=<database>;Integrated Security=true;Encrypt=Strict;TrustServerCertificate=false;ServerCertificate=C:\certificates\sql-server.cer;MultiSubnetFailover=true;

通过可信通道分发预期证书,并保护文件不被替换。 精确的证书匹配是常规链和名称验证的替代方案,而不是额外的检查。 证书字节必须匹配;仅仅同一个主题名或公钥是不够的。 缺少、无法读取、无效或不匹配的引脚文件将无法通过验证。

证书固定会使客户端部署与证书轮换绑定在一起。 当服务器证书发生变化,包括续签时,更新PIN码。 不要通过接受网络提供的未经验证的证书来获取PIN码。

SqlClient 不会为任意的 TLS 服务器证书验证提供公开回调。 AccessTokenCallback 控制认证令牌获取,而非 TLS 验证。

开发证书与故障排除

使用带有正确服务器名称的可信开发证书。 如果你在隔离的开发环境中临时将 TrustServerCertificate=true 与 Encrypt=true 一起使用,则连接会被加密,但客户端不会验证服务器证书。

注意

不要作为证书错误的生产修复部署 TrustServerCertificate=true 。 它会禁用服务器 Mandatory 身份验证,对 Strict则无效。

Failure 检查
证书链不值得信任。 在客户端安装相应的受信任根证书和中间证书。 验证 SQL Server 实际提供的证书。
证书名称不匹配。 将 Server 与证书 SAN 进行比较。 更正名称、证书或有意设置的 HostNameInCertificate 覆盖项。
证书已过期。 更新服务器证书并检查客户端时钟。
固定的证书不匹配或无法加载。 检查文件路径、权限、格式和部署证书。 通过你信任的分发流程更新密码。
严格加密无法连接。 确认终端支持 TDS 8.0,并且其 TLS 配置与客户端兼容。

关于服务器端配置,请参见 证书概述。

加密和证书验证行为的更改

这些兼容性说明解释了升级旧应用时的行为变化。 新应用应使用本文中描述的当前设置。

驱动程序发布 找零
1.0 Encrypt=false 为默认值。 当客户端不请求加密时,服务器强制加密不会触发证书验证。
2.0 服务器强制加密即使在 TrustServerCertificate 时也仍遵循 Encrypt=false。
4.0 加密默认启用。 升级可能会暴露之前未注意到的证书配置错误。
5.0 添加 Optional、 Mandatory、 Strict和 HostNameInCertificate。
5.1 添加用于证书固定的 ServerCertificate。
7.0.3 修复了托管网络的证书固定验证,确保在文件缺失、无效或不匹配时,即使正常平台验证成功,也不会通过证书固定验证。