Binder Trace

Binder Trace est un outil permettant d'intercepter et d'analyser les messages Binder d'Android. Considérez-le comme un « Wireshark pour Binder ».

Prérequis

version de python >= 3.9

⚙️ Installation

Vous aurez besoin d'un appareil Android rooté ou d'un émulateur.

• (Linux uniquement) - installez xclip ou xsel pour la fonctionnalité « copier dans le presse-papiers »

  sudo apt-get install xclip

  sudo apt-get install xsel

• Installez depuis PyPi

  pip install binder-trace

• Vérifiez quelle version de frida est installée (assurez-vous d'avoir installé les dépendances avec pip)

  pip list | grep frida

• Téléchargez la version correspondante de frida-server depuis la page des versions de frida

• Assurez-vous qu'adb s'exécute en root, poussez frida-server vers votre appareil et exécutez-le

  adb root

  adb push frida-server /data/local/tmp

  adb shell

  chmod u+x /data/local/tmp/frida-server

  /data/local/tmp/frida-server

Arguments

▶️ Démarrage de binder trace

Pour démarrer binder trace, il faut choisir un appareil et un processus auquel s'attacher. Dans l'exemple suivant, nous utilisons adb et frida-ps pour identifier un processus auquel s'attacher sur un émulateur local. Comme il s'agit d'un émulateur Android 11, nous choisissons le répertoire de structures Android 11. Choisissez le répertoire de structures qui correspond le plus à votre version d'Android. Si vous souhaitez des structures pour une autre version d'Android, faites-le-nous savoir. Une fois lancé, utilisez l'application cible pour générer des transactions Binder.

> adb devices
List of devices attached
emulator-5554   device

> frida-ps -Ua
 PID  Name           Identifier
----  -------------  ----------------------------
8334  Messaging      com.android.messaging
7941  Phone          com.android.dialer
9607  Settings       com.android.settings

> cd binder_trace
> binder-trace -d emulator-5554 -n Messaging -a 11

⌨️ Commandes

🌐 Global

📈 Panneau de fréquences

🔎 Fichier de configuration

Pour filtrer, définissez tout ou partie des options interface, method, type et inclusive. Pour ne pas utiliser une option, laissez-la vide ""

Sans l'argument -c

> binder-trace -d emulator-5554 -n Contacts -a 13

Avec l'argument -c

config.json

{
    "filters": [
        {
            "interface": "android.gui.IDisplayEventConnection",
            "method": "requestNextVsync",
            "type": "",
            "inclusive": false
        },
        {
            "interface": "android.content.IContentProvider",
            "method": "",
            "type": "call",
            "inclusive": false
        }
    ]
}

> binder-trace -d emulator-5554 -n Contacts -a 13 -c .\binder_trace\binder_trace\config.json

android.gui.IDisplayEventConnection->requestNextVsync->"" et android.content.IContentProvider->"" ->call ont été filtrés

📦 Compatibilité des structures

Les interfaces Binder internes peuvent changer entre les versions mineures, et comme tout est compilé ensemble sans information de version à l'exécution, il est difficile de fournir des informations de structure 100 % précises pour chaque version de l'écosystème Android, très fragmenté.

Plus de détails sur les structures sont disponibles sur la page des structures.