178 个 IPC 通道不可怕,可怕的是 preload 里那一行

今天人工智能榜第 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 由正则拼出来的工具,都要先手动构造每一类反例跑一遍再看结论。

可以直接照着做的五步

  1. 数注册数,得到一个基线。它不说明安全,只说明规模。
  2. 数可达数:把 preload 一个一个过,透传的按「等于注册数」记。
  3. 给通道配策略表,至少标出 exec 和 secret。这两类不做完,后面的减法没有意义。
  4. 数死暴露:preload 暴露了、渲染进程从没调用的,全部删掉。
  5. 给同步通道补 senderFrame 校验,白名单加一条启动期断言。

跑完这五步,你会得到一个比 178 小得多的数字。那个数字才叫攻击面。

回到那篇标题。逆向自己公司的桌面端是好事,能扒出 178 个通道也说明工程有底子。但「反而放心了」这个结论跳步了------注册通道数不等于可达通道数,可达通道数也不等于可被利用的通道数,中间每一步都有一个开关,而且这些开关通常没人守。

通道数是你给自己的心理安慰,可达通道数才是别人手里的入口。

相关推荐
颜进强19 分钟前
微信里冒出一个新 AI 入口,我们把接入它的每一步坑都写下来了
前端·ai编程
bai27322 分钟前
Node 22 里的等待:从回调到 Promise,一次上传流程的最小记录
前端
__sjfzllv___22 分钟前
在职前端Leader学习/转行 AI Agent -DAY104
前端
花椒技术27 分钟前
从 AI Demo 到直播间上线:全场一起猜的接入、排错与验收
前端·ai编程
花椒技术1 小时前
一名前端借助 AI ,6天把【神兔之争】游戏做进直播间
前端·ai编程
孟健1 小时前
用 HyperFrames 解决前端视频生成难题:国产 Flash 模型实测 3 条 1080p 视频
前端·人工智能·开源
super_Omni2 小时前
突破前端防御重围:现代 Web 媒体资产嗅探、CDN 逆向还原与反爬破壁架构实战
前端·架构·媒体
wuyk5552 小时前
Spider-第14讲-表单提交与CSRF
前端·爬虫·python·elasticsearch·csrf
AI多Agent协作实战派2 小时前
用 Python 做一个学生成绩管理系统(班级统计篇)
前端