罗罗编程学习记录
本页内容 展开查看

07.5.3 安全边界(contextIsolation、CSP、远程内容)

所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.5 Electron 与 Tauri

覆盖范围

  • contextIsolation、nodeIntegration、sandbox 的关系与推荐配置
  • CSP(Content Security Policy)在 Electron 中的配置
  • 远程内容加载风险(loadURL vs loadFile)
  • XSS 在 Electron 中的危害(如何从 XSS 到 RCE)
  • webPreferences 安全检查表

高频题速览

编号 题目 难度 频率
07.5.3-001 contextIsolation 的作用是什么?为什么必须开启? 基础 ★★★★★
07.5.3-002 nodeIntegration 为什么默认应关闭? 基础 ★★★★★
07.5.3-003 sandbox 是什么?开启后有什么限制? 进阶 ★★★★
07.5.3-004 CSP 在 Electron 中怎么配置? 进阶 ★★★★
07.5.3-005 为什么不要用 loadURL 加载远程页面? 基础 ★★★★★
07.5.3-006 XSS 在 Electron 中为什么特别危险? 进阶 ★★★★
07.5.3-007 如何安全地加载第三方网页? 进阶 ★★★
07.5.3-008 webPreferences 安全配置清单有哪些? 基础 ★★★★
07.5.3-009 远程模块(remote module)为什么被废弃? 进阶 ★★★
07.5.3-010 如何防止开发者工具被普通用户打开? 基础 ★★

07.5.3-001 contextIsolation 的作用是什么?为什么必须开启?

频率 ★★★★★ | 难度 基础

一句话结论

contextIsolation 让 preload 脚本的上下文与页面的 JS 上下文完全隔离:页面不能访问 preload 中的变量和函数,也不能篡改通过 contextBridge 暴露的 API;关闭后页面 JS 可以修改 preload 暴露的桥接函数,一旦 XSS 就能劫持所有 IPC 调用。

概念解释

  • 开启 contextIsolation 时:preload 运行在独立的 V8 上下文中,页面 window 与 preload window 不是同一个对象。
  • 关闭 contextIsolation 时:preload 和页面共享同一个 window,页面可以 window.desktopAPI.readFile = evilFunction,之后所有调用都被劫持。
  • Electron 12+ 默认开启 contextIsolation: true。

代码 / 示例

// 正确配置
new BrowserWindow({
  webPreferences: {
    contextIsolation: true,   // 必须 true
    nodeIntegration: false,   // 必须 false
    sandbox: true,           // 推荐 true
    preload: path.join(__dirname, 'preload.js')
  }
})

常见误区

  • 误区:「我不用 preload 暴露什么敏感 API,关了没关系」;正解:只要 preload 存在,关闭隔离就有被篡改的风险。
  • 误区:contextIsolation 开启后页面和 preload 完全不能通信;正解:通过 contextBridge.exposeInMainWorld 正常通信。

追问 / 延伸

  • contextIsolation 与 sandbox 的关系?sandbox 是更底层的 OS 级沙箱,contextIsolation 是 JS 上下文隔离,两者独立但配合使用。
  • 老项目升级到 contextIsolation: true 有什么注意?之前依赖共享 window 的代码会失效,需要全部走 contextBridge。

07.5.3-002 nodeIntegration 为什么默认应关闭?

频率 ★★★★★ | 难度 基础

一句话结论

nodeIntegration 开启后渲染进程可以直接 require Node.js 模块(fs、child_process 等),页面一旦有 XSS,攻击者就能执行任意系统命令;关闭后渲染进程没有 Node 能力,系统能力只能通过 preload 暴露的白名单函数调用。

概念解释

  • nodeIntegration 是 Electron 早期的设计(让渲染进程也用 Node),现代安全实践必须关闭。
  • 关闭后,渲染进程是一个纯 Chromium 环境,等价于浏览器中的网页。
  • 即使页面加载恶意远程内容,也只能在沙箱里搞破坏,不能逃出浏览器执行系统命令。

常见误区

  • 误区:「我的页面全是本地的,不会有 XSS」;正解:npm 依赖、CDN 脚本、第三方 SDK 都可能引入 XSS 风险。
  • 误区:nodeIntegration: true 是必须的;正解:所有 Node 能力通过 preload + IPC 暴露,不需要开启 nodeIntegration。

