Binder Trace

Binder Trace è uno strumento per intercettare e analizzare i messaggi Binder di Android. Pensalo come un "Wireshark per Binder".

Requisiti

versione di Python >= 3.9

⚙️ Installazione

Avrai bisogno di un dispositivo Android rooted o di un emulatore.

• (solo Linux) - installa xclip o xsel per la funzionalità "copia negli appunti"

  sudo apt-get install xclip

  sudo apt-get install xsel

• Installa da PyPi

  pip install binder-trace

• Controlla quale versione di frida è installata (assicurati di aver installato i requisiti con pip)

  pip list | grep frida

• Scarica la versione corrispondente di frida-server dalla pagina delle release di frida

• Assicurati che adb sia in esecuzione come root, esegui il push di frida-server sul dispositivo e avvialo

  adb root

  adb push frida-server /data/local/tmp

  adb shell

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

  /data/local/tmp/frida-server

Argomenti

▶️ Avvio di binder trace

Per avviare binder trace dobbiamo scegliere un dispositivo e un processo a cui collegarci. Nell'esempio seguente usiamo adb e frida-ps per identificare un processo a cui collegarci su un emulatore locale. Trattandosi di un emulatore Android 11, scegliamo la directory delle struct di Android 11. Scegli la directory delle struct che corrisponde più fedelmente alla tua versione di Android. Se desideri le struct per una versione diversa di Android, faccelo sapere. Una volta in esecuzione, inizia a usare l'app target per generare alcune transazioni 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

⌨️ Controlli

🌐 Globali

📈 Pannello delle frequenze

🔎 File di configurazione

Per filtrare, definisci una o più delle opzioni interface, method, type e inclusive. Per non usare un'opzione, lasciala vuota ""

Senza l'argomento -c

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

Con l'argomento -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->"" e android.content.IContentProvider->""->call sono stati filtrati

📦 Compatibilità delle strutture

Le interfacce binder interne possono cambiare tra versioni minori e, poiché sono di fatto compilate tutte insieme senza informazioni sulla versione a runtime, è difficile fornire informazioni strutturali accurate al 100% per ogni release nell'ecosistema altamente frammentato di Android.

Maggiori dettagli sulle strutture sono disponibili nella pagina delle strutture.