
安全与权限
📖 本章由 3 节合并而成,便于整体阅读与分享。逐节精读/修改请用本目录下的分篇源文件;配图相对路径仍有效。
本章目录
- 1 · JSBridge 安全模型:桥是能力,也是被打开的“后门”
- 2 · 经典漏洞复盘:五个案例,看桥怎么失守、防线怎么补
- 3 · 配置安全与合规清单:上线前,把这些一字一句过一遍
- 本章术语表
1 · JSBridge 安全模型:桥是能力,也是被打开的“后门”
1.1 问题引入
某天你们 H5 里多了个埋点 SDK,它的 <script> 从 CDN 加载。结果线上 App 里登录态莫名被读出,用户还被“自动”分享了内容。排查到最后:不是后端被黑,是加载的脚本调了你们暴露给网页的桥方法 share()、getToken()——因为桥对任何能调用它的页面,一视同仁地放行。
桥是一把双刃剑:JS 能调到的每个桥方法,就等于把一份客户端能力开放给了页面。 页面可以是你们自己的,也可以是别人塞进来的——这个区分,正是本章要讲的核心。
1.2 先破误区
• 误区:“JSBridge 是 App 给自家 H5 用的,别人调不到。” • 事实:桥注入在 WebView 的 JS 世界里。任何能在这个 WebView 里执行 JS 的页面都够得着它——包括被 XSS 注入的脚本、第三方的
<iframe>、被劫持后 302 跳过去的恶意页面。桥不设防,就等于 App 把原生能力开放给了“任何能进这个窗的人”。
• 误区:“我收到 token 再调桥,把 token 给页面没关系,反正没公网可走。” • 事实:token 是“带着就能过门禁的凭证”。只要它被放进页面 JS 可见的内存里,一旦页面被注入脚本、被第三方 iframe 拉到、被截取,token 就被带走。最小化原则:页面要什么才给什么。
1.3 原理讲解:桥的信任模型三问
判断一座桥是否安全,不是问“这个桥有没有加密”,而是每次对被调用的方法问三个问题:
| 问题 | 要查清的东西 | 防御手段 |
|---|---|---|
| 哪个页面在调? | 发起调用的是不是白名单里的域名 | 来源校验(host / origin / source) |
| 能调什么? | 这个页面有没有资格调这个方法 | 方法级权限表 |
| 带了什么证? | 有没有可信凭证证明“是你”,且没被篡改 | 签名 / token 最小化下发 |
三问皆过才放行。缺一问,这座桥就只在“侥幸”层面是安全的(图见下)。

