gray-matter 的 JS front-matter 引擎把用户可控字符串当 JavaScript 求值导致 RCE
web/nodejs · verified
一句话结论
当服务端把用户可控字符串交给 gray-matter 解析且未禁用其 JavaScript front-matter 引擎时,以 ---js\n<JS>\n--- 包裹的输入会在解析阶段被当作 JavaScript 执行,配合 Node 进程里的 require('child_process') 即构成任意命令执行(RCE)。
原理
- gray-matter 把文本头部的 front-matter 按分隔符后缀选择「引擎」:
---js表示这一段不是 YAML 而是 JavaScript,库会对其求值并把返回值当作 front-matter 数据对象,这是设计上的「可编程 front-matter」能力。 - 危险点在于求值发生在服务端 Node 进程里,且能拿到完整 Node 运行时(
require),因此 front-matter 内容等同于源码,可访问child_process、文件系统与环境变量。 - 为什么用户可控:本例把鉴权 token 中的自定义声明
slogon直接传给gray(decoded.slogon),再用gray.stringify(...)重新拼装后渲染。能控制该声明就控制了被求值的 JS 文本。 - 为什么走到 RCE:调用形如
gray.stringify(gray(payload).content, {username}),先求值的gray(payload)在 payload 以---js开头时即触发 JS 执行,与后面stringify是否渲染、是否丢弃 front-matter 数据无关。 - 前置门槛:该管理接口用 JWT 鉴权,而签名密钥硬编码在构建产物/源码里,攻击者可离线签发
username=admin且slogon任意的 token,从而抵达gray()调用点。「密钥硬编码可伪造 token」与「把不可信字段交给可编程解析器」两个缺陷叠加才闭环。
触发条件
- 服务端用 gray-matter(或同类支持 JS 引擎的 front-matter 库)解析用户可控文本;
- 未把引擎显式锁定为 YAML/JSON,未对分隔符做白名单;
- 用户能控制进入解析器的整段文本(这里通过伪造 token 的自定义声明);
- 应用以 Node 进程运行,JS 引擎内可
require('child_process'); - 存在离线签发/篡改 token 的途径(硬编码密钥、弱密钥、算法混淆等)。
利用步骤
- 定位把用户字段交给
gray()/matter()的调用点(如gray(decoded.slogon).content)。 - 取得该字段控制权:本例用硬编码 JWT 密钥签发含恶意
slogon的管理员 token。 - 把
slogon构造成---js\n<JS>\n---,JS 内用require('child_process').execSync(...)执行命令;输出可写入 Web 目录文件或外带到攻击者控制的地址。 - 携带伪造 token 请求管理接口,触发解析,JS 在服务端执行。
- 读取结果(访问生成的文件,或接收带外 HTTP/DNS 请求);对结果做 Base64 解码以还原特殊字符。
PoC
// 演示 JS front-matter 在解析阶段即执行;仅在授权环境验证
const gray = require('gray-matter');
const payload = '---js\n((require("child_process")).execSync("id > /tmp/pwned"))\n---x';
const profile = gray.stringify(gray(payload).content, { username: 'admin' });
// gray(payload) 求值时 execSync 已执行,/tmp/pwned 写入命令输出
# 前置:用硬编码密钥伪造管理员 token
import jwt, time
tok = jwt.encode(
{"username": "admin", "slogon": malicious_slogon,
"iat": int(time.time()), "exp": int(time.time()) + 604800},
"<HARDCODED_JWT_SECRET>", algorithm="HS256")
变体与关联
- 变体:YAML 解析器的
!!js/function、其他语言 templating/front-matter 的「可编程头」、服务端模板注入,同属「把数据当代码」类;即便应用只取.content而丢弃 front-matter 数据,执行也发生在取.content之前,不因丢弃而幸免。 - 关联:JWT 硬编码/弱密钥伪造、Node.js 反序列化 gadget、服务端模板注入(SSTI)。
检测与防御
- 防御:不要用 JS 引擎解析任何不可信 front-matter;显式
engines: { yaml: ... }并把分隔符锁死为普通 YAML;对用户字段做白名单校验(只接受普通字符串,拒绝换行与---);不要把鉴权 token 的自定义声明直接交给富文本/可编程解析器。 - 密钥:JWT 签名密钥由环境变量/密钥管理系统注入,禁止写入前端可见的构建产物与源码;轮换已泄露密钥。
- 检测:WAF/日志中出现以
---js/---javascript开头、含require(、child_process、execSync的字段值;Node 进程异常派生sh -c、Web 目录出现非预期新文件、异常外联。