- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
3.0 KiB
Executable File
3.0 KiB
Executable File
解决 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(草案)
*应用 = > `应用`.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)。 - 新增金样:
/deskgate +/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。