Binder Trace

Binder Trace — это инструмент для перехвата и разбора сообщений Android Binder. Можно считать его «Wireshark для Binder».

Требования

версия python >= 3.9

⚙️ Установка

Вам понадобится рутированное Android-устройство или эмулятор.

• (только Linux) — установите xclip или xsel для функции «копировать в буфер обмена»

  sudo apt-get install xclip

  sudo apt-get install xsel

• Установка из PyPi

  pip install binder-trace

• Проверьте, какая версия frida установлена (убедитесь, что вы установили зависимости через pip)

  pip list | grep frida

• Загрузите подходящую версию frida-server со страницы релизов frida

• Убедитесь, что adb запущен от root, скопируйте frida-server на устройство и запустите его

  adb root

  adb push frida-server /data/local/tmp

  adb shell

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

  /data/local/tmp/frida-server

Аргументы

▶️ Запуск binder trace

Чтобы запустить binder trace, нужно выбрать устройство и процесс для подключения. В следующем примере мы используем adb и frida-ps, чтобы определить процесс для подключения в локальном эмуляторе. Поскольку это эмулятор Android 11, мы выбираем каталог структур для Android 11. Выбирайте каталог структур, который наиболее точно соответствует вашей версии Android. Если вам нужны структуры для другой версии Android, сообщите нам. После запуска начните использовать целевое приложение, чтобы сгенерировать несколько 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

⌨️ Управление

🌐 Глобальные

📈 Панель частот

🔎 Файл конфигурации

Для фильтрации укажите любой или все из параметров interface, method, type и inclusive. Чтобы не использовать параметр, оставьте его пустым ""

Без аргумента -c

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

С аргументом -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->"" и android.content.IContentProvider->""->call были отфильтрованы

📦 Совместимость структур

Внутренние интерфейсы Binder могут меняться между минорными версиями, и, поскольку они фактически компилируются вместе без информации о версии во время выполнения, сложно предоставить 100% точную информацию о структурах для каждого выпуска в сильно фрагментированной экосистеме Android.

Больше подробностей о структурах можно найти на странице структур.