android ssl pinning bypass Download - android ssl pinning bypass Code Source Download

android ssl pinning bypass

Autres catégories

1.0.0

Télécharger

Android-SSL-Pinning-Bypass

Un script Python (précédemment bash ) qui prépare Android APK (ou AAB, XAPK) pour l'inspection du trafic HTTPS.

Clause de non-responsabilité

Ce script n'est pas une "solution miracle" et même après l'avoir utilisée, vous pourriez ne pas être en mesure de capturer ou de décrypter le trafic HTTPS sur Android. Apprenez l'astuce n ° 2 de la section Tips.
Le script n'est pas encore complètement testé lors de la migration vers Python. Ce point sera supprimé une fois que le script sera testé.

Caractéristiques

Le script permet de contourner SSL PINing sur Android> = 7 via la reconstruction du fichier APK et la confiance du stockage des informations d'identification de l'utilisateur. Après le traitement, le fichier APK de sortie est prêt pour l'inspection du trafic HTTPS.

Si un fichier AAB a fourni le script crée un APK universel et le traite. Si un fichier XAPK a fourni le script le décompressez et traite chaque fichier APK.

Compatibilité

Fonctionne sur macOS, Linux et Windows.

[Besoin de tests] Les performances sur les fenêtres seront probablement à quelques reprises (~ 3,5) inférieures à celles de MacOS / Linux ( apktool prend plus de temps pour décoder l'APK).

Comment fonctionne le script?

Il:

Tout d'abord vérifie si tous les outils nécessaires sont disponibles et le télécharge si ce n'est pas le cas (sauf java );
Décode le fichier AAB vers le fichier APK via bundletool (FIF FILE AAB fourni) ou décompressez le fichier XAPK (dans le cas de XAPK);
Décode le fichier APK à l'aide apktool ;
patchs (ou crée si le fichier est manquant) le network_security_config.xml
code le nouveau fichier APK via apktool ;
Signe le (s) fichier (s) APK corrigé via uber-apk-signer .

Éventuellement, le script autorise:

Utilisez le stade de clé spécifique pour signer l'APK de sortie (par défaut, le stage de touche de débogage est utilisé);
Installez directement le (s) fichier APK correctif sur l'appareil via adb ;
conserver le contenu déballé du (s) fichier (s) APK d'entrée;
Supprimer le fichier source (APK / AAB / XAPK) après le correctif;
Pause l'exécution du script avant le codage du (s) fichier (s) APK de sortie au cas où vous auriez besoin de faire des actions manuellement.

L'accès racine n'est pas requis.

Exigences

Installez les outils de la liste ci-dessous:

Python> = 3,9
pépin
java> = 8
ADB - peut être installé avec Android Studio (recommandé) ou un package autonome des outils de plate-forme SDK (n'oubliez pas d'ajouter le chemin à la adb à la variable d'environnement de chemin)

Les outils ci-dessous seront téléchargés par le script au cas où il manquera:

bundletool
apktool
signaleur uber-apk

Usage

Conditions préalables:

Cloner le référentiel
Exécuter la commande pip3 install -r requirements.txt pour installer les modules Python requis

Le script peut être lancé comme

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

Exécutez python3 apk-rebuild.py -h (ou python3 apk-rebuild.py --help ) pour imprimer le manuel d'utilisation.

 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

Pour reconstruire le fichier APK, utiliser le script avec des arguments. Les exemples sont ci-dessous:

patcher le fichier AAB et ne pas supprimer le contenu du fichier APK déballé
```
 python3 apk-rebuild.py input.aab --preserve
```
Papet le fichier APK, supprimez le fichier APK source après le correctif et installez le fichier APK correctif sur l'Android-Device
```
 python3 apk-rebuild.py input.apk -r -i
```

Le chemin d'accès vers le fichier source doit être spécifié comme premier argument.

Conseils

Pour la capture facile de capturer le trafic HTTPS à partir des builds de développement, vous pouvez demander à votre développeur d'ajouter l'élément <debug-overrides> à the network_security_config.xml (et ajouter la propriété android:networkSecurityConfig à l'élément application dans AndroidManifest.xml bien sûr): https://developer.android.com/training/articles/security-config#debug-overrides.
Apprenez https://blog.nviso.eu/2020/11/19/proxying-android-app-straffic-common-issues-checklist/, il y a beaucoup d'informations utiles sur la capture du trafic sur Android.