Struct tide_acme::AcmeConfig

pub struct AcmeConfig<EC, EA = EC> where
    EC: Debug,
    EA: Debug,  { /* private fields */ }

Configuration for an ACME resolver.

The type parameters represent the error types for the certificate cache and account cache.

Implementations

impl AcmeConfig<Infallible, Infallible>

pub fn new(
    domains: impl IntoIterator<Item = impl AsRef<str>>
) -> AcmeConfig<Infallible, Infallible>

Creates a new AcmeConfig instance.

The new AcmeConfig instance will initially have no cache, and its type parameters for error types will be Infallible since the cache cannot return an error. The methods to set a cache will change the error types to match those returned by the supplied cache.

use rustls_acme::caches::DirCache;
let config = AcmeConfig::new(["example.com"]).cache(DirCache::new("./rustls_acme_cache"));

Due to limited support for type parameter inference in Rust (see RFC213), AcmeConfig::new is not (yet) generic over the AcmeConfig’s type parameters. An uncached instance of AcmeConfig with particular type parameters can be created using NoCache.

use rustls_acme::caches::NoCache;
let config: AcmeConfig<EC, EA> = AcmeConfig::new(["example.com"]).cache(NoCache::new());

impl<EC, EA> AcmeConfig<EC, EA> where
    EC: 'static + Debug,
    EA: 'static + Debug, 

pub fn directory(self, directory_url: impl AsRef<str>) -> AcmeConfig<EC, EA>

pub fn directory_lets_encrypt(self, production: bool) -> AcmeConfig<EC, EA>

pub fn domains(
    self,
    contact: impl IntoIterator<Item = impl AsRef<str>>
) -> AcmeConfig<EC, EA>

pub fn domains_push(self, contact: impl AsRef<str>) -> AcmeConfig<EC, EA>

pub fn contact(
    self,
    contact: impl IntoIterator<Item = impl AsRef<str>>
) -> AcmeConfig<EC, EA>

Provide a list of contacts for the account.

Note that email addresses must include a mailto: prefix.

pub fn contact_push(self, contact: impl AsRef<str>) -> AcmeConfig<EC, EA>

Provide a contact for the account.

Note that an email address must include a mailto: prefix.

pub fn cache<C>(
    self,
    cache: C
) -> AcmeConfig<<C as CertCache>::EC, <C as AccountCache>::EA> where
    C: 'static + Cache, 

pub fn cache_compose<CC, CA>(
    self,
    cert_cache: CC,
    account_cache: CA
) -> AcmeConfig<<CC as CertCache>::EC, <CA as AccountCache>::EA> where
    CC: 'static + CertCache,
    CA: 'static + AccountCache, 

pub fn cache_with_boxed_err<C>(
    self,
    cache: C
) -> AcmeConfig<Box<dyn Debug + 'static, Global>, Box<dyn Debug + 'static, Global>> where
    C: 'static + Cache, 

pub fn cache_option<C>(
    self,
    cache: Option<C>
) -> AcmeConfig<<C as CertCache>::EC, <C as AccountCache>::EA> where
    C: 'static + Cache, 

pub fn state(self) -> AcmeState<EC, EA>

pub fn incoming<TCP, ETCP, ITCP>(
    self,
    tcp_incoming: ITCP
) -> Incoming<TCP, ETCP, ITCP, EC, EA> where
    TCP: AsyncRead + AsyncWrite + Unpin,
    ITCP: Stream<Item = Result<TCP, ETCP>>,