追问 / 延伸

  • nodeIntegration 与 sandbox 冲突吗?sandbox: true 会强制 nodeIntegration: false,两者不能同时开启。
  • 老项目依赖 nodeIntegration 怎么办?逐步迁移到 preload 桥接模式,这是唯一安全路径。

07.5.3-003 sandbox 是什么?开启后有什么限制?

频率 ★★★★ | 难度 进阶

一句话结论

sandbox 是 Chromium 的 OS 级沙箱机制:开启后渲染进程运行在受限的用户账户下,不能直接访问文件系统、不能生成子进程;preload 脚本也被限制,只能 require 有限的 Electron 模块(ipcRenderer、contextBridge),不能 require fs / path 等 Node 模块。

概念解释

  • sandbox 比 contextIsolation 更底层:contextIsolation 是 JS 层面的隔离,sandbox 是操作系统层面的隔离。
  • 开启 sandbox 后,即使渲染进程被完全攻破,攻击者也只能在沙箱内活动,不能读写系统文件。
  • 限制:preload 中不能 require Node 内置模块(除了 electron 的有限导出),不能用 __dirname / __filename。

代码 / 示例

new BrowserWindow({
  webPreferences: {
    sandbox: true,
    contextIsolation: true,
    nodeIntegration: false,
    preload: 'preload.js'
  }
})

// preload.js 在 sandbox: true 下只能这样写:
const { contextBridge, ipcRenderer } = require('electron')
// 不能 require('fs')、不能 require('path')

常见误区

  • 误区:sandbox 开启后 preload 不能做任何事;正解:preload 仍然可以通过 ipcRenderer.invoke 与主进程通信,所有 Node 操作由主进程完成。
  • 误区:sandbox 开启后窗口白屏;正解:通常是 preload 中用了被禁止的 require,检查控制台错误。

追问 / 延伸

  • 哪些 API 在 sandbox: true 下不可用?Node 内置模块、原生插件、process 大部分属性。
  • 为什么 Electron 15+ 默认 sandbox?安全最佳实践,老项目需要显式关闭。

07.5.3-004 CSP 在 Electron 中怎么配置?

频率 ★★★★ | 难度 进阶

一句话结论

在加载的 HTML 页面中通过 <meta http-equiv="Content-Security-Policy"> 设置 CSP,限制脚本、样式、图片的加载来源;Electron 推荐的严格策略是只允许自身来源的脚本,禁止内联脚本、禁止 eval、禁止远程脚本,从源头减少 XSS 可利用面。

概念解释

  • CSP 是浏览器的安全机制,Electron 的渲染进程完全支持。
  • 在 Electron 中配置 CSP 尤其重要:因为页面一旦 XSS,影响比普通网页更大(可以调用桥接 API)。
  • 关键指令:default-src 'self'、script-src 'self'、style-src 'self' 'unsafe-inline'(很多 UI 库需要内联样式)、img-src 'self' data:。

代码 / 示例

<!-- index.html head 中 -->
<meta http-equiv="Content-Security-Policy"
      content="default-src 'self';
               script-src 'self';
               style-src 'self' 'unsafe-inline';
               img-src 'self' data: https:;
               font-src 'self';
               connect-src 'self' https://api.example.com;">

常见误区

  • 误区:允许 script-src 'self' https://cdn.example.com;正解:CDN 被攻破或域名劫持就等于引入任意脚本,尽量把依赖打包到本地。
  • 误区:CSP 可以放松一点方便开发;正解:开发环境和生产环境用同一份 CSP,构建时不区分。

追问 / 延伸

  • 内联脚本被 CSP 阻止怎么办?把内联脚本抽到外部 .js 文件,或使用 nonce / hash 白名单。
  • CSP 报告怎么收集?配置 report-uri 或 report-to,收集违规事件。

07.5.3-005 为什么不要用 loadURL 加载远程页面?

频率 ★★★★★ | 难度 基础

一句话结论

loadURL('https://example.com') 让应用直接加载远程网页,等同于把浏览器塞进应用:远程服务器被攻破、域名被劫持、CDN 被污染都会导致应用执行恶意代码;即使有 contextIsolation,恶意代码仍能调用所有暴露的 IPC 桥接函数,造成数据泄露或系统操作。

概念解释

  • Electron 应用应该加载本地文件:win.loadFile('index.html'),所有前端资源打包在应用内。
  • 远程页面模式(如早期的很多 Electron 应用)本质上是「套壳浏览器」,安全边界完全依赖远程服务器。
  • 如果必须显示远程内容(如帮助文档、内嵌网页),应该在独立窗口中加载,且该窗口不暴露任何 Node 桥接 API。

