文档开发者中心
我的
|

HarmonyOS 7

系统浏览器扩展 ID 的生成与稳定性规则:签名后 ID 如何预知,白名单如何预置?

背景与已验证事实

  • 项目扩展 manifest 无 "key" 字段;在系统浏览器开发者模式加载未签名扩展目录后,获得运行时分配的扩展 ID,无法确认其跨加载/跨设备的稳定性。
  • host 侧白名单必须精确 origin: 精确 ALLOWED_EXTENSION_ORIGINS;[shared_config.json] allowed_origins 精确匹配),不放宽通配。
  • 正式签名/分发后扩展 ID 未知 → 白名单无法最终收口,已成为本项目发布链路的实际阻断(见 IMPLEMENTATION_STATUS.md 发布收口节)。
  • chrome v3官方扩展经过签名的id,目前识别不了

想请教的问题

  1. 鸿蒙系统浏览器扩展 ID 的生成规则是什么?是否存在 Chrome 式 manifest key → ID 的等价机制(签名证书指纹 → ID)?
  2. 正式签名/上架后的扩展 ID 是否固定?能否在签名/发布之前预知并写入 host 白名单?
  3. host 侧 allowed_origins / 来源准入是否支持非精确匹配(按签名证书、按应用身份)?
  4. 未签名开发期 ID 可能变化时,官方建议的 host 白名单管理方式(开发者专用豁免通道?)
  5. 那个浏览器厂商签名扩展包后的ID 鸿蒙自带浏览器能够识别?华为浏览器目前无官方扩展商店。
点赞
1
收藏
回复
18
分享
举报
浏览114 发布于6天前重庆
全部评论
最多点赞
最新发布
最早发布
感谢
6楼回复于6天前 来自河南

这个问题建议区分 Chrome 扩展 ID 机制、华为浏览器扩展安装机制和 NativeMessaging 来源校验三个层面。

1、扩展 ID 生成规则

Chrome 的 manifest.json 中可以通过 key 固定扩展 ID,但目前华为公开的 WebNativeMessaging 开发文档没有说明是否支持这套机制,也没有公开扩展 ID 与签名公钥、证书指纹之间的映射规则。因此,不能直接认为 Chrome 的 ID 生成规则在华为浏览器上同样适用。

2、签名后 ID 是否固定

华为电脑浏览器支持拖拽安装 CRX,也支持加载解压目录。但目前没有查到华为官方对签名扩展 ID 稳定性、跨设备一致性以及签名前预知 ID 的明确承诺。建议使用同一份 CRX 在不同设备、不同安装方式下做对照测试,记录扩展管理页面显示的 ID。

3、allowed_origins 白名单

根据官方 WebNativeMessaging 指南,allowed_origins 配置的是扩展 Origin,示例校验使用 includes() 进行精确匹配。目前没有公开的按扩展签名证书或扩展应用身份进行替代匹配的配置方式。需要注意,allowList 中的浏览器应用 appIdentifier 与扩展 Origin 是两个不同维度的校验,不能相互替代。

4、开发和发布阶段如何处理

建议开发环境和正式环境维护独立的白名单。开发阶段获取浏览器实际分配的 Origin,正式发布前使用最终分发的扩展包进行安装验证,再将实际 Origin 固化到 host 的 shared_config.json 中。

另外,你提到 Chrome MV3 官方扩展经过签名后无法被识别,建议进一步区分是扩展安装失败、Manifest V3 API 不兼容,还是安装成功但 NativeMessaging 连接被白名单拒绝。这三个问题的排查方向不同。

目前最需要华为浏览器团队明确的是:是否支持 manifest key、CRX 签名公钥是否参与 ID 派生,以及正式分发后 ID 是否跨设备稳定。在这些规则没有得到官方确认前,不建议自行推导 ID 或放宽来源白名单。

展开全部
13楼回复于5天前 来自辽宁

