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

Este laboratorio da a cada alumno el trabajo de un ingeniero de detección en una sola VM Ubuntu: escribir una regla, probarla con datos cuya respuesta se conoce, ajustarla hasta que no se le escape nada y calle en lo demás, y medirla. Cada captura y cada log se inventaron para el laboratorio y se escriben a partir de texto fijo, así que todos ven lo mismo, y dos trabajos que escribe el alumno los califica un script con tráfico y logs que fabrica en ese momento.

Suricata, el sistema de detección de intrusiones de código abierto, es el de verdad, instalado desde el archivo de Ubuntu. Las herramientas de Sigma, sigma-cli y pySigma con un backend de SQLite, también son las de verdad, instaladas desde PyPI. Zeek no está en el archivo de Ubuntu, así que el laboratorio trae zeek-lite, su propio pequeño modelo de Zeek que escribe conn.log, dns.log y http.log en el formato de Zeek con parte de sus campos. Solo defensivo: el alumno usa estas herramientas en su propia copia, y en una red real solo con permiso por escrito.

Qué aprenden los alumnos

Cómo se hace y se mantiene una detección. La captura de una oficina inventada se convierte en logs al estilo de Zeek, que se leen con zeek-cut. Sobre ella se lanzan reglas de Suricata para una herramienta inventada llamada updater: un primer intento que salta con nombres que solo se parecen a los de la herramienta, una regla ajustada y anclada con dotprefix y endswith, y una regla con un umbral de una alerta por máquina y hora. Las reglas Sigma para eventos de procesos de Windows se convierten en SQL y se lanzan sobre una pequeña tabla de eventos. Un arnés de pruebas lanza cada regla sobre una captura mala conocida y otra buena conocida, y las cuentas dan la precisión y la exhaustividad.

Las cinco partes

Primero la captura como logs, con zeek-lite y zeek-cut. Segundo las reglas de Suricata de ejemplo, contadas y leídas con det, el ayudante del laboratorio. Tercero las reglas Sigma, convertidas con sigma convert y lanzadas con det sigma. Cuarto las capturas de prueba, con det test. Quinto dos trabajos que escribe el alumno: rules/local.rules, reglas de Suricata para una segunda herramienta inventada llamada quietbird, y beacon.py, un programa que encuentra en un conn.log de Zeek las máquinas que llaman a casa con un ritmo constante. El comentario al principio de cada uno dice exactamente qué debe hacer, y README.md en la carpeta personal no da ninguna respuesta.

Ejecútalo en tu navegador

Los laboratorios VM se ponen como tarea de laboratorio en un módulo, y el ejemplo está en la página del laboratorio. La máquina es pequeña: una CPU, 1 GB de memoria y 10 GB de disco. El setup instala desde PyPI, al que no llega un visitante sin cuenta, así que el laboratorio necesita una cuenta gratuita o de centro.

  1. Añadir el laboratorio. En un módulo que enseñes, añade una tarea y elige la tarjeta de laboratorio VM Ubuntu. La página muestra una breve descripción de la máquina en lugar de un archivo compose.
  2. Empezar desde el ejemplo. La página ofrece laboratorios ya hechos para empezar. Elige Detection engineering. Usar un ejemplo reemplaza el texto, y Deshacer recupera el tuyo.
  3. Publicar e iniciar tu propia copia. Publica y luego pulsa Iniciar. El script setup del laboratorio instala Suricata desde el archivo de Ubuntu y las herramientas de Sigma desde PyPI, y escribe las capturas, los logs, las reglas, el ayudante det y el README, la primera vez que arranca la VM, en más o menos un minuto.
  4. Abrir el terminal. Abre su terminal y lee README.md en la carpeta personal. No se abre nada en el navegador: el laboratorio es el terminal.

Una lección básica en este laboratorio

Detection Engineering Basics es una pequeña lección que se da en este laboratorio, una VM Ubuntu. Tiene un gancho, un objetivo «Puedo», palabras clave, una pregunta inicial, una comprobación tras cada idea, un error frecuente y una comprobación final, y cada paso tiene un botón Ejecutar que escribe su comando en el terminal de la máquina. El alumno convierte la captura en logs, cuenta las alertas de las reglas de ejemplo, las prueba con las dos capturas de prueba y lanza una regla Sigma.

