Struct AuthorizationHandle

pub struct AuthorizationHandle<'a> { /* private fields */ }

An ACME authorization as described in RFC 8555 (section 7.1.4)

Authorizations are retrieved from an associated Order by calling Order::authorizations(). This type dereferences to the underlying AuthorizationState for easy access to the authorization’s state.

For each authorization, you’ll need to:

• Select which ChallengeType you want to complete
• Call AuthorizationHandle::challenge() to get a ChallengeHandle
• Use the ChallengeHandle to complete the authorization’s challenge

https://datatracker.ietf.org/doc/html/rfc8555#section-7.1.3

Implementations

impl<'a> AuthorizationHandle<'a>

pub async fn refresh(&mut self) -> Result<&AuthorizationState, Error>

Refresh the current state of the authorization

pub async fn deactivate(&mut self) -> Result<&AuthorizationState, Error>

Deactivate a pending or valid authorization

Returns the updated AuthorizationState if the deactivation was successful. If the authorization was not pending or valid, an error is returned.

Once deactivated the authorization and associated challenges can not be updated further.

This is useful when you want to cancel a pending authorization attempt you wish to abandon, or if you wish to revoke valid authorization for an identifier to force future uses of the identifier by the same ACME account to require re-verification with fresh authorizations/challenges.

pub fn challenge( &'a mut self, type: ChallengeType, ) -> Option<ChallengeHandle<'a>>

Get a ChallengeHandle for the given type

Yields an object to interact with the challenge for the given type, if available.

pub fn url(&self) -> &str

Get the URL of the authorization

Methods from Deref<Target = AuthorizationState>

pub fn identifier(&self) -> AuthorizedIdentifier<'_>

Creates an AuthorizedIdentifier for the identifier in this authorization

Trait Implementations

impl Deref for AuthorizationHandle<'_>

type Target = AuthorizationState

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.