flexible-hyper-server-tls

Crates.ioflexible-hyper-server-tls
lib.rsflexible-hyper-server-tls
version0.5.0
sourcesrc
created_at2023-07-25 21:24:14.092215
updated_at2024-10-21 05:20:03.628995
descriptionEasily choose between HTTP or HTTPS when using hyper
homepage
repositoryhttps://github.com/ravenclaw900/flexible-hyper-server-tls
max_upload_size
id926022
size49,553
(ravenclaw900)

documentation

README

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;
    }
}
Commit count: 40

cargo fmt