HarmonyOS HAP 逆向流程:sourceMaps 泄露源码树 + modules.abc 反编译 + ArkTS 字节码阅读
mobile/harmony · verified
一句话结论
HarmonyOS 的 .hap 本质是 ZIP,解压后 ets/modules.abc 是 ArkTS 编译后的方舟字节码,ets/sourceMaps.map 若未在发布构建中剥离会泄露完整源码文件树;用带 ABC 插件的 JADX 反编译,结合 module.json5/main_pages.json、Stage 生命周期和方舟伪指令(newlexenvwithname、asyncfunctionenter、suspendgenerator、resumegenerator)即可还原业务逻辑与密钥派生链。
原理
- HAP 结构:
.hap是 ZIP,典型目录包含ets/modules.abc(ArkTS 字节码)、ets/sourceMaps.map(源码映射)、resources/base/、resources/rawfile/(不编译的原始资源)、module.json5(模块配置)、pack.info、libs/arm64-v8a/(Native 库)。一个应用可由多个 HAP(Entry/Feature)、HSP(动态共享包)、HAR(静态共享包)组成。 - 配置与路由:
module.json5的mainElement指定入口 Ability,pages指向resources/base/profile/main_pages.json;入口EntryAbility.onWindowStageCreate的windowStage.loadContent('pages/...')决定首屏。AppStorage/LocalStorage是进程级/页面级全局键值存储,跨页面传递的 token/用户信息常在这里。 - sourceMaps 泄露:
sourceMaps.map是 JSON,键为源码路径(如entry/src/main/ets/model/FlagUtil.ets),值为version/file/sources/mappings;正常发布应剥离,保留它通常意味着 debug 构建或未配置sourceMap。它直接给出模块划分、类名与文件路径,是逆向的“代码地图”。 - ABC 字节码:ArkTS 经方舟编译器前端(TypeScript AST)与后端生成
.abc,内部包含文件头、类/方法定义、字符串常量池、字节码指令区。公开格式文档有限,常用带 ABC 插件的 JADX 反编译;输出会保留方舟伪指令,需要按语义还原。 - 伪指令语义:
newlexenvwithname([n, "name0", slot0, ...], n)创建词法环境,_lexenv_X_Y_中 X 是嵌套层级、Y 是槽位;数组格式为[总数, 名称, 槽位, ...]。asyncfunctionenter+suspendgenerator+resumegenerator+getresumemode是async/await的展开;asyncfunctionresolve/reject对应 Promise 的 resolve/reject。ldlocalmodulevar、createobjectwithbuffer、ldobjbyvalue等用于模块变量、对象字面量和属性访问。- Native 层:若存在
libs/arm64-v8a/*.so,通过 N-API(napi_define_properties/DECLARE_NAPI_FUNCTION)向 ArkTS 暴露函数;import xxx from 'libxxx.so'对应 native 模块,需 IDA/Ghidra 分析。 - 为什么可逆向:ArkTS 是 TypeScript 超集,编译后保留较多语义信息(闭包变量名、字符串常量、类结构),相比 Dex 更容易还原高级逻辑;sourceMaps 与未混淆的字符串进一步降低门槛。
触发条件
- 目标为 HarmonyOS HAP/APP 包,且未加壳/未重度混淆。
ets/sourceMaps.map未剥离,或module.json5/main_pages.json可读。- 有 ABC 反编译工具(带插件的 JADX、ArkAnalyzer、abc2ets 等)。
- 业务逻辑主要在 ArkTS/ABC 中,或 Native 库可通过 N-API 定位。
利用步骤
- 把
.hap改后缀为.zip解压,列出ets/、resources/、module.json5、libs/。 - 读
module.json5的mainElement/pages,读main_pages.json得到页面列表;从EntryAbility.onWindowStageCreate确认首屏。 - 检查
ets/sourceMaps.map:提取所有sources路径,按model/、pages/、entryability/分类,推断各模块职责(登录、数据库、加解密、Bridge)。 - 用带 ABC 插件的 JADX 打开
modules.abc,按func_main_0的newlexenvwithname建立_lexenv_X_Y_→ 函数名映射。 - 按
asyncfunctionenter/suspendgenerator/resumegenerator模式跳过 async/await 模板,定位真实业务调用;跟踪AppStorage读写、字符串常量、硬编码密钥/哈希/密文。 - 若逻辑进入
libs/*.so,搜索napi_注册函数,定位导出方法与参数;结合 IDA/Ghidra/Unicorn 分析。 - 检查
resources/rawfile/下的 H5/JSON/配置,区分展示层与真实逻辑(可能是障眼法)。
PoC
# 1) 解包
unzip Bridge.hap -d Bridge_hap
ls Bridge_hap/ets Bridge_hap/resources Bridge_hap/libs
# 2) 看配置与路由
cat Bridge_hap/module.json5
cat Bridge_hap/resources/base/profile/main_pages.json
# 3) 看 sourceMaps 泄露的源码树
python - <<'PY'
import json
m = json.load(open('Bridge_hap/ets/sourceMaps.map'))
for k in m: print(k)
PY
# 4) 用带 ABC 插件的 JADX 反编译
jadx-gui Bridge_hap/ets/modules.abc
# 字节码模式 → ArkTS 语义
newlexenvwithname([2, "reject", 0, "resolve", 1], 2)
-> 闭包/词法环境,_lexenv_0_0_=resolve, _lexenv_0_1_=reject
asyncfunctionenter + suspendgenerator + resumegenerator + getresumemode
-> let x = await someAsyncCall()
变体与关联
- 包类型变体:多 HAP(Entry/Feature)、HSP 动态共享包、HAR 静态共享包;逻辑可能跨包,需同时解包。
- 保护变体:ABC 混淆(
#~@0>#符号)、字符串加密、Native 加壳、反调试;需先脱壳/解密常量。 - Native 变体:N-API 导出、JNI 风格封装、Unicorn 黑盒执行;见 [[mobile-harmony-arkts-napi-obfuscated-constants-sm4-vm-flag]]、[[mobile-harmony-hap-arkts-native-sbox-affine-unicorn]]。
- 关联:[[mobile-android-webview-jsbridge-arbitrary-origin-credential-theft]](WebView/JSBridge 信任边界)、[[ctf-reverse-android-arm64-jni-unicorn-offline-oracle]](移动端 native 逆向)。
检测与防御
- 检测:发布包中存在
sourceMaps.map、未混淆的类名/字符串、硬编码密钥/哈希/密文;HAP 内rawfile含敏感配置;WebView 暴露敏感 JSBridge 方法。 - 防御:发布构建剥离
sourceMaps.map;启用 ABC 混淆/字符串加密;密钥与凭据放服务端或安全存储,不要硬编码在客户端;WebView 做域名白名单与 JSBridge 鉴权。 - 加固:HAP 加壳/完整性校验;敏感逻辑下沉到服务端;对
rawfile与 WebView 加载内容做审计。