ペネトレーションテスター向けのHuman-in-the-loop型AI CLI。偵察、検証、証拠付きレポート作成をターミナルで実行
zakirkun/guardian-cli
Google Gemini、OpenAI、ClaudeなどのLLMで、nmapやnucleiを使ったペネトレーションテストを実行するPython製CLI。
- スター
- 1,895
- フォーク
- 368
- 未解決の Issue
- 5
- 最終コミット
- 4 か月前
これは何?
Guardianは、ペネトレーションテストを自動化するコマンドラインフレームワークです。AIエージェントがテスト手順を計画し、実行するセキュリティツールを選択して、その出力を分析します。すべてのツール実行が記録されるため、各検出結果を生成元のコマンドまでたどれます。
OpenAI、Claude、Gemini、OpenRouter、Requesty、Ollama、OpenAI互換エンドポイントなど、複数のAIプロバイダーに対応しています。ネットワークスキャン、Webレコナissance、サブドメイン探索、脆弱性スキャン、SSL/TLSテスト、クラウドおよびコンテナの監査、Active DirectoryやAndroidの評価をカバーする約50種類のツールラッパーが用意されています。ワークフローは依存関係グラフとしてYAMLで定義でき、各ステップを並列実行したり、中断後に再開したりできます。
レポートはMarkdown、HTML、JSONで生成でき、検出結果はSARIF、DefectDojo、Slackに出力できます。スコープの検証、侵襲的なツールの実行前に確認を求める仕組み、ログ内のAPIキーのマスキングも備えています。Guardianの利用は、ユーザーにテスト権限があるシステムに限られます。
主な機能
- 01Gemini、OpenAI、Claude、ローカルのOllamaモデルなど、複数プロバイダーによるAIの計画立案とツール選択。
- 02ネットワーク、Web、クラウド、モバイル分野をカバーする約50種類のセキュリティツールラッパー。
- 03依存関係に基づく並列実行と、中断後の再開に対応したYAMLワークフロー。
- 04各検出結果を元となるツール実行に紐付ける証跡の記録。
- 05Markdown、HTML、JSON、SARIFへのレポート出力と、DefectDojoおよびSlackとの連携。
- 06スコープの検証と、侵襲的なツールの実行前に確認を求める仕組み。
ユースケース
- テスト権限のあるシステムに対して、再現性のあるレコナissanceやWeb脆弱性スキャンを実行する。
- 証跡付きの構造化されたペネトレーションテストレポートを作成し、課題管理ツールやSARIFベースのコードスキャンに出力する。
- Ollama経由でローカルモデルを使い、LLM駆動のセキュリティ自動化を試す。
クイックスタート
- 1
リポジトリをクローンする
git clone https://github.com/zakirkun/guardian-cli.git - 2
プロジェクトディレクトリに移動する
cd guardian-cli - 3
仮想環境を作成してインストールする(Linux/macOS)
python3 -m venv venv && source venv/bin/activate && pip install -e . - 4
インストールを確認する
python -m cli.main --help
使う前に知っておきたいこと
- OpenAI、Anthropic、Google、OpenRouter、Requestyなど、対応するAIプロバイダーのAPIキーが必要です。
- 多くのセキュリティツールはオプションであり、すべての機能を利用するには別途インストールが必要です。
- メタデータ上のライセンスはNOASSERTIONですが、READMEにはMITと記載されています。使用前にLICENSEファイルを確認してください。
- 許可を得たセキュリティテストのみを対象としているため、使用には法的責任が伴います。
トピック
よくある質問
- guardian-cli とは?
- Google Gemini、OpenAI、ClaudeなどのLLMで、nmapやnucleiを使ったペネトレーションテストを実行するPython製CLI。 Guardianは、ペネトレーションテストを自動化するコマンドラインフレームワークです。AIエージェントがテスト手順を計画し、実行するセキュリティツールを選択して、その出力を分析します。すべてのツール実行が記録されるため、各検出結果を生成元のコマンドまでたどれます。
- guardian-cli は無料で使えますか?ライセンスは?
- guardian-cli は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- guardian-cli は今もメンテナンスされていますか?
- 半年以内に更新あり。guardian-cli の最終コミットは 2026年6月27日 です。
- guardian-cli は何に使えますか?
- テスト権限のあるシステムに対して、再現性のあるレコナissanceやWeb脆弱性スキャンを実行する。 証跡付きの構造化されたペネトレーションテストレポートを作成し、課題管理ツールやSARIFベースのコードスキャンに出力する。 Ollama経由でローカルモデルを使い、LLM駆動のセキュリティ自動化を試す。
- guardian-cli のインストール方法は?
- リポジトリをクローンする: git clone https://github.com/zakirkun/guardian-cli.git プロジェクトディレクトリに移動する: cd guardian-cli 仮想環境を作成してインストールする(Linux/macOS): python3 -m venv venv && source venv/bin/activate && pip install -e . インストールを確認する: python -m cli.main --help
- guardian-cli はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/zakirkun/guardian-cli
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
ペアリングしたBluetoothスマートフォンやスマートウォッチが圏外になると、デスクトップを自動ロックするPython製CLIです。
経験からスキルを作成・改善し、多数のモデルプロバイダーに対応、CLIやメッセージアプリから利用できる自己改善型AIエージェント。
React、Next.js、Svelte、Vue、Node.jsでAIアプリケーションやエージェントを構築するための、プロバイダーに依存しないTypeScriptツールキット。