1.3.1 第一问:来源校验——最难也最容易被绕过
来源校验的目标:识别“说话的是哪个页面”。最常见的三种来源证据,各有坑:
- Referer:
http跳转时浏览器会带,但https→http、meta跳转、noreferrer下会缺失;更致命的是它由页面可控,想伪造并不难,不能作为唯一依据。 - document.URL / host:当前文档地址。在 JS 里读它,比 Referer 可靠,但仍会被
about:blank(空地址)、data:、被 302 之后的主机地址搞出歧义。 - 跨域 iframe / 302:页面 A 用
<iframe src="https://evil.com">包一层,或把链接 302 到恶意域名——此时“当前文档”到底算 A 还是算 evil.com,以 WebView 实测为准,不同内核判定不一致。这也是校验必须放原生侧、而不是放 JS 侧的原因:JS 侧自己判断宿主,宿主可能被页面自己说糊弄。
结论:来源校验要放在桥的入口(原生侧),并且用“协议 + host”做整串判断,别只用“后缀包含”。
1.3.2 第二问:方法白名单——能调什么要按页面分级
身份的下一步是授权。把桥方法分成几档:
public:任何白名单页面都能调(如hideLoading)。login级:需要登录态的 H5 才能调(如写 Cookie)。sensitive:仅限少数字台页或后台维护页(如发分享、取设备号),且通常要二次确认。
原生侧维护一张 方法 → 允许域名集合 的权限表,调方法时先查表。这张表不要写死在跳转逻辑里另一个地方,要和来源校验走同一份配置。
1.3.3 第三问:凭证——签名与 token 的最小化
- 签名:对参数做 HMAC(密钥只在原生和后端,不在页面),页面不能自证。适用于“页面调桥时证明参数没被改”。
- token 下发最小化:别把“全量 token 一次性给页面”。页面要展示用户信息,就只给它信息;要调写接口,就给它一个限时、限域、限方法的最小 token。宁可多几次桥调用按需取,也别图省事一次发全。
1.4 代码验证:来源校验骨架(防御向)
下面给出最小可用的来源校验骨架,双端各一段。核心原则:在桥的入口用“协议 + host”做强判断,不在 JS 里判断。
1.4.1 Android(Kotlin)· 桥入口判 URL host
// 平台:Android | 用途:JSBridge 调用的来源校验骨架(防御向)
// 思路:App 里每个 WebView 绑定自己的"允许 host"列表;
// 任何 addJavascriptInterface / shouldOverrideUrlLoading 进入桥方法前,先过这条闸。
class SecureBridge(private val webView: WebView, private val allowedHosts: Set<String>) {
// 精确匹配"协议+host",不允许 *. 后缀包含(防 *.example.com 被 evil.example.com 顶替)
private fun isAllowed(host: String): Boolean {
val parts = host.lowercase()
// 例:白名单只放 "app.example.com",别放 "example.com" 或 "*.example.com"
return allowedHosts.contains(parts)
}
// 桥被调用时的统一入口
@JavascriptInterface
fun call(method: String, json: String): String {
val page = webView.url ?: return "{\"err\":\"no-url\"}"
val host = Uri.parse(page).host ?: return "{\"err\":\"no-host\"}"
if (!isAllowed(host)) return "{\"err\":\"forbidden-host\"}"
// 第二问:查方法级权限表
val permitted = permissionTable[method]?.contains(host) ?: false
if (!permitted) return "{\"err\":\"forbidden-method\"}"
// 第三问:敏感方法要求签名
if (sensitiveMethods.contains(method)) {
// 这里把签名校验留给原生+后端,页面没有密钥
val sigOk = verifyHmac(json, serverNonce) // 示意:HMAC 校验
if (!sigOk) return "{\"err\":\"bad-signature\"}"
}
return dispatch(method, json)
}
}
说明:
verifyHmac、dispatch是示意占位,不必照抄真实签名协议。这段要表达的是顺序:先验来源 → 再查方法权限 → 最后敏感方法验签名。哪一步不过都直接拒,不给任何业务反馈细节(防探测)。
1.4.2 iOS(Swift)· decidePolicyFor 里判 host
// 平台:iOS | 用途:WKWebView 的 WKNavigationDelegate 来源校验骨架(防御向)
// 思路:在导航层就把来源挡在门外,桥方法只对白名单 host 开放。
func webView(
_ webView: WKWebView,
decidePolicyFor navigationAction: WKNavigationAction,
decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
) {
let whitelist: Set<String> = ["app.example.com"] // 精确 host,别用后缀匹配
guard let url = navigationAction.request.url,
let host = url.host?.lowercased(),
let scheme = url.scheme?.lowercased(),
scheme == "https", // 协议一起校验
whitelist.contains(host) // host 精确命中
else {
decisionHandler(.cancel) // 来源不合法:直接取消
return
}
// 方法级权限与签名校验放进 messageHandler 那一步(和 Android 对应)
decisionHandler(.allow)
}
⚠️ 这类校验若长年手写 if/else 散落各处,后面就难维护;正规容器会把这份判断收敛成一份:来源校验 + 方法权限表 + 签名 一起配置的“安全桥接三件套”。
1.5 安全桥接三件套(直接照抄进评审清单)
| 序号 | 项 | 落地形态 |
|---|---|---|
| ① | scheme / host 校验 | 桥入口 / 导航决策拦截层,精确匹配“协议+host”,拒绝后缀包含、拒绝凭 Referer |
| ② | 方法级权限表 | 方法 → 允许域名集合,原生侧集中配置;敏感方法单独列 |
| ③ | 敏感操作二次确认 | 分享、支付、取隐私信息前,弹系统级确认或走原生二次弹窗,不经页面 JS 直接执行 |
前端能贡献的:不在 JS 里自己伪造来源,明确区分“页面业务逻辑”和“桥调用”,敏感操作尽量不把完整 token 留在 JS 内存里(用完即弃 / 短时效)。
1.6 坑点清单
| 坑 | 现象 | 根因 | 解法 |
|---|---|---|---|
| 用后缀匹配域名 | 上线后 evil.example.com 能调桥 |
*.example.com 把子域全放开 |
精确 host 白名单 |
| 只信 Referer | https 页面 Referer 缺失/可伪造 | 来源证据不可信 | 原生侧判 document 的 scheme+host |
| iframe 包一层 | 第三方 iframe 触发桥方法 | 跨域 iframe 对桥可见性以内核为准 | 校验 origin/source/顶层 frame |
| 302 后歧义 | 跳转后 host 判断错 | 重定向改了当前文档身份 | 导航决策层整串校验后再放行 |
| 全量 token 一次下发 | JS 内存泄漏/注入被带 token | 凭证过度下发 | 最小化、短时效、按需取 |
1.7 自测题
- 简答:桥的“信任三问”是哪三问?各对应什么防御手段?
- 判断:用
Referer作为唯一来源校验是否可靠?为什么? - 简答:为什么
*.example.com白名单比example.com更危险? - 动手:在你们容器配置里找桥的域名白名单,看它是精确 host 匹配还是后缀匹配。
- 简答:token“全量一次下发”为什么危险?最小化的三条正交维度是什么?
参考答案(思考后再点开)
- 哪个页面在调(来源校验)/能调什么(方法白名单)/带了什么证(签名 + token 最小化)。
- 不可靠。https→http、
noreferrer、meta跳转都会让它缺失,且它由页面可控可伪造;只能作辅助。 *.example.com把evil.example.com、pwn.example.com一并放开,等于把边界扩到整个子域命名空间。- (动手)重点看是否用“协议 + host”整串精确匹配,还是只要后缀包含就放。
- 全量 token 留在页面 JS 内存,一旦被注入/iframes 拉走就泄露。最小化正交维度:限时(短时效)、限域(只给需要的页面)、限方法(只给够调某方法的最小权限)。
回顾:桥安全不是单一手段,是“来源验证 + 方法授权 + 凭证最小化”的层层递进。下一节我们复盘五个经典漏洞,看防线是怎么被攻破、又怎么被补上的。
2 · 经典漏洞复盘:五个案例,看桥怎么失守、防线怎么补
2.1 问题引入
“这些漏洞都是十年前的事了,跟我有什么关系?”——有关系。今天一段 loadUrl("file://...")、一个打开的 allowFileAccess、一次没校验 host 的 scheme 路由,都可能是同型漏洞的新副本。本章按固定五段复盘五个案例。只讲原理与防御,不提供任何攻击代码。
2.2 漏洞 ①:addJavascriptInterface 反射漏洞(Android,API 17 前)
年代背景:Android 4.1(API 16)及更早,addJavascriptInterface 把整个 Java 对象挂进 JS,不要求注解。
原理图景:早期实现把 obj 的公共方法全部映射给 JS——包括从 Object 继承的 getClass(),拿到它就能沿反射链摸到可执行系统命令的类。前提:WebView 加载了不可信内容(被劫持页面、被注入的 XSS)。
为什么会发生:API 把“暴露对象”和“暴露能力”画了等号,无白名单;宿主又常加载第三方页面/广告,把全能力桥挂给了不可信内容。
修复与防御:API 17 起必须给方法加 @JavascriptInterface 注解,未注解方法对 JS 不可见——官方以“注解白名单”收口;再配合最小暴露、removeJavascriptInterface 移除内置高危对象。minSdkVersion 别降到 16;老设备改走“URL Scheme 拦截”通道。
给前端的启示:前端评审要问“这个桥挂给了哪些页面”——不可信页面能调到高危方法,锅在容器。
2.3 漏洞 ②:file 域攻击(Android)
年代背景:配置类漏洞,主角是两个 WebSettings 开关:allowFileAccessFromFileURLs、allowUniversalAccessFromFileURLs。
原理图景:默认值与版本相关(allowFileAccessFromFileURLs / allowUniversalAccessFromFileURLs 自引入起默认即为 false,需显式打开才危险;allowFileAccess 在不同 API 级别默认值不同,新版本已默认 false——具体以你们目标的 API 级别实测为准)。前者允许 file:// 页面用 XHR 读其他本地文件;后者更宽——本地页对任意来源的请求不受同源约束。前提是本地 HTML 被注入(如分享内容落地成临时 HTML 再打开),脚本便能读 App 私有文件。
为什么会发生:老代码保留历史默认值;“自己的 file 页面可信”假设不成立——本地页一样可能被塞恶意脚本;抄示例配置从未评估后果。
修复与防御:release 包显式关掉两个开关;不加载任意落地的本地 HTML;离线包走容器自家 scheme/拦截映射,不走 file://。
// 平台:Android | 用途:file 域相关开关的防御性配置(骨架,防御向)
webSettings.apply {
allowFileAccess = false // 按需开;能不开就不开
allowFileAccessFromFileURLs = false // API 17+ 默认 false,显式再关一遍
allowUniversalAccessFromFileURLs = false // 同上;开了必须进上线清单说明理由
}
给前端的启示:file: 协议不代表更可信,反而代表“能力受限或异常敏感”;别把敏感数据落成“让 App 再打开”的本地文件。
2.4 漏洞 ③:URL Scheme 劫持
年代背景:Android 的“scheme 抢注”与 iOS 的 scheme 钓鱼,跨年代通用问题。
原理图景:Android 的自定义 scheme(如 hybrid://)不归一个 App 独有——任何 App 都能在 manifest 里声明同一 scheme。若容器做 scheme 路由却不校验调用方与参数来源,第三方 App 就能构造同 scheme URL 拉起你的容器页并塞进伪造参数。另一分支:H5 被 302 指向恶意 scheme(evil://...),而拦截层没有白名单,恶意 host 也放行。
为什么会发生:scheme 本是公开的路由名却被当秘密;拦截层“只认 scheme 不认 host”;302 链路中间跳转的 host 不在校验范围。
修复与防御:scheme 前缀校验 + 域名白名单双闸——scheme 认自家的,host 认白名单;对外入口优先用 App Links / Universal Links 这类“域名可验证”机制;容器维护“允许拉起的原生页”路由表,表外拒绝。
给前端的启示:别把“调起原生”的 URL 放进分享链/二维码等不可控入口;location.href = 'xxx://...' 前确认走自家路由。
2.5 漏洞 ④:XSS 与桥的组合
年代背景:不是某个 CVE,而是一类组合问题——Web 侧任意一个 XSS 都能被“放大”成客户端侧问题。
原理图景:Web 里 XSS 的后果通常是“当前页为所欲为”。但 WebView 里页面背后还挂着一座桥:被注入的脚本拿到 window.xxxBridge 后,调桥 = 调客户端。桥的能力上限,就是 XSS 的实际伤害上限。
为什么会发生:XSS 被视为前端 Bug、桥被视为客户端资产,没人把“XSS + 桥”当组合威胁建模。
修复与防御:三层收口——① XSS 本身:输出转义、模板默认转义、CSP;② 桥最小化:getToken 等敏感方法不挂普通业务页;③ 敏感操作二次确认:分享/支付/取隐私弹原生确认框。
给前端的启示:评审报“页面有无 XSS 风险”时,同时报挂了哪些桥方法——伤害 = 页面 × 桥能力,两边都要进威胁模型。
2.6 漏洞 ⑤:消息伪造与来源歧义
年代背景:现代桥主力通道(WKScriptMessageHandler / 注入对象)是挂在 WebView 上的“全局信箱”,不天然区分“谁寄的信”。
原理图景:若页面里有跨域 iframe,部分内核/历史版本下其内脚本可能触达宿主的桥对象或消息通道(可见性以实测为准)。而原生侧若只信 data、不校验 origin / source,第三方页就可能“代仿”合法页面寄信。
为什么会发生:信箱是单实例,“信从哪来”要靠宿主主动校验;信任没有自动隔离。
修复与防御:原生侧校验 origin / source / frame(能力以实测为准);消息加一次性 nonce + 原生回执防重放;高风险容器禁止跨域 iframe 或让桥不暴露给子 frame。
给前端的启示:少让“会调桥的页面”嵌第三方 iframe;必须嵌时用 sandbox 最小集隔离,并写死“iframe 域不享有桥权限”。
2.7 坑点清单
| 漏洞 | 一句话根因 | 今天仍要查的一行配置 |
|---|---|---|
| ① 反射 | 全量暴露未注解方法 | minSdkVersion ≥ 17;桥方法全加注解 |
| ② file 域 | 本地页同源被撕开 | release 是否显式关掉两个 file 开关 |
| ③ Scheme 劫持 | 只认 scheme 不认 host | 导航拦截是否 scheme + host 双校验 |
| ④ XSS + 桥 | 桥能力 = XSS 上限 | 业务页是否挂了 getToken 级方法 |
| ⑤ 消息伪造 | 只看 data 不看 origin | 原生是否校验 origin / source / frame |
2.8 自测题
- 简答:
@JavascriptInterface注解修复反射漏洞的原理?白名单粒度是“方法”还是“对象”? - 判断:
allowUniversalAccessFromFileURLs默认是 true,对吗?(提示:分 API 版本。) - 线上出现“被 302 到 evil.com 的页面能调桥”,用上一节“三件套”的哪几件能挡住?
- 动手:搜 H5 项目里的
<iframe,判断“它所在页面挂了哪些桥方法”。 - 简答:为什么“XSS 的伤害上限取决于桥”?给两条削弱手段。
参考答案(思考后再点开)
- API 17 起只把带注解的公共方法映射给 JS——粒度是“方法”,未注解的(含反射入口)全部不可见。
- 分辨两件事:
allowFileAccessFromFileURLs/allowUniversalAccessFromFileURLs引入起默认 false;allowFileAccess的默认值随 API 级别有变(新版本默认 false)。以目标 API 实测为准。 - 来源校验(导航层 host 白名单取消非法跳转)+ 方法级权限表。
- (动手)重点看承载桥调用的页面;“第三方 iframe × 敏感桥”同页即风险组合。
- 攻击者可用的最大能力 = 桥暴露给该页面的方法集合;削弱:方法级权限表 + 敏感操作原生二次确认。
3 · 配置安全与合规清单:上线前,把这些一字一句过一遍
3.1 问题引入
安全评审通过不代表能上线。多数翻车不是因为攻击高级,而是上线前没人把 configuration 过一遍:漏关 file 开关、release 留着调试口、明文没关、隐私清单少写一项……本章给双端「安全配置 + 权限链路 + 数据合规」对照,收口成一份可照抄的 15 条上线前 Checklist。
3.2 先破误区
• 误区:“WebView 安全 = 桥做好校验就行。” • 事实:桥只是话术里的进攻面之一。配置项(file 域、mixed content、明文流量、调试口)是另一张清单,漏一个就可能把前面所有校验归零。
• 误区:“关调试口影响我们联调。” • 事实:WebView 调试口(Android
setWebContentsDebuggingEnabled(true)/ iOSisInspectable)只该在 debug build 开。release 打开等于把整个 WebView 内容页暴露给能连上调试端口的任何人/工具。
3.3 原理讲解
3.3.1 安全配置 Checklist(Android / iOS 双列)
| 配置项 | Android(WebSettings / manifest / network) | iOS(WKWebViewConfiguration / Info.plist) |
|---|---|---|
| file 域访问 | allowFileAccess(默认 true,需按场景关);allowFileAccessFromFileURLs / allowUniversalAccessFromFileURLs(API 17+ 默认关,release 保持关) |
iOS 无对等的 file 域同源穿透开关;fileURL 与 http 混合加载受限明显 |
| 混合内容 | setMixedContentMode:默认 MIXED_CONTENT_NEVER_ALLOW(若允许需显式设置,评估风险) |
无从属开关,策略由内核决定,涉及 http 资源时以实测为准 |
| 明文流量 | usesCleartextTraffic(network_security_config 里的 base 更细)——默认随 targetSdk 收紧,越新越严 |
ATS(App Transport Security):默认阻拦明文 HTTP;NSAllowsArbitraryLoads 只应临时/scope 开放 |
| 调试口 | setWebContentsDebuggingEnabled(true) 只在 debug,release 必须 false |
isInspectable 只在 debug;release 关 |
| 证书锁定 | OkHttp CertificatePinner(pin 原生栈);WebView 侧 pin 以实测为准 | URLSession / 相关库 pin;同样不等同 WebView |
| 证书锁定 × 抓包 | pin 会直接让 Charles 抓不到——内部调试环境用 debug build 关掉 pin,release 才开 | 同左:内部联调、抓包阶段用 debug 关 pin |
⚠️ 证书锁定防“中间人”,代价是“自己人抓不到包、证书一换就全线崩”:仅 release 且只对高价值域名 pin;内部调试环境 debug build 关闭 pin。粒度与范围进上线清单复核。
3.3.2 权限链路:相机 / 定位 / 麦克风 / 相册
WebView 里 H5 用 getUserMedia、定位 API 申请权限,不是一条直达系统弹窗的路,中间隔着宿主:
- Android:
WebChromeClient.onPermissionRequest先被触发 → 宿主再走运行时权限(requestPermissions,需声明)→ 用户同意后回写 H5(PermissionRequest.grant())。任一步漏,H5 都是拒绝。 - iOS:H5 的
getUserMedia能否拉起系统弹窗以实测为准;即便 Web 侧通过,前提是 Info.plist 写了对应用途描述(如NSCameraUsageDescription),没写就静默失败。 - 双端共性:“宿主申请过一次”≠“每个页面都能用”。被拒/撤回后的回调要打成闭环。
3.3.3 数据合规:采集最小化
- UA / 设备标识采集最小化:UA 里带机型、系统版本就够排查用,别把能定位到个人的设备标识随手丢给第三方 SDK。
- 隐私同意前不采集:拿到隐私授权(或符合当地合规前提)之前,不采集、不上报可识别用户的字段。
- 涉敏字段(IDFA 类标识、精确位置、相册内容)逐个过清单:用到才请求、请求前先声明用途。
3.4 代码验证:Android 权限链路骨架 + iOS 配置骨架
3.4.1 Android(Kotlin)· 把 onPermissionRequest 接到宿主运行时权限
// 平台:Android | 用途:WebChromeClient 把 WebView 权限请求交给宿主运行时权限(骨架)
class SecureWebChromeClient(private val host: Activity) : WebChromeClient() {
override fun onPermissionRequest(request: PermissionRequest) {
// 逐个把 WebView 的请求映射到宿主运行时权限
val wanted = request.resources.toList()
val androidPerms = wanted.mapNotNull {
when (it) {
PermissionRequest.RESOURCE_VIDEO_CAPTURE -> Manifest.permission.CAMERA
PermissionRequest.RESOURCE_AUDIO_CAPTURE -> Manifest.permission.RECORD_AUDIO
else -> null // 宿主不支持的资源,直接拒绝
}
}
if (androidPerms.isEmpty() || host.checkSelfPermission(androidPerms[0]) != PACKAGE_GRANTED) {
if (androidPerms.isNotEmpty()) {
host.requestPermissions(androidPerms.toTypedArray(), H5_PERMISSION_REQ)
}
request.deny() // 未拿到就拒绝;拿到后回写 grant()(示意)
return
}
request.grant(wanted)
}
}
3.4.2 iOS(Swift)· release 关闭调试口 + 只开所需 ATS
// 平台:iOS | 用途:release 关调试口(骨架)
#if DEBUG
webView.isInspectable = true // 仅 debug
#else
webView.isInspectable = false // release 关死
#endif
<!-- Info.plist 片段:能不开就尽量不开;开了也尽量 scope 到具体域名(示意) -->
<key>NSAppTransportSecurity</key>
<dict>
<key>NSExceptionDomains</key>
<dict>
<key>yourserver.example.com</key>
<dict>
<key>NSExceptionAllowsInsecureHTTPLoads</key><true/>
</dict>
</dict>
</dict>
上面的代码量足够你入评审参考,动手实验见 demo/stage-9-security(示例代码详见 demo 包)。
3.5 权限链路自测 / 坑表
| 坑 | 现象 | 根因 | 解法 |
|---|---|---|---|
| H5 调相机直接被打回 | onPermissionRequest 没接或 Manifest 缺声明 | 权限没透传 | Android 接 onPermissionRequest + 运行时权限 |
| iOS 调麦没弹窗 | Info.plist 缺用途描述 | 缺声明 | 补 NSMicrophoneUsageDescription |
| release 能调试 | 真机连上调试口 | 调试口没按 build 关 | debug 开 / release 关 |
| 抓包全失败 | release 包 Charles 解不开 | pin 开着 / user CA 不信 | debug build 关 pin |
| 明文被拦 | http 资源加载失败 | ATS / cleartext 默认严 | 只对必须域名 scope 开放 |
3.6 上线前 WebView 安全与合规 Checklist(15 条)

逐条勾完再发版:
- ⚠️
allowFileAccessFromFileURLs/allowUniversalAccessFromFileURLs在 release 为关。 - ⚠️
allowFileAccess只在必要场景开启,不整体放开。 - ✅ Mixed content(
setMixedContentMode/ ATS)对非必要域名保持阻拦。 - ✅ 明文流量只对白名单内必要域名放开,其余仍禁。
- ✅ WebView 调试口(Android / iOS)release 一律关。
- ✅ 证书锁定只 pin 高价值域名,内部环境用 debug 关 pin。
- ✅ JSBridge 白名单校验(scheme + host)已启用,不靠 Referer。
- ✅ 桥方法按权限表分级,敏感方法不挂普通业务页。
- ✅ 敏感操作有原生二次确认。
- ✅ 相机/定位/麦克风/相册权限链路双端打通并有回写。
- ✅ Manifest(Android)与 Info.plist(iOS)权限用途描述齐全。
- ✅ UA / 设备标识采集已最小化,无多余字段给第三方。
- ✅ 隐私同意前不采集、不上报可识别用户字段。
- ⚠️ 引入的第三方 SDK 逐个过权限与数据边界评审。
- ✅ 白名单域名、路由 scheme 表与其《生效环境对应表》版本一致。
3.7 自测题
- 简答:为什么 WebView 调试口不能留在 release?它暴露的是什么?
- 简答:Android H5 调相机,完整链路经过哪三层?漏了哪层会怎样?
- iOS 里 H5
getUserMedia不弹系统的排查起点是什么? - 判断:证书锁定开了就一劳永逸。(提示:抓包、证书轮换。)
- 动手:用上面的 15 条把你的一个线上 H5 容器过一遍,写出没过的项。
参考答案(思考后再点开)
- 调试口等于把页面内部(DOM、脚本、存储、网络)开放给连接者;release 开着 = 任何能连上的人都能读到业务,属于高危。
onPermissionRequest(WebView 层)→ 宿主运行时权限(系统层)→ 回写grant()给 H5;漏宿主层不会弹窗。- 先查
Info.plist是否写了对应用途描述(如NSCameraUsageDescription);再看 WebKit 侧getUserMedia在你们内核里是否支持(以实测为准)。 - 错。pin 防中间人,但会让 Charles 等内部抓包失效、证书轮换时冒全挂风险;策略是 debug 关、release 只对高价值域名 pin。
- (动手)重点通常是 6/7/11/14 几条——pin、白名单、用途描述、第三方 SDK。
本章术语表
| 术语 | 大白话解释 |
|---|---|
| 域名白名单 | 一张“只有这些域名能过”的允许名单,只有命中的页面才给放行。 |
| 来源校验 | 在桥入口先查“到底哪个页面在调”,确认不是别人冒充。 |
| 方法白名单 | 按“方法 → 允许的域名”做权限分档,页面没有资格的方法直接不给调。 |
| token 最小化 | 别把全套凭证一次交给页面,按需发“限时、限域、限方法”的最小凭证。 |
| HMAC 签名 | 用只有原生和后端知道的密钥对参数做摘要,页面自己伪造不了。 |
| Referer | 请求头里“我从哪来”的标注,但这值页面可控,只能当辅助证据。 |
| XSS | 攻击者往页面里注入脚本,“借你的页面身体”干坏事。 |
| addJavascriptInterface | Android 把原生对象暴露给 JS 的入口,暴露面越大越危险。 |
| 后缀匹配 | 用 *.example.com 这种宽松判断,容易把 evil.example.com 也放进来。 |
| 302 重定向 | 服务器把请求转跳另一个地址;中间那跳若不算 host 就可能绕过校验。 |
| 跨域 iframe | 一个页面里嵌的“别人家的”子页面;它对桥是否可见要以内核实测为准。 |
| 敏感操作二次确认 | 分享/支付/取隐私前弹系统或原生确认框,不靠页面 JS 直接执行。 |
| addJavascriptInterface 反射漏洞 | 早期 Android 把 Java 对象整个挂给 JS,攻击者顺着 getClass() 反射链一路摸到能执行系统命令的类。 |
| @JavascriptInterface 注解 | API 17 起的“方法白名单”:JS 只能看见带这个注解的方法,其余一律不可见。 |
| minSdkVersion | 工程里声明的最低支持的 Android 版本;降太低会让老设备的旧漏洞复活。 |
| file 域攻击 | file:// 页面被注入脚本后,借宽松开关去读 App 私有本地文件的攻击面。 |
| allowFileAccessFromFileURLs | 开关:允许 file:// 页面用 XHR 读其他本地文件。API 17 起默认关,release 保持关。 |
| allowUniversalAccessFromFileURLs | 更狠的同级开关:本地页对任意来源的请求都不受同源约束,等于把同源策略撕开。 |
| URL Scheme 劫持 | 自定义 scheme 不归一家独有,别的 App 抢注同名 scheme 就能伪造“调起原生”的 URL。 |
| App Links / Universal Links | 用可验证的域名归属替代裸 scheme 的官方拉起机制,比 scheme 难伪造。 |
| 同源策略 | 浏览器的基本隔离规则:不同来源的脚本互不许随便读对方的数据。 |
| CSP | Content Security Policy,网页上了一层“哪些脚本允许跑”的声明,用来压住 XSS 注入面。 |
| nonce | 一次性随机数,用来标记“这条消息是刚发的、不是重放的旧消息”。 |
| 消息伪造 | 桥的“全局信箱”不天然区分来信人,第三方页面模仿合法页面给原生寄假信。 |
| Mixed Content | HTTPS 页面里混进了 http 子资源,这个“混”本身就是个安全隐患,默认被拦。 |
| 明文流量 | 不走 TLS 加密的裸 http 传输;抓包就能看到内容,默认越新的系统管得越严。 |
| ATS | iOS 的强制 HTTPS 开关,默认拦明文 HTTP;要放开只能对特定域名做例外。 |
| usesCleartextTraffic | Android 侧“是否允许明文 http”的总开关,通常交给 network_security_config 更细控制。 |
| allowFileAccess 系列 | 控制 file:// 页面的本体访问权限;能不开就不开,release 保持显式关闭。 |
| 证书锁定 | 客户端写死“只认这把证书”,防中间人;代价是自己人抓包难、换证书易全挂。 |
| 调试口 | WebView 允许外部连上看页面内部(DOM/脚本/存储/网络)的开关:setWebContentsDebuggingEnabled / isInspectable。 |
| onPermissionRequest | Android 上 WebView 把 H5 权限申请先交给宿主这一层,宿主再转走运行时权限。 |
| 运行时权限 | App 在运行期间向用户申请的实际系统权限,声明了才弹得出且要用户同意。 |
| Info.plist | iOS 的配置文件;权限用途描述(如 NSCameraUsageDescription)没写对,H5 调相机就静默失败。 |
| Manifest | Android 清单文件;权限要在这里声明,缺了声明底层就不会给。 |
| IDFA | iOS 用来跨 App 追踪用户的广告标识符,属于敏感、要最小化采集的字段。 |
| 隐私清单 | 上线前对“采集什么、上报给谁”做的合规核对,未同意前不采集可识别用户字段。 |
| 采集最小化 | 原则:只要够排查使用的字段,别把能定位到个人的设备标识随手丢给第三方 SDK。 |
评论