Skip to main content

ChallengeManager

Struct ChallengeManager 

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

A rotating challenge manager that produces and validates challenges.

In production this rotates on a reviewed schedule (e.g. every 30 seconds with a 5-second overlap). Tests can use fixed values.

Implementations§

Source§

impl ChallengeManager

Source

pub fn new(initial: ServerChallenge, overlap_seconds: u64) -> Self

Create with an initial challenge and a rotation overlap. Self-rotation is disabled: the caller drives Self::rotate explicitly.

Source

pub fn rotating_for_domain( domain: ReplayDomainGuarantee, window_seconds: u64, overlap_seconds: u64, now: u64, ) -> Option<Self>

Create a self-rotating manager seeded from the OS CSPRNG, for a deployment whose replay admission domain is a single verifier instance.

Rotation is lazy rather than timer-driven: the current challenge is regenerated when its window has elapsed, at the moment it is next needed. A server that stops serving therefore cannot leave a stale challenge advertised, and there is no rotation task to stall.

Returns None for any other replay domain. Challenge validity is scoped to the replay admission domain and has one exact deadline shared by verification and replay garbage collection (§4.7): an independently random per-process challenge cannot provide that across several verifiers, so a shared or affine-routed domain must install a domain-wide challenge source instead of this one. Refusing here is why a multi-instance deployment cannot silently disagree about challenge freshness.

Source

pub fn rotating_with<F>( window_seconds: u64, overlap_seconds: u64, now: u64, generator: F, ) -> Self
where F: Fn() -> Vec<u8> + Send + Sync + 'static,

Self-rotating manager over an explicit value source. Production passes random_challenge_value; tests pass a deterministic sequence.

Source

pub fn current_or_rotate(&self, now: u64) -> Option<ServerChallenge>

The challenge to advertise on a denial, rotating first if the current window has elapsed.

Returns None only when the manager cannot produce one — a manager with no value source whose challenges have all expired. The caller then refuses service rather than advertising an unusable challenge.

Source

pub fn current(&self, now: u64) -> Option<ServerChallenge>

Get the current (newest still-valid) challenge for attaching to DispatchDenied. Returns None if rotation has stalled and all challenges have expired — the caller must refuse service rather than advertise an unusable challenge.

Source

pub fn validate(&self, presented: &[u8], now: u64) -> Option<u64>

Validate a presented challenge against all still-acceptable values. Returns the matched challenge’s accept_until if valid, or None. This atomically returns the deadline so the caller can compute min(proof.exp, accept_until) without a TOCTOU race against rotation.

Source

pub fn rotate(&self, value: Vec<u8>, window_seconds: u64, now: u64)

Rotate to a new challenge value. The previous challenge(s) remain accepted until their own accept_until deadline, so a retry that crosses rotation is not denied early.

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.

§

impl<T> Instrument for T

§

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

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

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

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

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

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: 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
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: 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
§

impl<T> ServiceExt for T

§

fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>
where Self: Sized,

Apply a transformation to the response body. Read more
§

fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using HTTP status codes. Read more
§

fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using gRPC headers. Read more
§

fn follow_redirects(self) -> FollowRedirect<Self>
where Self: Sized,

Follow redirect resposes using the Standard policy. Read more
Source§

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

Source§

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>,

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

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

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
§

fn with_current_subscriber(self) -> WithDispatch<Self>

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

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> MaybeSync for T
where T: Sync,