Grapefruit: suite de código abierto para pruebas de seguridad móvil

Kit de herramientas de instrumentación de aplicaciones móviles en tiempo de ejecución impulsado por Frida. Inspecciona, engancha y modifica aplicaciones móviles a través de una interfaz basada en web.

¡Ahora es compatible tanto con iOS como con Android!

Inicio rápido

Requiere que el servidor de Frida esté ejecutándose en tu dispositivo. Sigue primero las guías de configuración oficiales(Android).

npm (recomendado, requiere Node.js 22.18+)

npm install -g igf
igf

O ejecuta sin instalar (requiere Node.js 22.18+)

npx igf

Binarios precompilados para macOS, Linux y Windows están disponibles en GitHub Releases. Tanto el desarrollo desde el código fuente como los ejecutables precompilados usan Node.js; consulta la guía de desarrollo para el flujo de trabajo con npm.

Uso

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

Variables de entorno

Variable	Descripción	Valor predeterminado
HOST	Dirección de enlace del servidor	127.0.0.1
PORT	Puerto del servidor	31337
FRIDA_VERSION	Versión principal de Frida (16 o 17)	17
FRIDA_TIMEOUT	Tiempo de espera de operaciones de Frida (ms)	1000
PROJECT_DIR	Directorio del proyecto para datos/caché/registros	.igf en el directorio actual
LLM_PROVIDER	Proveedor de IA (anthropic, openai, gemini, openrouter)
LLM_API_KEY	Clave de API para el proveedor de LLM
LLM_MODEL	Nombre del modelo (p. ej. claude-sonnet-4-20250514)
LLM_BASE_URL	Endpoint personalizado (anula el predeterminado del proveedor)

Los indicadores de línea de comandos tienen prioridad sobre las variables de entorno cuando ambos están configurados.

Características

• Enganche de métodos en tiempo de ejecución - Intercepta funciones nativas y gestionadas con registro estructurado
• Intercepción de API criptográficas - Monitorea operaciones de cifrado/descifrado con captura de datos
• Explorador de sistema de archivos - Navega, sube, descarga e inspecciona archivos con vista previa hexadecimal/texto
• Inspección de bases de datos SQLite - Explora tablas, ejecuta consultas y visualiza resultados
• Transmisión de Syslog - Monitoreo de registros del sistema y del agente en tiempo real
• Informes de fallos de procesos - Manejador de excepciones con volcado de registros y traza inversa
• Soporte de Flutter - Monitorea canales de métodos de plataforma y explora instantáneas AOT de Dart, funciones, clases, cadenas, referencias y componentes recuperados
• Soporte de React Native - Inspector de puente y REPL de inyección de JavaScript
• Escáner de memoria - Busca e inspecciona la memoria del proceso
• Monitor de privacidad - Rastrea el acceso a API sensibles (cámara, micrófono, ubicación, sensores, etc.)
• Inspector de hilos - Visualiza y gestiona los hilos del proceso
• Explorador de módulos/símbolos - Inspecciona módulos cargados y símbolos exportados
• Análisis y descompilación - DEX, Flutter AOT, bytecode de Hermes y código nativo. Asistencia de IA disponible para la generación de scripts de enganche

iOS

• Acceso y modificación del Keychain
• Captura de tráfico de sesiones NSURL (HTTP/HTTPS/WebSocket)
• Inspección de WebView y JSContext con ejecución de JavaScript
• Volcado de jerarquía de UI y resaltado de elementos
• Visores de Info.plist, entitlements y cookies binarias
• Omisión de biometría (Touch ID / Face ID)
• Explorador de UserDefaults
• Monitoreo de operaciones de portapapeles y archivos
• Suplantación de geolocalización
• Suplantación de ID de dispositivo
• Inspección de clases y métodos de Objective-C
• Descriptores de archivos abiertos y conexiones de red (lsof)
• Análisis de seguridad (PIE, ARC, canarios de pila, cifrado)
• Visor de catálogo de recursos (Assets.car)
• Inspección de mensajes XPC/NSXPC

Android

• Decodificador de AndroidManifest.xml y explorador de componentes (activities, services, receivers, providers)
• Inspección de Android Keystore con atributos de claves
• Consulta, inserción, actualización y eliminación de proveedores de contenido
• Trazado de llamadas JNI con argumentos, valores de retorno y trazas inversas
• Inspección de clases Java (métodos, campos, interfaces)
• Construcción y lanzamiento de Intents
• Descriptores de archivos abiertos y conexiones de red (lsof)
• Captura de tráfico HTTP (OkHttp, Volley, URLConnection)
• Explorador de recursos
• Monitoreo de portapapeles y SharedPreferences
• Monitoreo de receptores de difusión

Documentación

• CLI y Daemon
• Desarrollo
• Arquitectura
• RPC
• Agradecimientos

Alcance y objetivos no contemplados

Este proyecto no incluye omisiones integradas para protecciones anti-manipulación:

• Omisión de detección de Frida
• Omisión de fijación de certificados SSL/TLS
• Omisión de detección de jailbreak o root

Justificación: Las soluciones RASP (Runtime Application Self-Protection) evolucionan continuamente para detectar frameworks de instrumentación. Mantener omisiones efectivas requiere un esfuerzo continuo para seguir el ritmo de los nuevos métodos de detección, lo que introduce una carga de mantenimiento significativa y posibles problemas de estabilidad. Estas omisiones también son altamente específicas de cada aplicación, lo que hace que las soluciones de propósito general sean frágiles.

En lugar de incluir omisiones integradas frágiles, Grapefruit se centra en capacidades de instrumentación e inspección que se combinan bien con herramientas de omisión dedicadas.