Struct TlsConnector 

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

Available on crate feature tls only.

A builder for client-side TLS connections.

Examples

use native_tls::TlsConnector;
use std::io::{Read, Write};
use std::net::TcpStream;

let connector = TlsConnector::new().unwrap();

let stream = TcpStream::connect("google.com:443").unwrap();
let mut stream = connector.connect("google.com", stream).unwrap();

stream.write_all(b"GET / HTTP/1.0\r\n\r\n").unwrap();
let mut res = vec![];
stream.read_to_end(&mut res).unwrap();
println!("{}", String::from_utf8_lossy(&res));

Implementations

impl TlsConnector

pub fn new() -> Result<TlsConnector, Error>

Returns a new connector with default settings.

pub fn builder() -> TlsConnectorBuilder

Returns a new builder for a TlsConnector.

pub fn connect<S>( &self, domain: &str, stream: S, ) -> Result<TlsStream<S>, HandshakeError<S>>

where S: Read + Write,

Initiates a TLS handshake.

The provided domain will be used for both SNI and certificate hostname validation.

If the socket is nonblocking and a WouldBlock error is returned during the handshake, a HandshakeError::WouldBlock error will be returned which can be used to restart the handshake when the socket is ready again.

The domain is ignored if both SNI and hostname verification are disabled.

Trait Implementations

impl Clone for TlsConnector

fn clone(&self) -> TlsConnector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TlsConnector

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

Formats the value using the given formatter.

impl From<TlsConnector> for TlsConnector

Available on crate feature native-tls only.

fn from(value: TlsConnector) -> TlsConnector

Converts to this type from the input type.