Struct TlsConfig 

pub struct TlsConfig {
    pub acme_enabled: bool,
    pub acme_directory: String,
    pub acme_email: Option<String>,
    pub cert_dir: String,
    pub acme_staging: bool,
    pub cert_file: Option<String>,
    pub key_file: Option<String>,
    pub acme_directory_url: Option<String>,
    pub acme_root_pem: Option<String>,
}

TLS configuration.

Fields

acme_enabled: bool

Enable ACME (Let’s Encrypt)

acme_directory: String

ACME directory URL

acme_email: Option<String>

ACME contact email

cert_dir: String

Certificate storage directory

acme_staging: bool

Use staging ACME server

cert_file: Option<String>

PEM certificate chain for the HTTPS listener.

Set this and key_file to serve TLS from a certificate on disk. Without them there is no HTTPS listener at all, which means HTTP/2 is only reachable as cleartext h2c and WebSocket only as ws://.

key_file: Option<String>

PEM private key matching cert_file.

acme_directory_url: Option<String>

ACME directory URL.

Defaults to Let’s Encrypt production. acme_staging = true switches to staging, which issues untrusted certificates against far looser rate limits – use it until the whole flow works, because production’s limits are per-domain-per-week and are easy to exhaust while debugging.

acme_root_pem: Option<String>

A PEM root to trust for the ACME directory’s own TLS.

Only for a CA with a private root, which in practice means a test CA such as Pebble. Never needed for Let’s Encrypt.

Trait Implementations

impl Clone for TlsConfig

fn clone(&self) -> TlsConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TlsConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TlsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TlsConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TlsConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.