vamp-forticheck

Scanner de CVE para Dispositivos de Borda Multi-Fabricante — VampSecure Labs

🇬🇧 English · 🇪🇸 Español

---

🇬🇧 English

vamp-forticheck é um scanner de segurança assíncrono e não destrutivo que detecta vulnerabilidades CVE em sete grandes fabricantes de segurança de rede. Ele realiza uma análise estruturada em três fases:

1. Detecção passiva — identifica impressões digitais de fabricante e versão de firmware a partir de cabeçalhos de resposta HTTP, banners e artefatos da página de login, sem acionar autenticação.
2. Sondagens semi-ativas de CVE — requisições HTTP direcionadas que confirmam condições específicas de vulnerabilidade, incluindo divulgação de versão, path traversal e indicadores de RCE pré-autenticação.
3. Análise de exposição secundária — verifica interfaces administrativas, APIs de gerenciamento e endpoints de exposição de credenciais expostos no mesmo host.

A cobertura abrange 16 CVEs em 7 fabricantes: FortiOS/FortiGate, Palo Alto PAN-OS, Cisco ASA, Cisco IOS-XE, Check Point Gateway, Juniper Junos e F5 BIG-IP.

---

Recursos

• Varredura totalmente assíncrona via asyncio + aiohttp com concorrência configurável
• Banco de dados de CVE de sete fabricantes, incluindo vulnerabilidades críticas exploradas ativamente
• Aplicação de escopo via arquivo de allowlist — evita sondagens não intencionais fora do escopo
• Pontuação de risco: CVSS × confidence_factor (1.0 para achados confirmados, 0.55 apenas para correspondência de versão)
• Entrada de alvos em massa a partir de arquivo ou argumentos diretos de linha de comando
• Relatório HTML autônomo para entrega ao cliente ou arquivamento
• Relatórios HTML + PDF de nível profissional via o módulo compartilhado vampsec_report

---

Requisitos

Python 3.11+
aiohttp >= 3.9.0
rich >= 13.7.0

Instale as dependências:

pip install -r requirements.txt

Instalação

pip install vamp-forticheck
# or with Homebrew:
brew install vampsecure-labs/labs/vamp-forticheck

git clone https://github.com/Vampsecure-Labs/vamp-forticheck.git
cd vamp-forticheck
pip install -r requirements.txt

Uso

python vamp_forticheck.py [OPTIONS]

Target selection:
  -t, --target HOST [HOST ...]   One or more targets (IP, hostname, or HOST:PORT)
  -i, --input FILE               File with one target per line

Scope:
  -s, --scope FILE               Allowlist file (CIDR blocks, wildcards, or exact hosts)

Performance:
  -c, --concurrency N            Maximum concurrent connections (default: 10)
      --timeout N                Per-request timeout in seconds (default: 10)

Output:
  -o, --output FILE              Write all findings to a JSON file
      --html FILE                Generate a standalone HTML report
  -v, --verbose                  Show detailed probe traces and HTTP responses

Exemplos

Escaneie um único dispositivo de borda e grave um relatório JSON:

python vamp_forticheck.py -t 203.0.113.1 -o results.json

Exibir uma lista de alvos dentro de um escopo definido, com saída HTML e registro detalhado:

python vamp_forticheck.py -i targets.txt -s scope.txt --html report.html -v

Escaneie vários hosts com maior simultaneidade:

python vamp_forticheck.py -t 10.0.0.1 10.0.0.2 10.0.0.254 -c 20 -o findings.json

Examine uma interface de gerenciamento em uma porta não padrão:

python vamp_forticheck.py -t firewall.corp.example:8443 --html firewall_report.html

Formatos de Saída

Formato	Como habilitar	Descrição
Console	Padrão	Tabela detalhada com fornecedor, IDs CVE, pontuação CVSS e nível de risco por host
JSON	-o FILE	Descobertas legíveis por máquina com metadados completos e detalhes da sonda
HTML	--html FILE	Relatório autônomo com tema escuro para visualização no navegador ou arquivamento
Relatório para cliente	Configurado via vampsec_report	HTML executivo + PDF para entrega ao cliente

---

Códigos de Saída

Código	Significado	Uso em CI/CD
0	Nenhuma descoberta — todos os alvos limpos	Aprovar gate
1	Descobertas de risco Médio / Baixo presentes	Revisão recomendada
2	Descobertas de risco Alto / Crítico confirmadas	Reprovar gate — escalar imediatamente

---

Níveis de Risco

Nível	Pontuação calculada
CRITICAL	≥ 9.0
HIGH	≥ 7.0
MEDIUM	≥ 4.0
LOW	> 0.0
INFO	0.0

Pontuação = CVSS_base × confidence_factor. A confiança é 1.0 quando uma sonda confirma a condição de vulnerabilidade, e 0.55 quando a descoberta é baseada apenas na divulgação de versão.

---

Exemplo de Saída

$ python vamp_forticheck.py -i targets.txt -s scope.txt --html report.html -v

 vamp-forticheck v1.2.0 — VampSecure Labs
 Targets: 6  |  Scope file: scope.txt  |  Concurrency: 10

 [Phase 1] Passive detection
  192.168.1.1    FortiOS 7.0.x   (HTTP header + login page artifact)
  192.168.1.254  PAN-OS 10.1.x   (X-FRAME-OPTIONS + GP portal fingerprint)
  10.0.0.1       Cisco IOS-XE    (HTTP/1.1 401 + Server: cisco-IOS)
  10.0.0.254     Cisco ASA       (SSL VPN portal fingerprint)
  10.10.0.1      F5 BIG-IP       (BigIP cookie + TMUI artifact)
  10.10.0.2      Unknown         (no vendor fingerprint matched)

 [Phase 2] CVE probes
  192.168.1.1    CVE-2024-21762  confirmed     (pre-auth RCE — path traversal response)
  192.168.1.1    CVE-2023-27997  confirmed     (heap overflow — SSL-VPN probe positive)
  192.168.1.254  CVE-2024-3400   version-match (PAN-OS 10.1 < 10.1.13-h3)
  10.0.0.1       CVE-2023-20198  confirmed     (HTTP server process — privilege escalation)
  10.10.0.1      CVE-2023-46747  confirmed     (TMUI unauthenticated RCE — 401 bypass)

 [Phase 3] Secondary exposure
  192.168.1.1    Admin interface exposed on port 8443 (HTTPS)
  10.0.0.254     REST API management endpoint /api/cli reachable
  10.10.0.1      iControl REST accessible without authentication

 ─────────────────────────────────────────────────────────────────────────────────
 Host             Vendor      CVEs   Risk score    Level
 192.168.1.1      FortiOS     2      9.6           CRITICAL
 192.168.1.254    PAN-OS      1      6.0 (v-match) HIGH
 10.0.0.1         IOS-XE      1      9.6           CRITICAL
 10.0.0.254       Cisco ASA   0      0.0           INFO
 10.10.0.1        F5 BIG-IP   1      9.6           CRITICAL
 10.10.0.2        Unknown     0      0.0           INFO
 ─────────────────────────────────────────────────────────────────────────────────
 Summary: 3 CRITICAL · 1 HIGH · 0 MEDIUM · 2 INFO
 HTML report: report.html  |  Exit code: 2

Por que vamp-forticheck vs. consulta de CVE do Shodan · Tenable Nessus · Rapid7 Nexpose