今天人工智能榜第 6 是那篇《我用 REA 逆向自己的 Electron 桌面端,扒出 178 个 IPC 通道后我反而放心了》。标题里的情绪我理解:数字够大,说明架构该有的分层都有,抽象做得挺完整。
但 178 这个数字,既不吓人,也不该让人安心。它量的是主进程注册了多少个 handler,而 handler 的数量跟攻击面之间,还隔着两层。
通道数为什么不能直接当攻击面
Electron 的进程结构里,渲染进程不能直接碰 Node,所有特权操作都要走 IPC。这中间有三样东西:
- 主进程用
ipcMain.handle/ipcMain.on注册通道,这是「有哪些能力」 - preload 用
contextBridge.exposeInMainWorld决定往页面里放什么,这是「能力怎么给出去」 - 渲染进程里的 JS 调
window.api.xxx,这是「谁能用」
178 是第一层。攻击面在第三层。
一层一层断了,数字就归零。三层全通,178 个通道一个不少全是入口。所以真正该数的不是注册数,是从渲染进程出发能走到底的通道数。
一行透传,注册数就直接等于可达数
我搭了一个最小复现工程:4 个模块,63 个通道,覆盖文件、工作区、Agent、系统四类,命名和真实桌面端一个路子。先写最省事的那版 preload:
js
const { contextBridge, ipcRenderer } = require("electron");
contextBridge.exposeInMainWorld("api", {
invoke: (channel, ...args) => ipcRenderer.invoke(channel, ...args),
send: (channel, ...args) => ipcRenderer.send(channel, ...args),
});
代码没有 bug,跑起来一切正常。它做的事只有一件:把「哪个通道可以开」的决定权,从主进程搬到了渲染进程。
而渲染进程里跑的 JS 是谁写的?是你,也可能是任何一个通过 XSS、恶意浏览器插件、被投毒的 npm 依赖、被篡改的远程配置进来的脚本。它现在不需要知道 63 个通道叫什么,只要会念一个字符串就行。
同一份主进程,跑两遍
换成白名单版本,主进程一行没改。跑完的结果是这样的:
| preload | 可达通道 | exec | secret | mutate | 高危合计 |
|---|---|---|---|---|---|
| 透传版 | 63 / 63 | 9 | 7 | 31 | 47 |
| 白名单版 | 15 / 63 | 0 | 0 | 2 | 2 |
注册数是 63,两版一模一样。可达数是 63 和 15,高危是 47 和 2,差了一个数量级。
「高危」怎么算?我给每个通道配了一张策略表,按后果分四类:
- exec :能让系统去打开或执行别的东西。
shell:open-external、shell:open-path、fs:reveal、fs:open-dialog、app:update:apply、fs:chmod、fs:zip/fs:unzip。这类通道本身就是跳板,一个 openExternal 配上 file://,或者配上自己注册的协议头,就能往下一跳。 - secret :能读出或改写凭证。
agent:key:get、agent:key:set、agent:config:set、net:proxy:set。桌面端把 API key 存在本地,这一类的价值比写文件高得多。 - mutate:能改本地状态。写文件、删目录、跑 Agent、改模型选择。
- read:只读。
63 个通道里 47 个不是只读。这个比例正常得不能再正常------一个能编辑文件的桌面端,大部分操作本来就要落盘。正因为正常,才不能靠「通道少」来求安心。
白名单也会腐化
白名单版暴露了 15 个方法,扫描渲染进程的实际调用,只命中 9 个。
剩下 6 个是:fs:exists、fs:hash、ws:settings:get、agent:status、agent:model:list、os:info。
这 6 个不报错、不告警、不影响功能,静静躺在 preload 里。它们大概是某个版本的临时需求留下的,需求下线了,暴露没下线。三年后没人记得为什么要暴露 fs:hash,也没人敢删------删了万一哪里在用呢。
每一个都是白送给 XSS 的入口。白名单不是一次性工作,它和业务代码一样会腐烂,而且腐烂得更安静,因为没有任何测试会覆盖「这个通道不该暴露」。
白名单只管能不能调,不管能调到哪
白名单版剩下的 13 个只读通道里,有一个是 fs:read。按我的策略表它算 read,零高危。但它仍然是危险的,因为策略表只看通道名,不看参数。
fs:read(p) 的 p 来自渲染进程。渲染进程传 /Users/me/.ssh/id_rsa,主进程就老老实实读出来。白名单在这里一句谎都没撒:它确实只放行了「读文件」这个动作,没放行「读任意文件」这件事------这两者之间的差别,只有参数校验能补上。
js
const ROOT = path.resolve(app.getPath("documents"), "workspace");
const inside = (p) => {
const r = path.resolve(ROOT, p);
return r === ROOT || r.startsWith(ROOT + path.sep);
};
ipcMain.handle("fs:read", async (_e, p) => {
if (!inside(p)) throw new Error("path outside workspace");
return fs.readFile(p, "utf8");
});
注意 ROOT + path.sep 那个后缀。少了它,/workspace-evil/x 会被判成在 /workspace 里,这是路径前缀校验最经典的一处漏。
所以完整的判定式是三段,不是一段:
攻击面 = 可达通道 ∩ 有副作用(包含参数域不受限的只读)∩ 没有来源校验
拿这个式子回头算我的 63 个通道:透传版是 63,白名单版是 15,再扣掉参数域没管的五个路径类只读通道(fs:read、fs:list、fs:stat、fs:exists、fs:hash),还剩 10。
数字一路往下砍,每一刀都得有理由。有理由的减法才叫审计,没理由的减法叫自我安慰。
最容易被漏掉的是同步通道
扫描器还会输出一行:同步通道 2 条,带来源校验 0 条。
ipcMain.on 和 ipcMain.handle 的区别不只是返回值。on 配 e.returnValue 就是同步调用,菜单、快捷键、拖拽这类场景经常这么用;而它的 e 里有 senderFrame,也就是这一枪是谁开的。
不查,任何 frame 都能开这一枪------包括 iframe、webview,包括 window.open 出来的子窗口。修法很短:
js
const TRUSTED = new Set(["app://index.html", "app://settings.html"]);
function trusted(e) {
const url = e.senderFrame?.url || "";
return [...TRUSTED].some((u) => url.startsWith(u));
}
ipcMain.on("fs:rename-sync", (e, from, to) => {
if (!trusted(e)) return; // 不抛错,直接丢弃
fs.renameSync(from, to);
});
注意这里返回的是「静默丢弃」而不是抛异常。被拒的调用方不该拿到「你这个通道存在但你没权限」这条信息。
烂掉的根因:两套坐标不同构
写到这里,最该说的其实不是怎么扫,是为什么会烂。
看通道名:fs:read、ws:list、agent:run、app:version。按业务域命名,没毛病。
看权限:读、写、执行。按后果分级。
这是两套坐标。加一个 fs:sync-folder,命名上毫无违和,但它该进 exec、mutate 还是 read?说不清。说不清的结果就是没人加,于是它掉进「没进表 = 按 read 处理」的默认桶。
默认桶就是漏洞。任何 default allow 的设计,最后都会长成透传。
要让纪律自动生效,得让权限位进名字:
js
// ro: 只读 rw: 可写 sys: 可打开外部程序或系统能力
const CHANNELS = {
"ro:fs/read": readFile,
"ro:fs/list": listDir,
"rw:fs/write": writeFile,
"sys:shell/open-external": openExternal,
};
const ALLOWED = new Set(["ro:fs/read", "ro:fs/list", "ro:fs/stat",
"rw:fs/write", "sys:agent/run"]);
// 启动期断言:权限位缺失、白名单指向不存在的通道,直接不让启动
for (const ch of Object.keys(CHANNELS)) {
if (!/^(ro|rw|sys):/.test(ch)) throw new Error(`通道缺权限位: ${ch}`);
}
for (const ch of ALLOWED) {
if (!CHANNELS[ch]) throw new Error(`白名单指向不存在的通道: ${ch}`);
}
if (![...ALLOWED].some((c) => c.startsWith("sys:"))) {
console.warn("没有任何 sys 通道被放行,确认是否漏配");
}
启动期报错比文档里加粗一行有效。文档没人读,启动失败所有人都会读。
扫描器核心
工具不复杂,四步:解析常量表、抓 ipcMain.* 注册、判断 preload 是否透传、取交集。
python
import re
from pathlib import Path
REG = re.compile(r"ipcMain\.(handle|handleOnce|on|once)\s*\(\s*([^,)]+)")
CONST = re.compile(r"^\s*([A-Z][A-Z0-9_]+)\s*:\s*[\"']([^\"']+)[\"']", re.M)
def registry(root):
# 1. 通道名基本都是 IPC.XXX 常量,先把常量表拍平
consts = {}
for f in Path(root).rglob("*.js"):
for name, val in CONST.findall(f.read_text(encoding="utf-8")):
consts[name] = val
# 2. 抓注册,把常量引用换成真名
reg = {}
for f in Path(root, "main").rglob("*.js"):
text = f.read_text(encoding="utf-8")
for m in REG.finditer(text):
raw = m.group(2).strip()
ref = re.match(r"[A-Za-z_$][\w$]*\.([A-Z0-9_]+)$", raw)
ch = consts.get(ref.group(1)) if ref else raw.strip("\"'")
if ch:
reg[ch] = m.group(1)
return reg
def exposed_block(text):
# 3. 只取 exposeInMainWorld 的对象体做括号配对
i = text.find("{", text.find("exposeInMainWorld("))
depth = 0
for j in range(i, len(text)):
depth += text[j] == "{"
depth -= text[j] == "}"
if depth == 0:
return text[i:j + 1]
return ""
def reachable(preload_text, reg):
block = exposed_block(preload_text)
# 4. 暴露对象里出现「channel 由调用方传入」且没守卫 = 透传
if re.search(r"\(\s*channel\b", block) and "ALLOWED.has(" not in preload_text:
return set(reg), "passthrough"
allowed = re.search(r"ALLOWED\w*\s*=\s*new Set\(\[(.*?)\]\)", preload_text, re.S)
names = re.findall(r"[\"']([^\"']+)[\"']", allowed.group(1)) if allowed else []
return set(names) & set(reg), "whitelist"
第一版我把判据写成「文件里出现 ipcRenderer.invoke(channel」,结果白名单版也被判成透传------因为守卫函数 call() 内部就是 ipcRenderer.invoke(channel, ...args)。
这挺讽刺的:一个专门用来抓「谁都能调」的脚本,自己先把「内部封装」和「对外暴露」混为一谈。所以判据必须落在暴露对象身上,不能落在文件里。凡是 verdict 由正则拼出来的工具,都要先手动构造每一类反例跑一遍再看结论。
可以直接照着做的五步
- 数注册数,得到一个基线。它不说明安全,只说明规模。
- 数可达数:把 preload 一个一个过,透传的按「等于注册数」记。
- 给通道配策略表,至少标出 exec 和 secret。这两类不做完,后面的减法没有意义。
- 数死暴露:preload 暴露了、渲染进程从没调用的,全部删掉。
- 给同步通道补
senderFrame校验,白名单加一条启动期断言。
跑完这五步,你会得到一个比 178 小得多的数字。那个数字才叫攻击面。
回到那篇标题。逆向自己公司的桌面端是好事,能扒出 178 个通道也说明工程有底子。但「反而放心了」这个结论跳步了------注册通道数不等于可达通道数,可达通道数也不等于可被利用的通道数,中间每一步都有一个开关,而且这些开关通常没人守。
通道数是你给自己的心理安慰,可达通道数才是别人手里的入口。