Skip to main content

Module tls

Module tls 

Source
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 rustls feature, supply an Arc<ClientConfig> or Arc<ServerConfig>, and compose the provider with the generic TLS endpoint adapters.

Structs§

TlsClientEndpoint
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 accept and close conveniences. Other listener representations can use listener and acceptor to perform their own accept operation followed by the same TLS handshake contract.
TlsServerEndpoint
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. S supplies 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 TlsStream for 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. S supplies explicit execution/I/O capabilities. A stream owns its transport and TLS state; no background task or split reader/writer is implied.