SwiftNIO SSL
SwiftNIO SSL 是一个 Swift 包,其中包含基于 BoringSSL 的 TLS 实现。该包允许 SwiftNIO 的用户编写使用 TLS 保障数据传输的协议客户端和服务器。
名称主要源于该包使用的库(BoringSSL)的名称,并不是因为我们不知道该协议的名称。我们知道这个协议是 TLS!
要开始使用,请查看 API 文档。
使用 SwiftNIO SSL
SwiftNIO SSL 提供了两个 ChannelHandler
用于保障数据流:分别是 NIOSSLClientHandler
和 NIOSSLServerHandler
。可以将这些添加到 Channel
中,以保障该通道上的通讯。
此外,我们还提供了一些低级原语用于配置您的 TLS 连接。下面将展示这些原语。
要保障服务器连接,您需要一个文件中的 X.509 证书链(PEM 或 DER 格式,但 PEM 格式更简单),以及与叶证书关联的私钥。这些对象可以包含在用于初始化 ChannelHandler
的 TLSConfiguration
对象中。
例如
let configuration = TLSConfiguration.makeServerConfiguration(
certificateChain: try NIOSSLCertificate.fromPEMFile("cert.pem").map { .certificate($0) },
privateKey: .file("key.pem")
)
let sslContext = try NIOSSLContext(configuration: configuration)
let server = ServerBootstrap(group: group)
.childChannelInitializer { channel in
// important: The handler must be initialized _inside_ the `childChannelInitializer`
let handler = try NIOSSLServerHandler(context: sslContext)
[...]
channel.pipeline.addHandler(handler)
[...]
}
对于客户端,这稍微简单一些,因为客户端不需要证书链或私钥(尽管客户端可能拥有这些)。客户端的设置可以像这样进行:
let configuration = TLSConfiguration.makeClientConfiguration()
let sslContext = try NIOSSLContext(configuration: configuration)
let client = ClientBootstrap(group: group)
.channelInitializer { channel in
// important: The handler must be initialized _inside_ the `channelInitializer`
let handler = try NIOSSLClientHandler(context: sslContext)
[...]
channel.pipeline.addHandler(handler)
[...]
}
请注意,SwiftNIO SSL当前需要Swift 5.2及以上版本。2.13.x版本及之前的版本支持Swift 5.0和5.1