Expand description
Certificate revocation checking for pkix-path and pkix-chain.
Provides the RevocationChecker trait and implementations:
| Type | Feature | Description |
|---|---|---|
NoRevocation | (always) | Zero-cost; always reports not-revoked |
CrlChecker | crl | Offline CRL validation (you supply DER bytes) |
OcspChecker | ocsp | Offline OCSP response validation |
§no_std note
The core trait and NoRevocation are no_std. Feature-gated checkers
that perform network I/O are std-only and gated behind separate features.
§Security: anchor-issued certificate revocation
RevocationChecker::check_revocation_against_anchor has a default
implementation that returns Ok(()) (i.e., skips the check). Implementors
that require full-chain revocation coverage — including the certificate
issued directly by a trust anchor — MUST override this method. Failing
to override it will silently leave the anchor-issued certificate unchecked
with no compile error or runtime warning. See that method’s documentation
for details.
§Limitations
- No network I/O.
CrlCheckerandOcspCheckeroperate on caller-supplied DER bytes; this crate never opens a socket. Online fetching fromCRLDistributionPoints/AuthorityInfoAccessURIs lives in the optionalpkix-revocation-httpadapter crate. - OCSP response only. OCSP request construction (the DER bytes a
client POSTs to a responder) lives in
pkix-revocation-httpso it can stay paired with the HTTP transport. TheOcspCheckerin this crate validates already-fetched responses. - No OCSP stapling helpers. TLS-layer parsing of stapled responses
(RFC 6066 §8, multi-stapling RFC 6961) is a transport-protocol
concern handled by the TLS stack; once extracted, the response bytes
feed
OcspCheckerlike any other. - Algorithm coverage tracks
pkix-path. CRL and OCSP-response signature verification is delegated to aSignatureVerifier; the same algorithm gaps documented inpkix-path(Ed25519, P-521, RSA-PSS — tracked underPKIX-gphz) apply here.
Structs§
- CrlChecker
crl - Offline CRL-based revocation checker.
- DerError
- Opaque wrapper around an underlying ASN.1 / DER error.
- NoRevocation
- A no-op revocation checker that always reports certificates as not revoked.
- Ocsp
Checker ocsp - Offline OCSP-based revocation checker.
Enums§
- Error
- Errors returned by revocation checking.
- OutOf
Scope Reason - Reason a revocation check produced no determination.
Traits§
- Revocation
Checker - Pluggable revocation checking.
Functions§
- discover_
crl_ signer crl - Locate the certificate in
bundlethat signedcrl.
Type Aliases§
- Result
- Result alias for this crate.