Repolode
zakirkun

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. 1

    リポジトリをクローンする

    git clone https://github.com/zakirkun/guardian-cli.git
  2. 2

    プロジェクトディレクトリに移動する

    cd guardian-cli
  3. 3

    仮想環境を作成してインストールする(Linux/macOS)

    python3 -m venv venv && source venv/bin/activate && pip install -e .
  4. 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 の数値は毎日更新されます。

関連プロジェクト