Demo_CVE-2025-3248 — PoC Educacional

Propósito: Simular a vulnerabilidade (CVE-2025-3248) em um ambiente isolado para aprendizado sobre segurança da informação: montar laboratório, observar comportamentos exploráveis e discutir medidas de mitigação.

⚠️ DECLARAÇÃO LEGAL E ÉTICA (SOMENTE USO ÉTICO)

• Todo o conteúdo deste repositório é exclusivamente para fins acadêmicos/de pesquisa.
• Absolutamente não utilize o código-fonte/técnicas incluídas para interferir em sistemas que não sejam de sua propriedade ou sem autorização por escrito.
• O autor/colaboradores não se responsabilizam por quaisquer consequências decorrentes do uso indevido.
• Ao utilizar este repositório, você concorda com os termos acima.

Índice

• Introdução
• Arquitetura do laboratório
• Componentes do repositório
• Requisitos do sistema
• Início rápido
  • A. Montar o laboratório com Docker
  • B. Instalar dependências para o PoC
  • C. Executar o PoC no laboratório local
• Personalização da configuração
• Limpeza
• Notas de defesa / mitigação
• Solução de problemas
• Roteiro de aprendizado sugerido
• Licença
• Reiteração do compromisso de uso ético

Introdução

O repositório fornece:

• Um serviço de demonstração vulnerável executado em Docker (porta padrão 7860).
• Código PoC (exploit.py) para enviar solicitações que demonstram a exploração somente no seu laboratório.
• Documentação para montar o ambiente, executar testes, observar e testar medidas de defesa.

Arquitetura do laboratório

• Todos os testes são realizados na sua máquina ou na rede de laboratório que você controla.
• Não exponha este serviço à internet.

Componentes do repositório

• docker-compose.yml — Monta o container do aplicativo de demonstração vulnerável.
• exploit.py — Cliente PoC que demonstra a ativação da falha (somente para uso em laboratório).
• LICENSE — Licença de uso.
• README.md — A documentação que você está lendo.

Requisitos do sistema

• Docker e Docker Compose (plugin).
• Python 3.10+ e pip (para executar o PoC).
• Permissão para executar Docker (sudo no Linux ou usuário no grupo docker).

Início rápido

A. Montar o laboratório com Docker

git clone https://github.com/Kiraly07/Demo_CVE-2025-3248.git
cd Demo_CVE-2025-3248

# Iniciar o serviço de demonstração (em segundo plano)
docker compose up -d

# Verificar o container
docker compose ps

# Visualizar logs quando necessário
docker compose logs -f

B. Instalar dependências para o PoC

python -m venv venv
# Linux/macOS
source venv/bin/activate
# Windows PowerShell
# .\venv\Scripts\Activate.ps1

pip install --upgrade pip
pip install requests colorama argparse

(Opcional) criar requirements.txt:

requests
colorama
argparse

C. Executar o PoC no laboratório local

# Exemplo básico
python exploit.py -u http://[TARGET]:7860
 

Nota importante: Aponte --url apenas para localhost/sua máquina de laboratório. Não ataque alvos fora do escopo permitido.

Personalização da configuração

• Porta do serviço: Ajuste na seção ports: do docker-compose.yml.
• Rede Docker: Você pode adicionar uma rede separada para isolar o container (recomendado em laboratórios complexos).
• Proxy reverso: Se necessário, coloque atrás do Nginx e exponha apenas localmente (127.0.0.1 ou rede interna).

Limpeza

# Parar e remover container/volumes
docker compose down -v

# (Opcional) Remover venv
deactivate 2>/dev/null || true
rm -rf venv

Notas de defesa / mitigação

• Atualize o software para a versão corrigida quando houver aviso oficial.
• Limite a superfície de ataque: exponha apenas as portas necessárias; coloque atrás de um proxy reverso com autenticação.
• Princípio do menor privilégio para o container:
  • Execute com usuário não privilegiado.
  • Restrinja capabilities, ative root FS somente leitura se possível.
  • Isole a rede, não monte discos sensíveis.
• Monitoramento e logs: ative access log; monitore padrões suspeitos; alertas antecipados.
• WAF/IDS/IPS: aplique onde apropriado; sempre valide a entrada (input validation).

Solução de problemas

• Porta 7860 ocupada: altere o mapeamento de porta (ex: 8080:7860) no docker-compose.yml.
• Não é possível iniciar o container: veja os logs com docker compose logs -f.
• Falta de permissão Docker: use sudo ou adicione o usuário ao grupo docker.
• Erro ao instalar pacotes Python: atualize o pip e verifique proxy/firewall interno.

Roteiro de aprendizado sugerido

• Leia o docker-compose.yml para entender a superfície de ataque/dependências.
• Execute o PoC no laboratório local, registre as solicitações/respostas HTTP.
• Teste medidas de mitigação e reexecute o PoC para avaliar a eficácia.
• Escreva um relatório: causa raiz da falha, cadeia de exploração, impacto e recomendações.

Licença

• Consulte o arquivo LICENSE na raiz do repositório.

Reiteração do compromisso de uso ético

Este repositório foi criado apenas para fins educacionais. Não use para fins não autorizados. Sempre obtenha permissão explícita antes de testar a segurança de qualquer sistema que não seja de sua propriedade.