一、起源

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 常见问题对照

现象 常见原因 处置
页面脚本能直接读写文件 渲染进程直连运行时未禁用 关闭直连并改为经通道提供能力
桥接方法被页面改写 上下文隔离被关闭 启用上下文隔离
内联脚本无法执行导致界面异常 内容安全策略过严 先以报告模式观察,按实际来源逐步放开
页面内元信息声明策略不生效 部分响应与指令无法被元信息覆盖 改为在会话层注入响应头
点击链接后应用窗口跳到了站外 未拦截导航 拦截导航并交外部浏览器打开
弹出新窗口加载了任意内容 未设置新窗口策略 拒绝创建新窗口并按需外部打开
相机或麦克风被静默放行 只处理了权限请求未处理权限查询 两个处理器同时设置并默认拒绝
加载自签证书站点失败 未配置可信根 在受控环境中配置可信根,而不是忽略证书错误
应用包中的接口地址与密钥被提取 把密钥放进了前端产物 密钥只留服务端,本地敏感数据用系统密钥链
系统提示应用来源不可信 未完成签名或公证 完成两类签名与公证流程
自动更新安装失败或更新后无法启动 更新包未签名或签名身份不一致 使用同一身份签名并校验更新包签名
更新被替换为旧版本 未限制版本单调性 只允许升级并校验更新包
杀毒软件误报 未签名或打包方式触发启发式规则 完成签名并核对打包配置
调试工具可被用户任意打开 正式包未关闭调试入口 关闭自动开启并限制调试参数

四、总结

  1. 桌面应用同时具备内容解析与本地系统访问能力,渲染内容被注入的后果是本地文件与凭据失守,因此安全基线是默认配置而非可选项。
  2. 上下文隔离、沙箱与禁用渲染进程直连运行时三项配置共同构成边界,只开其中一项仍留有绕过路径。
  3. 内容策略的核心是只加载可信内容并避免远程内容,内容安全策略通过响应头注入比页面内声明更可靠。
  4. 应用窗口只显示自有内容,外部内容一律交给系统浏览器,导航与新窗口两个拦截点必须同时处理。
  5. 通信边界遵循最小暴露、参数校验与来源校验三条要求,参数校验只有放在主进程才构成约束。
  6. 权限请求与权限查询需要同时处理,默认拒绝并按功能显式授予,否则会出现行为不一致。
  7. 证书错误必须拒绝,需要自签证书时通过可信根解决,不能全局放行。
  8. 应用包不是安全存储,密钥不得进入产物;本地敏感数据应依赖系统密钥链加密,系统不支持时禁用而非降级。
  9. 打包完整性与功能开关提高二次打包门槛,正式包应关闭调试入口并不带源映射。
  10. 签名既是系统放行的前提,也是自动更新的信任基础;更新链路要求加密传输、签名校验、版本单调与通道分离。