解决 3:鉴权 / 门禁可配置且行为一致
|
|
| 问题 |
研究 §3 |
| 优先级 |
P0 · 波次 C1(依赖 01 的 prefix) |
| 触点 |
plugins/web/src/http.rs(rbac_middleware、path_matches、login 表单)· lib.rs(web_app_auth / web_app_gate)· ext/web |
1. 目标
- 未登录策略一致:可配置
redirect(303 登录)或 forbid(403),对任意 gate 路径生效,不再「仅 /admin* 会跳登录」。
- 匹配语义清晰:支持精确路径、前缀、以及排除列表;
/desk 默认不误伤 /desk/login。
- 默认 admin gate 使用 路径段边界(
/admin 与 /admin/…),不匹配 /admin-publish。
- 登录 URL、表单
action、成功/失败回跳均可配置(与 C0 对齐)。
2. 作者 API(草案)
| 字段 |
说明 |
login_path |
登录页 URL(GET 表单 + POST 处理);默认 {admin_prefix}/login |
match |
exact | prefix(默认对自定义 gate 建议 prefix + exclude) |
on_deny |
redirect | forbid;redirect 时跳 login_path(可带 ?next=) |
exclude |
逗号分隔或表列:匹配前缀时放行的路径 |
auth 注册默认 gate 时:
- 使用
{admin_prefix} + 段边界,不要 starts_with("/admin") 裸前缀。
- 自动把
login_path 加入放行列表。
3. 插件改动点
| 改动 |
说明 |
path_matches |
增加 exact;prefix 要求下一字符为 / 或结尾;可选 exclude |
rbac_middleware |
按 gate 的 on_deny 分支;通用放行 login_path,不写死 /admin/login |
| 登录 HTML |
action={login_path};hidden next 可选 |
| Session/CSRF |
短期仍用框架实现;文档标明字段名;中期再开放 login_form 自定义字段映射(非本波次必做) |
4. 兼容策略
- 未传新字段:行为对齐现网(
/admin* → redirect 登录;其它自定义 gate → 403)。
- 新增金样:
/desk gate + /desk/login 可匿名打开。
5. 验收
| 场景 |
期望 |
visitor 访问 /desk(on_deny=redirect) |
303 → /desk/login,不是 403 |
visitor 访问 /desk/login(exclude) |
200 登录页 |
/admin-publish 无显式 gate |
不被默认 admin gate 拦住 |
旧站仅 app.auth |
仍保护 /admin* |
6. 过渡期 → 已落地
C1 已落地(2026-09): auth 默认段边界 prefix + on_deny=redirect + 排除 login_path;自定义 gate 可设 match / on_deny / exclude。金样 tests/ext/web-c1-gates.mq.md;单元测试 http::gate_tests。