Hardening di Linux per CyberPatriot in Bash: modalità dry-run, backup, test bats e una verifica dry-run containerizzata su Ubuntu 22.04 e 24.04.
Hardening CyberPatriot per Linux: un framework Bash che esegue la parte scriptabile di un passaggio di hardening durante un round a tempo. Registra ogni modifica ed esegue il backup di ogni file prima di modificarlo. Le decisioni restano all'operatore.
Creato da Andrew Melek per il team CyberPatriot della Lakeside High School.
La CI esegue ShellCheck, i 27 test bats su Ubuntu 24.04 e il controllo dry-run su Ubuntu 22.04 e 24.04.
Output reale di make dry-run in un container Ubuntu 24.04, ridotto. La clip è disponibile anche su docs/media/cphlf-demo.mp4.
[!warning] Un'esecuzione reale rimuove pacchetti, reimposta le password degli account che esamini e riscrive sshd_config, PAM e le regole del firewall. Usalo su un'immagine di gara o su una VM usa e getta, e inizia con
--dry-run.
Ti servono Docker e make. Ogni target avvia un container --rm usa e getta con il repo montato in sola lettura, così lo script non viene mai eseguito sulla tua macchina.
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
Il controllo registra il checksum sha256, la modalità e il proprietario di ogni file sotto /etc, /home, /usr, /var e /root (saltando /var/cache e /var/log) prima e dopo l'esecuzione. Fallisce se lo script termina con un codice diverso da zero, scrive su stderr o modifica qualsiasi cosa al di fuori di /root/hardening-run. Una seconda passata utilizza una configurazione che imposta DRY_RUN=0 e verifica che il flag abbia comunque la precedenza.
Destinato a Ubuntu 22.04 e 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
Imposta le risposte dei ruoli WANT_* e HARDEN_DEFAULT_PASSWORD nella tua copia prima di procedere. examples/config.env.example elenca ogni variabile.
| Flag | Effetto |
|---|---|
--dry-run | Registra ogni comando nel log invece di eseguirlo. Scrive solo in /root/hardening-run. |
--auto-approve | Rimuove i pacchetti dual-use e legacy revisionati senza chiedere conferma. |
--config FILE | Preimposta le risposte dei ruoli. Root esegue il file come codice shell. |
I flag sulla riga di comando hanno la precedenza sul file di configurazione. Questi passaggi richiedono comunque un'interazione: la revisione degli account, i nuovi account, una password per ogni account revisionato, la scansione dei supporti e il riavvio. Con stdin chiuso (</dev/null) ognuno assume il proprio valore predefinito: nessun account revisionato, nessun supporto eliminato, nessun riavvio.
L'output va in /root/hardening-run: harden.log (aggiunto a ogni esecuzione), backups/ e baseline/ (sovrascritti a ogni esecuzione). Imposta HARDEN_STATE_DIR per spostarlo.
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
I comandi passano attraverso run() in lib/common.sh. Un comando fallito viene registrato come WARN e l'esecuzione prosegue. Le modifiche ai file che non sono un singolo comando controllano lo stesso flag DRY_RUN ed eseguono prima il backup del file. ensure_line_in_file e ensure_block_in_file impediscono a una seconda esecuzione di aggiungere righe duplicate. Le password riviste vengono impostate di nuovo a ogni esecuzione.
| Modulo | Cosa fa |
|---|---|
packages.sh | Aggiorna il sistema, esegue autoremove e imposta apt per l'aggiornamento giornaliero. Rimuove 18 strumenti offensivi e 7 giochi. Chiede prima di eliminare 12 strumenti a doppio uso e 14 servizi legacy, default mantenere. |
firewall.sh | ufw: nega il traffico in entrata per impostazione predefinita, consente quello in uscita, abilita. |
ssh.sh | Scrive sshd_config in un file temporaneo, lo verifica con sshd -t, poi lo sposta. Nessun login root, 3 tentativi di autenticazione, cifrari chacha20-poly1305, AES-GCM e AES-CTR, sftp mantenuto. |
services.sh | Regole del firewall per 8 servizi in base al ruolo. Quando un ruolo è disattivato elimina Samba, vsftpd, telnetd, MySQL, Apache e BIND. Quando è attivo installa Samba e lascia le condivisioni da revisionare, e installa e rafforza vsftpd, MySQL e Apache. Mail e stampa ricevono solo regole sulle porte. |
users.sh | Esamina gli account che indichi: eliminazione, diritti di amministrazione, reimpostazione della password e scadenza di 90/1/7 giorni. Crea nuovi account. Blocca la password degli account UID 0 aggiuntivi e degli account con password vuota. |
kernel.sh | 24 chiavi sysctl in un unico blocco contrassegnato: 15 chiavi di rete IPv4 e 9 chiavi del kernel e del filesystem. IPv6 viene disattivato solo con DISABLE_IPV6=yes. |
pam.sh | Qualità della password (12 caratteri, tutte e 4 le classi), una cronologia di 5, blocco dopo 5 tentativi falliti per 30 minuti sul layout standard common-auth, e scadenza login.defs di 90/1/7 giorni. Contiene anche kernel_login_defs. |
filesystem.sh | Permessi su shadow, passwd, group, directory home e /root. Cron e at solo per root, un banner di login, una reimpostazione di un rc.local esistente. Opzionale: disattivazione dello storage USB, FireWire e Thunderbolt, e una scansione dei media sotto /home. Scrive elenchi di file SUID, scrivibili da tutti, senza proprietario e PHP. |
monitoring.sh | Installa fail2ban, auditd (regole predefinite della distribuzione), rkhunter e chkrootkit senza pacchetti consigliati. ClamAV e la scansione rootkit sono opzionali. |
forensics.sh | Salva 11 file di baseline alla fine dell'esecuzione: informazioni di sistema, utenti, gruppi, ultimi accessi, processi, servizi, porte in ascolto, pacchetti installati e installati manualmente, stato del firewall e sshd_config. |
tools/ contiene due helper: find-port-owner.sh identifica il processo su una porta, e list-nonstandard-users.sh elenca gli account che non ti aspettavi.