文档开发者中心
我的
|

Asset Store Kit

鸿蒙应用安全加固实战:防逆向、防篡改、防调试,让应用"固若金汤"

一、引言:应用被"破解",损失的不只是钱

“应用上线一个月,被人反编译、去除广告、重新打包——盗版满天飞。”

这是很多商业应用面临的现实威胁。应用被逆向意味着:代码逻辑泄露、付费功能被破解、广告被移除、用户数据被窃取。对于金融、游戏、付费内容类应用,损失可能是数百万级。

HarmonyOS 提供了多层安全加固机制——代码混淆、签名校验、防调试、完整性校验、安全加固服务。今天这篇,我们从代码混淆 → 签名校验 → 防调试 → 完整性校验,系统拆解鸿蒙应用安全加固的完整方案。

二、先搞清楚:应用面临的五大威胁

威胁 说明 后果
反编译 把 HAP 解包,还原代码 逻辑泄露
重打包 修改代码后重新签名 盗版、去广告
动态调试 附加调试器,动态分析 密钥泄露
内存篡改 修改运行时内存 破解付费
二次打包 注入恶意代码 用户数据泄露

三、Step 1:代码混淆——让反编译"看不懂"

代码混淆是最基础的加固手段——重命名类、方法、变量,让反编译后的代码难以阅读。

3.1 开启混淆

在 build-profile.json5 中配置:

json

收起
自动换行
深色代码主题
复制
{
  "buildOption": {
    "arkOptions": {
      "obfuscation": {
        "ruleOptions": {
          "enable": true,
          "files": ["./obfuscation-rules.txt"]
        }
      }
    }
  }
}

3.2 配置混淆规则

创建 obfuscation-rules.txt:

text

收起
自动换行
深色代码主题
复制
# 开启所有混淆
-enable-property-obfuscation
-enable-toplevel-obfuscation
-enable-filename-obfuscation
-enable-export-obfuscation

# 保留入口文件
-keep-file-name entryability
-keep-file-name pages

# 保留需要反射的类
-keep class com.example.app.model.** { *; }

# 保留 JSON 序列化的字段
-keep-property-name name
-keep-property-name age
-keep-property-name userId

# 保留 Native 方法
-keep class com.example.app.native.** { *; }

# 保留注解
-keep-annotation

混淆规则说明:

规则 说明
-enable-property-obfuscation 混淆属性名
-enable-toplevel-obfuscation 混淆顶层作用域
-enable-filename-obfuscation 混淆文件名
-enable-export-obfuscation 混淆导出名称
-keep-property-name 保留指定属性名(不混淆)

⚠️ 注意:混淆后需要充分测试——特别是反射、JSON 序列化、Native 调用等场景,容易因混淆而出错。

四、Step 2:签名校验——防止重打包

重打包是最常见的攻击方式——攻击者修改代码后重新签名。签名校验让应用启动时检查签名是否被篡改。

typescript

收起
自动换行
深色代码主题
复制
import { bundleManager } from '@kit.BundleManagerKit';
import { cryptoFramework } from '@kit.CryptoArchitectureKit';

export class SignatureVerifier {
  // 预期的签名指纹(从 AGC 获取)
  private static readonly EXPECTED_FINGERPRINT = 'XX:XX:XX:XX:XX:XX:...';
  
  // 校验签名
  static async verifySignature(context: common.UIAbilityContext): Promise<boolean> {
    try {
      // 1. 获取应用签名信息
      const bundleInfo = await bundleManager.getBundleInfo(
        context.abilityInfo.bundleName,
        bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO
      );
      
      const signatureInfo = bundleInfo.signatureInfo;
      if (!signatureInfo) {
        console.error('❌ 无法获取签名信息');
        return false;
      }
      
      // 2. 计算签名指纹
      const fingerprint = await this.calculateFingerprint(signatureInfo.appCert);
      
      // 3. 比对指纹
      const isValid = fingerprint === this.EXPECTED_FINGERPRINT;
      
      if (!isValid) {
        console.error('❌ 签名校验失败,应用可能被篡改');
        // 可以在这里退出应用或限制功能
        return false;
      }
      
      console.log('✅ 签名校验通过');
      return true;
    } catch (err) {
      console.error('签名校验异常', err);
      return false;
    }
  }
  
