Skip to content

README.pt-BR.md

Latest commit

 

History

History
241 lines (176 loc) · 11.4 KB

README.pt-BR.md

File metadata and controls

241 lines (176 loc) · 11.4 KB
Raw

MikrotikAPI-BF v3.10.0 (pt-BR)

Python Version License Version Platform Wiki PyPI CodeQL

Framework de Ataque e Exploração RouterOS — força bruta de credenciais, 100 exploits CVE/EDB com PoC, auditoria de segurança automatizada em 8 fases, descoberta MAC-Server Layer-2, decodificadores offline de credenciais, analisador NPK, scanner CVE, export SARIF para CI/CD, scripts Nmap NSE, multi-alvo, stealth, vetores API/REST/Winbox/FTP/SSH/Telnet/SMB/SNMP/BFD/OSPF.

English: README.md · Contribuição: CONTRIBUTING.md · Conduta: CODE_OF_CONDUCT.md · Segurança: SECURITY.md

✨ Principais Funcionalidades

🔐 Autenticação e Força Bruta

  • RouterOS API (TCP 8728/8729) — protocolo binário completo (6.x MD5 challenge + 7.x plaintext)
  • REST API via HTTP/HTTPS (TCP 80/443) — força bruta Basic Auth
  • MAC-Telnet (TCP 20561) — protocolo proprietário Layer-2 (sem IP necessário)
  • Multi-alvo (--target-list / -T) — escanear a partir de arquivo
  • Threading — até 15 workers (--threads N)

🔍 Scanner CVE e Engine de Exploits

  • 47 classes de exploit — 27 CVEs + 5 config/design findings + 13 PoCs Exploit-DB + pesquisa novel
  • Exploits pre-auth — Winbox (CVE-2018-14847, CVE-2018-10066), HTTP traversal, SNMP, SMB, BFD, OSPF, DNS
  • Exploits post-auth — RCE via Scheduler, escalonamento Container, FOISted, extração chave WireGuard, wiretapping via packet sniffer, SSRF via tool/fetch, path traversal REST, command injection scheduler
  • SSH Jailbreak — shell root via patch de backup SSH (ROS 2.9.8–6.41rc56)
  • Decriptação Winbox — aprimora CVE-2018-14847 com decriptação de arquivos DAT
  • Ciente de versão — banco de dados CVE mapeia aplicabilidade à versão RouterOS detectada
  • --scan-cve — scan CVE standalone (sem força bruta)
  • --run-exploit <CVE_ID> — executar exploit específico por ID (v3.10.0+)

🛡️ Auditoria Automatizada de Segurança (v3.10.0+)

  • --audit — auditoria completa em 8 fases via REST API (sem necessidade de força bruta)
  • Fase 1: Enumeração de sistema (identidade, recursos, pacotes, saúde)
  • Fase 2: Mapeamento de serviços e rede (ip/service, firewall, interfaces)
  • Fase 3: Auditoria de usuários e credenciais (senha em branco, credenciais padrão)
  • Fase 4: Teste de injeção REST API (scheduler, path traversal, SSRF)
  • Fase 5: Sondagem de protocolo Winbox (porta 8291, banner M2)
  • Fase 6: Análise SNMP (comunidades padrão)
  • Fase 7: Descoberta de endpoints ocultos/debug
  • Fase 8: Exportação de configuração e auditoria de firewall
  • Gera relatório markdown + JSON raw + SARIF

🌐 Cobertura Winbox (TCP 8291)

  • CVE-2018-14847 — Divulgação de credenciais (Chimay-Red / EternalWink) — leitura de arquivo pre-auth
  • CVE-2018-10066 — Bypass de autenticação / directory traversal
  • CVE-2021-27263 — Bypass de auth (RouterOS 7.0.x)
  • CVE-2018-14847-MAC — Mesmo exploit via descoberta MNDP Layer-2
  • Script NSE — nse/mikrotik-winbox-cve-2018-14847.nse

ℹ️ Força bruta Winbox via protocolo GUI proprietário não implementada (sem biblioteca portável). Use porta API 8728. Todos os exploits CVE Winbox (leitura de arquivo pre-auth, bypass) estão plenamente implementados.

🛰️ MAC-Server / Descoberta Layer-2 (v3.3.0+)

  • Broadcast MNDP (UDP 20561) — descobre dispositivos mesmo sem IP
  • Força bruta MAC-Telnet (TCP 20561)
  • CVE-2018-14847-MAC — divulgação de credenciais via dispositivos descobertos por MNDP
  • Restrição L2 — requer mesmo domínio de broadcast

🔓 Decodificadores Offline de Credenciais (v3.5.0+)

  • --decode-userdat — decodifica user.dat após extração via CVE-2018-14847 (XOR com chave MD5)
  • --decode-backup — extrai arquivo .backup + auto-decodifica credenciais
  • --decode-supout — lista seções em supout.rif
  • --analyze-npk — analisador de pacotes NPK (vetor CVE-2019-3977)

🗺️ Scripts Nmap NSE (v3.6.0+)

  • mikrotik-routeros-version.nse — fingerprint RouterOS via HTTP/API/Winbox
  • mikrotik-api-brute.nse — força bruta completa da API (auth 6.x MD5 + 7.x plaintext)
  • mikrotik-default-creds.nse — testa credenciais padrão/vazias
  • mikrotik-api-info.nse — dump autenticado (usuários, serviços, firewall)
  • mikrotik-winbox-cve-2018-14847.nse — verifica divulgação de credenciais Winbox

🚀 Início Rápido

Instalar via pip (recomendado)

# Versão estável mais recente direto do PyPI
pip install mikrotikapi-bf

# Atualizar para a versão mais recente
pip install --upgrade mikrotikapi-bf