你好,针对描述的问题:

  • 官方 Native Messaging 指南只明确了 chrome-extension://<id>/ 完整 origin 精确匹配,示例校验是 includes(connectExtensionOrigin);未公开扩展 ID 生成算法、签名/发布后的稳定性规则,也没有按签名证书或应用身份的扩展准入机制。
  • 所以不能把 Chrome 的 manifest key → ID 或 HAP appIdentifier 规则当成华为浏览器承诺。需先用最终 .crx 在目标浏览器版本实测,记录管理页显示 ID,再验证重装、换设备、升级;只有复现一致,才能把 chrome-extension://<实测ID>/ 回填到 allowed_origins
  • allowList 是允许读取共享配置的浏览器应用 appIdentifier,不能替代扩展 origin 白名单。可分开维护开发/正式清单,发布前冻结正式扩展产物,正式 Host 依赖已验证的精确清单

文档参考

提工单建议: 如果最终 .crx 的 ID 仍不稳定或发布前必须预分配 ID,建议通过在线提单反馈,附系统/浏览器版本、.crx  SHA-256、manifest 是否含 key、实测 ID 截图、重装/换设备/升级结果,并要求明确 ID 派生规则、稳定性承诺与签名身份准入方案

11楼回复于5天前 来自湖南

正式白名单应以华为浏览器安装最终交付包后实际报告的 ID 为准。 Chrome 的 key 用的是扩展公钥,能在 Chrome 开发期固定 ID,这条规则在华为浏览器上需要实测。Chrome key 文档

  • 签名包怎么验证:鸿蒙电脑的华为浏览器官方支持在开发者模式下直接拖入 .crx 安装,也支持加载解压目录。对你手上的 MV3 包,先直接装 .crx,从扩展管理页或 chrome.runtime.id 取实际 ID。官方未公开哪些厂商签名会保留原 ID,能安装也不代表会沿用 Chrome 商店 ID。华为浏览器扩展安装说明
  • 白名单怎么配:allowed_origins 按完整的 chrome-extension://<id>/ 精确匹配,可列多个。shared_config.json 外层的 allowList 校验的是浏览器应用的 appIdentifier,扩展仍须通过 origin 校验。官方暂时没有提供按扩展证书匹配或开发期豁免的配置。HarmonyOS Native Messaging 指南
  • 发布怎么收口:开发包填实测的调试 ID。发布前用最终 .crx 在目标浏览器上验证全新安装、跨设备和升级,再用同一份已验证的 origin 清单生成 allowed_origins 和 ALLOWED_EXTENSION_ORIGINS。如果同一交付包的 ID 仍会漂移,就需要华为确认固定 ID 的分发方式,才能预置一套通用白名单。
9楼回复于5天前 来自广东

结论: 鸿蒙系统浏览器目前没有公开的 Chrome manifest key 等价机制,扩展 ID 的生成算法未文档化,因此无法在签名/发布前预知 ID。Host 侧 allowed_origins 不支持非精确匹配(不支持通配符、证书指纹或应用身份),开发期 ID 变化时必须重新构建 Host 应用。华为浏览器目前没有官方扩展商店,你无法依赖厂商签名来固定 ID。

原因

  • ID 生成规则未公开:官方文档没有说明鸿蒙浏览器扩展 ID 的具体算法。虽然 ID 格式与 Chrome 一致(32 位小写字母数字),但 Chrome 的 manifest key 机制是否被鸿蒙浏览器支持,官方从未确认。
  • 白名单仅支持精确匹配:allowed_origins 的校验逻辑是浏览器侧对数组做 includes 精确比对,没有通配符、没有按签名证书匹配、也没有按应用身份匹配的机制。
  • 签名后 ID 大概率固定,但无法预知:基于 Chromium 内核的实现,签名后的扩展 ID 由签名公钥决定,是固定的。但在签名之前,你无法通过官方手段提前计算出这个 ID。

方案

方案一:开发期动态白名单 + 二次鉴权(唯一可行的工程路径)

