Skip to content

A TLS implementation over AsyncRead and AsyncWrite

License

Notifications You must be signed in to change notification settings

zazabe/async-tls

This branch is up to date with async-rs/async-tls:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

245641a · Jan 18, 2024
Feb 1, 2023
Jan 18, 2024
Feb 1, 2023
Feb 21, 2017
Jul 15, 2020
Jan 18, 2024
May 9, 2017
May 9, 2017
Dec 4, 2020
Aug 4, 2019

Repository files navigation

async-tls

Async TLS/SSL streams using Rustls.


Maintenance Notice

I, Florian Gilcher, am currently the main maintainer of async-tls. Due to general workload, I would like the hand the maintenance off to someone else carrying the general vision of async-tls:

  • Runtime-independence
  • Backend-independence (currently not implemented)
  • Focused on use-case based configuration rather then exposing all configurations

I expect applicants for maintainership to present a committment of at least 4h of time/week initially, so I recommend getting corporate backing first. The number isn't strict, but I want the process to improve maintenance. I'm happy with a group of multiple maintainers.

I commit to weekly feedback of 30 minutes for the first 2 months - more in the initial days of handover.

If interested, please reach out to me at through email.

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.

[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.

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

Simple Client

use async_tls::TlsConnector;
use async_std::net::TcpStream;

// ...

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

// ...

Client Example Program

See examples/client. You can run it with:

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

Server Example Program

See examples/server. You can run it with:

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:

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

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.

About

A TLS implementation over AsyncRead and AsyncWrite

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 98.4%
  • Shell 1.6%