Struct acme2::Challenge

pub struct Challenge {
    pub type: String,
    pub status: ChallengeStatus,
    pub validated: Option<String>,
    pub error: Option<AcmeError>,
    pub token: Option<String>,
    // some fields omitted
}

A challenge represents a means for the server to validate that an account has control over an identifier (domain).

A challenge can only be acquired through an Authorization.

Fields

type: String

The type of challenge encoded in the object.

status: ChallengeStatus

The status of this challenge.

validated: Option<String>

The time at which the server validated this challenge.

error: Option<AcmeError>

Error that occurred while the server was validating the challenge, if any.

token: Option<String>

A random value that uniquely identifies the challenge.

Implementations

impl Challenge

pub fn key_authorization(&self) -> Result<Option<String>, Error>

The key authorization is the token that the HTTP01, or DNS01

pub async fn validate(&self) -> Result<Challenge, Error>

Initiate validation of the challenge by the ACME server.

Before calling this method, you should have set up your challenge token so it is available for the ACME server to check.

In most cases this will not complete immediately. You should always call Challenge::wait_done after this operation to wait until the ACME server has finished validation.

pub async fn poll(&self) -> Result<Challenge, Error>

Update the challenge to match the current server state.

Most users should use Challenge::wait_done.

pub async fn wait_done(
    self,
    poll_interval: Duration
) -> Result<Challenge, Error>

Wait for the authorization to go into the AuthorizationStatus::Valid or AuthorizationStatus::Invalid state.

Will complete immediately if the authorization is already in one of these states.

Trait Implementations

impl Clone for Challenge

pub fn clone(&self) -> Challenge

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Challenge

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Challenge

pub fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.