You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: overrides/frida/README.md
+18-2Lines changed: 18 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,6 +12,8 @@ The scripts can automatically handle:
12
12
* Injecting a given CA certificate into the system trust stores so they're trusted in connections by default.
13
13
* Patching many (all?) known certificate pinning and certificate transparency tools, to allow interception by your CA certificate even when this is actively blocked.
14
14
* On Android, as a fallback: auto-detection of remaining pinning failures, to attempt auto-patching of obfuscated certificate pinning (in fully obfuscated apps, the first request may fail, but this will trigger additional patching so that all subsequent requests work correctly).
15
+
* Disabling many common root & jailbreak detections.
16
+
* Blocking most HTTP/3 connections (all UDP to port 443), which may be inconvenient to intercept, ensuring apps fall back to HTTP/2 or HTTP/1.
15
17
16
18
## Android Getting Started Guide
17
19
@@ -38,6 +40,7 @@ The scripts can automatically handle:
7. Explore, examine & modify all the traffic you're interested in! If you have any problems, please [open an issue](https://github.com/httptoolkit/frida-interception-and-unpinning/issues/new) and help make these scripts even better.
@@ -61,6 +64,7 @@ The scripts can automatically handle:
61
64
frida -U \
62
65
-l ./config.js \
63
66
-l ./ios/ios-connect-hook.js \
67
+
-l ./ios/ios-disable-detection.js \
64
68
-l ./native-tls-hook.js \
65
69
-l ./native-connect-hook.js \
66
70
-f $APP_ID
@@ -90,14 +94,15 @@ Each script includes detailed documentation on what it does and how it works in
90
94
*`PROXY_HOST` - the IP address (IPv4) of the proxy server to use (not required if you're only unpinning)
91
95
* `PROXY_PORT` - the port of the proxy server to use (not required if you're only unpinning)
92
96
*`DEBUG_MODE` - defaults to `false`, but switching this to `true` will enable lots of extra output that can be useful for debugging and reverse engineering any issues.
97
+
*`BLOCK_HTTP3` - defaults to `true`, which blocks HTTP/3 by dropping all UDP connections to port 443.
93
98
94
99
This should be listed on the command line before any other scripts.
95
100
96
101
*`native-connect-hook.js`
97
102
98
103
Captures all network traffic directly, routing all connections to the configured proxy host & port.
99
104
100
-
This is a low-level hook that applies to _all_ network connections. This ensures that all connections are forcibly redirected to the target proxy server, even those which ignore proxy settings or make other raw socket connections.
105
+
This is a low-level hook that applies to _all_ network connections. This ensures that all connections are forcibly redirected to the target proxy server, even those which ignore proxy settings or make other raw socket connections, and also blocks HTTP/3 connections if enabled.
101
106
102
107
This hook applies to libc, and works for Android, Linux, iOS, and many other related environments.
103
108
@@ -127,6 +132,14 @@ Each script includes detailed documentation on what it does and how it works in
127
132
128
133
Detects unhandled certificate validation failures, and attempts to handle unknown unrecognized cases with auto-generated fallback patches. This is more experimental and could be slightly unpredictable, but is very helpful forobfuscated cases, andin general will either fix pinning issues (after one initial failure) or will at least highlight code forfurther reverse engineeringin the Frida log output. This script shares some logic with `android-certificate-unpinning.js`, and cannot be used standalone - if you want to use this script, you'll need to include the non-fallback unpinning script too.
129
134
135
+
* `android-disable-root-detection.js`
136
+
137
+
Disables common root detection checks across native and Java layers to prevent detection of rooted Android devices.
138
+
139
+
This script intercepts file system access, shell commands, and package lookups for known root indicators (like `su`, Magisk, and related apps), and fakes key system properties (`ro.secure`, `ro.debuggable`, etc.) to simulate a production environment.
140
+
141
+
It blocks suspicious behavior like file existence checks and shell command execution, helping evade detection in apps using both standard and advanced root checks.
142
+
130
143
* `ios/`
131
144
132
145
* `ios-connect-hook.js`
@@ -135,13 +148,16 @@ Each script includes detailed documentation on what it does and how it works in
135
148
136
149
This is a low-level hook that applies to _all_ network connections. This ensures that all connections are forcibly redirected to the target proxy server, even those which ignore proxy settings or make other raw socket connections.
137
150
151
+
* `ios-disable-detection.js`
152
+
153
+
Disables JailMonkey jailbreak detection.
154
+
138
155
* `utilities/test-ip-connectivity.js`
139
156
140
157
You probably don't want to use this normally as part of interception itself, but it can be very useful as part of your configuration setup.
141
158
142
159
This script allows you to configure a list of possible IP addresses and a target port, and have the process test each address, and send a message to the Frida client for the first reachable address provided. This can be useful for automated configuration processes, if you don't know which IP address is best to use to reach the proxy server (your computer) from the target device (your phone).
143
160
144
-
---
145
161
146
162
These scripts are part of [a broader HTTP Toolkit project](https://httptoolkit.com/blog/frida-mobile-interception-funding/), funded through the [NGI Zero Entrust Fund](https://nlnet.nl/entrust), established by [NLnet](https://nlnet.nl) with financial support from the European Commission's [Next Generation Internet](https://ngi.eu) program. Learn more on the [NLnet project page](https://nlnet.nl/project/F3-AppInterception#ack).
0 commit comments