Nuclei CVE Analyzer

Ein schnelles CLI-Tool zur Analyse der CVE-Abdeckung in Nuclei-Templates.

Nuclei CVE Analyzer nimmt eine Liste von CVE-IDs, durchsucht ein lokales Nuclei-Template-Repository und ermittelt, für welche CVEs bereits passende Templates existieren und welche potenzielle Lücken in der Template-Abdeckung darstellen.

Entwickelt für Sicherheitsforscher, Schwachstellenjäger und Nuclei-Mitwirkende, die schnell fehlende CVE-Abdeckung identifizieren möchten.

Funktionen

• CVE-IDs aus Textdateien parsen
• CVE-Einträge aus einer lokalen CVE-Datenbank parsen
• Nuclei-YAML/YML-Templates scannen
• Von Nuclei-Templates referenzierte CVEs erkennen
• CVEs ohne passende Templates identifizieren
• CVE-Einträge automatisch deduplizieren
• Multithreaded-CVE-Analyse
• Optionale systemweite CVE-Erkennung
• Ergebnisse als JSON und CSV exportieren
• Separate Berichte für gefundene, fehlende und Template-Nutzung erstellen
• Saubere Terminal-Ausgabe dank Rich

Das Projekt konzentriert sich bewusst auf Template-Abdeckung statt auf externe Schwachstellenbewertung oder Anreicherungsdienste.

Beispiel

Eingabe:

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

Beispielausgabe:

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

Dadurch lassen sich CVEs leicht erkennen, die Kandidaten für neue Nuclei-Templates sein könnten.

Installation

Klonen Sie das Repository:

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

Erstellen Sie eine virtuelle Umgebung:

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

Abhängigkeiten installieren:

pip install -r requirements.txt

Verwendung

Eine CVE-Liste scannen

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

Mehrere Threads verwenden

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

Ergebnisse speichern

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

Das lokale System nach CVE-Referenzen scannen

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

Hilfe anzeigen

python3 nuclei_analyzer.py --help

Argumente

Argument	Beschreibung
-f, --file	Eingabedatei mit CVE-IDs
-n, --nuclei-path	Pfad zum Nuclei-Templates-Verzeichnis
-c, --cve-path	Lokales CVE-Datenbankverzeichnis
-t, --threads	Anzahl der Analyse-Worker-Threads
-o, --output	Kombinierte JSON-Ausgabedatei
--scan-system	Durchsucht gängige Systempfade nach CVE-IDs
-v, --verbose	Aktiviert ausführliches Logging
--log-level	Legt die Logging-Stufe fest

Ausgabe

Der Analyzer erzeugt mehrere Berichte im Ausgabeverzeichnis.

Kombinierte Ergebnisse

Enthält die vollständige Analyse:

output/results_YYYYMMDD_HHMMSS.json

Gefundene CVEs

CVEs aus dem Eingabesatz, für die passende Nuclei-Templates existieren:

output/found_cves.json

Fehlende Templates

CVEs aus dem Eingabesatz ohne passende Templates:

output/missing_templates.json

Verwendete CVEs

Alle CVEs, auf die von den gescannten Nuclei-Templates verwiesen wird:

output/used_cves.json

Prioritätsbericht

Eine gezielte Liste von CVEs, für die derzeit Templates fehlen:

output/priority_report.json

CSV-Ergebnisse

Eine tabellenkalkulationsfreundliche Version der Ergebnisse:

output/results.csv

Beispiel-Workflow

Ein typischer Workflow zur Identifizierung von Template-Lücken:

# 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

Der Analyzer meldet dann, welche CVEs bereits abgedeckt sind und für welche derzeit keine passenden Templates vorhanden sind.

Anwendungsfälle

Nuclei-Mitwirkende

Identifizieren Sie CVEs, für die möglicherweise neue Erkennungstemplates benötigt werden.

Sicherheitsforscher

Vergleichen Sie Schwachstellenlisten schnell mit der bestehenden Nuclei-Abdeckung.

Schwachstellenmanagement

Ermitteln Sie, welche Schwachstellen in einem Datensatz bereits mit Nuclei erkannt werden können.

Forschungsautomatisierung

Verwenden Sie die generierten JSON- oder CSV-Berichte als Eingabe für andere Analyse-Pipelines.

Projektstatus

Dieses Projekt konzentriert sich aktiv auf die CVE-zu-Nuclei-Template-Abdeckungsanalyse.

Das Ziel ist, das Tool leichtgewichtig, schnell und fokussiert zu halten, anstatt es in eine universelle Plattform zur Schwachstellenanreicherung zu verwandeln.

Roadmap

Geplante Verbesserungen umfassen:

• Verbesserte Erkennung von Template-Referenzen
• Analyse von Template-Metadaten
• Qualitätsprüfungen von Templates
• Bessere Erkennung doppelter Templates
• Schnellere Template-Indizierung
• Inkrementelles Scannen
• Zusätzliche Exportformate
• Verbesserte Berichterstellung und Filterung
• Statistiken zur Template-zu-CVE-Abdeckung

Anforderungen

• Python 3.10+
• Rich
• orjson

Installieren Sie die Abhängigkeiten mit:

pip install -r requirements.txt

Mitwirken

Beiträge, Fehlerberichte und Verbesserungen sind willkommen.

Beim Einreichen eines Pull Requests:

1. Halte die Änderungen fokussiert.
2. Bewahre das bestehende CLI-Verhalten, es sei denn, die Änderung modifiziert es absichtlich.
3. Füge eine klare Beschreibung der Änderung hinzu.
4. Teste den Analyzer nach Möglichkeit gegen ein echtes Nuclei-Template-Repository.

Haftungsausschluss

Dieses Projekt ist für Sicherheitsforschung, Schwachstellenanalyse und autorisierte Tests gedacht.

Verwende es nur gegen Systeme, Repositories und Datensätze, deren Analyse du autorisiert bist durchzuführen.

Lizenz

Füge hier die Lizenz deines Projekts hinzu.

---

Nuclei CVE Analyzer
CVE-Abdeckungsanalyse für Nuclei-Templates