diff --git a/README.md b/README.md new file mode 100644 index 0000000..a373bfb --- /dev/null +++ b/README.md @@ -0,0 +1,46 @@ +# EZHZ Android + +This is an android app for rooted device to help you to perform penetration testing on the applications installed on your device. + +## Features + +- [x] Forward network traffic of any application to interceptor proxy (inspired by [proxydroid](https://github.com/madeye/proxydroid)) +- [x] Manage and install any version of Frida server on your device (inspired by [FridaLoader](https://github.com/dineshshetty/FridaLoader)) +- [ ] Inspect and modify network encrypted or unencrypted shared preference data of any application + +## Installation + +You can download the latest release APK from [here](https://github.com/bongtrop/ezhz-android/releases). In order to install it, just install by `adb` command as follows: + +```bash +adb install -r ezhz-android-vX.X.apk # replace X.X with the version number +``` + +## Build + +You can build the APK by yourself by cloning this repository and build it with Android Studio. + +## Usage + +### Intercept network traffic + +1. Start the app and grant root access +2. Go to `Proxy` menu +3. Set the proxy address, port, proxy type, and dns of the interceptor proxy in `Proxy Settings` section. +4. Set the applications on `Apps Proxy` that you want to intercept its network traffic or check `Global Proxy` for all applications in `Target Settings` section. +5. Start the proxy by clicking on `Proxy Switch` switch. + +### Install Frida server + +1. Start the app and grant root access +2. Go to `Frida` menu +3. Select the Frida server version that you want to install +4. Click on `Install` button +5. Wait until the installation is finished +6. Start the Frida server by clicking on `Execute` button + +## Credits + +- Thank you for amazing ideas from [proxydroid](https://github.com/madeye/proxydroid) that using `iptables` and transparent proxy to forward network traffic to any interceptor tool. I upgrade the functionality of `proxydroid` to support QUIC protocol by changing the proxy client from `redsocks` to `gost v3` and relay UDP traffic to it. Additionally, I have a problem about finding target applications in application selector activity, so I have implemented new application selector by adding search functionality to it. +- Thank you for nice ideas from [FridaLoader](https://github.com/dineshshetty/FridaLoader) that it will download the latest version of `frida-server` from Github and run it by root user. I upgrade the functionality of `FridaLoader` to support multiple versions of `frida-server` and make it to be foreground service in order to be easier to manage. + diff --git a/app/.gitignore b/app/.gitignore index 42afabf..956c004 100644 --- a/app/.gitignore +++ b/app/.gitignore @@ -1 +1,2 @@ -/build \ No newline at end of file +/build +/release \ No newline at end of file diff --git a/app/src/main/ic_launcher-playstore.png b/app/src/main/ic_launcher-playstore.png index fc85de6..655c314 100644 Binary files a/app/src/main/ic_launcher-playstore.png and b/app/src/main/ic_launcher-playstore.png differ diff --git a/app/src/main/res/mipmap-hdpi/ic_launcher.webp b/app/src/main/res/mipmap-hdpi/ic_launcher.webp index 28f7b03..7a16c13 100644 Binary files a/app/src/main/res/mipmap-hdpi/ic_launcher.webp and b/app/src/main/res/mipmap-hdpi/ic_launcher.webp differ diff --git a/app/src/main/res/mipmap-hdpi/ic_launcher_foreground.webp b/app/src/main/res/mipmap-hdpi/ic_launcher_foreground.webp index 0084c30..058fc26 100644 Binary files a/app/src/main/res/mipmap-hdpi/ic_launcher_foreground.webp and b/app/src/main/res/mipmap-hdpi/ic_launcher_foreground.webp differ diff --git a/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp b/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp index 4aed2c4..3e77a74 100644 Binary files a/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp and b/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp differ diff --git a/app/src/main/res/mipmap-mdpi/ic_launcher.webp b/app/src/main/res/mipmap-mdpi/ic_launcher.webp index e1b941d..ee8aa86 100644 Binary files a/app/src/main/res/mipmap-mdpi/ic_launcher.webp and b/app/src/main/res/mipmap-mdpi/ic_launcher.webp differ diff --git a/app/src/main/res/mipmap-mdpi/ic_launcher_foreground.webp b/app/src/main/res/mipmap-mdpi/ic_launcher_foreground.webp index 85d81e5..212f9d5 100644 Binary files a/app/src/main/res/mipmap-mdpi/ic_launcher_foreground.webp and b/app/src/main/res/mipmap-mdpi/ic_launcher_foreground.webp differ diff --git a/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp b/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp index 05c96f1..901ed38 100644 Binary files a/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp and b/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp differ diff --git a/app/src/main/res/mipmap-xhdpi/ic_launcher.webp b/app/src/main/res/mipmap-xhdpi/ic_launcher.webp index cecfadc..4b9449c 100644 Binary files a/app/src/main/res/mipmap-xhdpi/ic_launcher.webp and b/app/src/main/res/mipmap-xhdpi/ic_launcher.webp differ diff --git a/app/src/main/res/mipmap-xhdpi/ic_launcher_foreground.webp b/app/src/main/res/mipmap-xhdpi/ic_launcher_foreground.webp index f44c059..a18be61 100644 Binary files a/app/src/main/res/mipmap-xhdpi/ic_launcher_foreground.webp and b/app/src/main/res/mipmap-xhdpi/ic_launcher_foreground.webp differ diff --git a/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp b/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp index 6a0d82b..31a97ab 100644 Binary files a/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp and b/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp differ diff --git a/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp b/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp index 011af01..696daa2 100644 Binary files a/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp and b/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp differ diff --git a/app/src/main/res/mipmap-xxhdpi/ic_launcher_foreground.webp b/app/src/main/res/mipmap-xxhdpi/ic_launcher_foreground.webp index 130fcd6..39700cb 100644 Binary files a/app/src/main/res/mipmap-xxhdpi/ic_launcher_foreground.webp and b/app/src/main/res/mipmap-xxhdpi/ic_launcher_foreground.webp differ diff --git a/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp b/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp index bb9464c..2dcd085 100644 Binary files a/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp and b/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp differ diff --git a/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp b/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp index 20a0e4c..f6904a7 100644 Binary files a/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp and b/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp differ diff --git a/app/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.webp b/app/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.webp index df54d49..c096864 100644 Binary files a/app/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.webp and b/app/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.webp differ diff --git a/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp b/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp index 2bf825c..1e56fda 100644 Binary files a/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp and b/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp differ diff --git a/app/src/main/res/values/ic_launcher_background.xml b/app/src/main/res/values/ic_launcher_background.xml index 1258cba..97190f8 100644 --- a/app/src/main/res/values/ic_launcher_background.xml +++ b/app/src/main/res/values/ic_launcher_background.xml @@ -1,4 +1,4 @@ - #427BD2 + #000732 \ No newline at end of file