Skip to content

fix(auth): 修复超管抢注接管、限流器满表锁死、扩展路由缺 RBAC/CSRF - #3

Merged
ruanbw merged 4 commits into
fix/high-corefrom
fix/high-auth
Oct 8, 2026
Merged

ruanbw merged 4 commits into
fix/high-corefrom
fix/high-auth

Conversation

@ruanbw

@ruanbw ruanbw commented Oct 8, 2026

Copy link
Copy Markdown
Owner

基于 fix/critical-review,修复代码审查中的三个 High 级认证问题。

改动

1. 超管邮箱抢注接管(internal/bootstrap/bootstrap.go、internal/store/store.go)

  • 问题:启动时若 JANUS_SUPERADMIN_EMAIL 对应的普通账号已存在,会被直接提权并保留原密码。注册不需要能收信,任何人抢先用该邮箱注册即可带着自己的密码成为超管。
  • 修复:新增 Store.PromoteToSuperAdminResetCredentials,在同一事务内置 is_super_admin、清空 password_hash、自增 token_version、删除全部会话 —— 提权后必须通过发往该邮箱的一次性 setup token 首登。原子化是为了避免"已提权未清密码"时崩溃,重启后因 IsSuperAdmin=true 跳过清理。
  • 不再覆盖 banned 状态(只把 pending 收敛为 active),并打印警告日志;提权时同样打印警告。
  • 顺带修复:创建时撞上唯一约束(另一副本或并发注册的普通账号)的分支原先无条件置 active,现统一走「已存在」逻辑(普通账号先作废凭据再提权、封禁不复活)。
  • 抽出最小接口 tenantStore,公开签名 Superadmin(ctx, *store.Store, email) 不变。

2. 限流器桶表满时拒绝所有新来源(internal/httpapi/ratelimit.go)

  • 问题:8192 个 key 满且都未过期时,新 key 一律返回 false —— 喷满来源即可锁死全部新访客的登录/注册/跳转。
  • 修复:先清过期条目,仍满则按 lastSeen 淘汰最旧的 1/16(摊销排序成本),新来源永远能拿到桶;持续活跃的 key 不会被冲掉。
  • 新增 AllowIP / rateLimitKeyForIP:IPv4(含 IPv4-mapped)按单地址,IPv6 按 /64 前缀归并。认证限流、访客跳转、落地页资源、Caddy 授权端点的 IP 限流均改用 AllowIP;按邮箱分桶的限流不变。

