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 Sigma pour les journaux

Après cette leçon: Je peux écrire une règle Sigma pour des événements de processus et la convertir en requête.

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

Écrire la règle une fois, chercher partout

Sigma est un format ouvert pour écrire des détections sur des journaux, en YAML. Un convertisseur transforme une règle Sigma dans le langage de requête de l’outil de recherche qu’utilise une équipe.

Les équipes partagent des règles Sigma parce qu’une règle écrite une fois peut tourner à plusieurs endroits. Vous écrivez des règles pour les événements Windows d’un bureau inventé, dans votre propre copie du labo uniquement.

À la fin de cette leçon

Remarque

Je peux écrire une règle Sigma pour des événements de processus et la convertir en requête.

Mots-clés

MotCe que ça veut direExemple
Sigmaun format ouvert pour les détections sur journaux, écrit en YAML
Source de journauxle genre de journal visé par une règleprocess_creation
Sélectionun groupe nommé de tests de champs qui doivent tous réussir
Modificateurun mot placé après un champ, qui change la comparaisonendswith
Conditionla façon dont les sélections se combinent en correspondance
Backendla partie qui transforme une règle en un langage de recherche

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

La seule règle

Important

Ces événements sont inventés pour le labo. Ne cherchez dans de vrais journaux que sur des systèmes dont vous avez la charge ou une autorisation écrite. Les journaux sur le travail des gens sont des données personnelles : ne lisez que ce que la tâche demande.

Une règle Sigma dit où et quoi

Une règle Sigma a une source de journaux, le genre de journal qu’elle lit, et une détection. La détection contient des sélections nommées et une condition qui les combine.

Le Run affiche une règle pour une attaque classique : un fichier Word ou Excel qui lance PowerShell avec une commande encodée. Chaque test de champ a un modificateur après une barre.

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 une règle Sigma

Commande
cat sigma/office-powershell.yml

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

PartieDans la règleCe qu’elle veut dire
Source de journauxprocess_creation, windowsLire les événements de démarrage de processus Windows
Sélection parentParentImage|endswith, deux valeursLancé par Word ou par Excel
Sélection childImage|endswith et CommandLine|containsPowerShell, avec " -enc " dans sa commande
Conditionparent and childLes deux sélections doivent réussir
Tagsattack.t1059.001La technique ATT&CK qu’elle détecte

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

Un backend transforme la règle en requête

sigma convert utilise un backend pour transformer une règle en un langage de recherche. Le labo a le backend SQLite, donc la règle devient du SQL. Repérez endswith devenu LIKE avec un % devant, une liste devenue OR, et une sélection devenue AND.

Le second Run convertit la règle et exécute le SQL sur les 41 événements du labo. Un seul événement correspond.

Convertir la règle en SQL

Commande
sigma convert -t sqlite sigma/office-powershell.yml

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

Lancer la règle sur les événements

Commande
det sigma sigma/office-powershell.yml

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 Sigma est un programme qui fouille les journaux. C’est un format. Un backend convertit la règle dans le langage de recherche de l’outil qui garde les journaux. La même règle devient du SQL ici, et une autre requête pour un autre outil.

Tester une règle sur tout ce qui l’entoure

Le premier Run liste chaque démarrage de PowerShell dans les événements. Il y en a trois. Un seul vient de Word avec -enc. Un administrateur a lancé -enc depuis le bureau, et Excel a lancé un script par son nom. La règle a eu raison d’ignorer les deux.

Le second Run essaie une règle plus large, tout lancement de whoami. Elle prend l’attaque et un administrateur. Une sélection filter avec and not filter retirerait l’administrateur.

Chaque démarrage de PowerShell

Commande
sqlite3 logs/events.db "SELECT Computer, User, ParentImage, CommandLine FROM logs WHERE Image LIKE '%powershell.exe'"

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

Une règle plus large et ses correspondances

Commande
det sigma sigma/whoami.yml

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

À vous : comment comparent les modificateurs

Code: python
valeur = "C:/Windows/System32/whoami.exe"

print("endswith :", valeur.lower().endswith("whoami.exe"))
print("contains :", "system32" in valeur.lower())
print("startswith :", valeur.lower().startswith("d:/"))
print("égal :", valeur.lower() == "whoami.exe")
# Sigma compare sans tenir compte des majuscules. Pourquoi lower() des deux côtés ?

À 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.