From 7ff0242c304117882dfca1f74908eb637ac73d84 Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Wed, 4 Nov 2026 01:18:24 +0800 Subject: [PATCH] =?UTF-8?q?fix(rbac):=20=E5=BD=95=E5=85=A5=E9=A1=B5?= =?UTF-8?q?=E8=B7=A8=E8=8F=9C=E5=8D=95=E4=BE=9D=E8=B5=96=E2=80=94=E2=80=94?= =?UTF-8?q?=E5=8F=AA=E6=9C=89=E3=80=8C=E6=9B=B4=E6=96=B0=E5=BD=95=E5=85=A5?= =?UTF-8?q?=E3=80=8D=E6=9D=83=E9=99=90=E4=B9=9F=E8=83=BD=E5=BD=95=E5=85=A5?= =?UTF-8?q?=E5=AE=9A=E5=88=B6=E9=A1=B9=E7=9B=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 问题:renderIntake / renderCustomIntake 要读 /custom/meta 与 /custom/projects、写 POST /custom/updates,这三个接口按 SEGMENT_MENU 全归 custom 菜单 → 仅有 intake 权限的账号进录入页直接 403 白屏(后端审计 B-3 发现)。 - guard 增加 assist 分支:GET custom/meta、GET custom/projects、POST custom/updates 按 custom / intake 中较高级别放行;定制本体(详情/新建/修改/归档/删除)仍严格 custom。 - 新增回归:intake-only 账号读 meta/清单 200、写交付记录 200、进定制详情/新建 403; staff-only 账号不享受 assist。 - README 权限章节与 MEMORY 同步 assist 口径 + EXPORT_MENU fail-closed 说明; MEMORY 记录 migrate_legacy_rbac 已下线(10-01 前旧库需经含迁移版本中转)。 - pytest 89 passed --- .workbuddy/memory/MEMORY.md | 4 ++-- README.md | 3 +++ app/security.py | 14 ++++++++++++++ tests/test_api_contract.py | 18 ++++++++++++++++++ 4 files changed, 37 insertions(+), 2 deletions(-) diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index 90e57ed..329326a 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -51,8 +51,8 @@ ## 登录与权限 / RBAC(2026-10-01 成体系) - 全站需**登录**:未登录访问 `/api/*` 返回 **401**。默认管理员 **admin / admin123**(`app/config.py` 的 `ADMIN_PASSWORD`,可用 `.env` 覆盖);另有 `user`(部门成员)。 -- **三层模型**:`users` ←(`user_roles`)→ `roles` ←(`role_menus`)→ 菜单授权。`role_menus` 一行 = 一个菜单一个级别(`rw` 可编辑 / `ro` 只读),**表里没这行 = 看不到该菜单**;一个用户可挂多个角色,最终权限取**并集**(同菜单取更高级别,`constants.merge_levels` + `LEVEL_RANK`)。旧库由 `security.migrate_legacy_rbac()` 从 `roles.menus` / `users.menus` JSON 迁过来。`audit_logs` 记写操作与登录行为。 -- **两端同时管**:前端 `canR/canW/can` 过滤侧栏与写操作按钮;后端 `security.guard` 按 `SEGMENT_MENU`(接口路径首段 → 菜单)二次校验,直接调接口绕不过去。菜单 = `constants.MENUS` 八项:board / projects / custom / focus / staff / intake / settings / rbac。 +- **三层模型**:`users` ←(`user_roles`)→ `roles` ←(`role_menus`)→ 菜单授权。`role_menus` 一行 = 一个菜单一个级别(`rw` 可编辑 / `ro` 只读),**表里没这行 = 看不到该菜单**;一个用户可挂多个角色,最终权限取**并集**(同菜单取更高级别,`constants.merge_levels` + `LEVEL_RANK`)。`security.migrate_legacy_rbac()`(一次性旧库迁移)已于 2026-11-04 删除——2026-10-01 之前形态的库要先跑含迁移的版本中转。`audit_logs` 记写操作与登录行为。 +- **两端同时管**:前端 `canR/canW/can` 过滤侧栏与写操作按钮;后端 `security.guard` 按 `SEGMENT_MENU`(接口路径首段 → 菜单)二次校验,直接调接口绕不过去。**唯一跨菜单开口**:录入定制项目要读的 `custom/meta`、`custom/projects`(GET) 与要写的 `custom/updates`(POST) 按 custom/intake 较高级别放行(guard 里的 assist 分支)。`/export/*` 未登记 `EXPORT_MENU` 一律 403(fail-closed)。菜单 = `constants.MENUS` 八项:board / projects / custom / focus / staff / intake / settings / rbac。 - **会话 = 服务端 token + HttpOnly Cookie `unis_session`**(`SESSION_DAYS=30`,启动时 `purge_expired_sessions()` 清过期)。**只认 Cookie,不认自定义头**;退出 / 停用 / 改密 / 强制下线都是删 token,立即失效。写脚本登录用 `http.cookiejar` + `POST /api/auth/login`,响应体是 user dict,**不含 token**。 - **防锁死**:`ensure_seed()` 保证至少留一个 `rbac: rw` 的启用账号;内置角色(管理员 / 部门成员 / 只读访客)`is_builtin`,禁止删除。 - **界面**:「权限管理」四个子页签 `#view-rbac .ctab[data-rbactab=roles|users|sessions|logs]`:角色权限(授权矩阵)/ 用户 / 在线会话(强制下线)/ 操作日志(菜单 + 动作 + 时间过滤,可清空)。 diff --git a/README.md b/README.md index 6486e9b..6b9bc4c 100644 --- a/README.md +++ b/README.md @@ -382,6 +382,9 @@ python scripts/legacy/add_entry_date.py --force # 全部重算 每个路由都挂了 `security` 的权限依赖,按路径首段映射菜单(`SEGMENT_MENU`), 读请求要求 `ro`、写请求要求 `rw`;越权返回 403 并记一条 `audit_logs`(`action=deny`)。 `/api/auth/*`、`/api/meta` 这类只要求登录,不看菜单,否则无法登录与自助改密。 + 录入页跨菜单依赖单独开口:`GET /api/custom/meta`、`GET /api/custom/projects`、`POST /api/custom/updates` + 按 **custom / intake 两者中较高的级别**判定——只有「更新录入 rw」的账号也能录入定制项目; + 定制本体(详情 / 新建 / 修改 / 归档)仍严格走 custom。新增这类跨菜单读接口要同步改 `security.guard` 的 assist 白名单。 - **内置角色**:`管理员`(全部 `rw`)、`部门成员`(业务菜单 `rw`,设置与权限只读/无)、`只读访客`(除权限外全部 `ro`), `is_builtin` 标记,不能删除。 - **不会被锁死**:系统始终保证至少有一个「启用 + 权限管理可编辑」的账号; diff --git a/app/security.py b/app/security.py index df4c329..38e3b4d 100644 --- a/app/security.py +++ b/app/security.py @@ -24,6 +24,7 @@ from sqlalchemy.orm import Session from . import config from .constants import ( LEVEL_LABELS, + LEVEL_RANK, LEVELS, MENU_KEYS, MENU_LABELS, @@ -225,6 +226,19 @@ def guard(request: Request, db: Session = Depends(get_db)) -> User | None: if request.method not in READ_METHODS and user.menus.get("rbac") != "rw": raise HTTPException(status_code=403, detail=f"「{MENU_LABELS['rbac']}」是只读权限,不能修改") return user + # 录入页跨菜单依赖:录入定制项目必须能读定制元数据 / 项目清单并写定制交付记录。 + # 只给「更新录入」权限的账号也要能完成录入,这三个接口按 custom / intake 两者中较高的级别放行; + # 定制项目其余接口(详情、修改、归档……)仍严格走 custom 菜单。 + assist = ((request.method in READ_METHODS and path in ("/api/custom/meta", "/api/custom/projects")) + or (request.method == "POST" and path == "/api/custom/updates")) + if assist: + need_write = request.method not in READ_METHODS + have = max((user.menus.get(m, "") for m in ("custom", "intake")), + key=lambda x: LEVEL_RANK.get(x, 0)) + if have and (not need_write or have == "rw"): + return user + raise HTTPException(status_code=403, + detail=f"录入定制项目需要「{MENU_LABELS['intake']}」或「{MENU_LABELS['custom']}」的可编辑权限") rule = resolve_rule(path, request.method) if rule is None: return user diff --git a/tests/test_api_contract.py b/tests/test_api_contract.py index 9166279..5ddf3b5 100644 --- a/tests/test_api_contract.py +++ b/tests/test_api_contract.py @@ -51,3 +51,21 @@ def test_操作日志服务端分页(h): ids0 = {x["id"] for x in p0["items"]} ids1 = {x["id"] for x in p1["items"]} assert not (ids0 & ids1) + + +def test_录入页跨菜单依赖(h): + """只给「更新录入 rw」的账号:能读定制 meta/清单、能写定制交付记录(录入闭环), + 但定制项目详情 / 新建仍归 custom 菜单。""" + pid = h.today_period_id + cp = h.custom("录入联动用定制项目") + c = h.user_client("intake_only", menus={"intake": "rw"}) + assert c.get("/api/custom/meta").status_code == 200 + assert c.get("/api/custom/projects").status_code == 200 + r = c.post("/api/custom/updates", json={"custom_project_id": cp["id"], "period_id": pid, "content": "只凭录入权限写的交付记录"}) + assert r.status_code == 200, r.text + # 定制项目本体操作不在 assist 白名单里 + assert c.get(f"/api/custom/projects/{cp['id']}").status_code == 403 + assert c.post("/api/custom/projects", json={"name": "越界新建"}).status_code == 403 + # 连 custom 读都没有的其它菜单账号(如只有 staff rw)不享受 assist + s = h.user_client("staff_only", menus={"staff": "rw"}) + assert s.get("/api/custom/projects").status_code == 403