3. 扩展路由缺 RBAC 与 CSRF(internal/httpapi/server.go、session.go、internal/rbac/rbac.go、pkg/janus/janus.go)

  • 问题:WithProtectedRoutes 注入的路由只挂在 authenticate() 上,没有 Casbin authorize(),也没有 CSRF 校验;authorize() 里的 is_protected_extension 放行分支没有任何代码设置该标记,是死代码。
  • 修复:
    • 扩展挂在 prot(已含 authorize())下的子组,并追加新中间件 csrfGuard()(复用 requireCSRF):cookie 认证的非安全方法必须带正确的 X-CSRF-Token;Bearer 免检;拿不到认证方式/会话时 fail-closed 403。
    • 挂载后对比路由表,把扩展实际注册的每条 (方法, 路径) 通过新增的 rbac.GrantTenantExtension 登记为 tenant 策略(不开前缀通配);superadmin 已由 /api/* 覆盖。
    • 默认策略:挂在 /api/admin/ 下,或首段为参数/通配(如 /api/:x、/api/*all,可能命中 /api/admin/...)的扩展路由不对租户放行,即超管专属并打印日志。扩展要声明「仅超管」,挂到 /api/admin/ 下即可。
    • 删除死代码分支;ginPathToCasbinPath(原未被使用)移至 rbac.GinPathToPolicyPath;修正 WithProtectedRoutes 文档注释。
  • 现有 pkg/janus/protected_routes_test.go 的用法(租户 JWT GET 扩展路由)不受影响。

验证

  • gofmt -l:本次改动的文件无输出(pkg/plugin/plugin_test.go 是既有问题,未改动)
  • go build ./...、go vet ./...:通过
  • 无数据库单元测试(全部通过):
    • internal/bootstrap:提权走凭据作废、封禁不复活、已是超管不重置、新建路径
    • internal/rbac:TestGrantTenantExtension、TestGinPathToPolicyPath
    • internal/httpapi:TestRateLimiterFullDoesNotLockOutNewClients、TestRateLimiterFullKeepsActiveBucketCount、TestRateLimiterExpiredPurgedFirst、TestRateLimitKeyForIP、TestRateLimiterIPv6SameSlash64SharesBucket、TestProtectedExtensionRoutesAuthorizeAndCSRF(13 个子用例)
    • 其余无 DB 包(config/domain/geo/jwt/mailer/rules/pkg/event/pkg/plugin)均通过
  • 新增需 Postgres 的黑盒回归(按仓库惯例写在 auth_test.go,本地无 DB 已 skip,未实际跑过):TestSuperadminBootstrapPromotionResetsCredentials、TestSuperadminBootstrapKeepsBannedTenantBanned。请在有 DB 的环境跑 JANUS_TEST_DB_REQUIRED=1 go test ./...。

已知取舍

  • 淘汰最旧条目意味着被淘汰来源的计数清零;但被淘汰的总是最久未活动的那批,且每喷一个新 key 本身就是一份独立额度,不比直接换来源更划算。

ruanbw added 2 commits October 8, 2026 07:13
- bootstrap: 提权既有普通账号为超管时原子作废其凭据(清空密码、自增 token_version、
  删除会话),强制走 setup token 首登;不再复活 banned 账号;并发注册分支同样处理
- ratelimit: 桶表满时淘汰最久未活动条目而非拒绝所有新来源;IPv6 按 /64 归并计数
- 扩展路由: WithProtectedRoutes 挂到 authorize() 组下并追加 CSRF 中间件,
  按实际注册的 (方法, 路径) 登记租户策略,/api/admin 下及首段通配的扩展仅超管可用;
  删除 authorize 中从未生效的 is_protected_extension 放行分支,修正文档注释
1. 跳转缓存语义
- 规则改写、多目标轮询、落地页与其余 302 一律 302 + Cache-Control: no-store
- 单目标 301 带有界缓存 private, max-age=JANUS_REDIRECT_301_MAX_AGE(默认 5m,0 = no-store);
  开启规则的短链 301 改为 no-store(仍保留 301 状态码)
- 注册 HEAD /{code},与 GET 同响应;HEAD 不记明细、不推进轮询指针

2. 访问明细移出请求路径
- 新增 httpapi.VisitQueue:有界队列 + worker 池 + 多行批量 INSERT,
  落库 ctx 与请求解耦(WithoutCancel + 超时),队列满丢弃并计数,批量失败逐行重试
- 后置访问钩子改为落库之后由队列触发;被丢弃的明细不触发钩子
- 未配置队列(黑盒测试)或队列已关闭时退回同步写入,同样不再随客户端断开取消
- cmd/janus 与 pkg/janus 在 http.Server.Shutdown 之后排空队列
- 新增 store.PickTargetFrom / InsertVisits,跳转不再二次读取 link_targets
- 连接池可配置 JANUS_DB_MAX_OPEN_CONNS(默认 25,空闲上限同值)
@ruanbw
ruanbw changed the base branch from fix/critical-review to fix/high-core October 8, 2026 07:23

ruanbw commented Oct 8, 2026

Copy link
Copy Markdown
Owner Author

已 rebase 到 fix/high-core(#6)之上,base 改为 fix/high-core,新 head 342861b。

无文本冲突。确认语义兼容:#6 的 initHandler 只在 New 中执行一次、业务路由经 NoRoute 委托给原子替换的 fallback;本 PR 的 mountProtectedExtensions(authorize + csrfGuard + 按实际注册路由登记租户策略)位于 httpapi.New 内,由 #6 的 fullHandler() 每次组装完整路由时调用一次,扩展回调不会被重复执行。

合并顺序:#1 → #6 → #3 → #2 → #4 → #5(请按此顺序依次合并;每个 PR 合并后,下一个 PR 的 base 会由 GitHub 自动改指向其上一级的目标分支)。

验证:每一步 rebase 后均 gofmt -l、go build ./...、go vet ./... 通过;在本地 Postgres 16 上 go test ./... -p 1(JANUS_TEST_DB_REQUIRED=1)全部通过,最终分支 fix/high-domains 连跑两遍均通过。

ruanbw and others added 2 commits October 8, 2026 07:25
@ruanbw
ruanbw merged commit 44ee500 into fix/high-core Oct 8, 2026
2 checks passed
@ruanbw
ruanbw deleted the fix/high-auth branch October 14, 2026 04: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