常见误区

  • 误区:「我的网站是 HTTPS 的,安全」;正解:HTTPS 只防传输,不防服务器被攻破或供应链攻击。
  • 误区:loadURL 加载远程页面更新方便;正解:远程页面的风险远大于自动更新的便利,而且 Electron 的自动更新机制已经能解决版本更新问题。

追问 / 延伸

  • 必须内嵌网页怎么办?用 webview 标签或独立 BrowserWindow,配置 webPreferences 不包含 preload,且限制可以导航的域名。
  • 远程内容与本地交互怎么做?通过 postMessage,不暴露 IPC 桥接。

07.5.3-006 XSS 在 Electron 中为什么特别危险?

频率 ★★★★ | 难度 进阶

一句话结论

普通网页 XSS 只能偷 cookie、重定向;Electron 中 XSS 可以调用 preload 暴露的所有桥接 API(读文件、写文件、打开 shell、执行命令),直接升级为 RCE(远程代码执行),所以 Electron 的 XSS 防护比普通 Web 严格得多。

概念解释

  • 攻击链:页面有 XSS → 攻击者注入脚本 → 脚本调用 window.desktopAPI.readFile('/etc/passwd') → 数据外传。
  • 即使 nodeIntegration 关闭,preload 暴露的 API 也是攻击面。
  • 防护:严格 CSP(禁止内联脚本和 eval)、输入输出转义、依赖审计、最小化暴露的桥接 API。

常见误区

  • 误区:「XSS 是 Web 的问题,桌面应用不用管」;正解:Electron 的页面就是 Web 页面,所有 XSS 防护手段都适用。
  • 误区:用 innerHTML 渲染用户内容没事;正解:用户输入必须转义,或用框架的安全渲染(React 自动转义)。

追问 / 延伸

  • 如何审计 XSS?用 ESLint 规则禁止 innerHTML、eval、new Function,定期跑依赖漏洞扫描。
  • 桥接 API 太多怎么收敛?只暴露业务必需的,通用能力(如任意文件读写)不暴露,由业务 API 封装。

07.5.3-007 如何安全地加载第三方网页?

频率 ★★★ | 难度 进阶

一句话结论

在独立 BrowserWindow 或 <webview> 中加载第三方网页,该窗口不设置 preload(不暴露任何桥接 API),通过 setWindowOpenHandler 限制窗口跳转,通过 will-navigate / will-redirect 事件限制可以访问的域名,配合 CSP 限制资源加载。

概念解释

  • 第三方网页(如帮助中心、OAuth 授权页)不能与主应用共享桥接 API。
  • 限制导航:will-navigate 事件中判断新 URL 是否在白名单,不在则阻止。
  • 新窗口处理:setWindowOpenHandler 决定 window.open 的行为,防止弹出不可控窗口。
  • webview 标签:需要在 webPreferences 中设置 webviewTag: true,每个 webview 独立进程。

代码 / 示例

const externalWin = new BrowserWindow({
  webPreferences: {
    contextIsolation: true,
    nodeIntegration: false,
    sandbox: true
    // 不设置 preload
  }
})

externalWin.webContents.on('will-navigate', (event, url) => {
  const allowed = ['https://help.example.com', 'https://auth.example.com']
  if (!allowed.some(a => url.startsWith(a))) {
    event.preventDefault()
  }
})

externalWin.loadURL('https://help.example.com/docs')

常见误区

  • 误区:第三方窗口也用同一个 preload;正解:第三方页面可能被 XSS,会劫持桥接 API。
  • 误区:不限制导航,用户可以在应用内访问任意网站;正解:限制域名白名单,避免钓鱼和恶意内容。

追问 / 延伸

  • OAuth 回调怎么处理?监听 will-redirect 事件,识别回调 URL 后关闭窗口并把 token 传回主进程。
  • webview 标签和 BrowserWindow 哪个好?webview 嵌入在页面中,BrowserWindow 是独立窗口,根据 UX 选择。

07.5.3-008 webPreferences 安全配置清单有哪些?

频率 ★★★★ | 难度 基础

一句话结论

所有 BrowserWindow 的 webPreferences 必须满足:contextIsolation: true、nodeIntegration: false、sandbox: true(推荐)、webSecurity: true(默认,不要关)、enableRemoteModule: false、preload 只暴露白名单 API、禁止 devTools 在生产环境(可配置但要管控)。

