Durcissement Linux CyberPatriot en Bash : mode dry-run, sauvegardes, tests bats et une vérification dry-run conteneurisée sur Ubuntu 22.04 et 24.04.
Durcissement CyberPatriot pour Linux : un framework Bash qui exécute la partie scriptable d'une passe de durcissement pendant une manche chronométrée. Il journalise chaque modification et sauvegarde chaque fichier avant de le modifier. Les décisions d'appréciation restent à l'opérateur.
Créé par Andrew Melek pour l'équipe CyberPatriot du Lakeside High School.
La CI exécute ShellCheck, les 27 tests bats sur Ubuntu 24.04, et la vérification en dry-run sur Ubuntu 22.04 et 24.04.
Sortie réelle de make dry-run dans un conteneur Ubuntu 24.04, tronquée. Le clip est également disponible à l'adresse docs/media/cphlf-demo.mp4.
[!warning] Une exécution réelle purge des paquets, réinitialise les mots de passe des comptes que vous examinez, et réécrit sshd_config, PAM et les règles de pare-feu. Utilisez-le sur une image de compétition ou une VM jetable, et commencez par
--dry-run.
Vous avez besoin de Docker et de make. Chaque cible démarre un conteneur jetable --rm avec le dépôt monté en lecture seule, de sorte que le script ne s'exécute jamais sur votre machine.
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
Le contrôle enregistre la somme sha256, le mode et le propriétaire de chaque fichier sous /etc, /home, /usr, /var et /root (en ignorant /var/cache et /var/log) avant et après l'exécution. Il échoue si le script se termine avec un code non nul, écrit sur stderr ou modifie quoi que ce soit en dehors de /root/hardening-run. Une seconde passe utilise une configuration qui définit DRY_RUN=0 et vérifie que le drapeau l'emporte toujours.
Cible Ubuntu 22.04 et 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
Définissez d'abord les réponses des rôles WANT_* et HARDEN_DEFAULT_PASSWORD dans votre copie. examples/config.env.example liste toutes les variables.
| Option | Effet |
|---|---|
--dry-run | Journalise chaque commande au lieu de l'exécuter. N'écrit que sous /root/hardening-run. |
--auto-approve | Purge les paquets à double usage et hérités examinés sans demander. |
--config FILE | Préremplit les réponses des rôles. Root source le fichier comme du code shell. |
Les options de la ligne de commande l'emportent sur le fichier de configuration. Ces étapes demandent toujours une confirmation : la revue des comptes, les nouveaux comptes, un mot de passe pour chaque compte examiné, le balayage des supports et le redémarrage. Avec stdin fermé (</dev/null), chacune prend sa valeur par défaut : aucun compte examiné, aucun support supprimé, aucun redémarrage.
La sortie va dans /root/hardening-run : harden.log (complété à chaque exécution), backups/ et baseline/ (écrasés à chaque exécution). Définissez HARDEN_STATE_DIR pour le déplacer.
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
Les commandes passent par run() dans lib/common.sh. Une commande échouée est journalisée comme WARN et l'exécution se poursuit. Les modifications de fichiers qui ne sont pas une simple commande vérifient le même indicateur DRY_RUN et sauvegardent d'abord le fichier. ensure_line_in_file et ensure_block_in_file empêchent une seconde exécution d'ajouter des lignes en double. Les mots de passe examinés sont redéfinis à chaque exécution.
| Module | Ce qu'il fait |
|---|---|
packages.sh | Met à jour le système, exécute autoremove et configure apt pour se mettre à jour quotidiennement. Supprime 18 outils offensifs et 7 jeux. Demande avant de purger 12 outils à double usage et 14 services hérités, conservation par défaut. |
firewall.sh | ufw : refus du trafic entrant par défaut, autorisation du trafic sortant, activation. |
ssh.sh | Écrit sshd_config dans un fichier temporaire, le vérifie avec sshd -t, puis le déplace. Pas de connexion root, 3 tentatives d'authentification, chiffrements chacha20-poly1305, AES-GCM et AES-CTR, sftp conservé. |
services.sh | Règles de pare-feu pour 8 services selon le rôle. Lorsqu'un rôle est désactivé, purge Samba, vsftpd, telnetd, MySQL, Apache et BIND. Lorsqu'il est activé, installe Samba et laisse les partages à examiner, et installe et durcit vsftpd, MySQL et Apache. Le courrier et l'impression ne reçoivent que des règles de ports. |
users.sh | Examine les comptes que vous nommez : suppression, droits d'administration, réinitialisation du mot de passe et expiration à 90/1/7 jours. Crée de nouveaux comptes. Verrouille le mot de passe des comptes UID 0 supplémentaires et des comptes dont le mot de passe est vide. |
kernel.sh | 24 clés sysctl dans un bloc marqué : 15 clés réseau IPv4 et 9 clés du noyau et du système de fichiers. IPv6 n'est désactivé qu'avec DISABLE_IPV6=yes. |
pam.sh | Qualité des mots de passe (12 caractères, les 4 classes), un historique de 5, verrouillage après 5 échecs pendant 30 minutes sur la disposition common-auth d'origine, et expiration login.defs à 90/1/7 jours. Contient aussi kernel_login_defs. |
filesystem.sh | Permissions sur shadow, passwd, group, les répertoires personnels et /root. cron et at réservés à root, une bannière de connexion, une réinitialisation d'un rc.local existant. Optionnel : désactivation du stockage USB, FireWire et Thunderbolt, et un balayage des médias sous /home. Écrit les listes de fichiers SUID, modifiables par tous, sans propriétaire et PHP. |
monitoring.sh | Installe fail2ban, auditd (règles par défaut de la distribution), rkhunter et chkrootkit sans paquets recommandés. ClamAV et l'analyse de rootkits sont optionnels. |
forensics.sh | Enregistre 11 fichiers de référence à la fin de l'exécution : informations système, utilisateurs, groupes, dernières connexions, processus, services, ports en écoute, paquets installés et installés manuellement, état du pare-feu et sshd_config. |
tools/ contient deux assistants : find-port-owner.sh identifie le processus sur un port, et list-nonstandard-users.sh liste les comptes que vous n'attendiez pas.