Errors

ACME errors.

exception acme.errors.Error

Generic ACME error.

exception acme.errors.DependencyError

Dependency error

exception acme.errors.SchemaValidationError

JSON schema ACME object validation error.

exception acme.errors.ClientError

Network error.

exception acme.errors.UnexpectedUpdate

Unexpected update error.

exception acme.errors.NonceError

Server response nonce error.

exception acme.errors.BadNonce(nonce: str, error: Exception, *args: Any)

Bad nonce error.

exception acme.errors.MissingNonce(response: Response, *args: Any)

Missing nonce error.

According to the specification an “ACME server MUST include an Replay-Nonce header field in each successful response to a POST it provides to a client (…)”.

Variables

~.response (requests.Response) – HTTP Response

exception acme.errors.PollError(exhausted: Set[messages.AuthorizationResource], updated: Mapping[messages.AuthorizationResource, messages.AuthorizationResource])

Generic error when polling for authorization fails.

This might be caused by either timeout (exhausted will be non-empty) or by some authorization being invalid.

Variables

• exhausted – Set of AuthorizationResource that didn’t finish within max allowed attempts.

• updated – Mapping from original AuthorizationResource to the most recently updated one

property timeout: bool

Was the error caused by timeout?

exception acme.errors.ValidationError(failed_authzrs: List[messages.AuthorizationResource])

Error for authorization failures. Contains a list of authorization resources, each of which is invalid and should have an error field.

exception acme.errors.TimeoutError

Error for when polling an authorization or an order times out.

exception acme.errors.IssuanceError(error: messages.Error)

Error sent by the server after requesting issuance of a certificate.

exception acme.errors.ConflictError(location: str)

Error for when the server returns a 409 (Conflict) HTTP status.

In the version of ACME implemented by Boulder, this is used to find an account if you only have the private key, but don’t know the account URL.

Also used in V2 of the ACME client for the same purpose.

exception acme.errors.WildcardUnsupportedError

Error for when a wildcard is requested but is unsupported by ACME CA.