
CyberPatriot-Linux-Härtung in Bash: Dry-Run-Modus, Backups, bats-Tests und eine containerisierte Dry-Run-Prüfung auf Ubuntu 22.04 und 24.04.
CyberPatriot-Härtung für Linux: ein Bash-Framework, das den skriptbaren Teil eines Härtungsdurchlaufs während einer zeitlich begrenzten Runde ausführt. Es protokolliert jede Änderung und sichert jede Datei, bevor sie bearbeitet wird. Entscheidungen bleiben beim Bediener.
Entwickelt von Andrew Melek für das CyberPatriot-Team der Lakeside High School.
CI führt ShellCheck, die 27 bats-Tests auf Ubuntu 24.04 und die Dry-Run-Prüfung auf Ubuntu 22.04 und 24.04 aus.
Echte Ausgabe von make dry-run in einem Ubuntu-24.04-Container, gekürzt. Der Clip ist auch unter docs/media/cphlf-demo.mp4 verfügbar.
[!warning] Ein echter Lauf entfernt Pakete, setzt die Passwörter der von Ihnen überprüften Konten zurück und schreibt sshd_config, PAM und Firewall-Regeln neu. Verwenden Sie ihn auf einem Wettbewerbs-Image oder einer Wegwerf-VM und beginnen Sie mit
--dry-run.
Sie benötigen Docker und make. Jedes Ziel startet einen Wegwerf-Container mit --rm, in dem das Repo schreibgeschützt eingebunden ist, sodass das Skript niemals auf Ihrem Rechner läuft.
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
Die Prüfung zeichnet die sha256-Summe, den Modus und den Eigentümer jeder Datei unter /etc, /home, /usr, /var und /root (mit Ausnahme von /var/cache und /var/log) vor und nach dem Lauf auf. Sie schlägt fehl, wenn das Skript mit einem Nicht-Null-Exitcode beendet wird, auf stderr schreibt oder etwas außerhalb von /root/hardening-run ändert. Ein zweiter Durchlauf verwendet eine Konfiguration, die DRY_RUN=0 setzt, und prüft, dass das Flag weiterhin Vorrang hat.
Zielt auf Ubuntu 22.04 und 24.04 ab (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
Setze zuerst die Antworten für die WANT_*-Rollen und HARDEN_DEFAULT_PASSWORD in deiner Kopie. examples/config.env.example listet jede Variable auf.
| Flag | Wirkung |
|---|---|
--dry-run | Protokolliert jeden Befehl, anstatt ihn auszuführen. Schreibt nur unter /root/hardening-run. |
--auto-approve | Entfernt die geprüften Dual-Use- und Legacy-Pakete ohne Nachfrage. |
--config FILE | Legt die Rollenantworten vorab fest. Root liest die Datei als Shell-Code ein. |
Flags auf der Kommandozeile haben Vorrang vor der Konfigurationsdatei. Diese Schritte fragen weiterhin nach: die Kontenprüfung, neue Konten, ein Passwort für jedes geprüfte Konto, die Medienbereinigung und den Neustart. Bei geschlossenem stdin (</dev/null) nimmt jeder Schritt seinen Standardwert an: keine Konten geprüft, keine Medien gelöscht, kein Neustart.
Die Ausgabe erfolgt nach /root/hardening-run: harden.log (bei jedem Lauf angehängt), backups/ und baseline/ (bei jedem Lauf überschrieben). Setze HARDEN_STATE_DIR, um dies zu verschieben.
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
Befehle laufen über run() in lib/common.sh. Ein fehlgeschlagener Befehl wird als WARN protokolliert, und der Lauf fährt fort. Dateibearbeitungen, die kein einzelner Befehl sind, prüfen dasselbe DRY_RUN-Flag und sichern die Datei zuerst. ensure_line_in_file und ensure_block_in_file verhindern, dass ein zweiter Lauf doppelte Zeilen hinzufügt. Überprüfte Passwörter werden bei jedem Lauf erneut gesetzt.
| Modul | Was es tut |
|---|---|
packages.sh | Aktualisiert das System, führt autoremove aus und stellt apt auf tägliche Aktualisierung ein. Entfernt 18 offensive Tools und 7 Spiele. Fragt vor dem Entfernen von 12 Dual-Use-Tools und 14 Legacy-Diensten nach, Standard ist Behalten. |
firewall.sh | ufw: eingehend standardmäßig verweigern, ausgehend erlauben, aktivieren. |
ssh.sh | Schreibt sshd_config in eine temporäre Datei, prüft sie mit sshd -t und verschiebt sie dann an ihren Platz. Kein Root-Login, 3 Authentifizierungsversuche, chacha20-poly1305-, AES-GCM- und AES-CTR-Chiffren, sftp bleibt erhalten. |
services.sh | Firewall-Regeln für 8 Dienste nach Rolle. Ist eine Rolle aus, werden Samba, vsftpd, telnetd, MySQL, Apache und BIND entfernt. Ist sie an, wird Samba installiert und die Freigaben bleiben zur Prüfung durch dich, und vsftpd, MySQL und Apache werden installiert und gehärtet. Mail und Drucken erhalten nur Port-Regeln. |
users.sh | Überprüft die von dir benannten Konten: Löschen, Admin-Rechte, ein Passwort-Reset und 90/1/7-Tage-Aging. Legt neue Konten an. Sperrt das Passwort zusätzlicher UID-0-Konten und von Konten mit leerem Passwort. |
kernel.sh | 24 sysctl-Schlüssel in einem markierten Block: 15 IPv4-Netzwerkschlüssel und 9 Kernel- und Dateisystemschlüssel. IPv6 wird nur mit DISABLE_IPV6=yes deaktiviert. |
pam.sh | Passwortqualität (12 Zeichen, alle 4 Klassen), eine Historie von 5, Sperrung nach 5 Fehlversuchen für 30 Minuten beim Standard-Layout von common-auth und login.defs-Aging von 90/1/7 Tagen. Enthält außerdem kernel_login_defs. |
filesystem.sh | Berechtigungen auf shadow, passwd, group, Home-Verzeichnissen und /root. Cron und at nur für Root, ein Login-Banner, ein Zurücksetzen eines vorhandenen rc.local. Optional: USB-, FireWire- und Thunderbolt-Speicher aus, und ein Medien-Sweep unter /home. Schreibt Listen von SUID-, weltweit beschreibbaren, nicht zugeordneten und PHP-Dateien. |
monitoring.sh | Installiert fail2ban, auditd (Distributions-Standardregeln), rkhunter und chkrootkit ohne empfohlene Pakete. ClamAV und der Rootkit-Scan sind optional. |
forensics.sh | Speichert am Ende des Laufs 11 Baseline-Dateien: Systeminformationen, Benutzer, Gruppen, letzte Logins, Prozesse, Dienste, lauschende Ports, installierte und manuell installierte Pakete, Firewall-Status und sshd_config. |
tools/ enthält zwei Helfer: find-port-owner.sh benennt den Prozess auf einem Port, und list-nonstandard-users.sh listet Konten auf, die du nicht erwartet hast.