Hikari-LLVM15

A fork of HikariObfuscator [WIP]

English | 中文

原项目链接

https://github.com/HikariObfuscator/Hikari

构建

https://llvm.org/docs/GettingStarted.html#getting-the-source-code-and-building-llvm

如果你使用MacOS, 可直接从actions中下载

Swift混淆支持

由于Xcode的LLVM相比原版LLVM有大量闭源改动，Hanabi在Xcode 15起已无法编译Swift。

使用Swift Toolchain。

需要注意的是添加混淆参数的位置是在Swift Compiler - Other Flags中的Other Swift Flags，并且是在前面加-Xllvm，而不是-mllvm。 关闭优化的地方在Swift Compiler - Code Generation中的Optimization Level，设置为 No Optimization [-Onone] 。由于swift语言的特性，如果混淆swift不关闭优化，字符串混淆可能会失效

每次修改Other Swift Flags后编译前需要先Shift+Command+K(Clean Build Folder)，因为Swift并不会像OC一样检测到项目cflag的修改就会重新编译

PreCompiled IR

PreCompiled IR是指自定义的LLVM Bitcode文件，可以通过在存在回调函数的源文件的编译命令(C Flags)中加上-emit-llvm生成，然后放到指定位置即可

一些修改

AntiClassDump (该功能存在设计缺陷，开启后程序可能崩溃，不建议使用)

arm64e支持

BogusControlFlow

跳过包含MustTailCall的基本块以避免错误

跳过presplit coroutine和包含CoroBeginInst的基本块以支持swift

修复了消失的不透明谓词

Flattening

跳过presplit coroutine以支持swift

间接修改状态变量，可以使部分脚本无法正常反混淆（如d810）

FunctionCallObfuscate

将只会在启用混淆的地方混淆Objc Call，而不是整个模块

FunctionWrapper

跳过一些目前无法处理的函数以支持swift

支持混淆包含byval的函数（可能？）

SplitBasicBlocks

修复了可能的堆污染错误

StringEncryption

支持加密在结构体和数组中的字符串

支持加密Rust字符串

arm64e支持

Substitution

添加更多pattern

IndirectBranch

运行后会重排列基本块的顺序

默认启用基于栈的跳转，可以使静态分析更困难

混淆选项

这里只会介绍修改的部分，原项目存在的功能请自行前往https://github.com/HikariObfuscator/Hikari/wiki/查看

AntiClassDump

-acd-rename-methodimp

重命名在IDA中显示的方法函数名称(修改为ACDMethodIMP)，不是修改方法名。默认关闭

AntiHooking (不建议使用)

整体开启这个功能会使生成的二进制文件大小急剧膨胀

支持检测Objective-C运行时Hook。如果检测到就会调用AHCallBack函数(从PreCompiled IR获取)，如果不存在AHCallBack，就会退出程序。

InlineHook检测目前只支持arm64，在函数中插入代码检测当前函数是否被Hook，如果检测到就会调用AHCallBack函数(从PreCompiled IR获取)，如果不存在AHCallBack，就会退出程序。

-enable-antihook

启用AntiHooking。默认关闭

-ah_inline

检测当前函数是否被inline hook。默认开启

-ah_objcruntime

检测当前函数是否被runtime hook。默认开启

-ah_antirebind

使生成的文件无法被fishhook重绑定符号。默认关闭

-adhexrirpath

AntiHooking PreCompiled IR文件的路径

AntiDebugging

自动在函数中进行反调试，如果有InitADB和ADBCallBack函数(从PreCompiled IR获取)，就会调用ADBInit函数，如果不存在InitADB和ADBCallBack函数并且是Apple ARM64平台，就会自动在void返回类型的函数中插入内联汇编反调试，否则不做处理。

-enable-adb

启用AntiDebugging。默认关闭

-adb_prob

每个函数被添加反调试的概率。默认为40

-adbextirpath

AntiDebugging PreCompiled IR文件的路径

StringEncryption

-strcry_prob

每个字符串中每个byte被加密的概率。默认为100。

BogusControlFlow

-bcf_onlyjunkasm

在虚假块中只插入花指令

-bcf_junkasm

在虚假块中插入花指令，干扰IDA对函数的识别。默认关闭

-bcf_junkasm_minnum

在虚假块中花指令的最小数量。默认为2

-bcf_junkasm_maxnum

在虚假块中花指令的最大数量。默认为4

-bcf_createfunc

使用函数封装不透明谓词。默认关闭

ConstantEncryption

修改自https://iosre.com/t/llvm-llvm/11132

对能够处理的指令中使用的常量数字(ConstantInt)进行异或加密

-enable-constenc

启用ConstantEncryption。默认关闭

-constenc_times

ConstantEncryption在每个函数混淆的次数。默认为1

-constenc_togv

将常量数字(ConstantInt)替换为全局变量，以及把类型为整数的二进制运算符(BinaryOperator)的运算结果替换为全局变量。默认关闭

-constenc_togv_prob

每个常量数字(ConstantInt)被替换为全局变量的概率。默认为50

-constenc_subxor

替换ConstantEncryption的异或运算，使其变得更加复杂

-constenc_subxor_prob

每个异或运算被替换为替换为相等的更加复杂运算的概率。默认为40

IndirectBranch

-indibran-use-stack

将跳转表的地址在Entry Block加载到栈中，每个基本块再从栈中读取。默认开启

-indibran-enc-jump-target

加密跳转表和索引。默认关闭

Functions Annotations

支持的选项

C++/C 函数

例如你有多个函数，你只想在函数int foo() 开启indibran-use-stack

int foo() __attribute((__annotate__(("indibran_use_stack"))));
int foo() {
   return 2;
}

例如你想在函数int foo() 关闭indibran-use-stack

int foo() __attribute((__annotate__(("noindibran_use_stack"))));
int foo() {
   return 2;
}

例如对于函数int foo()，你想将bcf_prob设置为100

int foo() __attribute((__annotate__(("bcf_prob=100"))));
int foo() {
   return 2;
}

ObjC 方法

例如你想像C/C++例子中那样开启indibran-use-stack :

#ifdef __cplusplus
extern "C" {
#endif
void hikari_indibran_use_stack(void);
#ifdef __cplusplus
}
#endif

@implementation foo2 : NSObject
+ (void)foo {
  hikari_indibran_use_stack();
  NSLog(@"FOOOO2");
}
@end

例如对于方法+ (void)foo，你想将bcf_prob设置为100：

#ifdef __cplusplus
extern "C" {
#endif
void hikari_bcf_prob(uint32_t);
#ifdef __cplusplus
}
#endif

@implementation foo2 : NSObject
+ (void)foo {
  hikari_bcf_prob(100);
  NSLog(@"FOOOO2");
}
@end

选项

• ah_inline 
• ah_objcruntime
• ah_antirebind  
• bcf_prob
• bcf_loop
• bcf_cond_compl   
• bcf_onlyjunkasm
• bcf_junkasm
• bcf_junkasm_maxnum
• bcf_junkasm_minnum
• bcf_createfunc
• constenc_subxor
• constenc_togv
• constenc_togv_prob
• constenc_subxor_prob
• constenc_times
• fw_prob
• indibran_use_stack
• indibran_enc_jump_target
• split_num
• strcry_prob
• sub_loop
• sub_prob

新支持的标志

• adb Anti Debugging
• antihook Anti Hooking
• constenc Constant Encryption

许可

https://github.com/HikariObfuscator/Hikari#license