Struct NonceManager 

pub struct NonceManager { /* private fields */ }

Nonce Manager | Nonce 管理器

Manages nonce generation and validation to prevent replay attacks 管理 nonce 的生成和验证以防止重放攻击

Implementations

impl NonceManager

pub fn new(storage: Arc<dyn SaStorage>, timeout: i64) -> NonceManager

Create new nonce manager | 创建新的 nonce 管理器

Arguments | 参数

• storage - Storage backend | 存储后端
• timeout - Nonce validity period in seconds | Nonce 有效期（秒）

pub fn generate(&self) -> String

Generate a new nonce | 生成新的 nonce

Returns | 返回

Unique nonce string | 唯一的 nonce 字符串

pub async fn store( &self, nonce: &str, login_id: &str, ) -> Result<(), SaTokenError>

Store and mark nonce as used | 存储并标记 nonce 为已使用

Arguments | 参数

• nonce - Nonce to store | 要存储的 nonce
• login_id - Associated user ID | 关联的用户ID

pub async fn validate(&self, nonce: &str) -> Result<bool, SaTokenError>

Validate nonce and ensure it hasn’t been used | 验证 nonce 并确保未被使用

Arguments | 参数

• nonce - Nonce to validate | 要验证的 nonce

Returns | 返回

Ok(true) if valid and not used, Ok(false) if already used 如果有效且未使用返回 Ok(true)，如果已使用返回 Ok(false)

pub async fn validate_and_consume( &self, nonce: &str, login_id: &str, ) -> Result<(), SaTokenError>

Validate and consume nonce in one operation | 一次操作验证并消费 nonce

Arguments | 参数

• nonce - Nonce to validate and consume | 要验证和消费的 nonce
• login_id - Associated user ID | 关联的用户ID

Returns | 返回

Ok(()) if valid, error if already used or invalid 如果有效返回 Ok(())，如果已使用或无效返回错误

pub fn check_timestamp( &self, nonce: &str, window_seconds: i64, ) -> Result<bool, SaTokenError>

Extract timestamp from nonce and check if it’s within valid time window 从 nonce 中提取时间戳并检查是否在有效时间窗口内

Arguments | 参数

• nonce - Nonce to check | 要检查的 nonce
• window_seconds - Time window in seconds | 时间窗口（秒）

pub async fn cleanup_expired(&self) -> Result<(), SaTokenError>

Clean up expired nonces (implementation depends on storage) 清理过期的 nonce（实现依赖于存储）

Note: Most storage backends automatically expire keys with TTL 注意：大多数存储后端会自动过期带 TTL 的键

Trait Implementations

impl Clone for NonceManager

fn clone(&self) -> NonceManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.