SSL/TLS 支持
支持安全套接字层/传输层安全。使用 NIO 时,JDK 5+ 的 SSLEngine
功能用于在连接建立后处理握手。不使用 NIO 时,使用标准的 SSLSocketFactory
和 SSLServerSocketFactory
对象创建连接。提供了一些策略接口,允许进行大量的自定义。这些接口的默认实现提供了开始使用安全通信的最简单方法。
入门
无论您是否使用 NIO,都需要在连接工厂上配置 ssl-context-support
属性。此属性引用一个 <bean/> 定义,该定义描述了所需密钥库的位置和密码。
SSL/TLS 对等方需要两个密钥库
-
一个密钥库,其中包含用于标识对等方的私钥和公钥对
-
一个信任库,其中包含受信任的对等方的公钥。请参阅 JDK 提供的
keytool
实用程序的文档。基本步骤如下-
创建一个新的密钥对并将其存储在密钥库中。
-
导出公钥。
-
将公钥导入对等方的信任库。
-
对其他对等方重复此操作。
-
在测试用例中,通常在两个对等方上使用相同的密钥库,但在生产环境中应避免这种情况。 |
建立密钥库后,下一步是将它们的位置指示给TcpSSLContextSupport
bean,并将对该 bean 的引用提供给连接工厂。
以下示例配置 SSL 连接
<bean id="sslContextSupport"
class="o.sf.integration.ip.tcp.connection.support.DefaultTcpSSLContextSupport">
<constructor-arg value="client.ks"/>
<constructor-arg value="client.truststore.ks"/>
<constructor-arg value="secret"/>
<constructor-arg value="secret"/>
</bean>
<ip:tcp-connection-factory id="clientFactory"
type="client"
host="localhost"
port="1234"
ssl-context-support="sslContextSupport" />
DefaultTcpSSLContextSupport
类还具有可选的protocol
属性,可以是SSL
或TLS
(默认值)。
密钥库文件名(前两个构造函数参数)使用 Spring 的Resource
抽象。默认情况下,这些文件位于类路径上,但您可以使用file:
前缀覆盖此设置(以在文件系统上查找这些文件)。
从版本 4.3.6 开始,当您使用 NIO 时,可以在连接工厂上指定ssl-handshake-timeout
(以秒为单位)。此超时(默认值为 30 秒)在等待数据时用于 SSL 握手期间。如果超时,则停止该过程并关闭套接字。
主机验证
从版本 5.0.8 开始,您可以配置是否启用主机验证。从版本 5.1 开始,默认情况下启用它;禁用它的机制取决于您是否使用 NIO。
主机验证用于确保您连接到的服务器与证书中的信息匹配,即使证书是受信任的。
当使用 NIO 时,请配置DefaultTcpNioSSLConnectionSupport
,例如。
@Bean
public DefaultTcpNioSSLConnectionSupport connectionSupport() {
DefaultTcpSSLContextSupport sslContextSupport = new DefaultTcpSSLContextSupport("test.ks",
"test.truststore.ks", "secret", "secret");
sslContextSupport.setProtocol("SSL");
DefaultTcpNioSSLConnectionSupport tcpNioConnectionSupport =
new DefaultTcpNioSSLConnectionSupport(sslContextSupport, false);
return tcpNioConnectionSupport;
}
第二个构造函数参数禁用主机验证。然后将connectionSupport
bean 注入到 NIO 连接工厂中。
当不使用 NIO 时,配置位于TcpSocketSupport
中
connectionFactory.setTcpSocketSupport(new DefaultTcpSocketSupport(false));
同样,构造函数参数禁用主机验证。