agent-bom

AI エージェントの背後にある脆弱なソフトウェアを見つけ、露出の証拠を追跡します。

AI、MCP、クラウドインフラストラクチャ向けのオープンソースセキュリティスキャナー兼セルフホスト可能なコントロールプレーンです。 AI エージェントと MCP サーバーを担当する AppSec およびプラットフォームエンジニア向けです。 リポジトリをスキャンし、検出結果をエージェントやインフラストラクチャのコンテキストと関連付け、 影響範囲と到達可能性の証拠に基づいて修正の優先順位を決定できます。ローカルスキャンにアカウントは不要です。

クイックスタート · インテグレーション · サンプルグラフ · セルフホスト · 製品ツアー · ドキュメント

uv をインストールした状態で、調査するリポジトリから次を実行します。

uvx agent-bom scan .

検出されたエージェントと MCP サーバーを確認し、重大度の高い検出結果から優先して対処し、該当パッケージの修正ガイダンスに従ってください。判定とあわせてカバレッジの不足箇所も確認してください。証拠が不完全な場合、評価に問題がないとは言えません。 このスキャンで確認できることと確認できないこと。

レビュー済みの修正を適用してロックファイルを更新し、同じリポジトリに対して uvx agent-bom scan . を再実行して、検出結果が変化したことを確認してください。 uvx agent-bom scan . -f sarif -o findings.sarif でレポートを保存し、アップロードして CI のゲートを設定してください。 セットアップに失敗した場合は uvx agent-bom doctor を実行してください。pip でのインストール方法と既存の checkup アシスタントのワークフローについては、初回実行ガイドをご覧ください。

GitHub Actions では、同じスキャン結果を SARIF としてコードスキャンにアップロードし、CLI と同じデフォルトのゲートに従って重大またはクリティカルな検出結果がある場合に失敗します。

permissions:
  contents: read
  security-events: write
steps:
  - uses: actions/checkout@v4
  - uses: koda-ai-studio/agent-bom@v0
    with:
      upload-sarif: 'true'

すぐに試せるプロジェクトがない場合は、uvx agent-bom scan --demo --offline を実行して、同梱のサンプルを確認してください。終了コード 1 は想定どおりです。サンプルがセキュリティゲートに該当しています。ゼロ以外の終了コードは、セキュリティゲートへの該当または評価の不完全を示す場合があります。レポートとカバレッジを確認してください。 終了コードをご覧ください。

この録画では、ラベル付きのサンプルデータと同梱のアドバイザリを使用しています。認証情報への参照は名前であり、シークレットの値ではありません。記録された関係性は、悪用やデータアクセスの成功を証明するものではありません。

対応範囲

対応ソース

検出とスキャンでは、現在これらのソースから読み取ります。最後の行には、エビデンスの送信先が記載されています。リストはコードに基づくマニフェスト（docs/images/integrations-manifest.json）から生成され、実装のない項目が記載されている場合、テストは失敗します。

製品名とロゴは各所有者の商標であり、対応するエビデンスソースを識別する目的でのみ使用しています。これらの使用は、推奨や提携を意味するものではありません。

コンテキストと露出を調査する

脆弱なコンポーネントを使用しているエージェントはどれですか？ そのエージェントは何にアクセスできますか？ その経路を裏付けるエビデンスは何ですか？ 保持されたスキャンを、テナント単位でスコープされた正確な ID によって関連付けます。各エージェントから MCP サーバー、パッケージ、検出結果、認証情報、データストアに至るまで、記録された影響範囲を追跡します。各関係のソースとエビデンスの種類を確認し、同じスコープを再スキャンして変更点を調べます。

架空の環境のサンプルです。破線の使用、認証情報、アクセスのリンクは設定またはモデル化されたものであり、実行時に観測されたものではありません。経路分析は収集されたスナップショットのみを対象とします。 環境グラフをフルサイズで開く。

エージェントから修正の検証まで： Document Intake Agentを選択 → CVE-2023-4863（重大度：高、KEV掲載）と各矢印のエビデンスを確認 → 提案された修復を実施 → 変更されたピンを再スキャンしてスナップショットを比較します。この比較で検証されるのは変更された入力であり、実行中のデプロイではありません。

補足エビデンス：1つのパッケージ、3つの解析済み入力。 リポジトリのピン、イメージのSBOM、モデル化されたKubernetesワークロードは、1つの[email protected]に解決されます。イメージのインベントリとデプロイの出現箇所は別々のノードとして維持され、アドバイザリの受領記録は開いた状態です。

