Nuclei CVE Analyzer

Uno strumento CLI veloce per analizzare la copertura CVE nei template Nuclei.

Nuclei CVE Analyzer prende un elenco di ID CVE, analizza un repository locale di template Nuclei e determina quali CVE hanno già template corrispondenti e quali rappresentano potenziali lacune nella copertura dei template.

Realizzato per ricercatori di sicurezza, cacciatori di vulnerabilità e contributori di Nuclei che desiderano un modo rapido per identificare la copertura CVE mancante.

Funzionalità

• Analizza gli ID CVE da file di testo
• Analizza i record CVE da un database CVE locale
• Analizza i template Nuclei YAML/YML
• Rileva i CVE referenziati dai template Nuclei
• Identifica i CVE senza template corrispondenti
• Deduplica automaticamente le voci CVE
• Analisi CVE multithread
• Scoperta CVE opzionale a livello di sistema
• Esporta i risultati in JSON e CSV
• Genera report separati per trovati, mancanti e utilizzo dei template
• Output terminale pulito grazie a Rich

Il progetto si concentra deliberatamente sulla copertura dei template anziché su servizi esterni di scoring o arricchimento delle vulnerabilità.

Esempio

Input:

CVE-2021-44228
CVE-2021-45046
CVE-2022-26134
CVE-2023-21840
CVE-2023-22809

Esempio di output:

CVE             STATUS
CVE-2021-44228  FOUND
CVE-2021-45046  FOUND
CVE-2022-26134  FOUND
CVE-2023-21840  MISSING
CVE-2023-22809  MISSING

Questo rende facile individuare le CVE che potrebbero essere candidate per nuovi template Nuclei.

Installazione

Clona il repository:

git clone https://github.com/YOUR_USERNAME/nuclei-cve-analyzer.git
cd nuclei-cve-analyzer

Creare un ambiente virtuale:

python3 -m venv .venv
source .venv/bin/activate

Installa le dipendenze:

pip install -r requirements.txt

Utilizzo

Scansiona un elenco di CVE

python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -n /path/to/nuclei-templates

Usa più thread

python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -t 16 \
    -n /path/to/nuclei-templates

Salva i risultati

python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -t 16 \
    -o output/results.json \
    -n /path/to/nuclei-templates

Scansiona il sistema locale alla ricerca di riferimenti CVE

python3 nuclei_analyzer.py \
    --scan-system \
    -n /path/to/nuclei-templates

Mostra aiuto

python3 nuclei_analyzer.py --help

Argomenti

Argomento	Descrizione
-f, --file	File di input contenente gli ID CVE
-n, --nuclei-path	Percorso della directory dei template Nuclei
-c, --cve-path	Directory del database CVE locale
-t, --threads	Numero di thread worker per l'analisi
-o, --output	File di output JSON combinato
--scan-system	Cerca gli ID CVE nelle posizioni di sistema comuni
-v, --verbose	Abilita la registrazione dettagliata
--log-level	Imposta il livello di registrazione

Output

L'analizzatore genera diversi report all'interno della directory di output.

Risultati combinati

Contiene l'analisi completa:

output/results_YYYYMMDD_HHMMSS.json

CVE trovati

CVE dell'insieme di input che hanno template Nuclei corrispondenti:

output/found_cves.json

Template mancanti

CVE dell'insieme di input senza template corrispondenti:

output/missing_templates.json

CVE utilizzate

Tutte le CVE referenziate dai template Nuclei scansionati:

output/used_cves.json

Report sulle priorità

Un elenco mirato di CVE attualmente privi di template:

output/priority_report.json

Risultati CSV

Una versione dei risultati adatta ai fogli di calcolo:

output/results.csv

Flusso di lavoro di esempio

Un flusso di lavoro tipico per identificare le lacune nei template:

# Prepare a list of CVEs
cat example_cves.txt

# Scan the Nuclei repository
python3 nuclei_analyzer.py \
    -f example_cves.txt \
    -t 16 \
    -n ~/nuclei-templates

L'analizzatore riporta quindi quali CVE sono già coperti e quali attualmente non dispongono di template corrispondenti.

Casi d'uso

Contributori di Nuclei

Identificare i CVE che potrebbero necessitare di nuovi template di rilevamento.

Ricercatori di sicurezza

Confrontare rapidamente gli elenchi di vulnerabilità con la copertura esistente di Nuclei.

Gestione delle vulnerabilità

Determinare quali vulnerabilità in un dataset possono già essere rilevate utilizzando Nuclei.

Automazione della ricerca

Utilizzare i report JSON o CSV generati come input per altre pipeline di analisi.

Stato del progetto

Questo progetto è attivamente incentrato sull'analisi della copertura dei template CVE-to-Nuclei.

L'obiettivo è mantenere lo strumento leggero, veloce e mirato, anziché trasformarlo in una piattaforma generica di arricchimento delle vulnerabilità.

Roadmap

I miglioramenti pianificati includono:

• Rilevamento migliorato dei riferimenti ai template
• Analisi dei metadati dei template
• Controlli di qualità dei template
• Migliore rilevamento dei template duplicati
• Indicizzazione più rapida dei template
• Scansione incrementale
• Formati di esportazione aggiuntivi
• Reporting e filtraggio migliorati
• Statistiche di copertura template-to-CVE

Requisiti

• Python 3.10+
• Rich
• orjson

Installa le dipendenze con:

pip install -r requirements.txt

Contribuire

Contributi, segnalazioni di bug e miglioramenti sono benvenuti.

Quando invii una pull request:

1. Mantieni le modifiche mirate.
2. Preserva il comportamento esistente della CLI a meno che la modifica non lo modifichi intenzionalmente.
3. Includi una descrizione chiara della modifica.
4. Verifica l'analyzer su un repository reale di template Nuclei, ove possibile.

Disclaimer

Questo progetto è destinato alla ricerca sulla sicurezza, all'analisi delle vulnerabilità e ai test autorizzati.

Utilizzalo solo su sistemi, repository e dataset che sei autorizzato ad analizzare.

Licenza

Aggiungi qui la licenza del tuo progetto.

---

Nuclei CVE Analyzer
Analisi della copertura CVE per i template Nuclei