一、起源
1.1 三类攻击面
| 攻击面 | 入口 | 被利用后的后果 |
|---|---|---|
| 渲染内容 | 加载的远程页面、注入的脚本、被污染的数据 | 调用已暴露的系统能力,读写文件与凭据 |
| 本地能力 | 通信通道、协议唤起、文件关联、外部程序调用 | 越权访问目录、执行非预期程序、伪造身份 |
| 分发链路 | 更新包、安装包、第三方依赖 | 下发被篡改的版本,形成持久化控制 |
1.2 与网页风险的关键差别
网页中的脚本被限制在浏览器沙箱内,危害主要限于当前站点数据;桌面应用中一旦隔离被削弱,脚本即可获得与用户同等的本地权限。因此桌面应用的安全基线不是可选项,而是默认配置,任何为图方便而关闭隔离的做法都需要明确评估并记录。
1.3 取舍
| 选择 | 获得 | 付出 |
|---|---|---|
| 保持完整隔离 | 边界清晰,注入后果有限 | 系统能力必须经通道显式提供,开发成本上升 |
| 关闭部分隔离以简化开发 | 少写一层通道代码 | 一旦内容被注入即等同于本地任意操作,风险不可控 |
二、原理
2.1 渲染进程的三项基线配置
| 配置 | 作用 | 关闭后的后果 |
|---|---|---|
| 上下文隔离 | 页面脚本与预加载脚本运行在互不可见的环境中 | 页面脚本可直接改写桥接实现,绕过所有校验 |
| 沙箱 | 限制渲染进程可用的系统接口 | 渲染进程可访问更底层的系统能力 |
| 禁用运行时直连 | 页面脚本不能直接引入运行时模块 | 页面可直接读写文件与执行命令 |
三项配置相互独立但共同构成边界:只开其中一项仍留有绕过路径。现代版本默认已启用前两项,显式声明可以避免被后续改动意外关闭。
另外两项需要保持默认的配置是"网页安全策略"与"不允许运行不安全内容":前者一旦关闭,同源限制失效;后者允许加密页面加载明文资源,为注入提供通道。
2.2 内容加载策略
| 策略 | 说明 |
|---|---|
| 只加载可信内容 | 应用界面应来自本地产物或自有域名,不加载第三方页面 |
| 避免远程内容 | 需要展示外部内容时,用系统浏览器打开或使用受限容器,不要加载进应用窗口 |
| 内容安全策略 | 限制脚本与样式与连接来源,阻断内联脚本执行 |
| 禁止不安全混合内容 | 加密页面不允许加载明文资源,避免被中间人注入 |
内容安全策略的落地方式有两种:页面内的元信息声明,或由会话拦截响应头注入。响应头注入更可靠,因为元信息方式无法覆盖所有响应,也无法限制部分指令。策略应先以报告模式观察,确认无误拦后再强制生效。
2.3 导航与新窗口控制
默认情况下,页面中的链接点击与脚本跳转可能导致应用窗口导航到站外地址,或弹出新窗口加载任意内容。必须在两处拦截:
| 拦截点 | 处理方式 |
|---|---|
| 导航 | 校验目标是否为允许的来源,非允许时阻止并改为外部打开 |
| 新窗口 | 拒绝创建,需要打开时改为外部打开 |
| 嵌入内容 | 不允许页面自行嵌入外部内容,或严格限制其来源与能力 |
原则是"应用窗口只显示自有内容,外部内容一律交给系统浏览器"。这条原则同时解决了安全与体验问题:用户在系统浏览器中拥有完整的地址栏与扩展能力。
2.4 通信边界
三条约要求:暴露的能力按最小粒度设计,一个通道只做一件事;所有参数在主进程侧校验类型与范围;每条消息校验来源是否为预期界面。
具体实现见 进程间通信与预加载。需要强调的是一条结论:参数校验放在界面侧只是提示,只有放在主进程才构成约束,因为界面脚本可以被注入内容改写。
2.5 权限与设备访问
| 权限 | 默认处理建议 |
|---|---|
| 相机与麦克风 | 默认拒绝,按功能显式授予并记录 |
| 地理位置 | 默认拒绝 |
| 通知 | 按需授予,注意与主进程通知的区别 |
| 剪贴板与屏幕捕获 | 按需授予,屏幕捕获应有明显提示 |
| 外部协议打开 | 由是否放行具体协议决定 |
权限请求与权限查询需要同时处理:只有请求处理器而没有查询处理器时,部分接口仍会按默认策略放行或拒绝,导致行为不一致。
2.6 会话、证书与凭据
| 关注点 | 要求 |
|---|---|
| 证书错误 | 不允许忽略证书错误;需要自签证书时按环境的可信根处理,而不是全局放行 |
| 请求拦截 | 拦截请求时只做白名单内的改写,不注入来自不可信来源的内容 |
| 会话隔离 | 不同信任级别的内容使用不同会话,避免共享存储与凭据 |
| 数据清理 | 提供清理缓存与凭据的入口,退出登录时清除相关数据 |
| 凭据存放 | 不把密钥写入应用包;需要本地保存时使用系统密钥链加密能力 |
应用包不是安全存储:打包只是归档,不能防止解包查看,因此不能把密钥与服务端凭据放入产物。本地必须保存的敏感数据应使用系统密钥链提供的加密接口。
2.7 打包完整性与调试入口
| 措施 | 作用 |
|---|---|
| 归档校验 | 校验应用资源的完整性,防止被替换后仍可运行 |
| 功能开关 | 关闭不需要的高权限能力,如允许以运行时方式执行脚本 |
| 只从归档加载 | 限制只从打包归档中加载应用代码 |
| 关闭调试入口 | 正式包中不自动开启开发者工具,也不开放调试参数 |
这些措施的意义是提高"二次打包与注入"的门槛:即使攻击者拿到安装目录,替换资源后也可能因完整性校验失败而无法运行。
2.8 代码签名与公证
| 平台 | 要求 | 未签名的后果 |
|---|---|---|
| Windows | 使用代码签名证书对可执行文件与安装包签名 | 系统安全提示与拦截,杀毒软件误报概率上升 |
| macOS | 开发者证书签名加公证加启用强化运行时 | 系统安全机制会阻止启动或提示来源不可信 |
| Linux | 无统一强制要求 | 应由发布流程提供校验值与签名文件供用户核对 |
签名不仅是"让系统放行",也是自动更新的前提:部分平台的更新机制要求新旧版本均由同一身份签名,否则更新会被拒绝或安装后无法启动,因此签名凭据必须妥善保管并在发布流程中固定使用。
2.9 自动更新的信任链
| 环节 | 要求 |
|---|---|
| 更新源 | 必须使用加密通道,且与签名身份一致 |
| 更新包校验 | 校验签名与摘要,防止被替换为篡改版本 |
| 版本单调性 | 只允许升级到更高版本,防止通过降级安装存在缺陷的旧版本 |
| 通道分离 | 稳定与测试通道使用不同的更新地址,避免测试版下发到正式用户 |
| 灰度 | 按比例放量并保留暂停能力 |
自动更新的完整链路与发布流程见 打包签名与发布。
2.10 依赖与供应链
| 风险 | 说明 | 处置 |
|---|---|---|
| 依赖漏洞 | 打包进应用的所有依赖都随应用分发 | 定期审计并对直接依赖优先处置 |
| 原生模块权限 | 原生模块以完整权限运行,可绕过部分隔离 | 限制引入,必要时逐项评估 |
| 第三方脚本 | 页面引入的外部脚本可读取页面全部内容与已暴露能力 | 尽可能不引入,必须引入时加完整性校验 |
| 构建产物泄露 | 未压缩与带源映射的产物会暴露实现细节 | 正式包不带源映射,错误上报单独管理 |
三、实现
3.1 安全基线配置
// main/security.js:集中声明安全基线,避免散落在各处
const { app, session, shell, BrowserWindow } = require('electron');
const path = require('node:path');
const TRUSTED_ORIGINS = new Set(
app.isPackaged
? ['file://']
: ['http://localhost:5173', 'file://']
);
function isTrustedUrl(url) {
try {
const parsed = new URL(url);
if (parsed.protocol === 'file:') return TRUSTED_ORIGINS.has('file://');
return TRUSTED_ORIGINS.has(parsed.origin);
} catch {
return false;
}
}
function secureWebPreferences() {
return {
preload: path.join(__dirname, 'preload.js'),
contextIsolation: true, // 上下文隔离
sandbox: true, // 渲染进程沙箱
nodeIntegration: false, // 页面不得直连运行时
nodeIntegrationInWorker: false,
webSecurity: true, // 保持网页安全策略默认开启
allowRunningInsecureContent: false,
experimentalFeatures: false,
webviewTag: false, // 不使用内嵌网页容器
spellcheck: false,
};
}
function applySessionHardening() {
const ses = session.defaultSession;
// 注入安全响应头(比页面内声明更可靠)
ses.webRequest.onHeadersReceived((details, callback) => {
callback({
responseHeaders: {
...details.responseHeaders,
'Content-Security-Policy': [
"default-src 'self'; " +
"script-src 'self'; " +
"style-src 'self' 'unsafe-inline'; " +
"img-src 'self' data: blob:; " +
"connect-src 'self' https://api.example.com; " +
"object-src 'none'; base-uri 'self'; frame-ancestors 'none'",
],
},
});
});
// 权限请求:默认拒绝,仅放行明确需要的
ses.setPermissionRequestHandler((webContents, permission, callback) => {
const allowed = new Set(['notifications', 'clipboard-sanitized-write']);
callback(allowed.has(permission));
});
ses.setPermissionCheckHandler((webContents, permission) => {
const allowed = new Set(['notifications', 'clipboard-sanitized-write']);
return allowed.has(permission);
});
// 证书错误:一律拒绝,需要自签证书时通过可信根解决
app.on('certificate-error', (event, webContents, url, error, certificate, callback) => {
event.preventDefault();
console.warn('[security] 证书校验失败', url, error);
callback(false);
});
}
function applyNavigationHardening(win) {
// 导航拦截:非可信来源一律阻止并交外部打开
win.webContents.on('will-navigate', (event, url) => {
if (!isTrustedUrl(url)) {
event.preventDefault();
openExternalSafely(url);
}
});
// 新窗口:拒绝创建,改为外部打开
win.webContents.setWindowOpenHandler(({ url }) => {
if (/^https?:$/.test(new URL(url).protocol)) {
openExternalSafely(url);
}
return { action: 'deny' };
});
// 禁止页面自行嵌入外部内容
win.webContents.on('will-attach-webview', (event) => {
event.preventDefault();
});
}
const ALLOWED_PROTOCOLS = new Set(['https:', 'http:', 'mailto:']);
function openExternalSafely(url) {
try {
const parsed = new URL(url);
if (!ALLOWED_PROTOCOLS.has(parsed.protocol)) return false;
shell.openExternal(parsed.toString());
return true;
} catch {
return false;
}
}
module.exports = {
secureWebPreferences,
applySessionHardening,
applyNavigationHardening,
openExternalSafely,
isTrustedUrl,
};
// main.js 中使用
const { app, BrowserWindow } = require('electron');
const security = require('./security');
app.whenReady().then(() => {
security.applySessionHardening();
const win = new BrowserWindow({
show: false,
webPreferences: security.secureWebPreferences(),
});
security.applyNavigationHardening(win);
win.once('ready-to-show', () => win.show());
// ... 加载界面
});
3.2 本地敏感数据
// main/secure-store.js:使用系统密钥链能力加密本地数据,而不是明文保存
const { safeStorage, app } = require('electron');
const fs = require('node:fs/promises');
const path = require('node:path');
const storePath = path.join(app.getPath('userData'), 'secure.dat');
async function saveSecret(plainText) {
if (!safeStorage.isEncryptionAvailable()) {
// 系统不支持时不应退化为明文保存,而是提示并禁用该功能
throw Object.assign(new Error('系统加密能力不可用'), { code: 'E_NO_KEYCHAIN' });
}
const encrypted = safeStorage.encryptString(plainText);
await fs.writeFile(storePath, encrypted, { mode: 0o600 });
}
async function loadSecret() {
try {
const encrypted = await fs.readFile(storePath);
return safeStorage.decryptString(encrypted);
} catch {
return null;
}
}
module.exports = { saveSecret, loadSecret };
要点:应用包内不得写入任何密钥;本地必须保存的敏感数据依赖系统密钥链加密,且系统不支持时应禁用相关功能而不是降级为明文。
3.3 安全自检清单
| 类别 | 核对项 |
|---|---|
| 渲染进程 | 上下文隔离与沙箱已启用,页面未直连运行时,未使用内嵌网页容器 |
| 内容 | 只加载自有内容,已注入内容安全策略,未关闭网页安全策略 |
| 导航 | 已拦截导航与新窗口,外部地址一律交系统浏览器打开,协议白名单校验 |
| 通信 | 未暴露通信对象本身,通道按最小粒度,参数与来源在主进程校验 |
| 权限 | 权限请求与查询同时处理,默认拒绝,按功能显式授予 |
| 证书 | 不忽略证书错误,需要自签证书时通过可信根配置 |
| 数据 | 密钥不进入应用包,本地敏感数据经系统密钥链加密,退出登录清理数据 |
| 产物 | 正式包不带源映射,关闭调试入口,启用归档完整性校验与功能开关 |
| 签名 | 两类平台完成签名与公证,签名凭据受控,更新包经签名校验 |
| 更新 | 更新源使用加密通道,只允许升级,通道分离并支持暂停与灰度 |
| 依赖 | 依赖漏洞已审计,原生模块必要时才引入,第三方脚本尽量不引入 |
| 外部输入 | 协议地址与文件路径均校验,打开外部程序限制协议白名单 |
3.4 常见问题对照
| 现象 | 常见原因 | 处置 |
|---|---|---|
| 页面脚本能直接读写文件 | 渲染进程直连运行时未禁用 | 关闭直连并改为经通道提供能力 |
| 桥接方法被页面改写 | 上下文隔离被关闭 | 启用上下文隔离 |
| 内联脚本无法执行导致界面异常 | 内容安全策略过严 | 先以报告模式观察,按实际来源逐步放开 |
| 页面内元信息声明策略不生效 | 部分响应与指令无法被元信息覆盖 | 改为在会话层注入响应头 |
| 点击链接后应用窗口跳到了站外 | 未拦截导航 | 拦截导航并交外部浏览器打开 |
| 弹出新窗口加载了任意内容 | 未设置新窗口策略 | 拒绝创建新窗口并按需外部打开 |
| 相机或麦克风被静默放行 | 只处理了权限请求未处理权限查询 | 两个处理器同时设置并默认拒绝 |
| 加载自签证书站点失败 | 未配置可信根 | 在受控环境中配置可信根,而不是忽略证书错误 |
| 应用包中的接口地址与密钥被提取 | 把密钥放进了前端产物 | 密钥只留服务端,本地敏感数据用系统密钥链 |
| 系统提示应用来源不可信 | 未完成签名或公证 | 完成两类签名与公证流程 |
| 自动更新安装失败或更新后无法启动 | 更新包未签名或签名身份不一致 | 使用同一身份签名并校验更新包签名 |
| 更新被替换为旧版本 | 未限制版本单调性 | 只允许升级并校验更新包 |
| 杀毒软件误报 | 未签名或打包方式触发启发式规则 | 完成签名并核对打包配置 |
| 调试工具可被用户任意打开 | 正式包未关闭调试入口 | 关闭自动开启并限制调试参数 |
四、总结
- 桌面应用同时具备内容解析与本地系统访问能力,渲染内容被注入的后果是本地文件与凭据失守,因此安全基线是默认配置而非可选项。
- 上下文隔离、沙箱与禁用渲染进程直连运行时三项配置共同构成边界,只开其中一项仍留有绕过路径。
- 内容策略的核心是只加载可信内容并避免远程内容,内容安全策略通过响应头注入比页面内声明更可靠。
- 应用窗口只显示自有内容,外部内容一律交给系统浏览器,导航与新窗口两个拦截点必须同时处理。
- 通信边界遵循最小暴露、参数校验与来源校验三条要求,参数校验只有放在主进程才构成约束。
- 权限请求与权限查询需要同时处理,默认拒绝并按功能显式授予,否则会出现行为不一致。
- 证书错误必须拒绝,需要自签证书时通过可信根解决,不能全局放行。
- 应用包不是安全存储,密钥不得进入产物;本地敏感数据应依赖系统密钥链加密,系统不支持时禁用而非降级。
- 打包完整性与功能开关提高二次打包门槛,正式包应关闭调试入口并不带源映射。
- 签名既是系统放行的前提,也是自动更新的信任基础;更新链路要求加密传输、签名校验、版本单调与通道分离。