実際のパーサーとモデル化されたインフラストラクチャを使用しています。グラフ上の経路は、悪用されたことを証明するものではありません。 関係グラフをフルサイズで開く。 コンテキスト、相関関係、到達可能性を調べる · リファレンスラボを実行する · このスクリーンショットを再現する

調査結果をチームに説明するには、影響ブリーフを作成します。 影響を受けるアセット、ソースの根拠、エビデンスの不足、次に確認すべきアクションをまとめます。

新しい CVE の影響を受けていますか？ 新しい CVE に対応する： 保存済みスキャンと照合します。NVD のみが公開している CVE も対象です。影響を受けるアセットと修正対象、確認が必要な影響を受ける可能性のあるディストリビューションパッケージ、影響範囲を確認できます。

サンプルグラフを開く

ブラウザーでデモを試す：ラベル付きのサンプルデータを使った UI の読み取り専用コピーです。インストールもバックエンドも不要です。スキャン、設定、サインインは無効になっています。同じグラフをローカルで開くには：

pip install 'agent-bom[ui]==0.110.0'
agent-bom quickstart --run --offline

表示されたサーバーコマンドを実行し、グラフの URL を開きます。オフラインのクイックスタートではパッケージの CVE 検索を省略するため、CVE がゼロでも安全とは判断できません。アドバイザリに基づく調査結果を確認するには、同梱のデモを使用するか、アドバイザリデータベースにデータを登録してください。

環境内でセルフホストする

お客様自身のインフラストラクチャ、ID、データベース、監査境界で運用できます。 公開リリースのチェックアウトからローカルのパイロットを開始します。

git clone --depth 1 --branch v0.110.0 https://github.com/koda-ai-studio/agent-bom.git && cd agent-bom
AGENT_BOM_IMAGE_TAG=0.110.0 docker compose up -d

http://localhost:3000**を開き、**Connections**または**New Scanを選択します。パイロットはループバックにバインドされ、状態をDockerボリュームに保持します。クラウドアカウントの場合は、スコープを限定した読み取り専用の接続を追加し、アクセスを確認してからスキャンを開始します。 認証済みデプロイを使用してください。

• CLIまたはCIでスキャンし、検出結果、SBOM、レポートをエクスポートします。
• インベントリ、グラフのエビデンス、修正、コンプライアンスを、お客様自身のコントロールプレーンに一元化します。
• プロキシまたはゲートウェイを通じて、選択した実行中のMCPツール呼び出しにポリシーを適用します。

Dockerパイロットガイド · PostgreSQLを使用したCompose · デプロイ方法を選択 · エンタープライズ制御 · クラウドアカウントを接続

連携

/plugin marketplace add koda-ai-studio/agent-bom
/plugin install agent-bom@agent-bom

検出では、デフォルトで読み取り専用アクセスを使用します。明示的なディスクのサイドスキャンでは、一時的なクラウドリソースが作成されます。エビデンスが不足している場合は、利用不可または部分的な状態のままになります。制御マッピングは監査認証ではありません。

永続化されたランタイム、プロキシ、ゲートウェイのアクティビティは、ソースの証跡と制限付きの時間枠をグラフに保持します。正確なインベントリ参照をレコードに紐付けられます。不明な ID や収集の欠落は明示されたままになります。記録されたアクティビティは、実行の証明にもアクセス権の付与にもなりません。ランタイムエビデンスの境界をご覧ください。

MITRE の手法との関連付けは調査の文脈を提供するものであり、攻撃の証明ではありません。ATLAS マッピングの証跡には、脆弱性との関連付けとソースカタログのハッシュが保持されます。モデル化されたグラフパスは、実際に観測された実行や有効なアクセスを立証するものではありません。

測定済みマッチャーの証明 · 製品の境界 · 権限 · 脅威モデル · リリースの検証 · グラフデータモデル

コントリビュートとサポート

初めての方へ。30 分で初めての PRガイドと、すぐに使える Codespace があれば、ローカル環境を設定せずに、何もない状態からテストに合格するまで進められます。good first issueまたはコントリビューターロードマップから始めて、Discordの #contributors で質問してください。

agent-bom は、さらなるメンテナーを募集しています。GOVERNANCE.mdでは、コントリビューターからトリアージ担当者、レビュアー、メンテナーへ進む道筋を説明し、MAINTAINERS.mdでは、各担当者が何をレビューするかを紹介しています。agent-bom が役立つエビデンスを提供できた場合は、スターを付けるか、フィードバックに短いコメントを残していただけると、ほかのセキュリティチームがこのプロジェクトを見つけ、信頼する助けになります。

コントリビュート · 機能とロードマップ · サポート · 不正確な検出結果を報告 · Apache-2.0

ソースのバージョン：v0.111.0 · 最新リリース：v0.110.0 · 変更履歴