async-tls

Features

async-tls can be used both in server and client programs. To save compilation times, you can switch off parts of this for faster compile times.

To only use async-tls on a client, deactivate default features and use the "client" feature.

toml [dependencies.async-tls] version = "0.8" default-features = false features = ["client"]

To only use async-tls on for the server side, deactivate default features and use the "server" feature.

toml [dependencies.async-tls] version = "0.8" default-features = false features = ["server"]

Simple Client

```rust use asynctls::TlsConnector; use asyncstd::net::TcpStream;

// ...

let tcpstream = TcpStream::connect("rust-lang.org:443").await?; let connector = TlsConnector::default(); let mut tlsstream = connector.connect("www.rust-lang.org", tcp_stream).await?;

// ... ```

Client Example Program

See examples/client. You can run it with:

sh cd examples/client cargo run -- hsts.badssl.com

Server Example Program

See examples/server. You can run it with:

sh cd examples/server cargo run -- 127.0.0.1:8080 --cert ../../tests/end.cert --key ../../tests/end.rsa

and point the client at it with:

sh cd examples/client cargo run -- 127.0.0.1 --port 8080 --domain localhost --cafile ../../tests/end.chain

NOTE: Don't ever use those certificate files anywhere but for testing!

Safety

This crate uses #![deny(unsafe_code)] to ensure everything is implemented in 100% Safe Rust.

License & Origin

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

This started as a fork of tokio-rustls.

Contribution

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