Skip to main content

rustls_letsencrypt/
lib.rs

1//! Automatic, process-scoped certificate management for rustls servers.
2//!
3//! Register the challenge-capable listener first with [`register_alpn_handler`],
4//! then register ordinary listeners with [`register_handler`].
5
6mod cert;
7mod acme;
8mod config;
9mod domain;
10mod error;
11mod event;
12mod issuer;
13mod manager;
14mod store;
15mod tls;
16#[cfg(feature = "blocking")]
17pub mod blocking;
18
19pub use cert::{CertificateProvenance, StoredCertificate, StoredLocalCa};
20pub use config::{
21    AcmeEndpoint, AlpnHandlerConfig, AlpnHandlerConfigBuilder, DnsServer, DnsTransport, EventOutput, HostPattern,
22    LetsEncryptAcmeProfile, ManagedPebbleConfig,
23};
24pub use domain::DnsName;
25pub use error::{Error, Result, StoreError};
26pub use event::{Event, EventKind, EventLevel, EventReceiver};
27pub use issuer::{CertIssuer, IssueReason, IssueRequest, IssuedCertificate, LocalCaIssuer};
28pub use manager::{
29    get_certificate, install_local_ca, list_certificates, reload_local_ca, subscribe_events,
30};
31pub use store::{
32    AcmeStoreNamespace, CertStore, FolderCertStore, LocalStoreNamespace, StoreCapabilities,
33    StoreChange, StoreRevision,
34};
35pub use tls::{
36    register_alpn_handler, register_handler, AcceptedTls, ManagedTlsListener,
37};
38
39/// The ALPN protocol required by RFC 8737.
40pub const ACME_TLS_ALPN_NAME: &[u8] = b"acme-tls/1";