  // 计算证书指纹
  private static async calculateFingerprint(cert: Uint8Array): Promise<string> {
    const md = cryptoFramework.createMd('SHA256');
    await md.update({ data: cert });
    const digest = await md.digest();
    
    return Array.from(digest.data)
      .map(b => b.toString(16).padStart(2, '0').toUpperCase())
      .join(':');
  }
}

在应用启动时校验:

typescript

收起
自动换行
深色代码主题
复制
export default class EntryAbility extends UIAbility {
  async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): Promise<void> {
    const isValid = await SignatureVerifier.verifySignature(this.context);
    
    if (!isValid) {
      // 签名异常,退出应用
      console.error('签名校验失败,应用退出');
      this.context.terminateSelf();
      return;
    }
    
    // 签名正常,继续启动
  }
}

五、Step 3:防调试——阻止动态分析

动态调试是攻击者分析应用逻辑的常用手段。防调试让应用检测到调试器时拒绝运行。

typescript

收起
自动换行
深色代码主题
复制
import { process } from '@kit.ProcessKit';

export class AntiDebug {
  private static debuggerCheckInterval: number = -1;
  
  // 检查是否被调试
  static isBeingDebugged(): boolean {
    try {
      // 检查调试状态
      return process.isDebug();
    } catch (err) {
      return false;
    }
  }
  
  // 启动持续检测
  static startMonitoring(): void {
    // 每 3 秒检测一次
    this.debuggerCheckInterval = setInterval(() => {
      if (this.isBeingDebugged()) {
        console.error('⚠️ 检测到调试器,应用退出');
        // 退出应用
        process.exit(0);
      }
    }, 3000);
  }
  
  // 停止检测
  static stopMonitoring(): void {
    if (this.debuggerCheckInterval !== -1) {
      clearInterval(this.debuggerCheckInterval);
    }
  }
}

⚠️ 注意:防调试要适度——过度检测可能影响正常开发调试。建议只在 Release 版本启用。

六、Step 4:完整性校验——防止代码篡改

完整性校验检查应用的关键文件是否被修改。

typescript

收起
自动换行
深色代码主题
复制
import { fileIo } from '@kit.CoreFileKit';
import { cryptoFramework } from '@kit.CryptoArchitectureKit';

export class IntegrityChecker {
  // 关键文件的预期哈希值(构建时生成)
  private static readonly EXPECTED_HASHES: Record<string, string> = {
    'entry.abc': 'abc123...',
    'config.json': 'def456...'
  };
  
  // 校验文件完整性
  static async verifyFiles(context: common.UIAbilityContext): Promise<boolean> {
    try {
      for (const [fileName, expectedHash] of Object.entries(this.EXPECTED_HASHES)) {
        const filePath = context.filesDir + '/' + fileName;
        
        // 计算实际哈希
        const actualHash = await this.calculateFileHash(filePath);
        
        if (actualHash !== expectedHash) {
          console.error(`❌ 文件完整性校验失败: ${fileName}`);
          return false;
        }
      }
      
      console.log('✅ 文件完整性校验通过');
      return true;
    } catch (err) {
      console.error('完整性校验异常', err);
      return false;
    }
  }
  
  // 计算文件哈希
  private static async calculateFileHash(filePath: string): Promise<string> {
    const file = fileIo.openSync(filePath, fileIo.OpenMode.READ_ONLY);
    const stat = fileIo.statSync(filePath);
    const buffer = new ArrayBuffer(stat.size);
    fileIo.readSync(file, buffer);
    fileIo.closeSync(file);
    
    const md = cryptoFramework.createMd('SHA256');
    await md.update({ data: new Uint8Array(buffer) });
    const digest = await md.digest();
    
    return Array.from(digest.data)
      .map(b => b.toString(16).padStart(2, '0'))
      .join('');
  }
}

七、Step 5:敏感逻辑下沉到 Native 层

