kyzsuukii / zygiskfrida

Injects frida gadget using zygisk to bypass anti-tamper checks.

ZygiskFrida

Frida is a dynamic instrumentation toolkit for developers, reverse-engineers, and security researchers

Zygisk part of Magisk allows you to run code in every Android application's Process.

Introduction

ZygiskFrida is a zygisk module allowing you to inject frida gadget in Android applications in a more stealthy way.

• The gadget is not embedded into the APK itself. So APK Integrity/Signature checks will still pass.
• The process is not being ptraced like it is with frida-server. Avoiding ptrace based detection.
• Control about the injection time of the gadget.
• Allows you to load multiple arbitrary libraries into the process.

This repo also provides a Riru flavor in case you are still using riru with an older magisk version rather than zygisk.

How to use the module

General Usage

• Download the latest release from the Release Page
  If you are using riru instead of zygisk choose the riru-release. Otherwise choose the normal version.
• Transfer the ZygiskFrida zip file to your device and install it via Magisk.
• Reboot after install
• Update /data/local/tmp/re.zyg.fri/target_packages on your device with the target package names.
  Apps with matching package names will be injected with the gadget. One package name per line.
  f.e. adb shell 'su -c "echo com.example.package > /data/local/tmp/re.zyg.fri/target_packages"'
• Launch your app. It will pause at startup allowing you to attach f.e. frida -U -N com.example.package or frida -U -n Gadget

Further configuration

Start up delay

There are times that you might want to delay the injection of the gadget. Some applications might run checks at start up and delaying the injection can help avoid these.

/data/local/tmp/re.zyg.fri/target_packages accepts a start up delay in milliseconds. You can provide it separated by a comma from the package_name.

f.e.

adb shell 'su -c "echo com.example.package,20000 > /data/local/tmp/re.zyg.fri/target_packages"'

would inject the gadget after a delay of 20 seconds.

You get a 10 seconds countdown to injection in the ZygiskFrida logs adb logcat -S ZygiskFrida. This can help if you want to time the injection with app interactions.

Gadget version and config

The bundled gadget is located at /data/local/tmp/re.zyg.fri/libgadget.so.
You can follow the Gadget Docs and add additional gadget config and scripts in that location.

In case you want to use a different gadget version than the one bundled, you can simply replace the libgadget.so with your own frida gadget.

Loading arbitrary libraries

This module also allows you to load arbitrary .so libraries into the process.
This can allow you to load additional helper libraries for the gadget or enable any other use case that might need libraries loaded into the app process.

For this you can add the file /data/local/tmp/re.zyg.fri/injected_libraries.
The file should consist of file paths to libraries. The libraries are loaded in the order they are specified in the file.

Example file content that would first load libhelperexample.so and then the bundled frida-gadget:

/data/local/tmp/re.zyg.fri/libhelperexample.so
/data/local/tmp/re.zyg.fri/libgadget.so

Make sure the libraries are located somewhere accessible by the app and that file permissions are properly set.

If you want the frida gadget to start, you need to explicitly specify the bundled frida-gadget at /data/local/tmp/re.zyg.fri/libgadget.so.
You can also choose to specify your own gadget this way or omit the gadget altogether.

How to build

• Checkout the project
• Run ./gradlew :module:assembleRelease
• The build magisk module should then be in the out directory.

You can also build and install the module to your device directly with ./gradlew :module:flashAndRebootZygiskRelease

Caveats

• For emulators this will start the gadget in native realm. This means that you will be able to hook Java but not native functions.

Credits

• Inspired by https://github.com/Perfare/Zygisk-Il2CppDumper
• https://github.com/hexhacking/xDL