Endurecimento do Linux para o CyberPatriot em Bash: modo dry-run, backups, testes bats e uma verificação dry-run em contêiner no Ubuntu 22.04 e 24.04.
Endurecimento CyberPatriot para Linux: um framework Bash que executa a parte scriptável de uma passagem de endurecimento durante uma rodada cronometrada. Ele registra cada alteração e faz backup de cada arquivo antes de editá-lo. As decisões de julgamento ficam com o operador.
Criado por Andrew Melek para a equipe CyberPatriot da Lakeside High School.
O CI executa o ShellCheck, os 27 testes bats no Ubuntu 24.04 e a verificação de dry-run no Ubuntu 22.04 e 24.04.
Saída real de make dry-run em um contêiner Ubuntu 24.04, resumida. O clipe também está em docs/media/cphlf-demo.mp4.
[!warning] Uma execução real remove pacotes, redefine as senhas das contas que você revisar e reescreve sshd_config, PAM e regras de firewall. Use-o em uma imagem de competição ou em uma VM descartável, e comece com
--dry-run.
Você precisa de Docker e make. Cada alvo inicia um contêiner descartável --rm com o repositório montado como somente leitura, para que o script nunca seja executado na sua 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
A verificação registra o sha256, o modo e o proprietário de cada arquivo em /etc, /home, /usr, /var e /root (ignorando /var/cache e /var/log) antes e depois da execução. Ela falha se o script sair com código diferente de zero, escrever em stderr ou alterar qualquer coisa fora de /root/hardening-run. Uma segunda passagem usa uma configuração que define DRY_RUN=0 e verifica se a flag ainda prevalece.
Destinado 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
Defina as respostas das funções WANT_* e HARDEN_DEFAULT_PASSWORD na sua cópia primeiro. examples/config.env.example lista todas as variáveis.
| Flag | Efeito |
|---|---|
--dry-run | Registra cada comando em vez de executá-lo. Escreve apenas em /root/hardening-run. |
--auto-approve | Remove os pacotes de uso duplo e legados revisados sem perguntar. |
--config FILE | Predefine as respostas das funções. O root carrega o arquivo como código shell. |
As flags na linha de comando têm precedência sobre o arquivo de configuração. Estas etapas ainda solicitam entrada: a revisão de contas, novas contas, uma senha para cada conta revisada, a varredura de mídia e a reinicialização. Com stdin fechado (</dev/null), cada uma assume seu padrão: nenhuma conta revisada, nenhuma mídia excluída, nenhuma reinicialização.
A saída vai para /root/hardening-run: harden.log (anexado a cada execução), backups/ e baseline/ (sobrescritos a cada execução). Defina HARDEN_STATE_DIR para movê-la.
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
Os comandos passam por run() em lib/common.sh. Um comando que falha é registado como WARN e a execução continua. As edições de ficheiros que não são um único comando verificam a mesma flag DRY_RUN e fazem primeiro uma cópia de segurança do ficheiro. ensure_line_in_file e ensure_block_in_file impedem que uma segunda execução adicione linhas duplicadas. As palavras-passe revistas são definidas novamente em cada execução.
| Módulo | O que faz |
|---|---|
packages.sh | Atualiza o sistema, executa autoremove e configura o apt para atualizar diariamente. Remove 18 ferramentas ofensivas e 7 jogos. Pergunta antes de purgar 12 ferramentas de duplo uso e 14 serviços legados, predefinição manter. |
firewall.sh | ufw: negar entrada por predefinição, permitir saída, ativar. |
ssh.sh | Escreve o sshd_config num ficheiro temporário, verifica-o com sshd -t e depois move-o para o local. Sem login de root, 3 tentativas de autenticação, cifras chacha20-poly1305, AES-GCM e AES-CTR, sftp mantido. |
services.sh | Regras de firewall para 8 serviços por função. Quando uma função está desligada, purga Samba, vsftpd, telnetd, MySQL, Apache e BIND. Quando está ligada, instala Samba e deixa as partilhas para revisão, e instala e reforça vsftpd, MySQL e Apache. Correio e impressão recebem apenas regras de portas. |
users.sh | Revê as contas que indicar: eliminar, direitos de administrador, reposição de palavra-passe e expiração de 90/1/7 dias. Cria novas contas. Bloqueia a palavra-passe de contas extra com UID 0 e de contas com palavra-passe vazia. |
kernel.sh | 24 chaves sysctl num bloco marcado: 15 chaves de rede IPv4 e 9 chaves de kernel e sistema de ficheiros. O IPv6 só é desativado com DISABLE_IPV6=yes. |
pam.sh | Qualidade de palavra-passe (12 caracteres, todas as 4 classes), um histórico de 5, bloqueio após 5 falhas durante 30 minutos no layout common-auth padrão, e expiração em login.defs de 90/1/7 dias. Também contém kernel_login_defs. |
filesystem.sh | Permissões em shadow, passwd, group, diretórios home e /root. cron e at apenas para root, um banner de login, uma reposição de um rc.local existente. Opcional: armazenamento USB, FireWire e Thunderbolt desativado, e uma limpeza de media em /home. Escreve listas de ficheiros SUID, com escrita para todos, sem proprietário e PHP. |
monitoring.sh | Instala fail2ban, auditd (regras predefinidas da distribuição), rkhunter e chkrootkit sem pacotes recomendados. ClamAV e a análise de rootkits são opcionais. |
forensics.sh | Guarda 11 ficheiros de linha de base no final da execução: informação do sistema, utilizadores, grupos, últimos logins, processos, serviços, portas à escuta, pacotes instalados e instalados manualmente, estado da firewall e sshd_config. |
tools/ tem dois auxiliares: find-port-owner.sh identifica o processo numa porta, e list-nonstandard-users.sh lista contas que não esperava.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.