DroidGround

Website | Demo

Em desafios CTF tradicionais, é comum esconder flags em arquivos de um sistema, exigindo que os atacantes explorem vulnerabilidades para recuperá-las. No entanto, no mundo Android, essa abordagem não funciona bem. Arquivos APK são facilmente baixáveis e reversíveis, então colocar uma flag no dispositivo geralmente torna trivial extraí-la usando análise estática ou truques de emulador. Isso limita severamente a capacidade de criar desafios realistas focados em tempo de execução.

DroidGround foi projetado para resolver esse problema.

É uma plataforma construída sob medida para hospedar desafios de hacking mobile Android em um ambiente controlado e realista, onde os atacantes são restringidos apenas o suficiente para exigir que resolvam os desafios da maneira pretendida.

Importante: os participantes podem ser presos dentro do ambiente do app. A modularidade da ferramenta permite definir se o usuário pode ou não abrir um shell, ler arquivos arbitrários ou instalar ferramentas externas. Tudo pode ser configurado para que a única forma de recuperar a flag seja através da compreensão e exploração do próprio app.

📋 Índice

• 🧭 Visão Geral
• ✨ Funcionalidades
• 📸 Capturas de Tela
• ⚙️ Configuração
• 🧩 Casos de Uso
• ⚙️ Uso
• 💡 Dicas
• 🛠 Desenvolvimento
• 🤝 Contribuindo
• 📚 Créditos
• 🪪 Licença

🧭 Visão Geral

DroidGround possibilita uma ampla variedade de desafios Android que de outra forma seriam difíceis de implementar em configurações CTF tradicionais. Por exemplo, em um desafio de execução remota de código (RCE), os jogadores podem receber um APK para análise local. Após descobrir uma vulnerabilidade, eles podem desenvolver um script Frida e executá-lo através do DroidGround no dispositivo alvo real para extrair a flag do armazenamento interno. Outros tipos de desafio podem envolver atividades ocultas, intents de broadcast personalizados, exploração de serviços ou análise dinâmica usando ferramentas pré-carregadas.

Com streaming de dispositivo em tempo real, controle refinado sobre funcionalidades, integração com Frida e scripts de configuração e reset personalizáveis, o DroidGround capacita organizadores de CTF a construir desafios Android seguros, flexíveis e realistas que vão muito além do que normalmente é possível.

✨ Funcionalidades

O DroidGround fornece um rico conjunto de funcionalidades controladas pelo servidor.

• Tela do Dispositivo em Tempo Real (via scrcpy), com controle opcional de mouse, toque e teclado
• Resetar Estado do Desafio
• Reiniciar App / Iniciar Activity / Iniciar Service
• Enviar Broadcast Intent
• Desligar / Reiniciar Dispositivo
• Baixar Bugreport (bugreportz)
• Scripting com Frida
  • Executar da biblioteca pré-carregada (modo restrito)
  • Executar scripts arbitrários (modo completo)
• Navegador de Arquivos
• Acesso ao Terminal
• Gerenciamento de APK
• Visualizador de Logcat
• Servidor de Exploit (se o modo de equipe estiver habilitado)

Quase todas as funcionalidades são modulares e definidas via variáveis de ambiente, garantindo controle preciso sobre o escopo do desafio.

📸 Capturas de Tela

Visão Geral	Iniciar Activity
Modo Restrito do Frida	Modo Completo do Frida
Navegador de Arquivos	Gerenciador de Apps
Terminal	Logs

⚙️ Configuração

O arquivo .env.sample no diretório raiz é um bom ponto de partida. Esta é a lista completa de todas as variáveis de ambiente atualmente suportadas: