Enum Environment 

pub enum Environment {
    Staging,
    Production,
}

Which Let’s Encrypt directory a certificate is requested against.

Variants

Staging

https://acme-staging-v02.api.letsencrypt.org/directory. Untrusted certificates, generous rate limits. The default.

Production

https://acme-v02.api.letsencrypt.org/directory. Trusted certificates, strict rate limits.

Implementations

impl Environment

pub fn directory_url(&self) -> &'static str

The ACME directory URL for this environment.

pub fn issuer_domain(&self) -> &'static str

The issuer domain to name in this zone’s CAA record.

Both environments are Let’s Encrypt, so both answer the same thing: RFC 8659’s issue property names the authority, not the directory, and staging and production are two directories of one authority. It is derived from this enum rather than configured so that the record authorising an issuer and the directory the order is placed against cannot be made to disagree — a CAA record naming an authority this deployment does not use is an outage at the next renewal.

pub fn banner(&self) -> String

A one-line, hard-to-miss statement of which environment this is — meant for a startup log line, not for parsing.

pub fn parse(value: &str) -> Result<Self, String>

Parses "staging" or "production", case-insensitively. Anything else is refused rather than silently defaulting, because a typo that falls back to staging in what somebody believed was a production deploy is worse than a startup failure.

Trait Implementations

impl Clone for Environment

fn clone(&self) -> Environment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Environment

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

Formats the value using the given formatter.

impl Default for Environment

fn default() -> Environment

Returns the “default value” for a type.

impl Display for Environment

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

Formats the value using the given formatter.

impl PartialEq for Environment

fn eq(&self, other: &Environment) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Environment

impl Eq for Environment

impl StructuralPartialEq for Environment