
Bash로 구현한 CyberPatriot Linux 하드닝: 드라이런 모드, 백업, bats 테스트, 그리고 Ubuntu 22.04 및 24.04에서의 컨테이너화된 드라이런 검사.
Linux용 CyberPatriot 하드닝: 시간 제한 라운드 동안 하드닝 패스의 스크립트 가능한 부분을 실행하는 Bash 프레임워크입니다. 모든 변경 사항을 기록하고, 각 파일을 편집하기 전에 백업합니다. 판단이 필요한 부분은 운영자에게 맡깁니다.
Lakeside High School CyberPatriot 팀을 위해 Andrew Melek이 제작했습니다.
CI는 ShellCheck, Ubuntu 24.04에서의 27개 bats 테스트, 그리고 Ubuntu 22.04 및 24.04에서의 드라이런 검사를 실행합니다.
Ubuntu 24.04 컨테이너에서 make dry-run을 실행한 실제 출력(일부 발췌). 클립은 docs/media/cphlf-demo.mp4에서도 볼 수 있습니다.
[!warning] 실제 실행은 패키지를 제거하고, 검토한 계정의 비밀번호를 재설정하며, sshd_config, PAM 및 방화벽 규칙을 다시 작성합니다. 대회 이미지나 일회용 VM에서 사용하고,
--dry-run으로 시작하십시오.
Docker와 make가 필요합니다. 각 대상은 저장소를 읽기 전용으로 마운트한 일회용 --rm 컨테이너를 시작하므로, 스크립트가 사용자의 머신에서 실행되지 않습니다.
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
검사는 실행 전후에 /etc, /home, /usr, /var, /root 아래의 모든 파일에 대해 sha256 합계, 모드 및 소유자를 기록합니다(/var/cache 및 /var/log는 건너뜀). 스크립트가 0이 아닌 값으로 종료되거나, stderr에 쓰거나, /root/hardening-run 외부의 항목을 변경하면 실패합니다. 두 번째 패스는 DRY_RUN=0을 설정하는 구성을 사용하며 해당 플래그가 여전히 우선하는지 확인합니다.
Ubuntu 22.04 및 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
복사본에서 먼저 WANT_* 역할 응답과 HARDEN_DEFAULT_PASSWORD를 설정하세요. examples/config.env.example에 모든 변수가 나열되어 있습니다.
| 플래그 | 효과 |
|---|---|
--dry-run | 각 명령을 실행하지 않고 기록만 합니다. /root/hardening-run 아래에만 기록합니다. |
--auto-approve | 검토된 이중 용도 및 레거시 패키지를 묻지 않고 제거합니다. |
--config FILE | 역할 응답을 미리 설정합니다. root가 해당 파일을 셸 코드로 소싱합니다. |
명령줄의 플래그가 구성 파일보다 우선합니다. 다음 단계들은 여전히 프롬프트를 표시합니다: 계정 검토, 새 계정, 검토된 각 계정의 비밀번호, 미디어 정리, 재부팅. stdin이 닫힌 상태(</dev/null)에서는 각 단계가 기본값을 사용합니다: 계정 검토 없음, 미디어 삭제 없음, 재부팅 없음.
출력은 /root/hardening-run에 저장됩니다: harden.log(실행할 때마다 추가됨), backups/ 및 baseline/(실행할 때마다 덮어씀). 위치를 옮기려면 HARDEN_STATE_DIR를 설정하세요.
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
명령은 lib/common.sh의 run()을 통해 실행됩니다. 실패한 명령은 WARN으로 기록되고 실행은 계속 진행됩니다. 단일 명령이 아닌 파일 편집은 동일한 DRY_RUN 플래그를 확인하고 먼저 파일을 백업합니다. ensure_line_in_file과 ensure_block_in_file은 두 번째 실행에서 중복 줄이 추가되는 것을 막습니다. 검토된 비밀번호는 매 실행마다 다시 설정됩니다.
| 모듈 | 수행 작업 |
|---|---|
packages.sh | 시스템을 업데이트하고, autoremove를 실행하며, apt가 매일 업데이트하도록 설정합니다. 18개의 공격 도구와 7개의 게임을 제거합니다. 12개의 이중 용도 도구와 14개의 레거시 서비스를 purge하기 전에 묻고, 기본값은 유지입니다. |
firewall.sh | ufw: 기본적으로 인바운드 거부, 아웃바운드 허용, 활성화. |
ssh.sh | sshd_config를 임시 파일에 작성하고, sshd -t로 검사한 뒤 이동시킵니다. root 로그인 불가, 인증 시도 3회, chacha20-poly1305, AES-GCM 및 AES-CTR 암호, sftp 유지. |
services.sh | 역할별로 8개 서비스에 대한 방화벽 규칙. 역할이 꺼져 있으면 Samba, vsftpd, telnetd, MySQL, Apache, BIND를 purge합니다. 켜져 있으면 Samba를 설치하고 공유는 검토하도록 남겨두며, vsftpd, MySQL, Apache를 설치하고 강화합니다. 메일과 프린팅은 포트 규칙만 적용됩니다. |
users.sh | 지정한 계정을 검토합니다: 삭제, 관리자 권한, 비밀번호 재설정, 90/1/7일 만료. 새 계정을 생성합니다. 추가 UID 0 계정과 빈 비밀번호 계정의 비밀번호를 잠급니다. |
kernel.sh | 하나의 표시된 블록에 24개의 sysctl 키: 15개의 IPv4 네트워크 키와 9개의 커널 및 파일시스템 키. IPv6는 DISABLE_IPV6=yes인 경우에만 꺼집니다. |
pam.sh | 비밀번호 품질(12자, 4개 클래스 모두), 5개의 이력, 기본 common-auth 레이아웃에서 5회 실패 후 30분 잠금, login.defs 만료 90/1/7일. kernel_login_defs도 포함합니다. |
filesystem.sh | shadow, passwd, group, 홈 디렉터리 및 /root의 권한. root 전용 cron 및 at, 로그인 배너, 기존 rc.local 재설정. 선택 사항: USB, FireWire 및 Thunderbolt 저장소 끄기, /home 아래 미디어 파일 정리. SUID, 전 세계 쓰기 가능, 소유자 없는 파일 및 PHP 파일 목록을 작성합니다. |
monitoring.sh | 권장 패키지 없이 fail2ban, auditd(배포판 기본 규칙), rkhunter, chkrootkit을 설치합니다. ClamAV와 루트킷 스캔은 선택 사항입니다. |
forensics.sh | 실행 종료 시 11개의 기준 파일을 저장합니다: 시스템 정보, 사용자, 그룹, 최근 로그인, 프로세스, 서비스, 수신 포트, 설치된 및 수동 설치된 패키지, 방화벽 상태, sshd_config. |
tools/에는 두 개의 헬퍼가 있습니다: find-port-owner.sh는 포트의 프로세스 이름을 알려주고, list-nonstandard-users.sh는 예상하지 못한 계정을 나열합니다.
| 결정 | 기본값 | 이유 |
|---|---|---|
| SSH 비밀번호 로그인 | 켜짐 (SSH_PASSWORD_AUTH=yes) | SSH 키가 없는 팀은 접속 수단을 유지합니다. 키가 준비되면 끄십시오. |
| 계정 삭제 | 묻고, 기본값 아니오 | 잘못된 삭제는 되돌릴 수 없습니다. 자신의 계정은 절대 삭제, 강등 또는 재설정되지 않습니다. |
| 계정 비밀번호 | HARDEN_DEFAULT_PASSWORD로 재설정 | 저장소의 값은 자리 표시자이며, 사용 시 로그에 경고가 표시됩니다. 직접 설정하십시오. |
| 이중 용도 및 레거시 패키지 | 묻고, 기본값 유지 | nmap이나 telnet 서버는 머신의 역할 일부일 수 있습니다. |
| 미디어 정리 | ALLOW_MEDIA_FILES=no이고 DELETE를 입력하지 않는 한 꺼짐 | /home 아래의 이미지, 오디오, 비디오 파일을 삭제합니다. 먼저 개수를 출력합니다. |
| 계정 잠금 | 5회 실패, 30분 | 팀원도 스스로 잠길 수 있습니다. root는 잠기지 않습니다. |
| ClamAV 및 루트킷 스캔 | 꺼짐 (INSTALL_CLAMAV, RUN_BASELINE_SCAN) | 느립니다. 라운드가 허용할 때 실행하십시오. |
| IPv6 | 켜짐 유지 (DISABLE_IPV6=no) | 체크리스트에서 요구하는 경우에만 끄십시오. |
| GRUB 비밀번호 | 자동화 안 함 | 실수하면 머신이 부팅되지 않을 수 있습니다. |
인바운드 트래픽은 기본 거부이며, 선택한 역할에 대해 허용됩니다. 이미지가 스코어링 에이전트에 보고하는 경우, 강화 전에 sudo ss -tulpn을 실행하고 강화 후에도 여전히 연결되는지 확인하십시오.
.gitlab-ci.yml은 각각 컨테이너에서 실행되는 세 개의 작업을 수행합니다: style 수준의 ShellCheck, tests/에 있는 27개의 bats 테스트, 그리고 Ubuntu 22.04 및 24.04에서의 dry-run 검사입니다. PAM 테스트는 pamtester로 로그인하여 올바른 비밀번호가 여전히 작동하는지, 그리고 잘못된 비밀번호 다섯 번으로 계정이 잠기는지 확인합니다. 나머지는 run(), 반복 편집, 백업, 설정 파싱, SSH 허용 목록, 계정 검토, MySQL purge 및 두 도구를 다룹니다. 로컬에서:
make lint
make test
make dry-run IMAGE=ubuntu:22.04
컨테이너 외부에서는 테스트가 건너뛰어지고 드라이런 스크립트는 오류와 함께 종료됩니다. 테스트가 하나라도 건너뛰어지면 CI가 실패합니다. 변경 규칙은 CONTRIBUTING.md에 있습니다.
모듈 헤더와 docs/security-controls.md는 CIS Ubuntu Linux Benchmark를 장(chapter) 단위로 인용하고, 11개의 NIST SP 800-53 Rev. 5 기본 통제 항목을 각 선택의 근거와 함께 인용합니다.
baseline/에 기록되어 검토됩니다.lib/packages.sh의 목록에 있거나 비활성화한 역할에 속하지 않는 한 패키지를 제거하는 것.저는 Lakeside High School의 CyberPatriot 프로그램 회장 겸 수석 연구원으로서 2024년부터 이 역할을 맡아 이 툴킷을 만들었습니다. 이 툴킷은 우리 팀의 교정 시간을 40% 단축했습니다. 저는 두 팀을 준결승으로 이끌었고, 우리 팀은 Linux 부문에서 3,000개 이상의 팀 중 상위 5위에 올랐습니다. 저는 20명 이상의 팀원을 교육했습니다. 자세한 내용은 whereisxuezugi.gitlab.io/amelek에서 확인하세요.
MIT. LICENSE를 참조하세요.