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§
- Admin
EnvConfig 🔒 - 初始管理员配置(来自
ADMIN_*环境变量)。 - Auth
Response - 认证接口统一响应结构。
- Current
User Response - 当前用户查询响应。
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 🔒