由于 shared_config.json 是编译时写死的静态配置,ID 变化后必须重新构建 Host 应用。更实际的做法是:

  1. 开发阶段:在 Host 应用的 onConnectNative 回调中,通过 ConnectionInfo.extensionOrigin 获取实际传入的扩展 origin。
  2. 应用侧二次校验:不依赖 allowed_origins 的硬编码白名单作为唯一防线。在 Host 侧自行校验扩展传入的认证字段(如扩展包名、通讯协议中的签名),作为额外安全层。
  3. 发布前收口:正式签名后,获取最终固定 ID,将其写入 allowed_origins 并重新构建 Host 应用。这是目前唯一能保证白名单精确匹配的路径。

方案二:等待华为官方扩展商店(长期)

OpenHarmony 社区已有“支持华为鸿蒙浏览器扩展市场”的需求记录,但截至当前,华为浏览器没有官方扩展商店。你无法依赖“厂商签名扩展包”来固定 ID,因为分发渠道本身尚不存在。

方案三:接受开发期 ID 不稳定的现实

每次通过开发者模式重新加载扩展后,记录新分配的 ID,更新 shared_config.json 并重新安装 Host 应用。这虽然繁琐,但在官方机制明确之前,是唯一合规的收口方式。

展开全部
19楼回复于前天13:11 来自北京

先说结论:**华为浏览器没有官方扩展商店,也不支持 Chrome 式扩展 ID 体系**,所以你在找的「manifest key → ID」等价机制在系统浏览器上大概率不存在。继续按 Chrome 的思路推这条路会一直卡住。 解释一下 Chrome 的机制作为对照:Chrome 扩展 ID 是由扩展公钥(manifest 里的 `key`)或签名证书公钥做 SHA256,取前 128 位按 a-p 字母映射生成的。所以签名证书固定 → ID 固定 → 可以提前算出来写白名单。这套机制依赖 Chrome 的扩展平台和签名分发体系。 华为浏览器目前不开放这套体系,所以: - 没有商店签名分发 → 没有稳定的签名证书 → 没有可预知的 ID - 开发者模式加载未签名目录得到的 ID 是运行时分配的,**跨加载、跨设备都不保证稳定** **可行的替代路径:** **一、白名单不要依赖扩展 ID,改用你们自己可控的身份标识。** host 侧和扩展侧各自持有同一份配置,扩展注入时带上一个由你们服务端签发的 token(含应用身份、有效期),host 校验签名而不是校验 origin。这样签名/发布前后都不需要改白名单。 **二、如果 host 侧必须是 origin 精确匹配,那就把 origin 作为构建期常量由 CI 注入。** 发布前在流水线里跑一步:读取实际分配到的 ID → 生成 host 配置 → 一起打包。避免手工维护两份配置。 **三、开发期豁免通道。** 在 host 侧加一个构建类型判断(debug/development 构建才开启),开发期放行所有 localhost/extension origin,正式包关闭。这是业内的常规做法,比追着 ID 变化可靠。 **四、关于「浏览器厂商签名扩展包后的 ID 能否被识别」**——如果你们走的是自研浏览器或内嵌 WebView 的方案,那 ID 规则由你们自己定义,不受华为浏览器限制。如果依赖系统浏览器,建议尽早确认它是否支持扩展加载,避免把整个发布链路压在一个不确定的能力上。 最后一句实话:这个能力目前官方文档支持很弱,建议同时在开发者社区提工单确认,别只靠社区猜测往下做。

18楼回复于4天前 来自广东

“未查到 ID 派生规则”不等于已经证明“不支持固定 ID”;目前能核验的 Native Messaging 指南不足以承诺 Chrome 的 key 规则在目标华为浏览器上生效。发布时可以先冻结实际分发的 CRX,在目标版本验证安装、重装、换设备和升级后的 ID,再把同一份已验证 origin 清单用于两处白名单;如果必须在安装之前预分配 ID,仍需浏览器团队确认正式规则。

配置片段如下,占位内容必须换成实测并核验的正式 ID;开发 ID 留在开发配置中:

