Struct TlsAcceptor

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

A builder for server-side TLS connections.

Examples

use native_tls::{Identity, TlsAcceptor, TlsStream};
use std::fs::File;
use std::io::{Read};
use std::net::{TcpListener, TcpStream};
use std::sync::Arc;
use std::thread;

let mut file = File::open("identity.pfx").unwrap();
let mut identity = vec![];
file.read_to_end(&mut identity).unwrap();
let identity = Identity::from_pkcs12(&identity, "hunter2").unwrap();

let listener = TcpListener::bind("0.0.0.0:8443").unwrap();
let acceptor = TlsAcceptor::new(identity).unwrap();
let acceptor = Arc::new(acceptor);

fn handle_client(stream: TlsStream<TcpStream>) {
    // ...
}

for stream in listener.incoming() {
    match stream {
        Ok(stream) => {
            let acceptor = acceptor.clone();
            thread::spawn(move || {
                let stream = acceptor.accept(stream).unwrap();
                handle_client(stream);
            });
        }
        Err(e) => { /* connection failed */ }
    }
}

Implementations

impl TlsAcceptor

pub fn new(identity: Identity) -> Result<TlsAcceptor, Error>

Creates a acceptor with default settings.

The identity acts as the server’s private key/certificate chain.

pub fn builder(identity: Identity) -> TlsAcceptorBuilder

Returns a new builder for a TlsAcceptor.

The identity acts as the server’s private key/certificate chain.

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

where S: Read + Write,

Initiates a TLS handshake.

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.

Trait Implementations

impl Clone for TlsAcceptor

fn clone(&self) -> TlsAcceptor

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<TlsAcceptor> for TlsAcceptor

fn from(inner: TlsAcceptor) -> TlsAcceptor

Converts to this type from the input type.