Struct CookieManager 

pub struct CookieManager { /* private fields */ }

Thread-safe cookie challenge manager

Implementations

impl CookieManager

pub fn new(config: CookieConfig) -> Result<Self, CookieError>

Create a new cookie manager with the given configuration

Errors

Returns CookieError::InvalidSecretKey if the secret key is all zeros.

pub fn new_fallback(config: CookieConfig) -> Self

Create a new cookie manager with a best-effort fallback for invalid secrets.

This avoids panicking on invalid keys and logs a warning instead.

pub fn config(&self) -> &CookieConfig

Get the configuration

pub fn generate_tracking_cookie(&self, actor_id: &str) -> CookieChallenge

Generate a tracking cookie for an actor

pub fn validate_cookie( &self, actor_id: &str, cookie_value: &str, ) -> ValidationResult

Validate a cookie value for an actor

pub fn correlate_actor(&self, cookie_value: &str) -> Option<String>

Correlate cookie to actor - extract actor_id from valid cookie

This uses timing-safe comparison to find the actor whose hash matches. Note: This is O(n) where n is number of tracked actors. For large scale, consider maintaining a reverse lookup table.

pub fn stats(&self) -> &CookieStats

Get statistics

pub fn len(&self) -> usize

Get number of tracked challenges

pub fn is_empty(&self) -> bool

Check if no challenges are tracked

pub fn cleanup_expired(&self) -> usize

Remove expired challenges

pub fn clear(&self)

Clear all challenges

Trait Implementations

impl Debug for CookieManager

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

Formats the value using the given formatter.

impl Interrogator for CookieManager

fn name(&self) -> &'static str

Name of this interrogator

fn challenge_level(&self) -> u8

Challenge level (1-5, lower = softer)

fn generate_challenge(&self, actor_id: &str) -> ChallengeResponse

Generate a challenge for the actor

fn validate_response(&self, actor_id: &str, response: &str) -> ValidationResult

Validate a challenge response

fn should_escalate(&self, _actor_id: &str) -> bool

Check if actor should escalate to next level