Binder Trace

Binder Trace es una herramienta para interceptar y analizar mensajes de Android Binder. Piénsalo como "Wireshark para Binder".

Requisitos

versión de python >= 3.9

⚙️ Instalación

Necesitarás un dispositivo Android rooteado o un emulador.

• (Solo Linux) - instala xclip o xsel para la funcionalidad "copiar al portapapeles"

  sudo apt-get install xclip

  sudo apt-get install xsel

• Instalar desde PyPi

  pip install binder-trace

• Comprueba qué versión de frida está instalada (asegúrate de haber instalado los requisitos con pip)

  pip list | grep frida

• Descarga la versión correspondiente de frida-server desde la página de lanzamientos de frida

• Asegúrate de que adb se esté ejecutando como root, envía frida-server a tu dispositivo y ejecútalo

  adb root

  adb push frida-server /data/local/tmp

  adb shell

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

  /data/local/tmp/frida-server

Argumentos

▶️ Iniciando binder trace

Para iniciar binder trace necesitamos elegir un dispositivo y un proceso al que conectarnos. En el siguiente ejemplo usamos adb y frida-ps para identificar un proceso al que conectarnos en un emulador local. Como es un emulador de Android 11, elegimos el directorio de estructuras de Android 11. Elige el directorio de estructuras que más se aproxime a tu versión de Android. Si deseas estructuras para una versión diferente de Android, por favor, háznoslo saber. Una vez que esté en ejecución, comienza a usar la aplicación objetivo para generar algunas transacciones de 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

⌨️ Controles

🌐 Global

📈 Panel de frecuencia

🔎 Archivo de Configuración

Para filtrar, define cualquiera o todas las opciones de interface, method, type e inclusive. Para no usar una opción, déjala en blanco ""

Sin el argumento -c

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

Con el argumento -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->"" y android.content.IContentProvider->"" ->call han sido filtrados

📦 Compatibilidad de Estructuras

Las interfaces de binder internas pueden cambiar entre versiones menores y, dado que prácticamente todo se compila junto sin información de versión en tiempo de ejecución, es difícil proporcionar información de estructuras 100% precisa para cada versión en el ecosistema altamente fragmentado de Android.

Puedes encontrar más detalles sobre las estructuras en la página de estructuras.