# Khaos Cve Hunt

> Workflow for discovering internet-exposed hosts affected by a specific CVE, from enrichment through host discovery to nuclei-based verification, using free public data sources.

- Skill: `henriqqw/khaos-cve-hunt` (Agent Skill)
- Install (CLI): `npx get-skill add henriqqw/khaos-cve-hunt`
- Raw SKILL.md: https://api.skillmd.com/api/skills/henriqqw/khaos-cve-hunt/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: henriqqw (https://skillmd.com/u/henriqqw)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/henriqqw/khaos-cve-hunt

---


# CVE Hunt — Descoberta de Hosts Expostos por CVE

Dado um CVE ID, este workflow encontra hosts internet-expostos executando a tecnologia afetada e verifica vulnerabilidade via nuclei. Usa exclusivamente fontes gratuitas sem autenticação como baseline, com escalonamento opcional para engines pagas.

## Pré-condições

- Assessment criado com scope adequado (ou escopo global para hunting proativo).
- `cvemap` instalado: `khaos_install_tool("cvemap")`.
- `uncover` instalado: `khaos_install_tool("uncover")`.
- `nuclei` instalado com templates atualizados.
- Authorization plan documentado — hunting proativo requer autorização explícita do operador.

## Fase 1 — Enriquecimento do CVE

**Objetivo**: obter metadados, CPEs afetados, severidade EPSS e verificar se existe template nuclei.

### 1.1 Buscar metadados via cvemap

```
tool_id: cvemap
target_url: https://cve-hunt.local/enrich?cve=CVE-XXXX-XXXXX
```

O cvemap retorna JSON com:
- `cve_id`, `severity`, `cvss_score`, `cvss_metrics`
- `epss.epss_score` — probabilidade de exploração em 30 dias (>0.7 = alta prioridade)
- `kev` — `is_kev: true` = confirmado explorado em produção (CISA KEV)
- `nuclei_templates[]` — se existe template official para este CVE
- `poc` — PoCs conhecidos no GitHub

### 1.2 Extrair a query de discovery

Prioridade decrescente para construir a query de busca:

1. **Nuclei template metadata** (melhor): abra o template do CVE em `data/tools/nuclei-templates/http/cves/XXXX/CVE-XXXX-XXXXX.yaml` e leia os campos:
   - `metadata.shodan-query` → use diretamente como query Shodan
   - `metadata.fofa-query` → use como query FOFA
   - `metadata.zoomeye-query` → use como query ZoomEye

2. **CPE-based query** (fallback): do JSON do cvemap, extraia `affected_products[].product` e construa:
   - Shodan: `product:"<product_name>"` ou `title:"<product_name>"`
   - Exemplo: `product:"Apache Log4j"` para Log4Shell

3. **CVE direto via shodan-idb** (mínimo): `vuln:CVE-XXXX-XXXXX`
   - Shodan InternetDB gratuito, sem API key, cobertura limitada mas funcional

### 1.3 Verificar no Shodan CVEDB (opcional, sem auth)

A API pública `https://cvedb.shodan.io/cve/{id}` retorna:
- `epss_score`, `kev`, `cpes[]`, `references[]`
- Use `khaos_http_request` para consultar diretamente se cvemap não estiver disponível

## Fase 2 — Discovery de Hosts Expostos

**Objetivo**: encontrar IPs/hosts internet-expostos executando a tecnologia vulnerável.

### IMPORTANTE: Engines e tipos de query

| Engine | Query suportada | Chave necessária |
|--------|----------------|-----------------|
| `shodan-idb` | Apenas IP/CIDR — **NÃO suporta `vuln:`** | Não |
| `shodan` | `vuln:CVE-XXX`, `product:"..."`, `cpe:"..."` | Sim (pago) |
| `censys` | `services.software: (vendor:"..." and product:"...")` | Sim (free tier) |
| `fofa` | `app="..."`, `title="..."` | Sim (free tier) |
| `hunter` | `"product name"` | Sim (pago) |

**`shodan-idb` aceita apenas IP/CIDR** (lookup de CVEs para um IP específico). Para descoberta CVE→hosts, use `shodan` (pago) ou queries de produto nas engines acima.

### 2.1 Estratégia gratuita — queries de produto (sem API key)

Sem API keys, use `khaos_cve_hunt_queries` para obter queries de produto dos CPEs, depois execute manualmente ou configure API keys:

```
# Exemplo FortiOS CVE-2024-55591 (strategy=cpe, primeiro CPE part=a: fortiproxy)
uncover -q 'cpe:"cpe:/a:fortinet:fortiproxy"' -e shodan -limit 100  # requer API key Shodan
uncover -q 'services.software: (vendor:"Fortinet" and product:"Fortiproxy")' -e censys -limit 100
uncover -q 'app="Fortinet Fortiproxy"' -e fofa -limit 100
```

### 2.2 Estratégia com API key Shodan (melhor cobertura)

Com `SHODAN_API_KEY` configurado no assessment:
```
tool_id: uncover
target_url: https://cve-hunt.local/discover?q=vuln%3ACVE-XXXX-XXXXX&e=shodan&limit=100
```

