Crate flexible_hyper_server_tls

This library lets you easily create a Hyper acceptor that be configured to either accept HTTP or HTTPS connections. This is useful for applications that users will self-host, and have the option to run as HTTP or provide their own HTTPS certificates. At the moment, this library only supports accepting HTTP/1 connections

Note: HTTP and HTTPS cannot be accepted at the same time, you decide which one to use when creating the acceptor.
If you want to use both HTTP and HTTPS, you can create 2 acceptors listening on different ports.

Features

• rustls_helpers (enabled by default): Provides some helpers for configuring TLS
• tls12 (enabled by default): Enables support for TLS 1.2
• aws_lc_rs (enabled by default): Uses the aws_lc_rs crate for cryptography
• ring: Uses the ring crate for cryptography

Example

use flexible_hyper_server_tls::*;
use http_body_util::Full;
use hyper::body::{Bytes, Incoming};
use hyper::service::service_fn;
use hyper::{Request, Response};
use std::convert::Infallible;
use tokio::net::TcpListener;

async fn hello_world(_req: Request<Incoming>) -> Result<Response<Full<Bytes>>, Infallible> {
    Ok(Response::new(Full::<Bytes>::from("Hello, World!")))
}

#[tokio::main]
async fn main() {
    let use_tls = true;

    let listener = TcpListener::bind("127.0.0.1:8080").await.unwrap();

    let mut acceptor = HttpOrHttpsAcceptor::new(listener);
     
    if use_tls {
        let tls = rustls_helpers::get_tlsacceptor_from_files("./cert.cer", "./key.pem").unwrap();
        acceptor = acceptor.with_tls(tls);
    }

    loop {
        if let Ok((peer_addr, conn_fut)) = acceptor.accept(service_fn(hello_world)).await {
            println!("New connection from {peer_addr}");

            tokio::spawn(async move {
                if let Err(err) = conn_fut.await {
                    eprintln!("Error serving connection: {err:?}")
                }
            });
        }
    }
}

Modules

rustls_helpers

Provides a couple of functions that assist in getting a TlsAcceptor from certificate and key data.

Structs

HttpOrHttpsAcceptor

Accept either an HTTP or HTTPS connection using Hyper

Enums

AcceptorError

Error when accepting connections