Struct Account

pub struct Account { /* private fields */ }

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.