Skip to main content

letsencrypt_staging/
letsencrypt_staging.rs

1//! Staging configuration for validating DNS, firewall, and renewal behavior.
2//!
3//! Replace the hostname and address below with your real DNS name and public
4//! server address before running this example.
5
6use std::{net::IpAddr, path::PathBuf};
7use rustls_letsencrypt::{
8    register_alpn_handler, register_handler, subscribe_events, AcmeEndpoint, AlpnHandlerConfig,
9    DnsServer, EventOutput, LetsEncryptAcmeProfile,
10};
11use tokio::net::TcpListener;
12
13#[tokio::main]
14async fn main() -> Result<(), Box<dyn std::error::Error>> {
15    let host = "api.example.com";
16    let public_ip: IpAddr = "203.0.113.10".parse()?;
17    let listener = TcpListener::bind("0.0.0.0:443").await?;
18    let mut config = AlpnHandlerConfig::for_host(&host)?;
19    config.public_ip_addresses = vec![public_ip];
20    config.dns_servers = Some(vec!["udp://1.1.1.1:53".parse::<DnsServer>()?, "udp://8.8.8.8:53".parse::<DnsServer>()?]);
21    config.verify_dns_before_issuance = true;
22    config.cert_store_directory = PathBuf::from("./certs");
23    config.acme_endpoint = AcmeEndpoint::LetsEncrypt(LetsEncryptAcmeProfile::Staging);
24    config.acme_contacts = vec!["mailto:ops@example.com".into()];
25    config.events = EventOutput::Subscribe;
26    config.local_fallback_enabled = true;
27    let mut alpn_listener = register_alpn_handler(listener, Some(config)).await?;
28    let mut events = subscribe_events()?;
29    tokio::spawn(async move { while let Ok(Some(event)) = events.recv().await { eprintln!("staging event: {event}"); } });
30    tokio::spawn(async move {
31        while let Ok(Some(connection)) = alpn_listener.accept().await {
32            // Process incoming ACME/HTTPS traffic on 443 here, or close it if
33            // this application only needs port 443 for certificate issuance.
34            drop(connection.into_stream());
35        }
36    });
37
38    // Run the real LDAP-over-TLS service on 636. It transparently uses the
39    // certificate issued and cached by the 443 ACME listener.
40    let ldap_listener = TcpListener::bind("0.0.0.0:636").await?;
41    let mut ldap_listener = register_handler(ldap_listener).await?;
42    while let Some(connection) = ldap_listener.accept().await? {
43        tokio::spawn(async move { drop(connection.into_stream()); });
44    }
45    Ok(())
46}