Struct TlsConnector

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

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>

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 copy 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

Formats the value using the given formatter.