https://github.com/hacker1024/mitmproxy_httptoolkit_android

A mitmproxy addon that allows use of the HTTP Toolkit Android app.
https://github.com/hacker1024/mitmproxy_httptoolkit_android

http-toolkit mitmproxy mitmproxy-addons

Last synced: 6 days ago
JSON representation

A mitmproxy addon that allows use of the HTTP Toolkit Android app.

• Host: GitHub
• URL: https://github.com/hacker1024/mitmproxy_httptoolkit_android
• Owner: hacker1024
• License: agpl-3.0
• Created: 2023-06-25T15:23:50.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-06-25T15:26:13.000Z (over 1 year ago)
• Last Synced: 2024-05-01T16:59:45.317Z (7 months ago)
• Topics: http-toolkit, mitmproxy, mitmproxy-addons
• Language: Python
• Homepage:
• Size: 17.6 KB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# HTTP Toolkit Android integration for mitmproxy

A [mitmproxy] addon that allows use of the [HTTP Toolkit] Android app.

## Rationale

[HTTP Toolkit] is not as featureful as [mitmproxy], but it has a very polished

Android connection experience. This addon allows all of HTTP Toolkit's Android

features (namely, guided certificate installation and per-app tunneling) to be

used with mitmproxy.

## Usage

### Installation

1. Download the [HTTP Toolkit Android app](https://play.google.com/store/apps/details?id=tech.httptoolkit.android.v1)

2. Clone this repository, or download the [addon script](./src/mitmproxy_httptoolkit_android.py)

### Execution

1. Launch `mitmproxy` (or `mitmdump`, `mitmweb`, etc.):  

   `mitmproxy -s src/mitmproxy_httptoolkit_android.py`

2. Follow the instructions in the log (type `E` in the TUI) to connect

#### Note: Multiple modes

If multiple mitmproxy modes are in use, the app will be able to connect to any

`listen_host`. It will only use the `listen_port` of the first mode for all of

them, however, due to limitations in its API.

### Installing the system certificate (rooted devices)

This feature is not yet implemented, but can be done manually in a number of

ways.

#### Method 1: Magisk

Install the CA certificate as instructed by the app. Then, install

[this Magisk module](https://www.androidacy.com/magisk-modules-repository/#movecerts)

and reboot.

#### Method 2: Generic

Manually perform the [actions the HTTP Toolkit server does](https://github.com/httptoolkit/httptoolkit-server/blob/b7379efcde361e0ab55383eac73ee4cbd4379bcd/src/interceptors/android/adb-commands.ts#L273).

[mitmproxy]: https://mitmproxy.org

[HTTP Toolkit]: https://httptoolkit.com/