ArkTS 代码相对容易反编译——把关键逻辑(如加密算法、授权校验)放到 Native(C/C++)层,增加逆向难度。

cpp

收起
自动换行
深色代码主题
复制
// native/crypto.cpp
#include <string>
#include <openssl/aes.h>

// Native 层实现加密
extern "C" {
  std::string nativeEncrypt(const std::string& plaintext, const std::string& key) {
    // AES 加密逻辑(编译后是机器码,反编译难度高)
    AES_KEY aesKey;
    AES_set_encrypt_key((const unsigned char*)key.c_str(), 128, &aesKey);
    
    std::string ciphertext;
    // ... 加密逻辑
    
    return ciphertext;
  }
}

ArkTS 调用 Native:

typescript

收起
自动换行
深色代码主题
复制
import { nativeCrypto } from 'libcrypto.so';

// 调用 Native 加密
const ciphertext = nativeCrypto.nativeEncrypt(plaintext, key);

八、Step 6:安全加固服务

对于高安全要求的应用(金融、游戏),建议使用专业安全加固服务:

服务 能力 适用场景
代码虚拟化 把 ArkTS 转为自定义字节码 核心逻辑保护
字符串加密 加密字符串常量 防止关键词搜索
反调试加固 多层反调试检测 防动态分析
防注入 检测恶意代码注入 防二次打包
完整性保护 运行时校验代码完整性 防篡改

⚠️ 注意:安全加固服务通常收费,需要根据应用的安全等级选择。

九、安全加固检查清单

检查项 状态
代码混淆已开启 ☐
签名校验已集成 ☐
防调试已启用(Release) ☐
关键文件完整性校验 ☐
敏感逻辑下沉 Native ☐
密钥不硬编码 ☐
网络请求 HTTPS ☐
敏感数据加密存储 ☐
安全加固服务已接入 ☐

十、常见踩坑点

坑1:混淆后没有充分测试

开启混淆后,反射、JSON 序列化失败,应用崩溃。

✅ 解法:混淆后完整回归测试,特别是反射和序列化场景。

坑2:签名校验只在启动时做

攻击者绕过启动校验,直接进入功能。

✅ 解法:关键操作前再次校验(如支付、解锁付费功能)。

坑3:防调试误伤开发

开发阶段开着防调试,调试器一附加就退出。

✅ 解法:只在 Release 版本启用防调试。

坑4:密钥硬编码在代码里

反编译后密钥直接泄露。

✅ 解法:密钥从服务端下发或存 Asset Store Kit。

坑5:只依赖混淆

混淆只是“让代码难读”,不是“让代码不可读”。

✅ 解法:多层防护——混淆 + 签名校验 + 防调试 + 完整性校验。

十一、结语

应用安全加固不是“一次性工作”,而是多层防护的持续工程。

从代码混淆 → 签名校验 → 防调试 → 完整性校验 → Native 下沉 → 安全加固服务,这套方案覆盖了应用面临的主要威胁。核心原则:混淆是基础、签名校验防重打包、防调试阻止分析、关键逻辑下沉 Native。

记住三个核心原则:

  1. 混淆是基础——但不够,需要多层防护

  2. 签名校验防重打包——启动时 + 关键操作时

  3. 密钥不硬编码——从服务端或 Asset Store 获取

点赞
1
收藏
回复
1
分享
举报
浏览14 发布于11小时前天津
全部评论
最多点赞
最新发布
最早发布
听说Flutter是在裸奔,是真的吗?
2楼回复于11小时前 来自北京
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
一、引言:应用被"破解",损失的不只是钱
二、先搞清楚:应用面临的五大威胁
三、Step 1:代码混淆——让反编译"看不懂"
四、Step 2:签名校验——防止重打包
五、Step 3:防调试——阻止动态分析
六、Step 4:完整性校验——防止代码篡改
七、Step 5:敏感逻辑下沉到 Native 层
八、Step 6:安全加固服务
九、安全加固检查清单
十、常见踩坑点
十一、结语
了解社区公约,与您携手共创和谐专业的开发者社区。