hyper-rustls

June 7, 2024 ยท View on GitHub

This is an integration between the Rustls TLS stack and the hyper HTTP library.

Build Status Crate Documentation

Release history

Release history can be found on GitHub.

License

hyper-rustls is distributed under the following three licenses:

  • Apache License version 2.0.
  • MIT license.
  • ISC license.

These are included as LICENSE-APACHE, LICENSE-MIT and LICENSE-ISC respectively. You may use this software under the terms of any of these licenses, at your option.

Running examples

server

cargo run --example server

client

cargo run --example client "https://docs.rs/hyper-rustls/latest/hyper_rustls/"

Crate features

This crate exposes a number of features to add support for different portions of hyper-util, rustls, and other dependencies.

Feature flagEnabled by defaultDescription
aws-lc-rsyesEnables use of the AWS-LC backend for rustls
http1yesEnables HTTP/1 support in hyper-util
http2noEnables HTTP/2 support in hyper-util
webpki-tokionoUses a compiled-in set of root certificates trusted by Mozilla (via webpki-roots)
native-tokioyesUse the platform's native certificate store at runtime (via rustls-native-certs)
rustls-platform-verifiernoUse the operating system's verifier for certificate verification (via rustls-platform-verifier)
ringnoEnables use of the ring backend for rustls
tls12yesEnables support for TLS 1.2 (only TLS 1.3 supported when disabled)
loggingyesEnables logging of protocol-level diagnostics and errors via log
fipsnoEnables support for using a FIPS 140-3 compliant backend via AWS-LC (enables aws-lc-rs feature)