MORF

Framework de Reconhecimento Móvel

Um poderoso kit de ferramentas de segurança ofensiva para análise de aplicativos móveis

Encontre Segredos. Proteja Apps. Mantenha-se Seguro.

📋 Índice

• 💡 Visão Geral
• 🚀 Início Rápido
• 🔍 Principais Funcionalidades
• 🏗️ Arquitetura
• 📋 Casos de Uso Comuns
• 📦 Instalação
  • Pré-requisitos
  • Método 1: Docker (Recomendado)
  • Método 2: Script de Execução
  • Configuração de Ambiente
• 🖥️ Uso
  • Interface Web
  • Linha de Comando
• 🏆 Reconhecimento em Conferências
• 🛣️ Roteiro de Desenvolvimento
• 👨‍💻 Autores
• 📄 Licença
• 🙏 Agradecimentos

💡 Visão Geral

O MORF é uma ferramenta avançada de análise de segurança móvel que descobre automaticamente informações sensíveis em aplicativos Android e iOS. Projetado para profissionais de segurança, testadores de penetração e desenvolvedores, o MORF fornece insights abrangentes sobre a postura de segurança de aplicativos móveis.

🚀 Início Rápido

O MORF pode estar em funcionamento em segundos usando Docker ou o script de execução incluído:

# Clone o repositório e entre no diretório
git clone https://github.com/amrudesh1/morf && cd morf

# Opção 1: Usando o script de execução (recomendado)
chmod +x run.sh && ./run.sh

# Opção 2: Usando Docker Compose
docker-compose up --build

Em seguida, basta visitar http://localhost no seu navegador e enviar um arquivo APK ou IPA para começar a análise!

🔍 Principais Funcionalidades

O MORF oferece capacidades abrangentes de análise de segurança para aplicativos móveis:

🏗️ Arquitetura

O MORF combina um backend em Go com um frontend em Angular para fornecer análise poderosa com uma interface intuitiva:

📋 Casos de Uso Comuns

📦 Instalação

Pré-requisitos

• Docker (recomendado para instalação mais simples)
• Alternativamente: Go e Node.js para configuração de desenvolvimento

Método 1: Docker (Recomendado)

Para usuários macOS, consulte README-LOCAL.md para um guia detalhado de desenvolvimento local.

# Clone o repositório
git clone https://github.com/amrudesh1/morf
cd MORF

# Inicie todos os serviços (MySQL, Redis, Backend, Frontend)
./run-local.sh start

# Ou usando docker-compose diretamente
docker-compose up -d

Os serviços estarão disponíveis em:

• Frontend: http://localhost
• Backend API: http://localhost:9092/api
• Health Check: http://localhost:9092/api/health

Comandos comuns:

./run-local.sh start    # Start all services
./run-local.sh stop     # Stop all services
./run-local.sh status   # Check service status
./run-local.sh logs     # View logs

Método 2: Script de Execução

git clone https://github.com/amrudesh1/morf
cd morf
chmod +x run.sh
./run.sh

Configuração de Ambiente

O MORF requer a variável de ambiente DATABASE_URL para conectar ao seu banco de dados:

# macOS/Linux
export DATABASE_URL="root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local"

# Windows (CMD)
set DATABASE_URL=root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local

# Windows (PowerShell)
$env:DATABASE_URL = "root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local"

Nota: O Docker Compose usará automaticamente as variáveis de ambiente definidas na sua máquina host.

🖥️ Uso

Interface Web

Após iniciar o MORF, acesse a interface web intuitiva em http://localhost e siga estes passos:

1. Envie seu arquivo APK ou IPA usando a interface de arrastar e soltar
2. Aguarde o MORF processar e analisar o aplicativo
3. Explore os resultados detalhados, incluindo:
   • Segredos e chaves de API descobertos
   • Análise de segurança de componentes
   • Avaliação de permissões
   • Mapeamento de deeplinks
   • Metadados abrangentes

Linha de Comando

O MORF também fornece uma CLI poderosa para automação e integração:

# Basic scan with console output
./morf cli --apk-path=/path/to/app.apk

🏆 Reconhecimento em Conferências

Aparições em Conferências

🛣️ Roteiro de Desenvolvimento

👨‍💻 Autores

@amrudesh1

📄 Licença

O MORF é lançado sob a Licença MIT. Consulte o arquivo LICENSE para mais detalhes.

🙏 Agradecimentos

• Secrets Patterns Database - Base de dados de padrões usada pelo MORF para detecção de segredos
• Comunidade de Segurança de Código Aberto - Por inspiração, feedback e suporte
• Todos os Contribuidores - Todos que contribuíram com código, feedback e ideias para o projeto MORF