La lección mira alrededor y deja al alumno la tarea propia del laboratorio, las reglas de quietbird y el programa de balizas, así que no da ninguna respuesta. El módulo universitario Ingeniería de detección con Sigma, Suricata y Zeek se trabaja en este laboratorio, con seis lecciones y una guía del profesorado.

Cómo se califica

El laboratorio tiene una comprobación. Se ejecuta sobre una copia de la máquina guardada y fabrica una captura nueva de una oficina con máquinas, nombres y cuentas que nadie ha visto: algunas consultas de los nombres de quietbird, algunos nombres parecidos que son de otros, y de una a tres máquinas que envían una y otra vez las llamadas de quietbird, junto a un programa cuyo nombre solo se le parece. El Suricata de verdad lanza rules/local.rules sobre ella, y solo aprueba una alerta por cada consulta de quietbird, una por cada máquina infectada envíe las llamadas que envíe, y nada más. Después fabrica un conn.log nuevo con una o dos balizas ocultas de intervalo aleatorio, señuelos y las columnas en otro orden, y un log tranquilo sin ninguna: beacon.py debe encontrar cada baliza con su intervalo mediano y su cuenta, e imprimir NO BEACON con el tranquilo. Se rechaza un beacon.py que inicie otro programa o que lea los archivos propios del laboratorio. La primera línea de lo que imprimió la comprobación dice por qué.

  1. Entregarlo. Asigna el laboratorio como cualquier tarea, con fecha límite si quieres. Cada alumno recibe una VM propia, que se conserva entre sesiones.
  2. Ejecutar la comprobación. En la fila de un alumno en la lista de la clase, pulsa Ejecutar la comprobación. Inicia una copia de su máquina guardada que no se vuelve a guardar, ejecuta el script de comprobación del laboratorio como root y muestra si pasó, qué imprimió y cuándo. Al alumno no se le comunica el resultado.
  3. Calificarlo. Lee la primera línea de lo que imprimió la comprobación: dice qué no está bien, por ejemplo un nombre parecido con el que alertó una regla, una máquina que dio siete alertas en vez de una, o una baliza que se le escapó al programa. Devuelve el trabajo con un motivo si necesita más.

La definición en GitHub

El archivo es toda la definición del laboratorio, el mismo texto que ejecuta la plataforma: tamaño, script setup, el ayudante, el generador de las capturas y los eventos, el modelo de Zeek, las reglas, el README y la comprobación. Cópialo y cambia las herramientas inventadas, los nombres o la oficina para hacer un laboratorio propio.

Prueba este laboratorio, y lo que cuesta

Con una cuenta personal gratuita puedes seguir las lecciones básicas de este laboratorio, con crédito gratuito suficiente cada mes para seguir la mayoría de las lecciones y sin tarjeta. Para una clase, un centro tiene gratis sus primeros 365 días, hasta 50 alumnos, y después paga por alumno y año, con todos los laboratorios incluidos y el profesorado gratis.

Preguntas frecuentes

¿El laboratorio necesita una licencia?
No. Suricata y scapy tienen licencia GPL-2.0, sigma-cli y pySigma son LGPL, el backend de SQLite es LGPL-3.0, y SQLite es de dominio público. Se instalan en la VM del alumno cuando arranca, desde el archivo de Ubuntu y desde PyPI, así que no distribuimos ninguno.
¿Es Zeek de verdad?
No. Zeek no está en el archivo de Ubuntu ni tiene un binario en una fuente a la que pueda llegar una VM de laboratorio, así que el laboratorio trae zeek-lite, un programa corto en Python nuestro que escribe conn.log, dns.log y http.log en el formato separado por tabuladores de Zeek con parte de sus nombres de campo. La lectura de los logs, zeek-cut y los nombres de campo son como en Zeek. El Zeek real escribe más campos y más logs.
¿Pueden los alumnos estropear algo?
Solo su propia copia. El tráfico se genera dentro de la VM a partir de texto fijo y nunca toca una red, y la máquina llega al archivo de Ubuntu y al índice de paquetes de Python y a nada más. Si un alumno estropea un archivo, det reset lo deja como se entregó.
¿Se probó el laboratorio en una VM de alumno de verdad?
El script setup, los comandos de las lecciones y la comprobación, con cada forma de engañarla, se ejecutaron en un contenedor Ubuntu 26.04 que hace de VM, en una máquina arm64. Conviene probar una VM de alumno arrancada y la instalación amd64 antes de una clase.