Struct BasicAuthBuilder

pub struct BasicAuthBuilder { /* private fields */ }

Builder for BasicAuth, provides extra convenience methods

Implementations

impl BasicAuthBuilder

pub fn new() -> Self

Create a new BasicAuthBuilder instance

pub fn user<U: Into<String>, P: Into<String>>( self, username: U, password: P, ) -> Self

Add a single user

pub fn users(self, users: HashMap<String, String>) -> Self

Add multiple users from HashMap

pub fn users_from_iter<I, U, P>(self, users: I) -> Self

where I: IntoIterator<Item = (U, P)>, U: Into<String>, P: Into<String>,

Add users from iterator

pub fn users_from_file<P: AsRef<Path>>(self, path: P) -> AuthResult<Self>

Load users from file (format: username:password, one per line)

pub fn validator(self, validator: Arc<dyn UserValidator>) -> Self

Set custom validator

pub fn realm<R: Into<String>>(self, realm: R) -> Self

Set authentication realm

pub fn case_sensitive(self, sensitive: bool) -> Self

Set username case sensitivity

pub fn with_cache(self, config: CacheConfig) -> Self

Enable authentication cache

pub fn disable_cache(self) -> Self

Disable authentication cache

pub fn cache_ttl_seconds(self, seconds: u64) -> Self

Set cache TTL (seconds)

pub fn cache_ttl_minutes(self, minutes: u64) -> Self

Set cache TTL (minutes, convenience)

pub fn cache_ttl_hours(self, hours: u64) -> Self

Set cache TTL (hours, convenience)

pub fn cache_size_limit(self, limit: usize) -> Self

Set cache size limit

pub fn path_filter(self, filter: PathFilter) -> Self

Set path filter

pub fn configure_paths<F>(self, configure: F) -> Self

where F: FnOnce(PathFilter) -> PathFilter,

Configure path filter (builder pattern)

pub fn skip_paths<I, P>(self, paths: I) -> Self

where I: IntoIterator<Item = P>, P: Into<String>,

Add skip paths (convenience)

pub fn max_header_size(self, size: usize) -> Self

Set request header size limit

pub fn log_failures(self, enabled: bool) -> Self

Enable authentication failure logging

pub fn max_concurrent_validations(self, max: usize) -> Self

Set maximum concurrent validations

pub fn validation_timeout(self, timeout: Duration) -> Self

Set validation timeout

pub fn rate_limit_per_ip(self, max_requests: usize, window: Duration) -> Self

Set rate limiting per IP

pub fn enable_metrics(self, enabled: bool) -> Self

Enable or disable metrics collection

pub fn log_usernames_in_production(self, enabled: bool) -> Self

Enable or disable logging usernames in production (security risk)

pub fn build(self) -> AuthResult<BasicAuth>

Build BasicAuth instance

pub fn try_build(self) -> AuthResult<BasicAuth>

Build and wrap error handling

Trait Implementations

impl Default for BasicAuthBuilder

fn default() -> Self

Returns the “default value” for a type.