Struct async_acme::acme::Account

pub struct Account { /* fields omitted */ }

An Acout at an ACME provider. Used to query certificates and challanges

1. load_or_create your Account
2. place a new_order for your domains
3. check_auth for a single domain, if valid move to 6.
4. use tls_alpn_01 to get a certificate for it
5. trigger_challenge on that domain
6. repeat 3. - 5. for all other domains
7. send_csr for your cert …
8. … and finally obtain_certificate

Implementations

impl Account

pub async fn load_or_create<'a, C, S, I>(
    directory: Directory,
    cache: Option<&C>,
    contact: I
) -> Result<Self, AcmeError> where
    C: AcmeCache,
    S: AsRef<str> + 'a,
    I: IntoIterator<Item = &'a S>, 

Create or load a cached Account for ACME provider at directory. Provide your email in contact in the form mailto:admin@example.com to receive warnings regarding your certificate. Set a cache to remember/load your account.

pub async fn new_order(&self, domains: Vec<String>) -> Result<Order, AcmeError>

send a new order for the DNS identifiers in domains

pub async fn check_auth(&self, url: impl AsRef<str>) -> Result<Auth, AcmeError>

check the authentication status for a particular challange

pub async fn trigger_challenge(
    &self,
    url: impl AsRef<str>
) -> Result<(), AcmeError>

trigger a particular challange

pub async fn send_csr(
    &self,
    url: impl AsRef<str>,
    csr: Vec<u8>
) -> Result<Order, AcmeError>

request a certificate to be signed

pub async fn obtain_certificate(
    &self,
    url: impl AsRef<str>
) -> Result<String, AcmeError>

obtain a signed certificate for a privious CSR

pub fn tls_alpn_01<'a>(
    &self,
    challenges: &'a [Challenge]
) -> Result<(&'a Challenge, impl AsRef<[u8]>), AcmeError>

return a hash for first alpn challange. the hash needs to be presented inside the TLS certificate when the ACME TLS ALPN is present

Trait Implementations

impl Debug for Account

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

Formats the value using the given formatter.