导语:Wiki.js 权限越权漏洞 CVE-2026-120698 以 CVSS 8.8 的高危评分,暴露了一个在 GraphQL 授权层反复出现的经典缺陷——权限校验只看了“调用者是谁”,却没看“目标是谁”。一个仅持有
manage:users的普通管理账号,可以绕过目标组授权,重置包括 Root 在内的任意本地账号密码,清除其 TFA 状态,甚至通过传入空组数组清空管理员组关系,让整个实例陷入无合法manage:system持有者的失管状态。本文以架构师视角拆解这条攻击链的每一环,并给出可直接落地的应急与加固方案。
一、漏洞速览:Wiki.js 权限越权漏洞的攻击面全景
先看官方通告给出的关键事实:受影响版本为 2.5.315 之前的所有版本,攻击者只需一个持有 manage:users 权限的已认证账号,即可完成从“普通用户管理员”到“Root 接管”的完整提权。修复版本为 2.5.315。CVSS 3.1 评分 8.8,属于高危。
| 评估维度 | 漏洞现状(< 2.5.315) | 修复后(≥ 2.5.315) | 架构收益 |
|---|---|---|---|
| 目标账号权限校验 | 缺失,仅校验调用者权限 | 校验目标当前特权等级 | 阻断横向提权 |
| groups 参数缺省行为 | 省略即自动放行,绕过目标组授权 | 缺省不再触发授权绕过 | 消除隐式放行 |
| TFA 清除接口 | users.disableTFA 无目标权限校验 | 增加目标特权校验 | 保护二次认证 |
| 空组数组副作用 | groups: [] 可清空管理员全部组关系 | 受保护账号组关系不可被清空 | 防止实例失管 |
企业级架构规范
flowchart TD
subgraph 接入层 ["表现层与接入网关 (Client & Gateway Tier)"]
A["攻击者账号 (仅 manage:users)"] --> B["GraphQL API 网关 (认证通过)"]
end
subgraph 规则层 ["授权编排与上下文层 (Policy & Context Tier)"]
B --> C["调用者权限校验 (manage:users 通过)"]
C --> D{"目标账号特权校验?"}
D -->|"缺失 / 被省略"| E["授权绕过 (Bypass)"]
end
subgraph 领域层 ["核心执行与改写引擎 (Core Mutation Tier)"]
E --> F["users.update 重置目标密码"]
E --> G["users.disableTFA 清除 TFA 状态与密钥"]
E --> H["groups: [] 清空管理员组关系"]
end
subgraph 存储层 ["基础设施与数据存储 (Infrastructure Tier)"]
F --> I[("本地账号凭据库")]
G --> I
H --> J[("组关系与权限映射表")]
end
I --> K["Root 管理员被接管 / 实例失管"]
J --> K
二、根因拆解:三条独立缺陷如何串成一条提权链
2.1 缺陷一:users.update 的目标权限校验缺失
通告原文的关键描述是:攻击者“通过省略可选的 groups 参数”来修改任意本地账号的密码。这里的架构问题在于,users.update 这个 mutation 的授权判定只发生在“调用者是否拥有 manage:users”这一层,而没有下沉到“调用者是否有权操作这个目标账号”这一层。在成熟的多租户或分级管理系统中,这属于典型的 对象级授权(Object-Level Authorization)缺失,也就是 OWASP API Security Top 10 中的 BOLA 类问题。
更微妙的是 groups 参数被设计为可选。当它被省略时,服务端逻辑自动放行,跳过了“目标组授权”检查。这意味着攻击者不需要构造任何非法参数,只需要“不传参数”就能触发绕过——这种隐式放行比显式漏洞更难被 WAF 规则捕获。
2.2 缺陷二:users.disableTFA 无目标特权检查
即便密码被重置,如果目标账号启用了 TFA,攻击者仍然无法登录。因此这条攻击链的第二环是 users.disableTFA:该接口在清除 tfaIsActive 状态与 TFA secret 时,同样没有校验目标账号的当前特权。两个缺陷叠加,攻击者就获得了“改密码 + 关二次认证”的完整登录能力。
授权校验必须遵循“调用者权限 × 目标对象权限”的二维判定。任何只做一维校验的 mutation,在分级管理场景下都等价于一个潜在的提权入口。设计评审时,应把“目标对象是否比调用者权限更高”作为强制检查项写入代码规范。
2.3 缺陷三:groups: [] 的破坏性副作用
通告还指出,向 users.update 传入 groups: [] 可以移除选定管理员的全部组关系,导致安装实例中不再有合法账号持有 manage:system。这已经不是单纯的提权,而是可用性层面的拒绝服务:系统进入无人可管的失管状态,恢复只能依赖数据库直改或重装。此外,ID 大于 2 的其他管理员也可被停用或删除,进一步扩大破坏面。
如果你的 Wiki.js 实例存在多个持有 manage:users 的账号,且未启用审计日志,那么“管理员组被清空”这一操作可能长期不被发现。建议立即核查组关系表的变更记录,确认是否存在异常的 groups 清空行为。
三、应急响应:从检测到修复的标准动作
3.1 第一步:版本确认与升级
官方修复版本为 2.5.315。对于容器化部署,升级动作应当纳入标准发布流程,而不是手工热改。以下为 Docker Compose 场景的升级命令:
# 1. 备份数据库与配置卷(务必先做)
docker compose exec db pg_dump -U wikijs wikijs > backup_$(date +%F).sql
# 2. 拉取修复版本镜像并重建
docker compose pull wiki
docker compose up -d wiki
# 3. 验证版本号
docker compose exec wiki node -e "console.log(require('./package.json').version)"
# 期望输出 >= 2.5.315
3.2 第二步:临时缓解(无法立即升级时)
若生产环境因合规或变更窗口限制无法立即升级,可采取以下临时收敛措施,核心思路是收缩 manage:users 的持有面:
- 立即审计并回收所有非必要的
manage:users授权,仅保留 1 个应急账号; - 在反向代理层对
/graphql的users.update、users.disableTFA操作增加请求体关键字拦截与告警; - 为 Root 账号启用独立强口令,并开启登录审计与异地登录告警;
- 对组关系表建立定时快照,一旦检测到
manage:system持有者数量归零立即告警。
点击展开:Nginx 层 GraphQL 操作审计与拦截示例
# 在 http 段定义日志格式,记录 GraphQL 操作名
log_format graphql_audit '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'op=$request_body';
# 在 server 段对敏感 mutation 做告警(示例:记录含 disableTFA 的请求)
map $request_body $suspicious_op {
default 0;
~*disableTFA 1;
~*"groupss*:s*[s*]" 1;
}
server {
access_log /var/log/nginx/graphql_audit.log graphql_audit;
if ($suspicious_op) {
# 仅记录并告警,不建议直接 403 以免误伤正常运维
add_header X-Security-Alert "sensitive-mutation";
}
}
3.3 第三步:入侵痕迹排查
由于该漏洞可静默重置密码并关闭 TFA,排查重点应放在“凭据变更”与“组关系变更”两条时间线上:
- 核查
users表中updatedAt近期发生变更的账号,尤其是 Root 与高权限账号; - 核查
tfaIsActive是否被异常置为 false; - 核查组关系映射表中是否存在被清空的记录;
- 比对应用日志中
users.update与users.disableTFA的调用来源 IP。
-- 近 7 天被修改的账号 SELECT id, email, name, "updatedAt" FROM users WHERE "updatedAt" > NOW() - INTERVAL '7 days' ORDER BY "updatedAt" DESC; -- 当前 manage:system 持有者数量(期望 >= 1) SELECT COUNT(DISTINCT ug."userId") AS system_admins FROM user_groups ug JOIN group_permissions gp ON gp."groupId" = ug."groupId" JOIN permissions p ON p.id = gp."permissionId" WHERE p.name = 'manage:system'; -- TFA 状态异常账号 SELECT id, email, "tfaIsActive" FROM users WHERE "tfaIsActive" = false AND "updatedAt" > NOW() - INTERVAL '7 days';
排查阶段切勿直接删除可疑账号,应先禁用并保留取证快照。若已确认 Root 被接管,需在隔离网络环境下重置凭据、轮换所有 API 密钥与集成 Token,并检查是否被植入持久化后门(如新增的本地账号或 OAuth 应用)。
四、纵深防御:从 Wiki.js 权限越权漏洞看授权模型设计
这起 Wiki.js 权限越权漏洞并非孤例,它折射出 GraphQL 应用在授权设计上的三个系统性盲区。作为架构师,我更关心如何把这类问题在框架层消灭,而不是依赖每次 CVE 后的补丁。
4.1 授权判定下沉到对象层
建议在 GraphQL 中间件中引入统一的 authorizeTarget(caller, target, action) 钩子,强制所有涉及目标对象的 mutation 在 resolver 执行前完成二维校验。校验逻辑应包含:目标是否比调用者权限更高、调用者是否属于目标所在组、操作是否在允许的动作白名单内。
4.2 消灭“缺省即放行”
可选参数在授权语义上应当遵循缺省即拒绝或缺省即继承调用者上下文,绝不能缺省即绕过。对于 groups 这类影响授权结果的参数,建议改为必填,或在缺省时显式继承目标当前组关系而非跳过校验。
4.3 破坏性操作加装护栏
对于可能清空管理员组、删除高权限账号的操作,应加装“最后管理员保护”护栏:当操作会导致 manage:system 持有者数量归零时,直接拒绝并告警。这与数据库的“最后超级用户保护”是同一类设计模式。
把“最后管理员保护”做成平台级能力,而非业务代码里的 if 判断。它应当位于数据访问层之上、业务逻辑之下,对所有写路径生效,这样新增的 mutation 会自动继承保护,避免同类漏洞复发。
五、总结与行动清单
Wiki.js 权限越权漏洞 CVE-2026-120698 的本质,是授权校验在“调用者维度”与“目标维度”之间的断裂,叠加可选参数的隐式放行与破坏性操作的缺失护栏。修复版本 2.5.315 已发布,建议所有实例在 24 小时内完成升级;无法立即升级的,按本文第三节的临时缓解措施收敛攻击面,并按第四节的设计原则推动授权模型改造。
- 确认实例版本,低于 2.5.315 立即安排升级;
- 审计并回收非必要的
manage:users授权; - 建立
manage:system持有者数量监控与组关系快照; - 在 GraphQL 层引入对象级授权钩子与最后管理员保护;
- 对
users.update、users.disableTFA建立调用审计与异常告警。
