Grapefruit: suíte de testes de segurança mobile de código aberto

Kit de instrumentação de aplicações mobile em tempo de execução com tecnologia Frida. Inspecione, faça hook e modifique aplicações mobile através de uma interface web.

Agora suporta iOS e Android!

Início Rápido

Requer o servidor Frida em execução no seu dispositivo. Siga primeiro os guias oficiais de configuração(Android).

npm (recomendado, requer Node.js 22.18+)

npm install -g igf
igf

Ou execute sem instalar (requer Node.js 22.18+)

npx igf

Binários pré-compilados para macOS, Linux e Windows estão disponíveis em GitHub Releases. Tanto o desenvolvimento a partir do código-fonte quanto os executáveis pré-compilados usam Node.js; consulte o guia de desenvolvimento para o fluxo de trabalho com 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

Variáveis de Ambiente

Variable	Description	Default
HOST	Server bind address	127.0.0.1
PORT	Server port	31337
FRIDA_VERSION	Frida major version (16 or 17)	17
FRIDA_TIMEOUT	Frida operation timeout (ms)	1000
PROJECT_DIR	Project directory for data/cache/logs	.igf in cwd
LLM_PROVIDER	AI provider (anthropic, openai, gemini, openrouter)
LLM_API_KEY	API key for the LLM provider
LLM_MODEL	Model name (e.g. claude-sonnet-4-20250514)
LLM_BASE_URL	Custom endpoint (overrides provider default)

Flags de linha de comando têm precedência sobre variáveis de ambiente quando ambas estão definidas.

Funcionalidades

• Hook de Métodos em Tempo de Execução - Intercepte funções nativas e gerenciadas com logging estruturado
• Intercepção de APIs Criptográficas - Monitore operações de encriptação/decriptação com captura de dados
• Navegador de Sistema de Ficheiros - Navegue, carregue, descarregue e inspecione ficheiros com pré-visualização hex/texto
• Inspeção de Bases de Dados SQLite - Navegue por tabelas, execute consultas e veja resultados
• Streaming de Syslog - Monitorização de logs do sistema e do agente em tempo real
• Relatório de Crashes de Processos - Manipulador de exceções com dump de registos e backtrace
• Suporte a Flutter - Monitore canais de métodos de plataforma e explore snapshots Dart AOT, funções, classes, strings, referências e componentes recuperados
• Suporte a React Native - Inspetor de bridge e REPL de injeção de JavaScript
• Scanner de Memória - Pesquise e inspecione a memória do processo
• Monitor de Privacidade - Rastreie acessos a APIs sensíveis (câmara, microfone, localização, sensores, etc.)
• Inspetor de Threads - Veja e gerencie threads do processo
• Navegador de Módulos/Símbolos - Inspecione módulos carregados e símbolos exportados
• Análise e Descompilação - DEX, Flutter AOT, bytecode Hermes e código nativo. Assistência de IA disponível para geração de scripts de hook

iOS

• Acesso e modificação do Keychain
• Captura de tráfego de sessões NSURL (HTTP/HTTPS/WebSocket)
• Inspeção de WebView e JSContext com execução de JavaScript
• Dump da hierarquia de UI e realce de elementos
• Visualizadores de Info.plist, entitlements e binary cookie
• Bypass de biometria (Touch ID / Face ID)
• Navegador de UserDefaults
• Monitorização de operações de Pasteboard e ficheiros
• Spoofing de geolocalização
• Spoofing de ID de dispositivo
• Inspeção de classes e métodos Objective-C
• Handles de ficheiros abertos e conexões de rede (lsof)
• Análise de segurança (PIE, ARC, stack canaries, encriptação)
• Visualizador de catálogo de assets (Assets.car)
• Inspeção de mensagens XPC/NSXPC

Android

• Descodificador de AndroidManifest.xml e navegador de componentes (activities, services, receivers, providers)
• Inspeção do Android Keystore com atributos de chave
• Consulta, inserção, atualização e eliminação em content providers
• Rastreamento de chamadas JNI com argumentos, valores de retorno e backtraces
• Inspeção de classes Java (métodos, campos, interfaces)
• Construção e lançamento de Intents
• Handles de ficheiros abertos e conexões de rede (lsof)
• Captura de tráfego HTTP (OkHttp, Volley, URLConnection)
• Navegador de recursos
• Monitorização de Clipboard e SharedPreferences
• Monitorização de broadcast receivers

Documentação

• CLI e Daemon
• Desenvolvimento
• Arquitetura
• RPC
• Agradecimentos

Âmbito e Não-Objetivos

Este projeto não inclui bypasses incorporados para proteções anti-tampering:

• Bypass de deteção de Frida
• Bypass de certificate pinning SSL/TLS
• Bypass de deteção de jailbreak ou root

Justificação: As soluções RASP (Runtime Application Self-Protection) evoluem continuamente para detetar frameworks de instrumentação. Manter bypasses eficazes exige um esforço contínuo para acompanhar novos métodos de deteção, introduzindo um fardo de manutenção significativo e potenciais problemas de estabilidade. Estes bypasses são também altamente específicos de cada aplicação, tornando as soluções de propósito geral frágeis.

Em vez de fornecer bypasses incorporados frágeis, o Grapefruit foca-se em capacidades de instrumentação e inspeção que se compõem bem com ferramentas de bypass dedicadas.

Abordagens recomendadas para avaliações autorizadas onde o bypass de RASP é necessário:

1. Frida Syscall Tracer — Use frida-strace (Frida 17.8.0+) para rastrear chamadas de sistema no processo alvo. Isto ajuda a identificar artefactos de deteção e a determinar que patches são necessários antes de anexar o Grapefruit:

   frida-strace -U -f com.example.app