概念解释

  • webSecurity: false 会禁用同源策略,非常危险,不要在生产使用。
  • enableRemoteModule: true 启用已废弃的 remote 模块,渲染进程可以直接引用主进程对象,必须关闭。
  • devTools: 开发环境开启,生产环境通过菜单或快捷键可以打开,但不应默认提供入口。

代码 / 示例

const isDev = process.env.NODE_ENV === 'development'

new BrowserWindow({
  webPreferences: {
    contextIsolation: true,
    nodeIntegration: false,
    sandbox: true,
    webSecurity: true,
    enableRemoteModule: false,
    devTools: isDev,
    preload: path.join(__dirname, 'preload.js')
  }
})

常见误区

  • 误区:为了调试方便设置 webSecurity: false;正解:这个设置会永久留在代码里,上线后就是漏洞。
  • 误区:enableRemoteModule 是默认的没关系;正解:Electron 14+ 已废弃,必须显式 false。

追问 / 延伸

  • 生产环境用户能不能打开 devTools?可以通过快捷键(Ctrl+Shift+I)打开,监控滥用情况,或打包时移除。
  • 还有哪些 webPreferences 需要注意?allowRunningInsecureContent(禁止 HTTPS 页面加载 HTTP 资源)、images、webgl 等。

07.5.3-009 远程模块(remote module)为什么被废弃?

频率 ★★★ | 难度 进阶

一句话结论

remote 模块让渲染进程可以直接引用主进程的对象(如 BrowserWindow、app),等同于在渲染进程中拥有完整 Node 能力;一旦 XSS,攻击者可以直接 require('electron').remote.require('child_process').exec(...),完全绕过 preload 的桥接限制;Electron 14+ 废弃,推荐用 IPC 替代。

概念解释

  • remote 模块早期设计目的:方便渲染进程调用主进程 API,不用写 IPC 样板。
  • 安全问题:它把主进程的对象代理到渲染进程,XSS 可以通过代理调用任意主进程方法。
  • 替代方案:所有主进程能力通过 ipcMain.handle 暴露,渲染进程通过 invoke 调用。

常见误区

  • 误区:remote 模块还能用,就继续用;正解:新版 Electron 已移除,必须迁移。
  • 误区:remote 只暴露给我自己的页面是安全的;正解:XSS 可以劫持 remote 代理。

追问 / 延伸

  • 老项目怎么迁移?逐一把 remote.xxx 调用改成 ipcMain.handle + ipcRenderer.invoke,preload 封装。
  • 有没有官方的迁移工具?Electron 官方有 @electron/remote 独立包,但仍然不安全,只建议过渡使用。

07.5.3-010 如何防止开发者工具被普通用户打开?

频率 ★★ | 难度 基础

一句话结论

生产环境通过 win.webContents.closeDevTools() 关闭已打开的 devTools,监听 before-input-event 阻止快捷键打开,菜单项中移除「开发者工具」入口;需要给特定用户(如内部测试)开放时,用隐藏快捷键或登录后才解锁。

概念解释

  • 用户打开 devTools 本身不是严重安全问题,但可以查看内部实现、调用 IPC 接口、篡改页面状态。
  • 防止方式:禁用快捷键、移除菜单入口、禁用 webContents 的 openDevTools 方法。
  • 完全禁止不现实(用户可以注入 DLL),但提高门槛即可。

代码 / 示例

// 生产环境禁用 devTools
if (!isDev) {
  win.webContents.on('before-input-event', (event, input) => {
    if (input.control && input.shift && input.key.toLowerCase() === 'i') {
      event.preventDefault()
    }
  })
  // 移除菜单中的 devTools 项
  const menu = Menu.getApplicationMenu()
  // 过滤掉 DevTools 相关项
}

常见误区

  • 误区:禁用 devTools 就能防 XSS;正解:devTools 只是辅助调试,XSS 防护靠 CSP 和输入校验。
  • 误区:生产环境完全不能有 devTools;正解:内部排障可能需要,用受控方式开放。

追问 / 延伸

  • 用户截图反馈怎么定位?接入崩溃监控和日志上报,不依赖 devTools。
  • 怎么判断用户是内部测试?根据登录账号或机器码,动态决定是否开放 devTools。

待整理清单

  • [ ] Electron 安全官方检查表(Electron Fuses)
  • [ ] 内容安全策略在 Electron 中的完整指令列表
  • [ ] webview 标签的安全配置