A query `vuln:CVE-XXXX-XXXXX` no **Shodan full** retorna todos os hosts que o Shodan indexou com aquela CVE. Cobertura muito superior ao shodan-idb.

### 2.3 Processar resultado

O uncover retorna JSONL com campos: `ip`, `port`, `host`, `url`.

Construa a lista de targets para verificação:
- Priorize entradas com `host` (FQDN) em vez de IP puro
- Normalize para `https://host:port` ou `http://host:port` baseado na porta

## Fase 3 — Verificação com Nuclei

**Objetivo**: confirmar vulnerabilidade em cada host descoberto.

### 3.1 Executar nuclei com template específico do CVE

Se cvemap retornou `nuclei_templates[]` com o CVE:

```
tool_id: nuclei
target_url: https://<host-do-uncover>/
# Adicione -id CVE-XXXX-XXXXX via params
```

No Khaos, o nuclei por padrão usa `-as` (auto-select por tecnologia). Para CVE hunt, force o template específico via params:
- Passe o host descoberto como `endpoint_url`
- Registre a verificação como evidence

### 3.2 Regras de validação

- **Nunca** marque como `validated` apenas com base no resultado do uncover — isso é uma observação passiva.
- Para validação, o nuclei precisa retornar `matched: true` com evidência no request/response.
- Exige 3 reproduções independentes para `validated` (padrão Khaos).
- Hosts em scopes de terceiros não-autorizados devem ser registrados como `informational` apenas.

## Fase 2 — Geração Automática de Queries via khaos_cve_hunt_queries (MCP)

**Objetivo**: obter queries otimizadas para cada engine a partir do CPE extraído do Shodan CVEDB.

### 2.0 Chamar khaos_cve_hunt_queries antes do uncover

```
khaos_cve_hunt_queries(assessment_id=..., cve_id="CVE-XXXX-XXXXX")
```

A resposta inclui:
- `cvedb` — EPSS score, KEV status, CPEs brutos (Shodan CVEDB, sem auth)
- `cpes[]` — CPEs parseados (Part/Vendor/Product/Version)
- `queries` — queries prontas por engine:
  - `shodan_idb` — para `uncover -e shodan-idb` (gratuito)
  - `shodan` — para `uncover -e shodan` (pago)
  - `censys` — para `uncover -e censys` (pago)
  - `fofa` — para `uncover -e fofa` (pago)
  - `hunter` — para `uncover -e hunter` (pago)
- `strategy` — `"cpe"` quando CPE foi encontrado, `"cve-id-only"` quando só o CVE-ID direto está disponível
- `nuclei_template` — caminho local do template se existir em disco

### 2.1 Usar a query gerada no uncover

**Com API key Shodan (melhor cobertura — suporta `vuln:`):**
```
tool_id: uncover
target_url: https://cve-hunt.local/discover?q=vuln%3ACVE-XXXX-XXXXX&e=shodan&limit=100
```

**Com API key Censys/FOFA (usar queries CPE geradas):**
```
# strategy="cpe": usar queries.censys ou queries.fofa de khaos_cve_hunt_queries
target_url: https://cve-hunt.local/discover?q=<queries.censys>&e=censys&limit=100
```

**Sem API keys (somente shodan-idb disponível):**
> `shodan-idb` só aceita IP/CIDR, não suporta queries de CVE ou produto.
> Configure pelo menos uma API key de engine de busca para host discovery efetivo.

### 2.2 Escalonamento para engines pagas

Substitua `shodan_idb` pela engine correspondente e configure a API key via `khaos_configure_auth_profiles`. Use `queries.shodan` para Shodan full, `queries.censys` para Censys, etc. As queries já estão no formato nativo de cada engine.

## Fluxo Completo (Resumo)

```
1. khaos_cve_hunt_queries(cve_id=CVE-XXXX-XXXXX)   → EPSS + KEV + CPE + queries por engine
2. cvemap -id CVE-XXXX-XXXXX -json                  → nuclei template + PoCs adicionais
3. uncover -q "<queries.shodan_idb>" -e shodan-idb  → lista de hosts expostos
4. httpx -list hosts.txt -json                      → confirmar serviços ativos
5. nuclei -id CVE-XXXX-XXXXX -list urls.txt         → verificar vulnerabilidade
6. Registrar findings com evidência
```

## Critérios de Priorização

Priorize hosts para verificação manual quando:
- `epss_score > 0.70` — alta probabilidade de exploração ativa
- `kev.is_kev = true` — confirmado explorado em produção
- Host retorna serviço ativo no httpx (não apenas IP de scanner)
- Template nuclei com severidade `critical` ou `high`

## Limitações do Shodan-IDB (Free Tier)

- Dados são snapshot — podem ter 2-7 dias de delay
- Sem filtros avançados (versão exata, country, ASN)
- Limite de 100 resultados por query sem API key
- Para targeting mais preciso, configure API keys no assessment via `khaos_configure_auth_profiles`

## Notas de Segurança Operacional

- Resultados do uncover são dados de terceiros — trate como hipóteses, não facts
- Nunca execute nuclei contra hosts fora do scope autorizado
- Documente a fonte de cada host (shodan-idb snapshot + data) no finding
- Para hunting proativo em bug bounty, verifique sempre o scope do programa antes de qualquer verificação ativa

