Files
marqdo/doc/design/ext-web-customization/03-auth-gates.md
2026-09-04 12:49:07 +08:00

3.0 KiB
Raw Permalink Blame History

解决 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. 目标

  1. 未登录策略一致:可配置 redirect(303 登录)或 forbid(403),对任意 gate 路径生效,不再「仅 /admin* 会跳登录」。
  2. 匹配语义清晰:支持精确路径、前缀、以及排除列表;/desk 默认不误伤 /desk/login。
  3. 默认 admin gate 使用 路径段边界(/admin 与 /admin/…),不匹配 /admin-publish。
  4. 登录 URL、表单 action、成功/失败回跳均可配置(与 C0 对齐)。

2. 作者 API(草案)

*应用 = > `应用`.auth users=`用户表` login_path="/desk/login" login_redirect="/desk"*
*应用 = > `应用`.gate path="/desk" roles="admin" match="prefix" on_deny="redirect" exclude="/desk/login"*
字段 说明
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。