收起
自动换行
深色代码主题
复制
{
  "allowed_origins": [
    "chrome-extension://<已核验的正式扩展ID>/"
  ]
}

allowList 里的浏览器 appIdentifier 只管共享配置的读取方,不能代替扩展来源;连接后的握手也不能代替浏览器侧的前置校验。你说的“识别不了”请先区分安装失败、安装后 ID 不同和 host 拒绝连接:官方电脑说明确实有直接拖入 CRX 的入口,但不等于任意 MV3 包都兼容。参考:通信配置 https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/web-native-messaging/ ;安装说明 https://consumer.huawei.com/cn/support/content/zh-cn16082289/

17楼回复于5天前 来自四川
关于鸿蒙系统浏览器扩展 ID 的生成,官方没有公开具体算法,仅确认格式与 Chrome 一致(32 位小写字符串),且未提供 Chrome 式的 manifest key 字段等价机制来预知 ID;正式签名后的 ID 虽大概率由签名公钥决定并保持稳定,但目前无法在签名或发布前预知并写入 host 白名单;host 侧的 allowed_origins 明确为精确匹配 chrome-extension://<扩展ID>/,不支持按签名证书或应用身份的非精确准入,开发期未签名 ID 变化时也无官方豁免通道,只能依赖精确刷新白名单;至于厂商签名扩展的识别,目前 HarmonyOS 移动端华为浏览器未开放插件支持,PC 端虽可加载 Chromium 扩展,但正式签名扩展的 ID 识别与准入仍受上述精确匹配约束,无官方扩展商店可供收口。
16楼回复于5天前 来自湖北

前面各位都聊了ID生成、预计算的坑,这里直接给一套能落地的方案。现在的核心问题就是鸿蒙浏览器扩展没有Chrome那种manifest key固定ID的能力,allowed_origins是精确匹配,差一个字符都不行,origin没法提前锁定,静态写死白名单发版很容易翻车。

开发用shared_config.json

收起
自动换行
深色代码主题
复制
{
  "appIdentifier": "com.xxx.demo",
  "allowed_origins": [
    "chrome-extension://替换成本机扩展详情页拿到的origin/"
  ]
}

一定要带上末尾的斜杠,很多人踩这个坑,不带斜杠直接匹配失败。开发机装好解压版扩展,复制页面上的origin填进去调试。

正式包推荐用动态白名单的ArkTS代码,把校验放到应用侧,不再完全依赖静态配置文件

收起
自动换行
深色代码主题
复制
import { WebNativeMessagingExtensionAbility } from '@ohos.web';
import { http } from '@ohos/net';

const ALLOWLIST_URL = "https://xxx/extension-allowlist";
let cachedTrustOrigins: string[] = [];

async function refreshOriginAllowList() {
  try {
    const res = await http.createHttp().request(ALLOWLIST_URL, {
      method: http.RequestMethod.GET
    });
    if (res.responseCode === 200) {
      cachedTrustOrigins = JSON.parse(res.result as string);
    }
  } catch (err) {
    console.error('拉取扩展白名单失败', JSON.stringify(err));
  }
}

function checkOriginValid(origin: string): boolean {
  return cachedTrustOrigins.includes(origin);
}

async function onNativeMessageReceive(origin: string, payload: ArrayBuffer) {
  if (cachedTrustOrigins.length === 0) {
    await refreshOriginAllowList();
  }
  if (!checkOriginValid(origin)) {
    console.error('来源origin不在白名单,拦截消息:', origin);
    return;
  }
  console.info('校验通过,处理扩展消息', origin);
}

如果项目不能联网,只能离线跑,就收集所有设备的origin合并到配置里

收起
自动换行
深色代码主题
复制
{
  "appIdentifier": "com.xxx.demo",
  "allowed_origins": [
    "chrome-extension://origin1/",
    "chrome-extension://origin2/",
    "chrome-extension://origin3/"
  ]
}

