Enum webpki::error::Error

source ·
#[non_exhaustive]
pub enum Error {
Show 38 variants BadDer, BadDerTime, CaUsedAsEndEntity, CertExpired, CertNotValidForName, CertNotValidYet, CertRevoked, EndEntityUsedAsCa, ExtensionValueInvalid, InvalidCertValidity, InvalidCrlNumber, InvalidNetworkMaskConstraint, InvalidSerialNumber, InvalidCrlSignatureForPublicKey, InvalidSignatureForPublicKey, IssuerNotCrlSigner, MalformedDnsIdentifier, MalformedExtensions, MalformedNameConstraint, MaximumNameConstraintComparisonsExceeded, MaximumPathBuildCallsExceeded, MaximumPathDepthExceeded, MaximumSignatureChecksExceeded, NameConstraintViolation, PathLenConstraintViolated, RequiredEkuNotFound, SignatureAlgorithmMismatch, UnknownIssuer, UnsupportedCertVersion, UnsupportedCriticalExtension, UnsupportedCrlVersion, UnsupportedDeltaCrl, UnsupportedIndirectCrl, UnsupportedRevocationReason, UnsupportedCrlSignatureAlgorithm, UnsupportedSignatureAlgorithm, UnsupportedCrlSignatureAlgorithmForPublicKey, UnsupportedSignatureAlgorithmForPublicKey,
}
Expand description

An error that occurs during certificate validation or name validation.

Variants (Non-exhaustive)§

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

BadDer

The encoding of some ASN.1 DER-encoded item is invalid.

§

BadDerTime

The encoding of an ASN.1 DER-encoded time is invalid.

§

CaUsedAsEndEntity

A CA certificate is being used as an end-entity certificate.

§

CertExpired

The certificate is expired; i.e. the time it is being validated for is later than the certificate’s notAfter time.

§

CertNotValidForName

The certificate is not valid for the name it is being validated for.

§

CertNotValidYet

The certificate is not valid yet; i.e. the time it is being validated for is earlier than the certificate’s notBefore time.

§

CertRevoked

The certificate, or one of its issuers, has been revoked.

§

EndEntityUsedAsCa

An end-entity certificate is being used as a CA certificate.

§

ExtensionValueInvalid

An X.509 extension is invalid.

§

InvalidCertValidity

The certificate validity period (notBefore, notAfter) is invalid; e.g. the notAfter time is earlier than the notBefore time.

§

InvalidCrlNumber

A CRL number extension was invalid:

  • it was mis-encoded
  • it was negative
  • it was too long
§

InvalidNetworkMaskConstraint

A iPAddress name constraint was invalid:

  • it had a sparse network mask (ie, cannot be written in CIDR form).
  • it was too long or short
§

InvalidSerialNumber

A serial number was invalid:

  • it was misencoded
  • it was negative
  • it was too long
§

InvalidCrlSignatureForPublicKey

The CRL signature is invalid for the issuer’s public key.

§

InvalidSignatureForPublicKey

The signature is invalid for the given public key.

§

IssuerNotCrlSigner

A CRL was signed by an issuer that has a KeyUsage bitstring that does not include the cRLSign key usage bit.

§

MalformedDnsIdentifier

A presented or reference DNS identifier was malformed, potentially containing invalid characters or invalid labels.

§

MalformedExtensions

The certificate extensions are malformed.

In particular, webpki requires the DNS name(s) be in the subjectAltName extension as required by the CA/Browser Forum Baseline Requirements and as recommended by RFC6125.

§

MalformedNameConstraint

A name constraint was malformed, potentially containing invalid characters or invalid labels.

§

MaximumNameConstraintComparisonsExceeded

The maximum number of name constraint comparisons has been reached.

§

MaximumPathBuildCallsExceeded

The maximum number of internal path building calls has been reached. Path complexity is too great.

§

MaximumPathDepthExceeded

The path search was terminated because it became too deep.

§

MaximumSignatureChecksExceeded

The maximum number of signature checks has been reached. Path complexity is too great.

§

NameConstraintViolation

The certificate violates one or more name constraints.

§

PathLenConstraintViolated

The certificate violates one or more path length constraints.

§

RequiredEkuNotFound

The certificate is not valid for the Extended Key Usage for which it is being validated.

§

SignatureAlgorithmMismatch

The algorithm in the TBSCertificate “signature” field of a certificate does not match the algorithm in the signature of the certificate.

§

UnknownIssuer

A valid issuer for the certificate could not be found.

§

UnsupportedCertVersion

The certificate is not a v3 X.509 certificate.

This error may be also reported if the certificate version field is malformed.

§

UnsupportedCriticalExtension

The certificate contains an unsupported critical extension.

§

UnsupportedCrlVersion

The CRL is not a v2 X.509 CRL.

The RFC 5280 web PKI profile mandates only version 2 be used. See section 5.1.2.1 for more information.

This error may also be reported if the CRL version field is malformed.

§

UnsupportedDeltaCrl

The CRL is an unsupported “delta” CRL.

§

UnsupportedIndirectCrl

The CRL contains unsupported “indirect” entries.

§

UnsupportedRevocationReason

The revocation reason is not in the set of supported revocation reasons.

§

UnsupportedCrlSignatureAlgorithm

The signature algorithm for a signature over a CRL is not in the set of supported signature algorithms given.

§

UnsupportedSignatureAlgorithm

The signature algorithm for a signature is not in the set of supported signature algorithms given.

§

UnsupportedCrlSignatureAlgorithmForPublicKey

The CRL signature’s algorithm does not match the algorithm of the issuer public key it is being validated for. This may be because the public key algorithm’s OID isn’t recognized (e.g. DSA), or the public key algorithm’s parameters don’t match the supported parameters for that algorithm (e.g. ECC keys for unsupported curves), or the public key algorithm and the signature algorithm simply don’t match (e.g. verifying an RSA signature with an ECC public key).

§

UnsupportedSignatureAlgorithmForPublicKey

The signature’s algorithm does not match the algorithm of the public key it is being validated for. This may be because the public key algorithm’s OID isn’t recognized (e.g. DSA), or the public key algorithm’s parameters don’t match the supported parameters for that algorithm (e.g. ECC keys for unsupported curves), or the public key algorithm and the signature algorithm simply don’t match (e.g. verifying an RSA signature with an ECC public key).

Implementations§

source§

impl Error

source

pub(crate) fn most_specific(self, new: Error) -> Error

source

pub(crate) fn rank(&self) -> u32

source

pub(crate) fn is_fatal(&self) -> bool

Returns true for errors that should be considered fatal during path building. Errors of this class should halt any further path building and be returned immediately.

Trait Implementations§

source§

impl Clone for Error

source§

fn clone(&self) -> Error

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for Error

1.30.0 · source§

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0 · source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
source§

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)
Provides type based access to context intended for error reports. Read more
source§

impl From<EndOfInput> for Error

source§

fn from(_: EndOfInput) -> Self

Converts to this type from the input type.
source§

impl From<Error> for ControlFlow<Error, Error>

source§

fn from(value: Error) -> Self

Converts to this type from the input type.
source§

impl PartialEq for Error

source§

fn eq(&self, other: &Error) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Copy for Error

source§

impl Eq for Error

source§

impl StructuralPartialEq for Error

Auto Trait Implementations§

§

impl Freeze for Error

§

impl RefUnwindSafe for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnwindSafe for Error

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.