# Verificar instalação
mikrotikapi-bf --help
mikrotikapi-bf --nse-path    # caminho dos scripts NSE instalados para o Nmap

Scripts NSE são instalados automaticamente no diretório do Nmap durante o pip install.
Para instalar manualmente: mikrotikapi-install-nse

Instalar do código-fonte (desenvolvimento)

git clone https://github.com/mrhenrike/MikrotikAPI-BF.git
cd MikrotikAPI-BF
pip install -e .          # instalação editável — inclui hook NSE automático
# ou sem o hook:
pip install -r requirements.txt
python mikrotikapi-bf.py --help

Comandos rápidos

# Força bruta básica
python mikrotikapi-bf.py -t 192.168.1.1 -U admin -d wordlists/passwords.lst

# Listas de usuários + senhas
python mikrotikapi-bf.py -t 192.168.1.1 -u users.lst -p passwords.lst

# Multi-alvo a partir de arquivo
python mikrotikapi-bf.py -T targets.lst -d passwords.lst --threads 5

# Scan completo de CVEs (autenticado)
python mikrotikapi-bf.py -t 192.168.1.1 --scan-cve --all-cves -U admin -P senha

# Executar exploit específico por CVE ID
python mikrotikapi-bf.py -t 192.168.1.1 --run-exploit CVE-2018-14847

# Auditoria completa de segurança em 8 fases com saída SARIF
python mikrotikapi-bf.py -t 192.168.1.1 --audit --export sarif -U admin -P senha

# Execução estilo pentest completo
python mikrotikapi-bf.py \
  -t 192.168.1.1 \
  -u wordlists/users.lst -p wordlists/passwords.lst \
  --validate ftp,ssh,telnet \
  --stealth --fingerprint --progress --export-all \
  --threads 5 -vv

# Decodificar user.dat após extração via CVE-2018-14847
python mikrotikapi-bf.py --decode-userdat user.dat --decode-useridx user.idx

# Ataque MAC-Server Layer-2
python mikrotikapi-bf.py --mac-discover --mac-brute -d passwords.lst

Uso com Nmap NSE

# Instalar scripts NSE
cp nse/*.nse /usr/share/nmap/scripts/ && nmap --script-updatedb

# Descoberta completa
nmap -p 80,8291,8728 --script "mikrotik-*" 192.168.1.0/24

# Verificar CVE-2018-14847
nmap -p 8291 --script mikrotik-winbox-cve-2018-14847 192.168.1.1

🗺️ Mapeamento de Superfície de Ataque

Superfície Completa — Status de Cobertura (v3.10.0)

Mapa Completo da Superfície de Ataque MikrotikAPI-BF

Superfície de ataque completa do RouterOS com indicadores de cobertura (✓ coberto / ✗ não coberto)

🟠 Vetores de Acesso

Cobertura dos Vetores de Acesso

Vetor Porta(s) Cobertura Como
telnet TCP/23 ✅ Coberto Validação pós-login
ssh TCP/22 ✅ Coberto Validação pós-login + EDB-28056
web (WebFig/REST) TCP/80, 443 ✅ Coberto Força bruta REST + 10+ exploits CVE/EDB
winbox TCP/8291 ✅ Coberto CVE-2018-14847, CVE-2018-10066, CVE-2021-27263 + NSE
ftp TCP/21 ✅ Coberto Validação pós-login + CVE-2019-3976/3977 + EDB-44450
samba (SMB) TCP/445 ✅ Coberto CVE-2018-7445, CVE-2022-45315
mactel (MAC-Telnet) TCP/20561 ✅ Coberto modules/mac_server.py — MNDP + brute (v3.3.0+)
dude TCP/2210 ❌ Não coberto The Dude — sem PoC
setup/netboot UDP/5000 ❌ Não coberto Apenas acesso físico/LAN
btest TCP/2000 ❌ Não coberto Protocolo não implementado
dhcp/console/USB Vários ❌ Não coberto Fora do escopo ou acesso físico

🔵 Alvos de Acesso

Cobertura dos Alvos de Acesso

📄 Referência de Flags CLI

Consulte a tabela completa de flags no README em inglês ou o Guia Completo (pt-BR) na wiki.

Nota técnica — validação de rate-limiting (2026-04-08)

Teste prático executado em CHR 7.22.1 default-fresh com o mesmo corpus de 30 tentativas:

  • --delay-mode high (0.0s): 3.70 att/s
  • --delay-mode custom -s 0.05: 3.15 att/s
  • --delay-mode balanced (0.25s): 1.85 att/s
  • --delay-mode stealth (1.0s): 0.79 att/s

Teste estendido em high (300 tentativas): 3.68 att/s (estável). Esses números foram usados como insumo de resposta técnica no caso VINCE.

📖 Documentação

Recurso Link
Wiki GitHub (pt-BR) Guia Completo
Wiki GitHub (en-US) Complete Usage Guide
Cobertura EDB EDB-Exploit-Coverage
Scripts NSE nse/README.md
Política de Segurança SECURITY.md
Changelog Releases

⚠️ Aviso Legal

  • Uso — Apenas para educação, pesquisa e testes explicitamente autorizados. Não utilize contra sistemas sem permissão formal por escrito.
  • Sem garantia — Fornecido "no estado em que se encontra" (AS IS) sob Licença MIT.
  • Sem responsabilidade — O(s) autor(es) não respondem por danos, uso indevido ou reclamações de terceiros. O uso é por sua conta e risco.
  • Atribuição — Preserve avisos de copyright. Contribuições via pull requests e issues são bem-vindas.

💬 Suporte

Licenciado sob MIT — ver LICENSE.
Autor: André Henrique (@mrhenrike) · LinkedIn/X: @mrhenrike