Skip to main content

Module auth

Module auth 

Source
Expand description

认证相关的 Dioxus server function。 认证相关的 Dioxus server function 与辅助函数。

提供注册、登录、登出、获取当前用户等接口, 通过 HttpOnly Cookie 维护会话,首个注册用户自动成为 admin。 也可通过 ADMIN_* 环境变量在启动时创建/同步初始管理员(env 为凭据源, 每次启动覆盖密码并确保 admin 角色),免去首次注册步骤——见 sync_admin_from_env。 所有 server function 均在 #[server(Name, "/api")] 下注册,供客户端与服务端调用。 仅在 feature = "server" 启用的服务端构建中执行数据库操作与 Cookie 写入。

Structs§

AdminEnvConfig 🔒
初始管理员配置(来自 ADMIN_* 环境变量)。
AuthResponse
认证接口统一响应结构。
CurrentUserResponse
当前用户查询响应。

Functions§

admin_env_active 🔒
ADMIN_* 初始管理员环境变量是否全部就位(即启动同步特性是否激活)。
get_current_admin_user
获取当前登录用户并要求其为 admin,否则返回 401/403。
get_current_user
获取当前登录用户的公开信息。
get_user_by_token
根据会话 token 查询对应用户(不含密码哈希,供会话缓存使用)。
login
用户登录。
logout
用户登出。
parse_admin_env 🔒
从环境变量读取初始管理员配置(ADMIN_USERNAME / ADMIN_EMAIL / ADMIN_PASSWORD)。
register
用户注册。
sync_admin_from_env 🔒
启动时按 ADMIN_* 环境变量同步初始管理员(env 是超级管理员的凭据源)。
validate_email 🔒
validate_password 🔒
validate_username 🔒