Grapefruit: Открытый набор для тестирования мобильной безопасности

Инструментарий для runtime-инструментирования мобильных приложений на базе Frida. Изучайте, перехватывайте и модифицируйте мобильные приложения через веб-интерфейс.

Теперь поддерживаются как iOS, так и Android!

Быстрый старт

Требуется запущенный сервер Frida на вашем устройстве. Сначала следуйте официальным руководствам по настройке(Android).

npm (рекомендуется, требуется Node.js 22.18+)

npm install -g igf
igf

Или запуск без установки (требуется Node.js 22.18+)

npx igf

Готовые бинарные файлы для macOS, Linux и Windows доступны на GitHub Releases. Как разработка из исходников, так и готовые исполняемые файлы используют Node.js; см. руководство по разработке для рабочего процесса с npm.

Использование

igf [options]           Start the server (default)

Options:
  --frida <16 | 17>      Frida version to use (default: 17)
  --host <host>          Host to bind (default: 127.0.0.1)
  --port <port>          Port to bind (default: 31337)
  --project <path>       Project directory for data/cache/logs (default: .igf in cwd)
  --no-open              Do not open browser on startup
  --help, -h             Show help message

Переменные окружения

Переменная	Описание	По умолчанию
`HOST`	Адрес привязки сервера	`127.0.0.1`
`PORT`	Порт сервера	`31337`
`FRIDA_VERSION`	Основная версия Frida (`16` или `17`)	`17`
`FRIDA_TIMEOUT`	Таймаут операций Frida (мс)	`1000`
`PROJECT_DIR`	Каталог проекта для данных/кэша/логов	`.igf` в текущем каталоге
`LLM_PROVIDER`	AI-провайдер (`anthropic`, `openai`, `gemini`, `openrouter`)
`LLM_API_KEY`	API-ключ для LLM-провайдера
`LLM_MODEL`	Имя модели (например, `claude-sonnet-4-20250514`)
`LLM_BASE_URL`	Пользовательская конечная точка (переопределяет значение провайдера по умолчанию)

Флаги командной строки имеют приоритет над переменными окружения, если заданы оба.

Возможности

Перехват методов во время выполнения — Перехват нативных и управляемых функций со структурированным логированием
Перехват криптографических API — Мониторинг операций шифрования/дешифрования с захватом данных
Просмотр файловой системы — Навигация, загрузка, скачивание и просмотр файлов с hex/текстовым предпросмотром
Просмотр баз данных SQLite — Просмотр таблиц, выполнение запросов и просмотр результатов
Потоковая передача Syslog — Мониторинг системных логов и логов агента в реальном времени
Отчёты о сбоях процессов — Обработчик исключений с дампом регистров и трассировкой стека
Поддержка Flutter — Мониторинг каналов методов платформы и исследование снимков Dart AOT, функций, классов, строк, ссылок и восстановленных компонентов
Поддержка React Native — Инспектор моста и REPL для инъекции JavaScript
Сканер памяти — Поиск и просмотр памяти процесса
Монитор приватности — Отслеживание доступа к конфиденциальным API (камера, микрофон, местоположение, датчики и т. д.)
Инспектор потоков — Просмотр и управление потоками процесса
Просмотр модулей/символов — Просмотр загруженных модулей и экспортируемых символов
Анализ и декомпиляция — DEX, Flutter AOT, байт-код Hermes и нативный код. Доступна помощь ИИ для генерации скриптов перехвата

iOS

Доступ и изменение Keychain
Захват трафика сессий NSURL (HTTP/HTTPS/WebSocket)
Просмотр WebView и JSContext с выполнением JavaScript
Дамп иерархии UI и подсветка элементов
Просмотр Info.plist, entitlements и бинарных cookie
Обход биометрии (Touch ID / Face ID)
Просмотр UserDefaults
Мониторинг буфера обмена и файловых операций
Подмена геолокации
Подмена идентификатора устройства
Просмотр классов и методов Objective-C
Открытые файловые дескрипторы и сетевые соединения (lsof)
Анализ безопасности (PIE, ARC, stack canaries, шифрование)
Просмотр каталога ресурсов (Assets.car)
Просмотр сообщений XPC/NSXPC

Android

Декодер AndroidManifest.xml и просмотр компонентов (activities, services, receivers, providers)
Просмотр Android Keystore с атрибутами ключей
Запрос, вставка, обновление и удаление через content provider
Трассировка вызовов JNI с аргументами, возвращаемыми значениями и трассировками стека
Просмотр классов Java (методы, поля, интерфейсы)
Создание и запуск Intent
Открытые файловые дескрипторы и сетевые соединения (lsof)
Захват HTTP-трафика (OkHttp, Volley, URLConnection)
Просмотр ресурсов
Мониторинг буфера обмена и SharedPreferences
Мониторинг broadcast receiver

Документация

Область применения и нецели

Этот проект не включает встроенные обходы для защиты от несанкционированного вмешательства:

Обход обнаружения Frida
Обход привязки SSL/TLS сертификатов
Обход обнаружения jailbreak или root

Обоснование: Решения RASP (Runtime Application Self-Protection) постоянно развиваются для обнаружения фреймворков инструментирования. Поддержание эффективных обходов требует постоянных усилий, чтобы не отставать от новых методов обнаружения, что создаёт значительную нагрузку на сопровождение и потенциальные проблемы со стабильностью. Эти обходы также сильно зависят от конкретного приложения, что делает универсальные решения хрупкими.

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

Рекомендуемые подходы для авторизованных оценок, где требуется обход RASP:

Frida Syscall Tracer — Используйте frida-strace (Frida 17.8.0+) для трассировки системных вызовов в целевом процессе. Это помогает выявить артефакты обнаружения и определить, какие патчи необходимы перед подключением Grapefruit:
```
frida-strace -U -f com.example.app
```

Популярное

grapefruit