认证方式
会话 Cookie
- 30 天过期
- HttpOnly, SameSite=Strict
- 通过
/api/auth/login登录时创建
API 密钥
Authorization头中的 Bearer 令牌(Authorization: Bearer bmx_...)- 密钥绑定到用户并继承其角色/权限
- 在数据库中使用 SHA-256 哈希存储
认证流程
authMiddleware首先检查 Bearer 令牌- 回退到会话 Cookie
- 两者都无效时返回 401 响应
免认证端点
| 端点 | 原因 |
|---|---|
/ | SPA 处理客户端认证 |
/api/health | 健康检查 |
/tgapi/* | 后端 API 代理(令牌即认证) |
默认管理员
首次运行时会创建默认管理员账户:- 用户名:
admin - 密码:
admin - 设置了
must_change_password标志——用户必须在首次登录时修改密码