76 releases

0.26.2 Mar 1, 2025
0.26.1 Dec 5, 2024
0.26.0 Mar 22, 2024
0.25.0 Dec 5, 2023
0.1.6 Mar 31, 2017

#5 in Asynchronous

Download history 2911152/week @ 2025-01-12 2588553/week @ 2025-01-19 2797431/week @ 2025-01-26 3132970/week @ 2025-02-02 3265309/week @ 2025-02-09 3227874/week @ 2025-02-16 3509166/week @ 2025-02-23 3927104/week @ 2025-03-02 3903995/week @ 2025-03-09 4055654/week @ 2025-03-16 4220176/week @ 2025-03-23 3645989/week @ 2025-03-30 3980408/week @ 2025-04-06 3505514/week @ 2025-04-13 3473052/week @ 2025-04-20 3053358/week @ 2025-04-27

14,205,529 downloads per month
Used in 5,619 crates (654 directly)

MIT/Apache

67KB
1.5K SLoC

tokio-rustls

github actions crates license license docs.rs

Asynchronous TLS/SSL streams for Tokio using Rustls.

Basic Structure of a Client

use rustls_pki_types::ServerName;
use std::sync::Arc;
use tokio::net::TcpStream;
use tokio_rustls::rustls::{ClientConfig, RootCertStore};
use tokio_rustls::TlsConnector;

// ...

let mut root_cert_store = RootCertStore::empty();
root_cert_store.extend(webpki_roots::TLS_SERVER_ROOTS.iter().cloned());
let config = ClientConfig::builder()
    .with_root_certificates(root_cert_store)
    .with_no_client_auth();
let connector = TlsConnector::from(Arc::new(config));
let dnsname = ServerName::try_from("www.rust-lang.org").unwrap();

let stream = TcpStream::connect(&addr).await?;
let mut stream = connector.connect(dnsname, stream).await?;

// ...

Client Example Program

See examples/client.rs. You can run it with:

cargo run --example client -- hsts.badssl.com

Server Example Program

See examples/server.rs. You can run it with:

cargo run --example server -- 127.0.0.1:8000 --cert mycert.der --key mykey.der

License & Origin

This project is licensed under either of

at your option.

This started as a fork of tokio-tls.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in tokio-rustls by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~10–33MB
~742K SLoC