Aller au contenu

Cheatsheet · Pentest web · Pentest infra et AD

Nuclei : scan de vulnérabilités par modèles, sélection, débit et faux positifs

Nuclei pour un scan de vulnérabilités autorisé : mise à jour des modèles, sélection par tags et gravité, débit, exclusions, sorties JSONL et faux positifs.

Par Steven Carrier Publié le

Site officiel : Nuclei

Nuclei envoie à des cibles des requêtes décrites par des modèles YAML (templates) et signale les réponses qui correspondent à une exposition, une mauvaise configuration ou une vulnérabilité connue. C’est un scanner : il produit des constats à vérifier, pas des preuves. Les options ci-dessous correspondent à la CLI actuelle ; confirmez-les avec nuclei -h sur votre version. Ne scannez que le périmètre validé avec la checklist de cadrage d’un pentest, et remplacez https://cible.example par votre cible. Pour repérer d’abord les services exposés, voir la cheatsheet Nmap.

Mettre à jour et explorer les modèles

# Version de Nuclei, puis version des modèles installés
nuclei -version
nuclei -templates-version

# Mettre à jour les modèles
nuclei -update-templates

# Lister les tags disponibles, puis les modèles qui correspondent à un filtre
nuclei -tgl
nuclei -tl -tags exposure -severity medium,high,critical

Les modèles sont écrits par la communauté et changent souvent. Notez dans le rapport la version de Nuclei et celle des modèles, pour que le scan soit reproductible. Relisez un modèle (-t chemin/modele.yaml) avant de l’utiliser sur un client : ce qu’il envoie doit être acceptable en production.

Lancer un premier scan

# Une cible
nuclei -u https://cible.example

# Une liste de cibles (une par ligne)
nuclei -l cibles.txt

# Seulement les constats, sans le bandeau ni les statistiques
nuclei -u https://cible.example -silent

# En-tête ou cookie imposé à toutes les requêtes HTTP (compte de test)
nuclei -u https://cible.example -H "Cookie: session=VALEUR"

Le premier passage doit rester limité : une gravité minimale, quelques tags, un débit réduit. Un scan sans filtre lance des milliers de requêtes.

Sélectionner les modèles

# Par gravité (info, low, medium, high, critical, unknown)
nuclei -u https://cible.example -severity high,critical

# Par tags
nuclei -u https://cible.example -tags exposure,misconfig,tech

# Par identifiant (jokers acceptés)
nuclei -u https://cible.example -id "git-config,CVE-2021-*"

# Un dossier ou un fichier de modèles précis
nuclei -u https://cible.example -t http/exposures/

# Détection automatique de la technologie, puis modèles associés
nuclei -u https://cible.example -automatic-scan
Option Rôle
-tags / -etags (-exclude-tags) inclure ou exclure par tag
-severity / -exclude-severity filtrer par gravité
-id / -exclude-id inclure ou exclure par identifiant
-t fichier ou dossier de modèles
-exclude-type exclure un protocole (dns, http, headless, tcp…)
-new-templates seulement les modèles de la dernière version

La forme longue -exclude-tags et la forme courte -etags désignent la même option. Vérifiez toujours la liste obtenue avec -tl avant de lancer.

Régler le débit et la charge

# 20 requêtes par seconde au plus, 10 modèles en parallèle, 10 hôtes en parallèle
nuclei -u https://cible.example -rate-limit 20 -concurrency 10 -bulk-size 10

# Délais et reprises
nuclei -u https://cible.example -timeout 10 -retries 1 -rate-limit 20

Par défaut, -rate-limit vaut 150 requêtes par seconde, -concurrency et -bulk-size valent 25 : c’est trop pour beaucoup d’applications de production. Convenez d’un débit avec le client, surveillez les codes 429 et 5xx, et arrêtez le scan en cas de dégradation. -max-host-error (30 par défaut) abandonne un hôte qui multiplie les erreurs ; ne le désactivez pas (-no-mhe) sur un service fragile.

