Frida Workbench для VSCode

Репозиторий | Проблемы | Установить

Это проект, созданный сообществом, и он не связан с официальной командой Frida. Он разрабатывается и поддерживается @CodeColorist как расширение с открытым исходным кодом для Visual Studio Code, улучшающее опыт написания скриптов на Frida.

中文说明

Предварительные требования

• Python >= 3.7
• Пакет Python frida-tools

Необязательные зависимости

• libimobiledevice (для команды inetcat для запуска SSH-оболочки)
• iTunes в Windows (для USB-подключения к iOS)

Если вы работаете в Windows, вам нужно держать iTunes открытым, чтобы взаимодействовать с устройствами iOS через USB.

Установка frida-tools

Из-за PEP0668 вы можете столкнуться с ошибкой при глобальном запуске pip3 install frida-tools.

Рекомендуемый способ — открыть папку (рабочую область) в VSCode, затем создать и активировать виртуальное окружение с помощью расширения Python. В этом случае расширение будет использовать ваше текущее активное виртуальное окружение Python для загрузки команд frida.

В качестве альтернативы вы можете использовать менеджер пакетов, такой как pipx или UV, чтобы установить его в $PATH, сохраняя изоляцию.

Возможности

Список приложений и процессов

Отображает список приложений и процессов на подключённых устройствах на боковой панели. Щёлкните правой кнопкой мыши, чтобы подключиться, подключиться с повышенными привилегиями для локальных целей, запустить, запустить в приостановленном режиме, завершить процессы или скопировать информацию об устройстве/процессе в буфер обмена. Поддерживаются локальные устройства, Apple Simulator, USB и удалённые устройства. Записи локальных процессов включают по возможности метаданные, такие как путь к исполняемому файлу, владелец, родительский PID и аргументы.

Интерактивные панели среды выполнения

Браузер модулей и экспортов

Просматривайте загруженные нативные модули и их экспортируемые функции для любого подключённого процесса. Фильтруйте модули по имени, просматривайте базовый адрес, размер и путь, затем выбирайте экспорты для генерации хуков.

Браузер классов и методов

Исследуйте классы и методы среды выполнения как для Java, так и для Objective-C. Фильтруйте классы, переключайтесь между собственными и унаследованными методами и выбирайте методы пакетно для генерации хуков. Также включает инспекцию протоколов Objective-C для просмотра и анализа протоколов.

Генерация заголовков

Выгружайте заголовки классов для обратной разработки:

• Objective-C — генерируйте файлы заголовков из метаданных классов среды выполнения
• Java — генерируйте декомпилированные заглушки классов с операторами package и import

Генерация хуков

Генерируйте код хуков Frida из панелей Modules и Classes:

• Нативные хуки — Interceptor.attach() с обратными вызовами onEnter / onLeave для экспортируемых функций
• Хуки Objective-C — хуки на основе классов и селекторов с правильным использованием моста ObjC
• Хуки Java — хуки Java.perform() / Java.use() с поддержкой перегрузки методов
• Хуки на основе ИИ — используйте GitHub Copilot для вывода сигнатур нативных функций (типы параметров, типы возвращаемых значений) и генерации логирования аргументов с учётом типов

Умное автодополнение (LSP)

Контекстно-зависимые автодополнения для скриптов Frida на JavaScript / TypeScript:

• ObjC.classes.<ClassName> — дополняет имена классов Objective-C
• ObjC.classes.Foo['<method>'] — дополняет селекторы методов
• ObjC.classes.Foo.method — дополняет селекторы методов класса
• Java.use('<ClassName>') — дополняет имена классов Java
• Process.getModuleByName('<name>') — дополняет имена загруженных модулей

Языковой сервер зависит от контекста целевого процесса. Вам нужно создать файл конфигурации .vscode/frida.json в вашей рабочей области. Проще всего щёлкнуть правой кнопкой мыши по процессу или приложению на боковой панели и выбрать Set LSP Target, что автоматически создаст файл.

Конфигурация .vscode/frida.json

Файл указывает, к какому устройству и цели должен подключаться LSP. Он требует поля device и ровно одного из полей app, pid или process.

Подключение по идентификатору приложения (рекомендуется — запускает или подключается к приложению):

{
    "device": "local",
    "app": "com.example.myapp"
}

Подключение по имени процесса:

{
    "device": "local",
    "process": "myprocess"
}

Подключение по PID (полезно, когда несколько процессов имеют одинаковое имя):

{
    "device": "local",
    "pid": 1234
}

Значение device соответствует идентификатору устройства Frida — local для хост-машины, идентификатор Simulator или USB-устройства, либо строка host:port для удалённых устройств.

LSP отслеживает изменения этого файла. Редактирование или повторное создание файла автоматически перезапускает языковой сервер с новой целью.

Syslog

Потоковая передача логов приложения в реальном времени от подключённых процессов.

Создание структуры проекта

• New Agent — создать новый проект Frida Agent с поддержкой TypeScript
• New C Module — создать новый проект Frida C Module
• Download Typings — загрузить определения типов TypeScript для Frida для автодополнения

Конфигурация отладки

Генерируйте launch.json и tasks.json для VSCode для отладки скриптов Frida с точками останова.

Инструменты Android

• Загрузка и запуск frida-server на устройстве Android (автоматическое определение архитектуры)
• Извлечение APK с устройства (щёлкните правой кнопкой мыши по приложению Android для извлечения)

Интеграция с внешними инструментами

• Objection — Runtime Mobile Exploration

Оболочка

Для устройств Android Open Shell — это обёртка для adb shell.

Для iOS она предоставляет SSH-оболочку на устройствах с джейлбрейком. Может потребоваться настройка учётных данных.

Поддержка удалённых устройств

Подключайтесь к удалённым устройствам Frida через host:port прямо с боковой панели.

CHANGELOG

Участники