通过

setEncrypt 方法 (SQLServerDataSource)

  • 项目

下载 JDBC 驱动程序

设置一个布尔值，此值指示是否启用了 encrypt 属性 。

语法

  
public void setEncypt(boolean encrypt)

参数

encrypt

如果在客户端和 SQL Server 之间启用传输层安全性 (TLS)（以前称为安全套接字层 (SSL)）加密，则为 true 。 否则为 false。

备注

如果 encrypt 属性设置为 true，则在服务器已安装有证书的情况下，Microsoft JDBC Driver for SQL Server 将确保 SQL Server 对在客户端与服务器之间发送的所有数据使用 TLS 加密 。 默认值是 false秒。

JDBC 驱动程序在尝试建立 TLS 握手时，会检测运行它的 Java 虚拟机 (JVM)。

如果 encrypt 属性设置为 true，则 Microsoft JDBC Driver for SQL Server 将使用 JVM 的默认 JSSE 安全提供程序与 SQL Server 协商 TLS 加密 。 默认的安全提供程序可能不支持成功协商 TLS 加密所需的全部功能。 例如，默认安全提供程序可能不支持在 SQL Server TLS/SSL 证书中使用的 RSA 公钥的大小。 在这种情况下，默认的安全提供程序可能报错，此错误将导致 JDBC 驱动程序终止连接。 为了解决这一问题，请执行下列操作之一：

  • 使用具有较小 RSA 公钥的服务器证书配置 SQL Server

  • 在“<java-home>/lib/security/java.security”安全属性文件中将 JVM 配置为使用其他 JSSE 安全提供程序

  • 使用其他 JVM

如果未指定 encrypt 属性或将此属性设置为 false，驱动程序将不会强制 SQL Server 支持 TLS 加密 。 如果 SQL Server 实例未配置为强制使用 TLS 加密，则将在不进行任何加密的情况下建立连接。 如果将 SQL Server 实例配置为强制使用 TLS 加密，则在经正确配置的 JVM 上运行时，Microsoft JDBC Driver for SQL Server 将自动启用 TLS 加密，否则连接将终止并且驱动程序将报错。

另请参阅

SQLServerDataSource 成员
SQLServerDataSource 类