Struct RustlsConnector 

pub struct RustlsConnector(/* private fields */);

A rustls TLS connector ready to perform TLS handshakes.

Wraps an Arc<ClientConfig> and can be built from a RustlsConnectorConfig via connector_with_no_client_auth or connector_with_single_cert, or directly from a ClientConfig via the From impl.

Implementations

impl RustlsConnector

pub fn new_with_webpki_root_certs() -> Result<Self>

Create a new RustlsConnector using the webpki-root certs (requires webpki-root-certs feature enabled)

Errors

Returns an error if we fail to init our verifier

Panics

See connector_with_no_client_auth.

pub fn new_with_platform_verifier() -> Result<Self>

Create a new RustlsConnector using the rustls-platform-verifier mechanism (requires platform-verifier feature enabled)

Errors

Returns an error if we fail to init our verifier

Panics

See connector_with_no_client_auth.

pub fn new_with_native_certs() -> Result<Self>

Create a new RustlsConnector using the system certs (requires native-certs feature enabled)

Errors

Returns an error if we fail to load the native certs or to init our verifier.

Panics

See connector_with_no_client_auth.

pub fn connect<S: Read + Write + Send + 'static>( &self, domain: &str, stream: S, ) -> Result<TlsStream<S>, HandshakeError<S>>

Connect to the given host

Errors

Returns a HandshakeError containing either the current state of the handshake or the failure when we couldn’t complete the handshake

pub async fn connect_async<S: AsyncRead + AsyncWrite + Send + Unpin + 'static>( &self, domain: &str, stream: S, ) -> Result<AsyncTlsStream<S>>

Connect to the given host asynchronously

Errors

Returns a io::Error containing the failure when we couldn’t complete the TLS handshake

Trait Implementations

impl Clone for RustlsConnector

fn clone(&self) -> RustlsConnector

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RustlsConnector

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Arc<ClientConfig>> for RustlsConnector

fn from(config: Arc<ClientConfig>) -> Self

Converts to this type from the input type.

impl From<ClientConfig> for RustlsConnector

fn from(config: ClientConfig) -> Self

Converts to this type from the input type.