Écarter les modèles intrusifs

# Exclure des familles de modèles à risque
nuclei -u https://cible.example -exclude-tags dos,intrusive,fuzz,default-login

# Exclure des protocoles ou des modèles précis
nuclei -u https://cible.example -exclude-type headless -exclude-id "identifiant-a-ecarter"

# Sans serveur OAST externe (interactsh) : exclut les modèles qui en dépendent
nuclei -u https://cible.example -no-interactsh

Les noms de tags évoluent : listez-les avec -tgl et contrôlez avec -tl ce qui sera réellement exécuté. Un tag comme dos ou intrusive signale des modèles susceptibles de perturber un service, et default-login des modèles qui essaient des identifiants par défaut (tentatives d’authentification, risque de verrouillage) ; l’absence de tag ne garantit pas l’innocuité. Les modèles DAST (-dast) envoient des charges de test dans les paramètres, et les modèles -headless pilotent un navigateur : n’activez ni l’un ni l’autre sans accord explicite, et idéalement d’abord sur un environnement de recette. Par défaut, certains modèles utilisent un serveur OAST public : vérifiez que l’accord avec le client l’autorise, sinon utilisez -no-interactsh.

Enregistrer les résultats

# JSONL (une ligne JSON par constat) dans un fichier
nuclei -u https://cible.example -jsonl -output resultats.jsonl

# Rapports Markdown exportés dans un dossier
nuclei -u https://cible.example -markdown-export rapport-nuclei

# Voir les requêtes et réponses échangées (diagnostic)
nuclei -u https://cible.example -id git-config -debug

# Faire passer le trafic par Burp
nuclei -u https://cible.example -proxy http://127.0.0.1:8080

Le JSONL se traite bien avec jq ou un tableur et s’importe dans un outil de suivi. Conservez-le avec la commande exacte, la date et les versions. Passer par un proxy de test aide à relire les échanges : voir la cheatsheet Burp Suite.

Traiter les faux positifs

Tout constat Nuclei est une hypothèse. Avant de le rapporter :

  1. Relisez le modèle : que teste-t-il exactement, et quel matcher s’est déclenché ?
  2. Rejouez la requête à la main (-debug, puis curl ou Repeater) et lisez la réponse complète.
  3. Vérifiez le contexte : une page d’erreur personnalisée ou un WAF peut renvoyer un 200 à tout.
  4. Confirmez la version ou la configuration réelle du composant par une autre source.
  5. Écartez durablement un modèle bruyant avec -exclude-id, en le notant dans le rapport.

Les constats de gravité info (technologies détectées, en-têtes) aident à cartographier la surface mais ne sont pas des vulnérabilités. Classez et priorisez le reste avec le client, sans reprendre telle quelle la gravité du modèle.

Sources

Ressources liées

  • Méthodologie · Pentest web · Pentest infra et AD · Cloud

    Cadrage d’un pentest

    Checklist de cadrage d’un test d’intrusion : périmètre, autorisations écrites, contacts d’urgence, comptes de test et gestion des données.

    Publié le

  • Outil · Pentest web · Pentest infra et AD

    Calculateur CVSS 3.1

    Calculez le score de base CVSS 3.1 d’une vulnérabilité, sa sévérité et son vecteur, ou collez un vecteur existant pour le relire. Calcul local.

    Publié le

  • Cheatsheet · Pentest infra et AD · Pentest web

    Cheatsheet Nmap

    Commandes Nmap prêtes à copier : découverte d’hôtes, scan de ports TCP et UDP, détection de versions, scripts NSE et formats de sortie.

    Publié le

BEAROPS

Besoin d’un test d’intrusion ?

Les experts BEAROPS testent vos applications, votre infrastructure et votre cloud, en boîte noire ou grise, selon les référentiels de l’OWASP, du NIST et de l’ANSSI.