Skip to content

feat(webapp): RBAC 与 CSRF 中间件(#70 第二批) - #86

Merged
Antruly merged 1 commit into
masterfrom
feat/auth
Nov 22, 2026
Merged

Antruly merged 1 commit into
masterfrom
feat/auth

Conversation

@Antruly

@Antruly Antruly commented Nov 22, 2026

Copy link
Copy Markdown
Owner

Part of #70(第二批:RBAC + CSRF;密码哈希、登录限流、审计留后续)。

内容

新增 uvcpp_web_auth:

RBAC

  • 角色存在会话数据里(默认键 roles,逗号分隔);
  • uvcpp_session_set_roles() / uvcpp_session_has_role() / uvcpp_require_roles(list);
  • require_roles 是任一命中(OR);
  • 无会话 / 会话里没有角色键 → 401;有角色但不匹配 → 403;
  • skip_paths 按归一化路径精确匹配放行(登录、健康检查)。

CSRF(双提交 + 会话绑定)

  • 每会话生成随机 token,存会话并下发非 HttpOnly Cookie(前端 JS 可读),SameSite 默认 Strict;
  • 不安全方法(非 GET/HEAD/OPTIONS)要求 X-CSRF-Token 头或表单 _csrf,与会话 token 逐字节相同(常数时间比较),否则 403;
  • 没装会话中间件时 csrf_protect() 返回 500(配置错误不静默放行);
  • token 与会话绑定:注销/换会话后旧 token 失效。

用例

web_app_auth_func:

  1. 无角色访问 /admin → 401;
  2. POST /login 缺 CSRF → 403,带 X-CSRF-Token → 200 并写入 admin 角色,随后 /admin → 200;
  3. 要求 user 角色的队列里只有 admin → 403;
  4. 表单 _csrf= 路径同样通过;
  5. POST /admin 缺 token → 403、带 token → 200;
  6. CSRF Cookie 不含 HttpOnly、带 SameSite=Strict。

验证

build-all 171/171、build-h3 / build-default 编过;check_docs / check_doc_lines / check_doc_versions / check_ci_layout 全绿。文档 doc/webapp-guide.md §23。

新增 `uvcpp_web_auth`(`src/webapp/uvcpp_web_auth.*`):

- **RBAC**:角色存会话(默认键 `roles`,逗号分隔);`uvcpp_session_set_roles()`
  / `uvcpp_session_has_role()` / `uvcpp_require_roles(list)`(任一命中,OR);
  无会话或会话里没有角色键 → 401,有角色但不匹配 → 403;`skip_paths`
  精确匹配放行(登录/健康检查)。
- **CSRF(双提交 + 会话绑定)**:每会话随机 token,存会话 + 发**非 HttpOnly**
  Cookie(SameSite=Strict 可配);不安全方法(非 GET/HEAD/OPTIONS)要求
  `X-CSRF-Token` 头或表单 `_csrf` 与会话 token 逐字节相同,否则 403;
  token 比较走常数时间循环;没装会话中间件时返回 500(配置错误不静默放行)。

用例 `web_app_auth_func`:无角色 401、admin 登录后放行、要求 user 时 403、
缺/错 CSRF 403、头部与表单两条路径通过、CSRF Cookie 非 HttpOnly 且
SameSite=Strict。文档 `doc/webapp-guide.md` §23。

本地 build-all 171/171、build-h3/default 编过;五条文档门禁全绿。
@Antruly
Antruly merged commit 8f49c32 into master Nov 22, 2026
47 of 49 checks passed
@Antruly
Antruly deleted the feat/auth branch November 22, 2026 07:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant