场景描述
工程源码的混淆可以降低工程被破解攻击的风险,但会导致无法直接通过Release应用的堆栈信息定位到源码的具体文件和行位置,不易于开发者快速定位解决问题。本工具使用指南将以开发者视角,向开发者讲解,如何分别使用IDE自带反混淆工具AnalyzeStaceTrace和hstack命令行对Release应用中C++堆栈、ArkTS堆栈以及ArkTS堆栈中混淆的方法名进行还原,方便开发者进行错误信息定位(注:仅支持API12及以上的工程)。
文件准备工作
1.已混淆的工程和报错日志,这里以混淆工程为例,混淆规则配置如下:
# 开启属性名称混淆
-enable-property-obfuscation
# 开启字面量名称混淆
-enable-string-property-obfuscation
# 开启文件/文件夹名称混淆
-enable-filename-obfuscation
# 开启顶层作用域名称混淆(作用于类名、方法名)
-enable-toplevel-obfuscation
# 开启export导出对象混淆
-enable-export-obfuscation
两次运行工程分别点击工程内的Native按钮和ArkTS按钮获取混淆后的报错日志。
2.获取原工程混淆后build产物目录下的sourceMaps.map文件,nameCache.json文件,以及生成的so文件(根据运行的设备的CPU架构选取对应的so文件)产物路径参考下图:
方案描述
1.使用IDE自带工具Analyze Stace Trace工具进行日志反混淆。
a.当前工程为堆栈所在应用对应的工程,且存在Release构建产物:
i.单击菜单栏Code->Analyze Stack Trace,或在FaultLog页面异常堆栈信息处右键选择Analyze Stack Trace。
ii.在弹出的Analyze Stack Trace对话框中,粘贴Release应用的异常堆栈信息。取消勾选Unscramble stack,点击Start Analyze进行解析,对话框右侧及为解析结果:
b.当前工程不为堆栈所在应用对应的工程。
i.ArkTS堆栈报错信息反混淆操作演示。
打开Analyze Stack Trace工具栏,勾选Unscramble stack,分别添加应用对应的sourceMaps.map文件、nameCache.json文件点击Start Analyze即可进行解析,对话框右侧即为解析结果:
ii.Native堆栈报错信息反混淆操作演示。
打开Analyze Stack Trace工具栏,勾选Unscramble stack,分别添加应用对应的sourceMaps.map文件、nameCache.json文件和对应的so文件,点击Start Analyze即可进行解析:
iii.IDE界面参数介绍:
-
-
-
- 左侧输入框:输入需要解析的堆栈信息,右侧为输出结果区域。
- Unscramble stack:不勾选表示以当前IDE工程的realease产物来解析堆栈。
- Source map:文件中存有混淆前后代码位置的映射关系。
- so:动态链接库,包含了已编译的可重用代码,可以被程序在运行时动态加载和链接。
- Name cache:混淆名称映射表,文件中包含混淆前和混淆后的名称。
- Start Analyze:开始解析。
-
-
2.使用hstack命令的方式进行日志反混淆。
准备工作:
建议准备五个空的文件夹(文件名可自定义),这里在E:\hstackTest目录下分别新建nameCache、nativeso、sourcemap、output、input五个空的文件夹为例。将nameCache.json文件放入nameCache文件内,将sourceMaps.map文件放入sourceMaps文件夹中,将生成的so文件放入nativeso文件中,input文件存放ArkTS和Native堆栈报错信息文件,output文件作为输出目录。
工具下载和环境配置:
- a.Node.js配置到环境变量中,以Windows系统为例:(建议使用18.14.1版本)。
-
b.如果需要对C++文件产生的异常进行解析,则需要将SDK中的native\llvm\bin目录配置到环境变量中,变量名设置为“ADDR2LINE_PATH”(路径的文件名不能包含空格)。
-
c.根据电脑的操作系统,从DP平台上的套件货架上下载对应版本的hstack工具。
ArkTS堆栈报错信息反混淆操作演示。
将ArkTS堆栈文件放入input文件夹内,在工具所在目录打开终端,输入指令:
hstack -i E:\hstackTest\input -o E:\hstackTest\output -s E:\hstackTest\sourcemap -n E:\hstackTest\nameCache
在output文件夹中即可看到解析后的ArkTS堆栈文件(解析后的文件会在原文件名下增加一个“_”命名),解析效果展示:
Native堆栈报错信息反混淆操作演示。
将Native堆栈文件放入input文件夹内,在工具所在目录打开终端,输入指令:
hstack -i E:\hstackTest\input -o E:\hstackTest\output -s E:\hstackTest\sourcemap --so E:\hstackTest\nativeso -n E:\hstackTest\nameCache
解析效果展示:
hstack命令行配置说明:
指令 | 说明 |
-s | 可选,指定工程sourcemap.map文件归档目录。参数为文件夹 |
--so | 可选,指定工程so文件归档目录。参数为文件夹 |
-n | 可选 ,指定工程nameCache.json文件归档目录。参数为文件夹 |
-i | 堆栈文件目录,参数为文件夹 |
-o | 反混淆文件输出目录,参数为文件夹 |
--version/-v | 查看hstack版本。 |
--help/-h | 查询hstack命令行帮助。 |
注意事项:
- sourcemap与so文件归档目录至少提供一项。
- 如果需要对方法名进行解析还原,则需要同时提供sourcemap与nameCache文件。
- 路径参数,包括ADDR2LINE_PATH这个环境变量的参数值,不支持以下特殊字符:`!@#¥……&*()——|{}【】‘;:。,、?。