Endurecimiento de Linux para CyberPatriot en Bash: modo de simulación, copias de seguridad, pruebas de bats y una comprobación de simulación en contenedor sobre Ubuntu 22.04 y 24.04.
Endurecimiento de CyberPatriot para Linux: un framework en Bash que ejecuta la parte automatizable de una pasada de endurecimiento durante una ronda cronometrada. Registra cada cambio y hace una copia de seguridad de cada archivo antes de editarlo. Las decisiones de criterio quedan en manos del operador.
Creado por Andrew Melek para el equipo de CyberPatriot de Lakeside High School.
CI ejecuta ShellCheck, las 27 pruebas de bats en Ubuntu 24.04 y la comprobación de ejecución en seco en Ubuntu 22.04 y 24.04.
Salida real de make dry-run en un contenedor Ubuntu 24.04, recortada. El clip también está en docs/media/cphlf-demo.mp4.
[!warning] Una ejecución real purga paquetes, restablece las contraseñas de las cuentas que revises y reescribe sshd_config, PAM y las reglas del firewall. Úsalo en una imagen de competición o en una VM desechable, y empieza con
--dry-run.
Necesitas Docker y make. Cada objetivo inicia un contenedor desechable --rm con el repositorio montado en modo de solo lectura, de modo que el script nunca se ejecuta en tu máquina.
git clone https://gitlab.com/WhereIsXuezugi/cphlf.git
cd cphlf
make dry-run IMAGE=ubuntu:24.04
[00:00] INFO === harden.sh starting on Ubuntu 24.04 ===
[00:00] INFO DRY-RUN MODE: no changes will be made
[...]
[00:01] INFO DRY-RUN: default deny incoming -- would execute: ufw default deny incoming
[00:01] INFO DRY-RUN: default allow outgoing -- would execute: ufw default allow outgoing
[...]
[00:01] INFO === Hardening run complete ===
[...]
check: harden.sh exit 0, stderr empty
check: files changed in /etc /home /usr /var /root: 1
check: /root/hardening-run/harden.log
check: a config with DRY_RUN=0 still dry-runs
check: passed
La comprobación registra el hash sha256, el modo y el propietario de cada archivo bajo /etc, /home, /usr, /var y /root (omitiendo /var/cache y /var/log) antes y después de la ejecución. Falla si el script termina con un código distinto de cero, escribe en stderr o modifica algo fuera de /root/hardening-run. Una segunda pasada utiliza una configuración que establece DRY_RUN=0 y verifica que el flag siga prevaleciendo.
Orientado a Ubuntu 22.04 y 24.04 (apt, ufw, PAM).
cp examples/config.env.example my-machine.env
sudo ./bin/harden.sh --config my-machine.env --dry-run
sudo ./bin/harden.sh --config my-machine.env --auto-approve
Establece primero las respuestas de rol WANT_* y HARDEN_DEFAULT_PASSWORD en tu copia. examples/config.env.example enumera todas las variables.
| Flag | Efecto |
|---|---|
--dry-run | Registra cada comando en lugar de ejecutarlo. Solo escribe en /root/hardening-run. |
--auto-approve | Purga los paquetes de doble uso y heredados revisados sin preguntar. |
--config FILE | Preestablece las respuestas de rol. Root carga el archivo como código de shell. |
Los flags en la línea de comandos tienen prioridad sobre el archivo de configuración. Estos pasos siguen solicitando confirmación: la revisión de cuentas, las nuevas cuentas, una contraseña para cada cuenta revisada, el barrido de medios y el reinicio. Con stdin cerrado (</dev/null) cada uno toma su valor predeterminado: ninguna cuenta revisada, ningún medio eliminado, ningún reinicio.
La salida va a /root/hardening-run: harden.log (se añade en cada ejecución), backups/ y baseline/ (se sobrescriben en cada ejecución). Establece HARDEN_STATE_DIR para moverlo.
flowchart LR
cli["bin/harden.sh<br/>flags, config, role answers"] --> mods["lib/*.sh<br/>10 modules in a fixed order"]
mods -->|commands| run["run()<br/>dry run: log it<br/>real run: execute, WARN on failure"]
mods -->|file edits| guard["DRY_RUN check<br/>backup_file first"]
run --> state["/root/hardening-run<br/>log, backups, baseline"]
guard --> state
Los comandos pasan por run() en lib/common.sh. Un comando fallido se registra como WARN y la ejecución continúa. Las ediciones de archivos que no son un único comando comprueban el mismo indicador DRY_RUN y hacen una copia de seguridad del archivo primero. ensure_line_in_file y ensure_block_in_file evitan que una segunda ejecución añada líneas duplicadas. Las contraseñas revisadas se vuelven a establecer en cada ejecución.
| Módulo | Qué hace |
|---|---|
packages.sh | Actualiza el sistema, ejecuta autoremove y configura apt para actualizarse a diario. Elimina 18 herramientas ofensivas y 7 juegos. Pregunta antes de purgar 12 herramientas de doble uso y 14 servicios heredados, por defecto mantener. |
firewall.sh | ufw: denegar entrante por defecto, permitir saliente, habilitar. |
ssh.sh | Escribe sshd_config en un archivo temporal, lo comprueba con sshd -t y luego lo mueve a su sitio. Sin inicio de sesión de root, 3 intentos de autenticación, cifrados chacha20-poly1305, AES-GCM y AES-CTR, sftp se mantiene. |
services.sh | Reglas de firewall para 8 servicios por rol. Cuando un rol está desactivado, purga Samba, vsftpd, telnetd, MySQL, Apache y BIND. Cuando está activado, instala Samba y deja los recursos compartidos para que los revises, e instala y endurece vsftpd, MySQL y Apache. Correo e impresión solo reciben reglas de puertos. |
users.sh | Revisa las cuentas que indiques: eliminación, derechos de administrador, un restablecimiento de contraseña y caducidad de 90/1/7 días. Crea nuevas cuentas. Bloquea la contraseña de cuentas adicionales con UID 0 y de cuentas con contraseña vacía. |
kernel.sh | 24 claves sysctl en un bloque marcado: 15 claves de red IPv4 y 9 claves de kernel y sistema de archivos. IPv6 se desactiva solo con DISABLE_IPV6=yes. |
pam.sh | Calidad de contraseña (12 caracteres, las 4 clases), un historial de 5, bloqueo tras 5 fallos durante 30 minutos en el diseño estándar de common-auth, y caducidad en login.defs de 90/1/7 días. También contiene kernel_login_defs. |
filesystem.sh | Permisos en shadow, passwd, group, directorios home y /root. Cron y at solo para root, un banner de inicio de sesión, un restablecimiento de un rc.local existente. Opcional: almacenamiento USB, FireWire y Thunderbolt desactivado, y un barrido de medios bajo /home. Escribe listas de archivos SUID, escribibles por todos, sin propietario y PHP. |
monitoring.sh | Instala fail2ban, auditd (reglas por defecto de la distribución), rkhunter y chkrootkit sin paquetes recomendados. ClamAV y el escaneo de rootkits son opcionales. |
forensics.sh | Guarda 11 archivos de línea base al final de la ejecución: información del sistema, usuarios, grupos, últimos inicios de sesión, procesos, servicios, puertos a la escucha, paquetes instalados e instalados manualmente, estado del firewall y sshd_config. |
tools/ tiene dos ayudantes: find-port-owner.sh identifica el proceso en un puerto, y list-nonstandard-users.sh lista cuentas que no esperabas.