
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 はスキップ)。スクリプトが非ゼロで終了した場合、stderr に書き込んだ場合、または /root/hardening-run 以外の場所を変更した場合に失敗します。2 回目のパスでは、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 は、2 回目の実行で重複した行が追加されるのを防ぎます。レビュー済みのパスワードは実行のたびに再設定されます。
| モジュール | 動作内容 |
|---|---|
packages.sh | システムを更新し、autoremove を実行し、apt を毎日更新するように設定します。18 個の攻撃用ツールと 7 個のゲームを削除します。12 個の両用ツールと 14 個のレガシーサービスをパージする前に確認し、デフォルトは保持です。 |
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 をパージします。オンの場合は Samba をインストールして共有のレビューをユーザーに委ね、vsftpd、MySQL、Apache をインストールして堅牢化します。メールと印刷はポートルールのみです。 |
users.sh | 指定したアカウントをレビューします: 削除、管理者権限、パスワードリセット、90/1/7 日の有効期限。新しいアカウントを作成します。追加の UID 0 アカウントと空のパスワードを持つアカウントのパスワードをロックします。 |
kernel.sh | 1 つのマークされたブロックに 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 と rootkit スキャンはオプトインです。 |
forensics.sh | 実行終了時に 11 個のベースラインファイルを保存します: システム情報、ユーザー、グループ、最終ログイン、プロセス、サービス、リッスンポート、インストール済みおよび手動インストール済みパッケージ、ファイアウォール状態、sshd_config。 |
tools/ には 2 つのヘルパーがあります: 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 と rootkit スキャン | オフ (INSTALL_CLAMAV、RUN_BASELINE_SCAN) | 処理が遅いためです。ラウンドに余裕があるときに実行してください。 |
| IPv6 | オンのまま (DISABLE_IPV6=no) | チェックリストで求められた場合のみオフにしてください。 |
| GRUB パスワード | 自動化なし | 誤りがあるとマシンが起動できなくなる可能性があります。 |
インバウンドトラフィックはデフォルト拒否で、選択したロールに対して許可されます。イメージがスコアリングエージェントに報告する場合は、堅牢化の前に sudo ss -tulpn を実行し、その後も接続できることを確認してください。
.gitlab-ci.yml は3つのジョブをそれぞれコンテナ内で実行します。style レベルの ShellCheck、tests/ 内の27個の bats テスト、そして Ubuntu 22.04 と 24.04 でのドライランチェックです。PAM テストは pamtester でログインし、正しいパスワードが引き続き機能すること、および5回の誤ったパスワードでアカウントがロックされることを確認します。残りは run()、繰り返しの編集、バックアップ、設定の解析、SSH 許可リスト、アカウントレビュー、MySQL のパージ、および2つのツールをカバーしています。ローカルでは:
make lint
make test
make dry-run IMAGE=ubuntu:22.04
コンテナ外ではテストはスキップされ、ドライランスクリプトはエラーで終了します。テストが1つでもスキップされた場合、CIは失敗します。変更に関するルールはCONTRIBUTING.mdに記載されています。
モジュールのヘッダーとdocs/security-controls.mdは、CIS Ubuntu Linux Benchmarkを章ごとに、また11個のNIST SP 800-53 Rev. 5ベースコントロールを引用し、それぞれの選択理由を記載しています。
baseline/に記録され、レビューされます。lib/packages.sh内のリストに含まれる場合、または無効化したロールに属する場合を除き、パッケージを削除すること。私はLakeside High SchoolのCyberPatriotプログラムの会長兼リードリサーチャーとして、2024年からこの役職に就いており、このツールキットを開発しました。このツールキットにより、チームの修復時間は40%短縮されました。私は2つのチームを準決勝に導き、私たちのチームはLinux部門で3,000チーム以上の中でトップ5に入りました。これまでに20名以上のメンバーを指導してきました。詳細はwhereisxuezugi.gitlab.io/amelekをご覧ください。
MIT。LICENSEを参照してください。