Skip to main content

RevocationChecker

Struct RevocationChecker 

Source
pub struct RevocationChecker { /* private fields */ }
Expand description

Synchronous revocation checker with caching.

Checks bundle revocation status via online endpoints and CRL lists. Results are cached for the configured TTL to avoid redundant network requests.

The default transport uses rustls, validates and pins DNS results, disables redirects and proxies, and bounds every accepted response. A custom transport can be injected for deterministic tests.

Implementations§

Source§

impl RevocationChecker

Source

pub fn new(cache_ttl: Duration, timeout: Duration) -> Self

Create a new revocation checker.

§Arguments
  • cache_ttl - How long cached results remain valid.
  • timeout - Maximum time to wait for an HTTP response.
Source

pub fn with_limits( cache_ttl: Duration, timeout: Duration, max_cache_entries: usize, max_crl_cache_entries: usize, ) -> Self

Create a checker with explicit bounded cache capacities.

§Panics

Panics when either cache limit is zero.

Source

pub fn with_transport<T>( cache_ttl: Duration, timeout: Duration, transport: T, ) -> Self
where T: RevocationTransport + 'static,

Create a checker with an injected transport.

Source

pub fn check( &mut self, jti: &str, check_uri: Option<&str>, crl_uri: Option<&str>, ) -> RevocationStatus

Check the revocation status of a bundle by JTI.

Checks in order:

  1. Cache (if a cached result exists and has not expired).
  2. Online endpoint (if check_uri is provided).
  3. CRL (if crl_uri is provided).

If a configured check cannot establish status, returns a fail-closed unavailable status. A manifest with no revocation configuration remains not revoked.

Source

pub fn check_with_issuer( &mut self, jti: &str, check_uri: Option<&str>, crl_uri: Option<&str>, expected_issuer: Option<&str>, ) -> RevocationStatus

Check revocation while binding CRLs and cached decisions to an issuer.

Source

pub fn insert_crl(&mut self, uri: &str, crl: Crl)

Manually insert a CRL into the cache (useful for testing and offline operation).

Source

pub fn clear_cache(&mut self)

Clear all caches.

Trait Implementations§

Source§

impl Debug for RevocationChecker

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

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> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

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

Source§

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.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more