¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Escribir reglas Sigma para logs

Después de esta lección: Puedo escribir una regla Sigma para eventos de procesos y convertirla en una consulta.

Lección de 65 min6 comandosLaboratorio de ingeniería de detección: reglas Suricata, reglas Sigma y logs al estilo de Zeek en una VM Ubuntu privada

Escrita una vez, sirve en todas partes

Sigma es un formato abierto para escribir detecciones sobre logs, en YAML. Un conversor transforma una regla Sigma en el lenguaje de consulta de la herramienta de logs que use cada equipo.

Los equipos comparten reglas Sigma porque una regla escrita una vez funciona en muchos sitios. Vas a escribir reglas para los eventos de Windows de una oficina inventada, solo en tu copia del laboratorio.

Al terminar esta lección

Nota

Puedo escribir una regla Sigma para eventos de procesos y convertirla en una consulta.

Palabras clave

PalabraQué significaEjemplo
Sigmaun formato abierto para detecciones sobre logs, escrito en YAML
Fuente de logsel tipo de log para el que es una reglaprocess_creation
Selecciónun grupo con nombre de pruebas sobre campos que deben pasar todas
Modificadoruna palabra detrás de un campo que cambia cómo se comparaendswith
Condicióncómo se combinan las selecciones para dar una coincidencia
Backendla pieza que convierte una regla en un lenguaje de búsqueda

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

La regla única

Importante

Estos eventos se inventaron para el laboratorio. Busca en logs reales solo en sistemas que cuidas o que tienes permiso por escrito para revisar. Los logs sobre el trabajo de las personas son datos personales, así que lee solo lo que pide la tarea.

Una regla Sigma dice dónde y qué

Una regla Sigma tiene una fuente de logs, el tipo de log que lee, y una detección. La detección guarda selecciones con nombre y una condición que las combina.

La Ejecución imprime una regla para un ataque clásico: un archivo de Word o Excel que arranca PowerShell con una orden codificada. Cada prueba sobre un campo lleva un modificador tras una barra.

Entra en la carpeta del laboratorio

Comando
cd ~/detect

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Lee una regla Sigma

Comando
cat sigma/office-powershell.yml

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo: las partes de la regla

ParteEn la reglaQué significa
Fuente de logsprocess_creation, windowsLeer los eventos de arranque de procesos de Windows
Selección parentParentImage|endswith, dos valoresLo arrancó Word o lo arrancó Excel
Selección childImage|endswith y CommandLine|containsPowerShell, con " -enc " en su orden
Condiciónparent and childLas dos selecciones deben pasar
Etiquetasattack.t1059.001La técnica de ATT&CK que detecta

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un backend convierte la regla en consulta

sigma convert usa un backend para convertir una regla en un lenguaje de búsqueda. El laboratorio tiene el backend de SQLite, así que la regla se vuelve SQL. Fíjate en que endswith pasa a LIKE con un % delante, una lista pasa a OR y una selección pasa a AND.

La segunda Ejecución convierte la regla y lanza el SQL sobre los 41 eventos del laboratorio. Coincide un evento.

Convierte la regla en SQL

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Lanza la regla sobre los eventos

Comando
det sigma sigma/office-powershell.yml

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Un error frecuente

Advertencia

Mucha gente cree que Sigma es un programa que busca en logs. Es un formato. Un backend convierte la regla en el lenguaje de búsqueda de la herramienta que guarda los logs. La misma regla aquí se vuelve SQL y en otra herramienta, otra consulta.

Prueba una regla con todo lo cercano

La primera Ejecución lista cada arranque de PowerShell de los eventos. Hay tres. Solo uno vino de Word con -enc. Un administrador lanzó -enc desde el escritorio, y Excel lanzó un script por su nombre. La regla dejó fuera los dos, con razón.

La segunda Ejecución prueba una regla más flexible, cualquier ejecución de whoami. Coincide con el ataque y con un administrador. Una selección filter con and not filter quitaría al administrador.

Cada arranque de PowerShell de los eventos

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Una regla más flexible y sus coincidencias

Comando
det sigma sigma/whoami.yml

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Pruébalo: cómo comparan los modificadores

Código: python
value = "C:/Windows/System32/whoami.exe"

print("endswith:", value.lower().endswith("whoami.exe"))
print("contains:", "system32" in value.lower())
print("startswith:", value.lower().startswith("d:/"))
print("igual:", value.lower() == "whoami.exe")
# Sigma compara sin fijarse en las mayúsculas. ¿Por qué lower() en los dos lados?

Sobre este laboratorio y su código: Laboratorio de ingeniería de detección: reglas Suricata, reglas Sigma y logs al estilo de Zeek en una VM Ubuntu privada

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.