Expand description
Provider-neutral TLS handshakes, stream I/O and endpoint composition. The optional rustls feature supplies a concrete provider in tls::rustls. Applications select trust stores and credentials through provider configuration.
Client connectors authenticate the peer’s certificate and requested server identity. Server acceptors apply their configured certificate and client-authentication policy. Providers own TLS configuration, trust roots, credentials, protocol versions and ALPN offers; application code can retain concrete configuration types without erasing them into a shared options map.
Modules§
- rustls
- Rustls client/server providers over Base scheduler stream sockets. Enable the
rustlsfeature, supply anArc<ClientConfig>orArc<ServerConfig>, and compose the provider with the generic TLS endpoint adapters.
Structs§
- TlsClient
Endpoint - Compose connection establishment with a TLS client handshake. The server identity is explicit and independent of the underlying endpoint’s routing address.
- TlsListener
- A listener paired with its configured TLS acceptor. Native scheduler listeners have
acceptandcloseconveniences. Other listener representations can uselistenerandacceptorto perform their own accept operation followed by the same TLS handshake contract. - TlsServer
Endpoint - Compose binding with a configured TLS server provider. Binding wraps listeners; each accepted connection performs its own handshake. Wrap a composite endpoint here to support multiple listening addresses.
Traits§
- TlsAcceptor
- An explicitly configured TLS server provider over an owned accepted transport
C. Configuration includes the server identity, ALPN selection and any client-authentication policy. - TlsConnector
- An explicitly configured TLS client provider over an owned transport
C.Ssupplies any execution or I/O capabilities the provider needs; neither input is required to be a scheduler socket. - TlsSession
- Metadata available after a successful TLS handshake. Stream providers can also implement
TlsStreamfor provider-neutral application I/O and orderly shutdown. Retire those operations and send any required TLS close notification before closing the underlying transport. - TlsStream
- Sequential TLS application I/O, independent of a particular TLS provider.
Ssupplies explicit execution/I/O capabilities. A stream owns its transport and TLS state; no background task or split reader/writer is implied.