Nuclei CVE Analyzer

Un outil CLI rapide pour analyser la couverture des CVE dans les templates Nuclei.

Nuclei CVE Analyzer prend une liste d'identifiants CVE, analyse un dépôt local de templates Nuclei et détermine quels CVE disposent déjà de templates correspondants et lesquels représentent des lacunes potentielles de couverture par les templates.

Conçu pour les chercheurs en sécurité, les chasseurs de vulnérabilités et les contributeurs de Nuclei qui souhaitent identifier rapidement les CVE non couverts.

Fonctionnalités

• Analyser les identifiants CVE à partir de fichiers texte
• Analyser les enregistrements CVE à partir d'une base de données CVE locale
• Scanner les templates Nuclei YAML/YML
• Détecter les CVE référencés par les templates Nuclei
• Identifier les CVE sans template correspondant
• Dédupliquer automatiquement les entrées CVE
• Analyse CVE multithread
• Découverte CVE à l'échelle du système en option
• Exporter les résultats au format JSON et CSV
• Générer des rapports distincts pour les CVE trouvés, manquants et l'utilisation des templates
• Sortie terminal propre propulsée par Rich

Le projet se concentre délibérément sur la couverture des templates plutôt que sur des services externes de notation ou d'enrichissement des vulnérabilités.

Exemple

Entrée :

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

Exemple de sortie :

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

Cela facilite le repérage des CVE qui pourraient être candidates à de nouveaux templates Nuclei.

Installation

Clonez le dépôt :

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

Créez un environnement virtuel :

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

Installez les dépendances :

pip install -r requirements.txt

Utilisation

Analyser une liste de CVE

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

Utiliser plusieurs threads

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

Enregistrer les résultats

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

Analyser le système local à la recherche de références CVE

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

Afficher l'aide

python3 nuclei_analyzer.py --help

Arguments

Argument	Description
-f, --file	Fichier d'entrée contenant les identifiants CVE
-n, --nuclei-path	Chemin vers le répertoire des templates Nuclei
-c, --cve-path	Répertoire de la base de données CVE locale
-t, --threads	Nombre de threads de travail d'analyse
-o, --output	Fichier de sortie JSON combiné
--scan-system	Rechercher les identifiants CVE dans les emplacements système courants
-v, --verbose	Activer la journalisation détaillée
--log-level	Définir le niveau de journalisation

Output

L'analyseur génère plusieurs rapports dans le répertoire de sortie.

Combined Results

Contient l'analyse complète :

output/results_YYYYMMDD_HHMMSS.json

CVE trouvées

CVE de l'ensemble d'entrée pour lesquelles des templates Nuclei correspondants existent :

output/found_cves.json

Modèles manquants

CVE de l'ensemble d'entrée sans modèles correspondants :

output/missing_templates.json

CVE utilisées

Toutes les CVE référencées par les modèles Nuclei analysés :

output/used_cves.json

Rapport de priorité

Une liste ciblée de CVE actuellement dépourvues de templates :

output/priority_report.json

Résultats CSV

Une version des résultats adaptée aux tableurs :

output/results.csv

Exemple de flux de travail

Un flux de travail typique pour identifier les lacunes de modèles :

# 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'analyseur indique ensuite quels CVE sont déjà couverts et lesquels ne disposent pas actuellement de templates correspondants.

Cas d'usage

Contributeurs Nuclei

Identifier les CVE qui pourraient nécessiter de nouveaux templates de détection.

Chercheurs en sécurité

Comparer rapidement des listes de vulnérabilités avec la couverture Nuclei existante.

Gestion des vulnérabilités

Déterminer quelles vulnérabilités d'un jeu de données peuvent déjà être détectées à l'aide de Nuclei.

Automatisation de la recherche

Utiliser les rapports JSON ou CSV générés comme entrée pour d'autres pipelines d'analyse.

État du projet

Ce projet est activement axé sur l'analyse de la couverture des templates CVE vers Nuclei.

L'objectif est de maintenir l'outil léger, rapide et ciblé plutôt que de le transformer en une plateforme d'enrichissement de vulnérabilités à usage général.

Feuille de route

Les améliorations prévues incluent :

• Détection améliorée des références de templates
• Analyse des métadonnées des templates
• Contrôles de qualité des templates
• Meilleure détection des templates en double
• Indexation plus rapide des templates
• Analyse incrémentielle
• Formats d'export supplémentaires
• Rapports et filtrage améliorés
• Statistiques de couverture templates-vers-CVE

Prérequis

• Python 3.10+
• Rich
• orjson

Installez les dépendances avec :

pip install -r requirements.txt

Contribution

Les contributions, les rapports de bogues et les améliorations sont les bienvenus.

Lors de la soumission d'une pull request :

1. Gardez les modifications ciblées.
2. Préservez le comportement existant de la CLI, sauf si la modification le modifie intentionnellement.
3. Incluez une description claire de la modification.
4. Testez l'analyseur sur un dépôt réel de templates Nuclei lorsque cela est possible.

Avertissement

Ce projet est destiné à la recherche en sécurité, à l'analyse de vulnérabilités et aux tests autorisés.

Utilisez-le uniquement contre des systèmes, des dépôts et des jeux de données que vous êtes autorisé à analyser.

Licence

Ajoutez ici la licence de votre projet.

---

Nuclei CVE Analyzer
Analyse de la couverture CVE pour les templates Nuclei