Struct NonceConfig

pub struct NonceConfig {
    pub default_ttl: Duration,
    pub time_window: Duration,
}

Configuration for nonce authentication system.

This struct provides a centralized way to configure the security parameters of the nonce authentication system, including TTL and time window settings.

Environment Variables

Configuration options can be set via environment variables:

• NONCE_AUTH_DEFAULT_TTL: Default TTL in seconds (default: 300)
• NONCE_AUTH_DEFAULT_TIME_WINDOW: Time window in seconds (default: 60)

Example

use nonce_auth::nonce::NonceConfig;
use std::time::Duration;

// Use default configuration
let config = NonceConfig::default();

// Create custom configuration
let config = NonceConfig {
    default_ttl: Duration::from_secs(600), // 10 minutes
    time_window: Duration::from_secs(120), // 2 minutes
};

Fields

default_ttl: Duration

Default time-to-live for nonce records

time_window: Duration

Time window for timestamp validation

Implementations

impl NonceConfig

pub fn from_env() -> Self

Creates a new configuration from environment variables.

Returns

A NonceConfig instance with environment variable values.

Example

export NONCE_AUTH_DEFAULT_TTL=600
export NONCE_AUTH_DEFAULT_TIME_WINDOW=120

pub fn production() -> Self

Creates a production-ready configuration.

Production settings prioritize security and stability:

• 5 minutes TTL (reasonable balance between security and usability)
• 1 minute time window (accounts for network delays and clock skew)

pub fn development() -> Self

Creates a development configuration.

Development settings prioritize convenience:

• 10 minutes TTL (longer window for testing)
• 2 minutes time window (more forgiving for local development)

pub fn high_security() -> Self

Creates a high-security configuration.

High-security settings prioritize maximum security:

• 2 minutes TTL (very short window to minimize exposure)
• 30 seconds time window (strict timing requirements)

pub fn validate(&self) -> Vec<String>

Validates the configuration and returns any warnings.

Returns

A vector of warning messages for potentially problematic settings.

pub fn summary(&self) -> String

Returns a summary of the current configuration.

Trait Implementations

impl Clone for NonceConfig

fn clone(&self) -> NonceConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NonceConfig

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

Formats the value using the given formatter.

impl Default for NonceConfig

fn default() -> Self

Returns the “default value” for a type.