Chrome 打包应用 webview 分区隔离实战:基于 chrome-extensions-samples 的 local-resources 示例全解析
Chrome 打包应用 webview 分区隔离实战:基于 chrome-extensions-samples 的 local-resources 示例全解析
导读
本文以 chrome-extensions-samples 仓库 _archive 目录下归档的 local-resources 示例 为核心,深入剖析 Chrome 打包应用(Packaged App)中 <webview> 标签的 partition(分区)隔离机制,以及如何通过 manifest 为特定分区授予访问应用本地打包资源的权限。读完本文,你将掌握:为什么"可信本地内容"与"不可信外部内容"必须放入不同的 webview partition、共享 partition 会引发怎样的崩溃传染风险,以及如何用 webview.partitions 配置精确控制本地资源的访问边界——这是所有嵌入第三方网页的 Chrome 应用都绕不开的安全设计问题。
说明:该示例属于 Manifest V2 时代的 Chrome Apps(
"manifest_version": 2),现已随 Chrome Apps 的落幕归档于_archive目录,但其 partition 隔离思想对理解 Chromium 的进程/存储隔离模型仍有直接参考价值。
一、示例要解决的问题:可信与不可信内容如何共存
在 Chrome 打包应用中,<webview> 标签用来在应用界面内嵌第三方网页。但这里存在一个天然矛盾:
- 可信内容:应用打包在本地(如
trusted.html),是开发者自己控制、可完全信赖的资源; - 不可信内容:来自互联网(示例中为
http://en.wikipedia.org/wiki/Cross-site_scripting),随时可能崩溃、执行恶意脚本或被钓鱼页面替换。
如果两者混在一起渲染,一次外部网页的崩溃就可能连累整个应用。local-resources 示例的核心价值,就是用一组可运行的对比实验(Good / Bad 两个窗口)把这种风险直观地演示出来。
依据仓库内文档的原始描述(_archive/apps/samples/webview-samples/local-resources/README.md):
在 bad 示例中,可信与不可信内容共享同一个 partition;模拟不可信 webview 崩溃会同时拖垮可信 webview。而 good 示例将两者放入不同 partition,模拟不可信 webview 崩溃时,可信 webview 不受任何影响。
二、核心机制:webview 的 partition(分区)是什么
<webview> 标签的 partition 属性决定了一个 webview 的"隔离域"。从该示例可以归纳出 partition 的两层含义:
1. 存储与进程的隔离边界
- 相同 partition 的 webview 共享同一组存储(localStorage、IndexedDB、Cookies 等);
- 不同 partition 之间存储完全独立,互不可见;
- 相同 partition 的 webview 运行在关联的渲染进程中,因此其中一个崩溃会影响同 partition 的其它 webview。
2. 本地资源访问权限的授予单元
- 应用内的打包资源(如
trusted.html)默认不暴露给任何 webview; - 只有通过 manifest 中
webview.partitions显式授权的 partition,才能访问这些本地资源。
这正是示例文档反复强调的三个概念——Webview、Permissions、Partitions 的交叉点(原文档 Resources 一节分别列出了这三个主题的官方参考资料,本文不再给出外部链接,读者可在仓库内对照学习)。
三、manifest 配置:为特定分区授予本地资源访问权
示例的 manifest.json 完整演示了权限授予的写法:
{
"manifest_version": 2,
"name": "Local Resources Sample",
"minimum_chrome_version": "24.0.1307.0",
"version": "2.0",
"icons": {
"16": "icon_16.png",
"128": "icon_128.png"
},
"app": {
"background": {
"scripts": ["main.js"]
}
},
"permissions": [
"webview"
],
"webview": {
"partitions": [
{
"name": "bad",
"accessible_resources": ["trusted.html"]
},
{
"name": "good_trusted",
"accessible_resources": ["trusted.html"]
}
]
}
}
逐个字段说明(依据本仓库源码实际配置):
| 字段 | 取值 | 作用 |
|---|---|---|
permissions: ["webview"] |
固定值 | 应用级权限声明:使用 <webview> 标签的前置条件 |
webview.partitions[].name |
"bad" / "good_trusted" |
声明一个可被 <webview partition="..."> 引用的分区名 |
webview.partitions[].accessible_resources |
["trusted.html"] |
该分区允许访问的应用本地打包资源白名单 |
两个值得注意的细节:
accessible_resources是精确白名单:只有列出的文件(此处为trusted.html)对指定分区可见,其它打包资源仍被屏蔽,体现了"最小授权"原则;- 未列入的分区默认无本地权限:示例里刻意没有为
good_untrusted分区声明任何accessible_resources,用于承载不可信外部内容,从 manifest 层面就切断了它对本地资源的访问路径。
此外,"minimum_chrome_version": "24.0.1307.0" 表明该 API 自 Chrome 24 起可用,这也是它被归入 _archive 归档区的原因——API 本身随 Chrome Apps 停用而退役。
四、Bad 示例:共享 partition 的崩溃传染
bad_app.html 中,两个 webview 都使用了 partition="bad":
<!-- Bad application! Putting untrusted content in the same partition
-- as trusted content! -->
<webview id="trusted" class="full trim" partition="bad"
src="trusted.html"></webview>
<webview id="untrusted" class="full trim" partition="bad"
src="http://en.wikipedia.org/wiki/Cross-site_scripting"></webview>
这里可信的 trusted.html 与不可信的维基百科页面挤在同一个 partition 里。虽然 bad 分区在 manifest 中确实被授予了 trusted.html 的访问权,但这正是"坏例子"的根源:
- 因为共享 partition,两个 webview 的存储上下文和渲染进程是关联的;
- 当
untrustedwebview 崩溃时,同 partition 的trustedwebview 也会被一并拖垮; - 运行效果正如 README 所述——模拟不可信内容崩溃,可信内容同时崩溃。
安全结论:把本地可信资源授权给"也承载外部内容的同一分区",等于在隔离墙上开了一扇门,崩溃与潜在的越权访问都会顺着这扇门蔓延进来。
五、Good 示例:分区隔离的正确姿势
good_app.html 给出了正确做法——为可信与不可信内容分配两个不同的分区:
<webview id="trusted" class="full trim" partition="good_trusted"
src="trusted.html"></webview>
<!-- Good application! Putting untrusted content in a partition with
-- no local resource access -->
<webview id="untrusted" class="full trim" partition="good_untrusted"
src="http://en.wikipedia.org/wiki/Cross-site_scripting"></webview>
good_trusted分区:对应 manifest 中accessible_resources: ["trusted.html"]的声明,承载应用本地可信内容;good_untrusted分区:未在 manifest 中声明任何本地资源权限,只用于加载外部网页。
这样既保证了可信内容能正常读取打包资源(trusted.html 位于 trusted.html,内容是一段标注 "Your Trusted Package Content" 的静态页面),又把不可信内容彻底关在独立的隔离域里——即使它崩溃,也影响不到 good_trusted 分区中的可信 webview。
隔离原则总结:
- 本地资源访问权只授予承载可信内容的分区;
- 不可信内容使用独立、无本地权限的分区;
- 每个业务信任级别对应一个独立 partition,互不交叉。
六、验证手段:用 crash.js 模拟崩溃并重载
两个 HTML 页面都通过 crash.js 提供了交互验证按钮,其核心逻辑如下:
window.addEventListener('load', function(e) {
var crashButton = document.querySelector('#simulate-crash');
var reloadButton = document.querySelector('#reload');
var webview = document.querySelector('#untrusted');
crashButton.addEventListener('click', function(e) {
webview.terminate();
});
reloadButton.addEventListener('click', function(e) {
webview.reload();
});
});
两个关键 API 的语义:
webview.terminate():立即终止该 webview 对应的渲染进程,等效于"模拟外部网页崩溃"。由于它作用于#untrusted元素,若该元素与可信内容共享 partition(Bad 场景),可信 webview 随之崩溃;若分区隔离(Good 场景),可信 webview 安然无恙;webview.reload():重新加载外部内容,用于崩溃后恢复演示现场,方便反复对照两种行为差异。
页面按钮分别标注为 "Simulate foreign web content crash" 与 "Reload foreign web content"(见 good_app.html 与 bad_app.html)。
七、应用装配:main.js 如何同时打开两个窗口
main.js 负责应用启动装配,它监听应用生命周期事件并同时创建 Good 与 Bad 两个窗口,方便并排对比:
chrome.app.runtime.onLaunched.addListener(function() {
runApp();
});
chrome.app.runtime.onRestarted.addListener(function() {
runApp();
});
function runApp() {
chrome.app.window.create(
'good_app.html',
{'id': 'GoodWindowID'});
chrome.app.window.create(
'bad_app.html',
{'id': 'BadWindowID'});
}
chrome.app.runtime.onLaunched:应用首次启动时触发;chrome.app.runtime.onRestarted:应用被系统重启后触发,保证两种启动路径都能重建演示窗口;chrome.app.window.create:分别以窗口 IDGoodWindowID/BadWindowID创建两个并排窗口,分别加载 good 与 bad 两个 HTML 页面。
两页共用的 app.css 通过 flex 布局让 webview 铺满窗口(.full 的 width/height: 100% 配合 .flex-container),确保对比画面清晰。
八、如何运行与验证
由于示例属 MV2 时代的 Chrome Apps,运行验证需要满足以下前提(基于仓库实际配置推断,请以当时的 Chrome 环境为准):
- 确认环境支持 Chrome Apps 与
webviewAPI(示例要求最低 Chrome 24.0.1307.0,见 manifest); - 在
chrome://extensions开发者模式下加载 _archive/apps/samples/webview-samples/local-resources 目录(该目录内含manifest.json、两个 HTML、crash.js、main.js、trusted.html及图标资源); - 启动后出现两个窗口:
- Bad application:点击 "Simulate foreign web content crash",观察可信内容("Your Trusted Package Content" 页)是否同步崩溃;
- Good application:做同样的操作,观察可信内容保持完好;
- 点击 "Reload foreign web content" 可随时恢复不可信内容,反复验证。
仓库中 _archive/apps/samples/webview-samples 目录还包含 browser、multi-tab-browser、new-window、user-agent 等同主题 webview 示例,可与本示例对照阅读,形成对 webview API 的系统认知。
结语
local-resources 示例用一对 Good/Bad 窗口,把 Chrome webview 的安全模型压缩成了一个 30 秒即可理解的实验:partition 既是存储隔离域,也是崩溃隔离域,更是本地资源访问的授权边界。信任级别不同的内容必须各归其位——可信资源只授予可信分区,不可信内容永远留在无权限的独立分区中。虽然该 API 已随 Chrome Apps 归档,但"分区隔离 + 最小权限白名单"这一设计范式,在今天任何嵌入第三方内容的 WebView/iframe 架构中依然成立。
