pub struct NewOrder<P: Persist> { /* private fields */ }
Expand description
A new order created by Account::new_order
.
An order is created using one or many domains (a primary CN
and possible multiple
alt names). All domains in the order must have authorizations (confirmed ownership)
before the order can progress to submitting a CSR.
This order façade provides calls to provide such authorizations and to progress the order when ready.
The ACME API provider might “remember” for a time that you already own a domain, which means you might not need to prove the ownership every time. Use appropriate methods to first check whether you really need to handle authorizations.
Implementations§
source§impl<P: Persist> NewOrder<P>
impl<P: Persist> NewOrder<P>
sourcepub fn is_validated(&self) -> bool
pub fn is_validated(&self) -> bool
Tell if the domains in this order have been authorized.
This doesn’t do any calls against the API. You must manually call refresh
.
In ACME API terms, the order can either be ready
or valid
, which both would
mean we have passed the authorization stage.
sourcepub fn confirm_validations(&self) -> Option<CsrOrder<P>>
pub fn confirm_validations(&self) -> Option<CsrOrder<P>>
If the order is_validated
progress it to a CsrOrder
.
This doesn’t do any calls against the API. You must manually call [refresh
].
sourcepub fn refresh(&mut self) -> Result<()>
pub fn refresh(&mut self) -> Result<()>
Refresh the order state against the ACME API.
The specification calls this a “POST-as-GET” against the order URL.
Provide the authorizations. The number of authorizations will be the same as the number of domains requests, i.e. at least one (the primary CN), but possibly more (for alt names).
If the order includes new domain names that have not been authorized before, this list might contain a mix of already valid and not yet valid auths.