Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Écrire des règles Suricata et régler les alertes

Après cette leçon: Je peux écrire une règle Suricata et la régler pour supprimer un faux positif.

Leçon de 65 min6 commandesLab d’ingénierie de la détection : règles Suricata, règles Sigma et journaux à la Zeek dans une VM Ubuntu privée

Une ligne qui surveille chaque paquet

Suricata est un système libre de détection d’intrusion. Il lit le trafic réseau, le compare à des règles et écrit une alerte quand l’une d’elles correspond. Une règle Suricata tient sur une ligne de texte.

Un seul mot mal choisi dans cette ligne peut lever des centaines de fausses alertes par jour. Vous écrivez et réglez des règles sur la capture d’un bureau inventé, dans votre propre copie du labo uniquement.

À la fin de cette leçon

Remarque

Je peux écrire une règle Suricata et la régler pour supprimer un faux positif.

Mots-clés

MotCe que ça veut direExemple
Actionce que fait une règle quand elle correspondalert
Sticky bufferun mot-clé qui choisit la partie du trafic où chercherdns.query
Contentle texte qu’une règle cherche dans cette partie
Ancreun mot-clé qui fixe où le texte doit se trouverendswith
Seuilune limite au nombre d’alertes qu’une règle peut lever
fast.logle fichier d’alertes de Suricata, une ligne par alerte

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

La seule règle

Important

Ne lancez Suricata que sur votre propre copie du labo, ou sur un réseau dont le propriétaire a donné une autorisation écrite. Les captures d’ici sont inventées. Une règle s’écrit pour protéger un réseau, jamais pour surveiller des personnes qui n’y ont pas consenti.

Une règle a un en-tête et des options

Une règle commence par un en-tête : l’action, le protocole, et d’où vient le trafic et où il va. Les options suivent entre parenthèses, chacune terminée par un point-virgule.

Le Run affiche la règle réglée pour les recherches d’updater, le SID 1000002. Le tableau la démonte.

Entrer dans le dossier du labo

Commande
cd ~/detect

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Lire la règle de recherche réglée

Commande
grep "sid:1000002" rules/examples.rules

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Exemple travaillé : les parties de la règle 1000002

PartieDans la règleCe qu’elle veut dire
Action et protocolealert dnsLever une alerte, pour le trafic DNS
De et versany any -> any anyN’importe quelle adresse et quel port, dans un sens ou l’autre
Messagemsg:"updater lookup"Ce que dira l’alerte
Sticky bufferdns.queryNe chercher que dans le nom recherché
Content et ancresdotprefix; content:".cdn-update.example"; endswithLe nom se termine par ce domaine
Identitésid:1000002; rev:1Son numéro et sa version

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Une alerte nomme la règle et le flux

Le premier Run montre les quatre premières alertes sur la capture du bureau. Chaque ligne a l’heure, le SID, le message, le protocole, puis la source et la destination avec leurs ports.

Le second Run garde les alertes du premier essai, la règle 1000001, qui ne viennent pas de la machine infectée, 10.20.1.15. Les trois sont des faux positifs.

Les quatre premières alertes

Commande
det alerts pcaps/office.pcap rules/examples.rules | head -n 4

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Les faux positifs du premier essai

Commande
det alerts pcaps/office.pcap rules/examples.rules | grep "1:1000001:" | grep -v 10.20.1.15

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Une erreur fréquente

Attention

Beaucoup pensent que content correspond à un nom entier. Il correspond n’importe où à l’intérieur, donc "cdn-update" prend aussi cdn-updates.example et cdn-update.example.org. Utilisez endswith pour fixer la fin, et dotprefix pour ne compter que des étiquettes entières.

À vous : tests large et strict

Code: python
noms = ["a1b2.cdn-update.example", "cdn-update.example",
        "cdn-updates.example", "cdn-update.example.org"]

for nom in noms:
    large = "cdn-update" in nom
    strict = ("." + nom).endswith(".cdn-update.example")
    print(nom, "large :", large, "strict :", strict)
# Ajoutez "mycdn-update.example". Quel test réussit-il ?

Un seuil empêche une machine de vous inonder

Updater appelle son serveur chaque minute, donc la règle 1000003 alerte 20 fois pour une seule machine. Une seule alerte dirait la même chose.

La règle 1000004 ajoute threshold: type limit, track by_src, count 1, seconds 3600 : au plus une alerte par machine source et par heure. type threshold alerte plutôt à chaque count-ième correspondance, et type both alerte une fois quand le compte est atteint.

Lire la règle avec un seuil

Commande
grep "sid:1000004" rules/examples.rules

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Comparer les nombres d’alertes

Commande
det count pcaps/office.pcap rules/examples.rules

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

À propos de ce labo et de sa source: Lab d’ingénierie de la détection : règles Suricata, règles Sigma et journaux à la Zeek dans une VM Ubuntu privée

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.