
Ubuntuシステムのフォレンジックトリアージ用Python CLI/TUI — アーティファクト収集、タイムライン相関、Wazuh統合により、永続化メカニズムを検出して修復します。
ライブなUbuntuシステム向けのフォレンジックトリアージ — 自動化されたアーティファクト収集、永続化の検出、そしてガイド付きの修復を約1分で実行します。
Linuxシステムが侵害された疑いがあるとき、最初の30〜40分は通常、同じ10個のコマンドを順番に実行するために費やされます。実行中のプロセスを確認し、奇妙なcronジョブを探し、LD_PRELOADをgrepし、authorized_keysに新しいエントリがないかスキャンし、sudoersを監査する。各ステップは手作業で、コンテキストスイッチが発生し、プレッシャーの中でミスをしやすいものです。1つのソースを見落とすだけで — 例えば /etc/sudoers だけでなく /etc/sudoers.d/ を、あるいは /etc/cron.d/ に加えてユーザーのcrontabを — 不完全な全体像しか得られません。
既存の選択肢はこれをきれいに解決しません。lynis はハードニング監査ツールであり、トリアージツールではありません — クリーンなシステムでは設定の弱点を報告し、侵害されたシステムではノイズを生成します。chkrootkit と rkhunter は既知のルートキットシグネチャをチェックしますが、悪用されたsystemdタイマーや正規に見えるcronエントリのような新しい永続化手法には盲目です。汎用的なSIEMクエリは、目の前のシステムに存在しないかもしれないログ基盤を必要とします。そしてVolatilityのようなフォレンジックスイートは、稼働中のホスト上のライブシェルではなく、メモリイメージを対象としています。
このギャップを埋めるのは、今すぐライブシステム上で動作し、最も一般的な永続化ベクターをカバーし、複数のログソースにまたがるアクティビティをタイムラインに相関させ、外部エージェント、データベース、インターネット接続を必要とせずに、何を調べるべきかを正確に教えてくれるツールです。
ubuntilsは4つの連続したステージで実行されます:
/proc、cronテーブル、systemdユニット、SSHキー、sudoersファイル、環境定義、パッケージ整合性(dpkg --verify)、PAM/NSS設定、ロード済みカーネルモジュールからフォレンジックアーティファクトを並行して収集します。ほとんどのコレクターは1〜2秒で完了しますが、インストール済みのすべてのパッケージファイルを再チェックする dpkg --verify が支配的です — Ubuntu 26.04 arm64デスクトップVMでのフルスキャンは29〜68秒かかりました。--rules で読み込まれたカスタムルール — を収集されたアーティファクトに対して実行し、約1秒でランク付けされた信頼度スコア付きの検出事項リストを生成します。--json)として表示されます。ubuntils自体はネットワーク呼び出しを行わず、すべての機能 — カスタムルールと相関を含む — はローカルに収集されたアーティファクトに対して実行されます。検出事項がホストから出る唯一の方法は Wazuh統合 です: Wazuhエージェントがインストールされている場合、ライブの scan はその検出事項をローカルファイルに書き込み、エージェント がそれをマネージャーに送信します。実行ごとにこれをオフにするには --no-wazuh を渡します。
ubuntils scan は以下のすべての変更による影響を受けません — 依然として 100% ライブで単一ホスト対応であり、既存のすべてのフラグはまったく同じように動作します。2 つの追加コマンド collect と analyze は、同じ検出/タイムラインパイプラインを、調査対象ホスト上で直接検出を実行できない (または実行したくない) 場合のためのオフライン対応の取得後解析ワークフローに分割します — 検出カバレッジに関する注意事項を含め、以下の オフライン解析: collect と analyze を参照してください。
Ubuntu 22.04+ および PEP 668 を採用する任意のシステム (推奨):
Ubuntu 22.04+ はシステム全体への pip install をブロックします。pipx を使用してください — 環境を透過的に処理するため、意識する必要はありません:
sudo apt install pipx -y
pipx ensurepath # then open a new shell
git clone https://github.com/asmitdesai/ubuntils.git
cd ubuntils
pipx install -e .
ubuntils scan # not `ubuntils scan` — see below
通常のユーザーとして実行します。scan と collect は sudo の下で自身を再呼び出しします。自分で ubuntils … と入力すると command not found で失敗します。これは sudo の secure_path に、pipx がコマンドを配置する ~/.local/bin が含まれていないためです。root シェルから起動する必要がある場合は、インストールされたバイナリをパスで指定して呼び出すか(~youruser/.local/bin/ubuntils scan)、代わりに仮想環境へインストールしてください:
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/ubuntils scan
古いシステム / 手動インストール:
git clone https://github.com/asmitdesai/ubuntils.git
cd ubuntils
pip install -r requirements.txt -e .
ubuntils scan
ubuntils は完全なアーティファクトアクセスに root を必要とします。非 root ユーザーとして ubuntils scan を実行すると、同じ Python インタープリタ(絶対パス指定)を使って sudo で自動的に自身を再起動するため、PATH を root プロセスに引き継ぐことなく、正しい環境が使用されます。すべての外部コマンド(ss、dpkg、systemctl、…)は、固定された root 所有の検索パスで解決され、あなたの PATH は決して使用されません。root なしで実行すると、/etc/shadow、一部の /proc エントリ、保護された cron ファイルがスキップされ、それぞれについて警告がログに記録されます。
検出のみ — インタラクティブ TUI:
ubuntils scan
JSON出力をファイルに保存して検出:
ubuntils scan --json > /tmp/triage-$(hostname)-$(date +%Y%m%d).json
CLIによる修復プレビューでの検出(ドライラン — 変更は適用されません):
ubuntils scan --remediate
CLI修復適用後の検出:
ubuntils scan --remediate --confirm
印刷版:
ubuntils version
改ざん検知可能なバンドルを後で、またはオフラインで分析するために収集する:
ubuntils collect --output /path/to/bundle.tar.gz
以前に収集したバンドルを分析する(root 権限不要):
ubuntils analyze /path/to/bundle.tar.gz --json
バンドルの代わりに、マウントされたフォレンジックイメージまたは抽出されたファイルシステムツリーを分析する:
ubuntils analyze --root /mnt/forensic-image --json
バンドル形式と、重要な点として、ライブの scan と比較してオフライン分析では検出できないものについては、オフライン分析: 収集と分析 を参照してください。
ubuntils scan [OPTIONS]
--json Output JSON to stdout instead of launching the TUI
--output FILE Write the JSON report to FILE (implies --json)
--remediate Run the remediation engine after detection
--confirm Required with --remediate to actually apply changes (else dry-run)
--min-confidence N Only auto-remediate findings with confidence >= N (default 40)
--no-wazuh Never forward findings to a local Wazuh agent
--config FILE YAML allowlist of findings to suppress (see below)
--baseline FILE YAML baseline of environment-specific known-good fingerprints to suppress (see below)
--since TIME Limit the timeline to events since TIME (e.g. '24h', '7d', '2026-05-20')
--rules FILE YAML file of custom detection rules to add (see below)
--verbose Verbose structlog output
ubuntils collect [OPTIONS]
--output FILE Bundle path to write (default ./ubuntils-bundle-<timestamp>.tar.gz)
--verbose Verbose structlog output
ubuntils analyze (BUNDLE | --root PATH) [OPTIONS]
--root PATH Analyze a mounted image / artifact tree instead of a bundle
--json Output JSON instead of launching the TUI
--output FILE Write the JSON report to FILE (implies --json)
--config FILE YAML allowlist of findings to suppress (same format as scan)
--baseline FILE YAML baseline of environment-specific known-good fingerprints to suppress (same format as scan)
--rules FILE YAML file of custom detection rules to add (same format as scan)
--since TIME Limit the timeline to events since TIME (e.g. '24h', '7d', '2026-05-20')
--verbose Verbose structlog output
ubuntils version
Print version string and exit
--config)新しくプロビジョニングされたホストや CI 管理のホストでは、デプロイキー、プロビジョニング用 crontab、組み込みのシェル初期化など、想定内のノイズが発生します。対応担当者にそれを頭の中でフィルタリングするよう教える代わりに、YAML の許可リストで明示的に抑制します:
# allowlist.yaml
allowlist:
rules:
- SHELL_RC_MODIFICATION # suppress this rule entirely
paths:
- /home/ci/.ssh/authorized_keys # suppress any finding on this exact path
ubuntils scan --json --config allowlist.yaml
抑制は常に明示的です — ルールIDおよび/または正確なアーティファクトパスによって行われます。包括的な「すべてを無視する」スイッチはありません。サンプルは examples/allowlist.yaml にあります。
--baseline)--config は、このコードベースに対して ubuntils を実行する誰に対しても、どこでも ルールまたはパスを抑制します。--baseline はより狭く、環境固有です。つまり、「この 環境では、この正確なアーティファクト — この SSH キー、この RC ファイル — は既知の正常である」と述べるもので、同じツールでスキャンする他のすべてのホストに対してルールやパスを無効化することはありません。--config とは別のファイルとして保持されるのは、--rules が別であるのと同じ理由です。抑制とルール全体の許可リスト化は、1つのファイルに同居すべきではない異なる関心事です。