Crate tokio_boring

Async TLS streams backed by BoringSSL

This library is an implementation of TLS streams using BoringSSL for negotiating the connection. Each TLS stream implements the Read and Write traits to interact and interoperate with the rest of the futures I/O ecosystem. Client connections initiated from this crate verify hostnames automatically and by default.

tokio-boring exports this ability through accept and connect. accept should be used by servers, and connect by clients. These augment the functionality provided by the boring crate, on which this crate is built. Configuration of TLS parameters is still primarily done through the boring crate.

Structs

• AsyncPrivateKeyMethodError
  A fatal error to be returned from async private key methods.
• AsyncSelectCertError
  A fatal error to be returned from async select certificate callbacks.
• HandshakeError
  The error type returned after a failed handshake.
• HandshakeFuture
  Future for an ongoing TLS handshake.
• SslStream
  A wrapper around an underlying raw stream which implements the SSL protocol.
• SslStreamBuilder
  A partially constructed SslStream, useful for unusual handshakes.

Traits

• AsyncPrivateKeyMethod
  Describes async private key hooks. This is used to off-load signing operations to a custom, potentially asynchronous, backend. Metadata about the key such as the type and size are parsed out of the certificate.
• SslContextBuilderExt
  Extensions to SslContextBuilder.

Functions

• accept
  Asynchronously performs a server-side TLS handshake over the provided stream.
• connect
  Asynchronously performs a client-side TLS handshake over the provided stream.

Type Aliases

• BoxGetSessionFinish
  The type of callbacks returned by BoxSelectCertFuture methods.
• BoxGetSessionFuture
  The type of futures to pass to [SslContextBuilderExt::set_async_get_session_callback].
• BoxPrivateKeyMethodFinish
  The type of callbacks returned by BoxPrivateKeyMethodFuture.
• BoxPrivateKeyMethodFuture
  The type of futures returned by AsyncPrivateKeyMethod methods.
• BoxSelectCertFinish
  The type of callbacks returned by BoxSelectCertFuture methods.
• BoxSelectCertFuture
  The type of futures to pass to [SslContextBuilderExt::set_async_select_certificate_callback].
• ExDataFuture
  Convenience alias for futures stored in Ssl ex data by [SslContextBuilderExt] methods.