Accueil » Formations » Administration sécurité » Introduction à CrowdSec » TP07 – Tester les parseurs avec cscli explain et écrire une whitelist

TP07 – Tester les parseurs avec cscli explain et écrire une whitelist

← Introduction à CrowdSec

// travaux pratiques · Administration sécurité

TP07 - Tester les parseurs avec cscli explain et écrire une whitelist

  • TP 7 / 8
  • 5 étapes
  • ≈ 40 min
  • Accès libre

Objectif : diagnostiquer le traitement d’une ligne de journal avec cscli explain, écrire une whitelist de parsing pour une adresse de confiance et la valider, puis remettre en place la protection par défaut des adresses privées.

Prérequis :

  • Le laboratoire des TP précédents, avec Nginx surveillé (TP04).

Actions à réaliser :

  1. Expliquer le traitement de journaux SSH et Nginx. Sur crowdsec :

    sudo tail -n 5 /var/log/auth.log | sudo cscli explain --type syslog -f -
    sudo tail -n 3 /var/log/nginx/access.log | sudo cscli explain --type nginx -f -

    Pour chaque ligne, repérez les étapes s00-raw, s01-parse et s02-enrich et les parseurs qui ont réussi. Ajoutez -v pour voir le détail des champs extraits.

  2. Écrire une whitelist de parsing. Créez le fichier /etc/crowdsec/parsers/s02-enrich/01-labo-whitelist.yaml :

    sudo nano /etc/crowdsec/parsers/s02-enrich/01-labo-whitelist.yaml
    name: azur/labo-whitelist
    description: "Ignorer la machine d'audit du laboratoire"
    whitelist:
      reason: "Machine d'audit"
      ip:
        - "10.0.2.20"
    sudo systemctl restart crowdsec
  3. Valider la whitelist. Depuis attaquant, générez une requête web (curl -I http://10.0.2.10/), puis sur crowdsec :

    grep 10.0.2.20 /var/log/nginx/access.log | tail -n 1 | sudo cscli explain -f- --type nginx

    La sortie doit montrer la whitelist et se terminer par une ligne indiquant que l’événement a été ignoré.

  4. Rejouer une attaque. Relancez l’exploration du TP04 depuis attaquant et vérifiez qu’aucune nouvelle décision n’est créée :

    sudo cscli decisions list -i 10.0.2.20
  5. Revenir à une configuration de production. Supprimez la whitelist de laboratoire et réinstallez le parseur par défaut :

    sudo rm /etc/crowdsec/parsers/s02-enrich/01-labo-whitelist.yaml
    sudo cscli parsers install crowdsecurity/whitelists
    sudo systemctl restart crowdsec
    sudo cscli parsers list

Vérification / résultat attendu :

  • cscli explain affiche, ligne par ligne, les parseurs franchis avec succès.
  • Avec la whitelist active, les requêtes de 10.0.2.20 sont ignorées et ne produisent aucune décision.
  • À la fin du TP, crowdsecurity/whitelists figure de nouveau dans la liste des parseurs.

Pour aller plus loin : écrivez une whitelist à base d’expression qui ignore uniquement les requêtes GET /health d’une sonde de supervision, et testez-la avec cscli explain avant de l’activer.

// formation sur mesure

Former votre équipe sur ce sujet ?

Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.

Demander un programme
Défiler vers le haut