操作方式:全程只用一套正式证书打包crx,在所有目标设备上安装,逐个提取origin汇总,后续版本迭代时持续收集新出现的origin补进去。

配套一个node小脚本,把一行一条origin的origins.txt直接生成完整shared_config.json,内部批量采集很省事

收起
自动换行
深色代码主题
复制
const fs = require('fs');
fs.readFile('./origins.txt','utf8',(err,data)=>{
  if(err) return console.error(err);
  const list = data.trim().split('\n').filter(Boolean);
  const cfg = {
    appIdentifier:"com.xxx.demo",
    allowed_origins:list
  }
  fs.writeFileSync('./shared_config.json',JSON.stringify(cfg,null,2));
  console.log('配置生成完成');
})

额外提几个前面讨论里反复出现但容易忽略的点:社区里流传的哈希预算ID只适合拿来参考预估,绝对不能上正式包,浏览器版本、系统版本一变,算出来的值就对不上;换签名证书、重新打包、浏览器升级都有可能改变扩展origin;动态白名单的后端接口记得加鉴权,不然白名单被恶意篡改风险很高。

展开全部
15楼回复于5天前 来自江苏

先说结论:官方文档只确认了一件事,allowed_origins 是完整 chrome-extension://<扩展编号>/ 精确匹配;扩展编号怎么算、签名后稳不稳、能不能提前知道,官方都没有公开承诺。所以不要先按浏览器扩展的通用规则写死白名单,要先实测,再把实测结果锁进发布流程。

1. 编号生成要分三层看

未签名加载:浏览器临时分配编号,跨加载、跨设备是否稳定,官方没有说法,不能默认不变。

通用规则里的 key:在通用扩展体系里,manifest.json 加 key 字段(扩展公钥)可以固定开发期编号,编号由公钥摘要推导,密钥不变编号不变。但华为公开的清单示例没有 key 字段,也没有说明支持这套机制,只能当成待验证的假设,不能当成承诺。

签名包:通用体系下编号由包内公钥决定,与谁签的名无关,安装成功也不等于沿用原编号;华为浏览器是否按同一算法、是否保留原编号,同样没有官方说法。

2. 花十分钟实测 key 是否生效

收起
自动换行
深色代码主题
复制
# 生成密钥对并导出公钥
openssl genrsa -out ext_key.pem 2048
openssl rsa -in ext_key.pem -pubout -outform DER -out pubkey.der
# 取公钥摘要前 16 字节,再按半字节映射成 a–p,得到 32 位编号
openssl dgst -sha256 -binary pubkey.der | head -c 16 | od -An -tx1

把公钥的编码结果写进 manifest.json 的 key 字段,重新加载后比对扩展管理页显示的编号和扩展内 chrome.runtime.id 的返回值。注意:直接把 32 位十六进制串当编号是常见错误,必须做 a–p 映射才是 32 位编号。一致,开发期编号就能提前固定;不一致,就说明华为浏览器不走这条规则,不要再推导。

3. 白名单怎么配

allowed_origins 是数组,可以同时配开发期和正式编号,发布后删掉开发期条目。shared_config.json 外层的 allowList 管的是浏览器应用的 appIdentifier,不是扩展身份,不能互相替代。shared_config.json 是编译时静态配置,编号变了就要重新构建应用。

4. 发布收口的顺序要反过来

先冻结正式扩展包,再在目标浏览器版本上做全新安装、重装、换设备、升级各测一遍,编号稳定才回填白名单,最后构建应用发布包;构建时加一道检查,没有已验证的正式编号就直接失败,不要回退开发配置、不要放宽成通配。如果同一正式包编号仍漂移,就走在线提单,要求明确编号派生规则和固定编号的分发方式,同时把这条作为发布阻断记录下来。

5. 不要只靠白名单认身份

连接建立后,应用侧下发一次性随机数,扩展用预置私钥签名、应用用内置公钥验签;编号漂移、换设备都不影响这层校验,白名单只做第一道粗筛。

参考:

展开全部
14楼回复于5天前 未知归属地
共2页
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。