Lab d’ingénierie de la détection : règles Suricata, règles Sigma et journaux à la Zeek dans une VM Ubuntu privée
Ce lab donne à chaque élève le travail d’un ingénieur de la détection dans une seule VM Ubuntu : écrire une règle, la tester sur des données dont la réponse est connue, la régler jusqu’à ce qu’elle ne rate rien et reste muette, puis la mesurer. Chaque capture et chaque journal sont inventés pour le lab et écrits à partir de texte fixe, donc tous les élèves voient la même chose, et deux travaux écrits par l’élève sont notés par un script sur du trafic et des journaux qu’il fabrique à chaque fois.
Suricata, le système libre de détection d’intrusion, est le vrai, installé depuis l’archive d’Ubuntu. Les outils Sigma, sigma-cli et pySigma avec un backend SQLite, sont eux aussi les vrais, installés depuis PyPI. Zeek n’est pas dans l’archive d’Ubuntu, donc le lab a zeek-lite, son propre petit modèle de Zeek, qui écrit conn.log, dns.log et http.log au format de Zeek avec une partie de ses champs. Usage défensif uniquement : un élève utilise ces outils sur sa propre copie, et sur un vrai réseau seulement avec une autorisation écrite.
Ce que les élèves apprennent
Comment une détection se fabrique et s’entretient. La capture d’un bureau inventé devient des journaux à la manière de Zeek, lus avec zeek-cut. Des règles Suricata pour un outil inventé appelé updater y sont lancées : un premier essai qui se déclenche sur des noms qui ressemblent seulement à ceux de l’outil, une règle réglée et ancrée avec dotprefix et endswith, et une règle avec un seuil d’une alerte par machine et par heure. Des règles Sigma pour des événements de processus Windows sont converties en SQL et lancées sur une petite table d’événements. Un banc de test lance chaque règle sur une capture known-bad et une capture known-good, et les nombres donnent la précision et le rappel.
Les cinq parties
D’abord la capture sous forme de journaux, avec zeek-lite et zeek-cut. Deuxièmement les règles Suricata d’exemple, comptées et lues avec det, l’aide du lab. Troisièmement les règles Sigma, converties avec sigma convert et lancées avec det sigma. Quatrièmement les captures de test, avec det test. Cinquièmement deux travaux que l’élève écrit : rules/local.rules, des règles Suricata pour un second outil inventé appelé quietbird, et beacon.py, un programme qui trouve dans un conn.log de Zeek les machines qui appellent leur serveur à un rythme régulier. Le commentaire en tête de chacun dit exactement ce qu’il doit faire, et README.md dans le dossier personnel ne donne aucune réponse.
Le lancer dans votre navigateur
Les labs VM se donnent comme tâche de lab dans un module, et l’exemple se trouve sur la page du lab. La machine est petite : un processeur, 1 Go de mémoire et 10 Go de disque. Le setup installe depuis PyPI, qu’un visiteur sans compte ne peut pas joindre, donc le lab demande un compte gratuit ou d’établissement.
- Ajouter le lab. Dans un module que vous enseignez, ajoutez une tâche et choisissez la carte Lab VM Ubuntu. La page affiche une courte description de la machine au lieu d’un fichier compose.
- Partir de l’exemple. La page propose des labs prêts à l’emploi pour démarrer. Choisissez Detection engineering. Utiliser un exemple remplace le texte, et Annuler rend le vôtre.
- Publier et démarrer votre propre copie. Publiez, puis Démarrez. Le script setup du lab installe Suricata depuis l’archive d’Ubuntu et les outils Sigma depuis PyPI, puis écrit les captures, les journaux, les règles, l’aide det et le README, au premier démarrage de la VM, en une minute environ.
- Ouvrir le terminal. Ouvrez son terminal et lisez README.md dans le dossier personnel. Rien ne s’ouvre dans le navigateur : le lab, c’est le terminal.
Une leçon de base sur ce lab
Detection Engineering Basics est une petite leçon donnée dans ce lab, une VM Ubuntu. Elle a une accroche, un objectif « Je peux », des mots-clés, une question de départ, une vérification après chaque idée, une erreur courante et une vérification finale, et chaque étape a un bouton Exécuter qui tape sa commande dans le terminal de la machine. L’élève transforme la capture en journaux, compte les alertes des règles d’exemple, les teste sur les deux captures de test et lance une règle Sigma.
La leçon regarde autour d’elle et laisse à l’élève la tâche propre au lab, les règles de quietbird et le programme de balise : elle ne donne donc aucune réponse. Le module universitaire Ingénierie de la détection avec Sigma, Suricata et Zeek se travaille dans ce lab, avec six leçons et un guide de l’enseignant.
Comment il est noté
Le lab a une vérification. Elle s’exécute sur une copie de la machine enregistrée et fabrique une capture neuve d’un bureau aux machines, aux noms et aux nombres que personne n’a vus : quelques recherches des noms de quietbird, quelques noms ressemblants qui appartiennent à quelqu’un d’autre, et une à trois machines qui envoient encore et encore les appels de quietbird, à côté d’un logiciel dont le nom lui ressemble seulement. Le vrai Suricata lance rules/local.rules dessus, et ne valide qu’une alerte par recherche de quietbird, une par machine infectée quel que soit son nombre d’appels, et rien d’autre. Elle fabrique ensuite un conn.log neuf avec une ou deux balises cachées d’intervalle aléatoire, des leurres et des colonnes dans un nouvel ordre, ainsi qu’un journal calme sans balise : beacon.py doit trouver chaque balise avec son écart médian et son nombre de connexions, et afficher NO BEACON sur le journal calme. Un beacon.py qui lance un autre programme ou lit les fichiers du lab lui-même est refusé. La première ligne de ce que la vérification a affiché dit pourquoi.
- Le distribuer. Attribuez le lab comme n’importe quelle tâche, avec une échéance si vous le souhaitez. Chaque élève reçoit une VM à lui, conservée d’une séance à l’autre.
- Lancer la vérification. Sur la ligne d’un élève dans la liste de la classe, appuyez sur Lancer la vérification. Elle démarre une copie de sa machine enregistrée, qui n’est pas sauvegardée ensuite, exécute le script de vérification du lab en root et indique s’il a réussi, ce qu’il a affiché et quand. L’élève n’est pas informé du résultat.
- Noter. Lisez la première ligne de ce que la vérification a affiché : elle dit ce qui ne va pas, par exemple un nom ressemblant sur lequel une règle a alerté, une machine qui a donné sept alertes au lieu d’une, ou une balise que le programme a manquée. Renvoyez le travail avec un motif s’il faut aller plus loin.
La définition sur GitHub
Le fichier est toute la définition du lab, le texte même que la plateforme exécute : taille, script setup, aide det, générateur des captures et des événements, modèle de Zeek, règles, README et vérification. Copiez-le et changez les outils inventés, les noms ou le bureau pour faire un lab à vous.
Essayer ce lab, et ce qu’il coûte
Un compte personnel gratuit permet de suivre les leçons de base de ce lab, avec chaque mois assez de crédit gratuit pour suivre la plupart des leçons, sans carte. Pour une classe, un établissement a ses 365 premiers jours gratuits pour 50 élèves au plus, puis paie par élève et par an, tous les labs compris et les enseignants gratuits.
Questions fréquentes
- Le lab demande-t-il une licence ?
- Non. Suricata et scapy sont sous GPL-2.0, sigma-cli et pySigma sous LGPL, le backend SQLite sous LGPL-3.0, et SQLite est dans le domaine public. Ils sont installés dans la VM de l’élève à son démarrage, depuis l’archive d’Ubuntu et depuis PyPI : nous n’en distribuons aucun.
- Est-ce le vrai Zeek ?
- Non. Zeek n’est pas dans l’archive d’Ubuntu et n’a aucun binaire sur une source qu’une VM de lab peut joindre, donc le lab a zeek-lite, un court programme Python à nous qui écrit conn.log, dns.log et http.log au format à tabulations de Zeek, avec une partie des noms de champs de Zeek. La lecture des journaux, zeek-cut et les noms de champs sont ceux de Zeek. Le vrai Zeek écrit plus de champs et plus de journaux.
- Les élèves peuvent-ils casser quelque chose ?
- Seulement leur propre copie. Le trafic est produit dans la VM à partir de texte fixe et ne touche jamais un réseau, et la machine joint l’archive d’Ubuntu et l’index des paquets Python, et rien d’autre. Si un élève abîme un fichier, det reset le remet comme il a été donné.
- Le lab a-t-il été testé dans une vraie VM d’élève ?
- Le script setup, les commandes des leçons et la vérification, avec chaque façon de la tromper, ont été exécutés dans un conteneur Ubuntu 26.04 qui tient lieu de VM, sur une machine arm64. Une VM d’élève démarrée et l’installation amd64 méritent un essai avant un cours.