axum-server-dual-protocol

Description

Provides utilities to host a [axum-server] server that accepts the HTTP and HTTPS protocol on the same port. See [bind_dual_protocol].

A common use case for this is if a HTTPS server is hosted on a non-traditional port, having no corresponding HTTP port. This can be an issue for clients who try to connect over HTTP and get a connection reset error. For this specific purpose a [Layer] is provided that automatically upgrades any connection to HTTPS. See [UpgradeHttpLayer].

Usage

The simplest way to start is to use [bind_dual_protocol]: ```rust let app = Router::new().route("/", routing::get(|| async { "Hello, world!" }));

// User-supplied certificate and private key. let config = RustlsConfig::fromder(certificate, privatekey).await?;

axumserverdualprotocol::binddualprotocol(address, config) .serve(app.intomake_service()) .await?; ```

We now have a server accepting both HTTP and HTTPS requests! To use let app = Router::new() .route("/", routing::get(|| async { "Hello, world!" })) .layer(UpgradeHttpLayer); ```

MSRV

As this library heavily relies on [axum-server], [axum], [tower] and [hyper] the MSRV depends on theirs. At the point of time this was written the highest MSRV was [axum] with 1.56.

Changelog

See the [CHANGELOG] file for details.

License

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.

Contribution

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