#hyper-server #https-server #https #hyper #tls #http #tls-server

flexible-hyper-server-tls

Easily choose between HTTP or HTTPS when using hyper

8 releases (4 breaking)

new 0.5.0 Oct 21, 2024
0.4.0 Sep 4, 2024
0.3.0 Mar 15, 2024
0.2.1 Mar 14, 2024
0.1.1 Jul 26, 2023

#959 in Network programming

Download history 268/week @ 2024-07-01 126/week @ 2024-07-08 222/week @ 2024-07-15 245/week @ 2024-07-22 187/week @ 2024-07-29 221/week @ 2024-08-05 257/week @ 2024-08-12 270/week @ 2024-08-19 86/week @ 2024-08-26 342/week @ 2024-09-02 206/week @ 2024-09-09 261/week @ 2024-09-16 232/week @ 2024-09-23 255/week @ 2024-09-30 256/week @ 2024-10-07 238/week @ 2024-10-14

983 downloads per month

MIT/Apache

16KB
196 lines

Flexible Hyper Server TLS

A library that lets you choose whether to accept HTTPS or HTTP connections with Hyper. Very useful for situations where applications are self-hosted and the user gets to optionally provide their own HTTPS certificates.

This library also provides some helper functions that simplify the TLS setup by using the safe defaults from Rustls.

The aim of this library is to be simple and have minimal extra dependencies, while still allowing the user to customize things like TLS config.

For situations where you don't need to choose between HTTP and HTTPS, check out simple-hyper-server-tls or tls-listener.

Usage

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)
        .with_err_handler(|err| eprintln!("Error serving connection: {err:?}"));

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

    loop {
        acceptor.accept(service_fn(hello_world)).await;
    }
}

Dependencies

~12–28MB
~599K SLoC