Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/HexNio/ssl_pinning_remover
An Android SSL Pinning Remover tool for Security research and Bug Bounty
https://github.com/HexNio/ssl_pinning_remover
android bug-bounty bugbounty bugbounty-tool help-wanted python3 security-automation security-tools ssl-pinning
Last synced: 3 months ago
JSON representation
An Android SSL Pinning Remover tool for Security research and Bug Bounty
- Host: GitHub
- URL: https://github.com/HexNio/ssl_pinning_remover
- Owner: HexNio
- License: gpl-3.0
- Created: 2020-05-24T18:24:31.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-06-01T12:41:09.000Z (over 1 year ago)
- Last Synced: 2024-07-08T10:41:47.067Z (4 months ago)
- Topics: android, bug-bounty, bugbounty, bugbounty-tool, help-wanted, python3, security-automation, security-tools, ssl-pinning
- Language: Python
- Homepage:
- Size: 149 KB
- Stars: 40
- Watchers: 3
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - HexNio/ssl_pinning_remover - An Android SSL Pinning Remover tool for Security research and Bug Bounty (Python)
README
[](https://pypi.org/project/ssl-pinning-remover/)
[](https://www.python.org/)
## Brief history
All it started with two simple questions:
**How we can sniff ssl traffic in order to understand which services are invoked?**
and
**Is there a method to automate all the process from decompile a .apk to upload on your device?**
For the first questions i found a lot of guides that explain the procedure of modify the *AndroidManifest.xml* and the *network_security_config.xml* but there is not a single formula, there are different factors to understand in order to do it correctly.
For the second question is: Yes... but.
i found different types of project the on Github but they aren't completely automated in all those phases so here we are.
I read a lot of guides most of those requires to have a rooted device so i tried to create something to sniff the encrypted traffic unrooted devices in order to help all security researchers, this software is **UNSTABLE** for now, a lot of "unlocked" apps maybe will not work with this mod.
## How it works?
ssl_pinning_remover has all the following phases:
1. Unpack the .apk app with apktool
2. Check if the *AndroidManifest.xml* has the correct attributes and if *network_security_config.xml* exists with the correct tags
3. Repack the modified files in a new apk packet
4. Sign the new apk with a self signed certificate
5. Align the certified apk
6. it upload the new jar in the connected android device (Optional)
## Prerequisites
To use this script you need to install all those softwares in your environment:
* [Java JDK 8 or above](https://www.oracle.com/it/java/technologies/javase-downloads.html)
* [apktool](https://ibotpeaches.github.io/Apktool/)
* [Android Debug Bridge (adb)](https://developer.android.com/studio/releases/platform-tools)
On your device:
* [Enable USB Debugging](https://www.phonearena.com/news/How-to-enable-USB-debugging-on-Android_id53909)
## How to install
```
$ pip install -r requirements.txt
$ pip install ssl-pinning-remover
```
## How to use
| Parameter | Description | Mandatory |
| ------------- | ------------- |------------- |
| `-i --input` | Used to specify the input .apk path | Yes |
| `-v --verbose` | Used to increase the stdout verbosity | No |
| `-u --upload` | Used to specify if you want upload the "unlocked" apk in the connected device or not | No |
### Example
Elaborate without uploading .apk:
`ssl_pinning_remover -i test.apk -v`
Elaborate and upload .apk:
`ssl_pinning_remover -i test.apk -v -u`
The output path is the path where you launch the script.
The modified apk will have the same name of the original apk but before the extension will be added ".unlocked.apk"
## ToDo List
- [ ] frida-gadget implemetation
- [ ] Continue implementing studying difference configuration cases
- [ ] Make the software working for most of the applications in the play store
- [ ] Add more options
- [ ] Code review
## Disclaimer
This project is for educational and research purposes only. Any actions and/or activities related to the material contained on this GitHub Repository is solely your responsibility. The misuse of the information in this GitHub Repository can result in criminal charges brought against the persons in question. The author will not be held responsible in the event any criminal charges be brought against any individuals misusing the information in this GitHub Repository to break the law.