Struct AuthenticationManager 

pub struct AuthenticationManager { /* private fields */ }

认证管理器

统一管理用户认证、Token 生成和验证

Implementations

impl AuthenticationManager

pub fn new(jwt_secret: &[u8]) -> Self

创建新的认证管理器

参数

• jwt_secret - JWT 签名密钥（建议从环境变量读取）

pub fn with_config( jwt_secret: &[u8], access_expiration_secs: u64, refresh_expiration_secs: u64, ) -> Self

使用自定义配置创建认证管理器

pub async fn add_user(&self, user: User) -> AuthResult<()>

添加或更新用户（直接插入已哈希的 User）

适用于测试/迁移场景。生产用户注册应使用 register_user， 后者会验证密码强度并自动哈希。

pub async fn register_user( &self, username: &str, password: &str, role: &str, ) -> AuthResult<()>

注册新用户（验证密码强度 + 哈希 + 存储）

与 add_user 的区别：接收明文密码，内部执行 validate_strength → hash → insert 完整流程。适用于用户注册场景。

参数

• username - 用户名（同时作为内部用户 ID）
• password - 明文密码（需通过强度检查：≥8 字符 + 含字母 + 含数字）
• role - 用户角色

错误

密码强度不足时返回 AuthError::PasswordHash

pub async fn authenticate( &self, credentials: AuthCredentials, ) -> AuthResult<String>

用户认证

验证用户凭据并生成 JWT Token

pub fn verify_token(&self, token: &str) -> AuthResult<JwtClaims>

验证 JWT Token

pub fn refresh_token(&self, refresh_token: &str) -> AuthResult<String>

刷新访问令牌

pub async fn get_user(&self, username: &str) -> AuthResult<User>

获取用户信息

pub async fn remove_user(&self, username: &str) -> AuthResult<()>

删除用户