Skip to content

Commit

Permalink
Change logo and add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Pongsakorn Sommalai committed Aug 3, 2023
1 parent dc910cb commit 5957ac6
Show file tree
Hide file tree
Showing 19 changed files with 49 additions and 2 deletions.
46 changes: 46 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -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.

3 changes: 2 additions & 1 deletion app/.gitignore
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
/build
/build
/release
Binary file modified app/src/main/ic_launcher-playstore.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified app/src/main/res/mipmap-hdpi/ic_launcher.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-hdpi/ic_launcher_foreground.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-hdpi/ic_launcher_round.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-mdpi/ic_launcher.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-mdpi/ic_launcher_foreground.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-mdpi/ic_launcher_round.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xhdpi/ic_launcher.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xhdpi/ic_launcher_foreground.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xxhdpi/ic_launcher.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xxhdpi/ic_launcher_foreground.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xxxhdpi/ic_launcher_foreground.webp
Binary file not shown.
Binary file modified app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp
Binary file not shown.
2 changes: 1 addition & 1 deletion app/src/main/res/values/ic_launcher_background.xml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<color name="ic_launcher_background">#427BD2</color>
<color name="ic_launcher_background">#000732</color>
</resources>

0 comments on commit 5957ac6

Please sign in to comment.