android ssl pinning bypass Download - android ssl pinning bypass Quellcode Download

android ssl pinning bypass

Andere Kategorien

1.0.0

Herunterladen

Android-SSL-Pinning-Bypass

Ein Python -Skript (zuvor bash ), das Android APK (oder AAB, XAPK) für die HTTPS -Verkehrsinspektion vorbereitet.

Haftungsausschluss

Dieses Skript ist keine "Silberkugel" und auch nach der Verwendung können Sie den HTTPS -Verkehr auf Android möglicherweise nicht erfassen oder entschlüsseln. Erfahren Sie aus dem Abschnitt Tipps Tipp 2.
Das Skript wird bei Migration nach Python noch nicht vollständig getestet. Dieser Punkt wird entfernt, sobald das Skript getestet wird.

Merkmale

Das Skript ermöglicht es, SSL auf Android> = 7 durch den Wiederaufbau der APK -Datei und das Vertrauen des Benutzeranmeldeinformationsspeichers zu umgehen. Nach der Verarbeitung ist die Ausgabe -APK -Datei für die HTTPS -Verkehrsprüfung bereit.

Wenn eine AAB -Datei das Skript zur Verfügung stellt, erstellt sie eine universelle APK und verarbeitet sie. Wenn eine XAPK -Datei dem Skript bereitgestellt hat, entlarvt es und verarbeitet jede APK -Datei.

Kompatibilität

Funktioniert auf MacOS, Linux und Windows.

[Muss getestet werden] Die Leistung unter den Fenstern wird wahrscheinlich einige Male (~ 3,5) niedriger sein als in macOS / Linux ( apktool dauert länger, um die APK zu dekodieren).

Wie funktioniert das Skript?

Es:

Überprüfen Sie zunächst, ob alle erforderlichen Tools verfügbar sind, und lädt es herunter, wenn dies nicht der Fall ist (außer java ).
dekodiert die AAB -Datei über bundletool (falls die AAB -Datei angegeben) zu APK -Datei oder entlassung die XAPK -Datei (im Fall von XAPK).
decodiert die APK -Datei mit apktool ;
Patches (oder erstellt, wenn die Datei fehlt) der App network_security_config.xml der App, um die Benutzeranmeldeinformation wie vertrauenswürdig zu machen.
codiert die neue APK -Datei über apktool ;
Signiert die Patched APK-Datei (n) über uber-apk-signer .

Optional das Skript erlaubt:

Verwenden Sie den spezifischen Keystore zum Signieren der Ausgabe -APK (standardmäßig wird der Debug -Keystore verwendet).
Installieren Sie die Patched APK -Datei (n) direkt über adb am Gerät.
Entpackte Inhalt der Eingabe -APK -Datei (en) erhalten;
Entfernen Sie die Quelldatei (APK / AAB / XAPK) nach dem Patch;
Pausieren Sie die Skriptausführung vor der Codierung der Ausgabe -APK -Datei (n), falls Sie Aktionen manuell ausführen müssen.

Root -Zugriff ist nicht erforderlich.

Anforderungen

Installieren Sie die Tools aus der folgenden Liste:

Python> = 3,9
Pip
Java> = 8
ADB - Kann mit Android Studio (empfohlen) oder dem Standalone -Paket der SDK -Plattform -Tools installiert werden (vergessen Sie nicht, den Pfad zur adb -Variablen der Pfadumgebung hinzuzufügen)

Die folgenden Tools werden vom Skript heruntergeladen, falls es fehlt:

Bundletool
Apktool
Uber-APK-Unterzeichner

Verwendung

Voraussetzungen:

Klonen Sie das Repository
Führen Sie die Befehl pip3 install -r requirements.txt aus, um die erforderlichen Python -Module zu installieren

Das Skript kann wie gestartet werden wie

 python3 /path/to/the/script/apk-rebuild.py

Führen Sie python3 apk-rebuild.py -h (oder python3 apk-rebuild.py --help ) aus, um das Verwendungshandbuch zu drucken.

 usage: apk-rebuild.py [-h] [-v] [-i] [--pause] [-p] [-r] [-o OUTPUT] [--no-src] [--only-main-classes] [--ks KS]
                      [--ks-pass KS_PASS] [--ks-alias KS_ALIAS] [--ks-alias-pass KS_ALIAS_PASS]
                      file

The script allows to bypass SSL pinning on Android >= 7 via rebuilding the APK file 
and making the user credential storage trusted. After processing the output APK file 
is ready for HTTPS traffic inspection.

positional arguments:
  file                  path to .apk, .aab or .xapk file for rebuilding

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -i, --install         install the rebuilded .apk file(s) via adb
  --pause               pause the script execution before the building the output .apk
  -p, --preserve        preserve the unpacked content of the .apk file(s)
  -r, --remove          remove the source file (.apk, .aab or .xapk) after the rebuilding
  -o OUTPUT, --output OUTPUT
                        output .apk file name or output directory path (for .xapk source file)
  --no-src              use --no-src option when decompiling via apktool
  --only-main-classes   use --only-main-classes option when decompiling via apktool
  --ks KS               use custom .keystore file for .aab decoding and .apk signing
  --ks-pass KS_PASS     password of the custom keystore
  --ks-alias KS_ALIAS   key (alias) in the custom keystore
  --ks-alias-pass KS_ALIAS_PASS
                        password for key (alias) in the custom keystore

Verwenden Sie zum Wiederaufbau der APK -Datei das Skript mit Argument (en). Die Beispiele finden Sie unten:

Patch die AAB -Datei und löschen Sie den ausgepackten APK -Dateiinhalt nicht
```
 python3 apk-rebuild.py input.aab --preserve
```
Patch die APK-Datei, entfernen Sie die Quell-APK
```
 python3 apk-rebuild.py input.apk -r -i
```

Der Pfad zur Quelldatei muss als erstes Argument angegeben werden.

Tipps

Um den HTTPS-Datenverkehr aus Entwicklungsbauten einfach zu erfassen, können Sie Ihren Entwickler bitten, das Element <debug-overrides> zum the network_security_config.xml hinzuzufügen (und das android:networkSecurityConfig Eigenschaft zum application im AndroidManifest.xml natürlich): https://developer.android.com/training/articles/security-config#debug-overrides.
Lernen Sie https://blog.nviso.eu/2020/11/19/proxying-android-app-traffic-common- isues-checklist/, es gibt viele nützliche Informationen zur Verkehrsaufnahme auf Android.