agent-bom v0.97.4

_{上記のマークは、サポートされている発見、スキャン、接続、デプロイ、またはエビデンスバックエンドを表しており、コネクタの深さが同一であることを示すものではありません。機能マトリックスを参照してください。}

AI、MCP、クラウドインフラ向けのオープンセキュリティスキャナおよびセルフホスト型コントロールプレーン。

15 のパッケージエコシステム · 16 のコンプライアンスサーフェス · 84 のMCPツール · アカウント不要
クイックスタート · ライブデモ · ドキュメント

発見 → スキャン → 関連付け → 実行

agent-bom は、SCA、シークレット、IaC、コンテナにわたってリポジトリとソフトウェアサプライチェーンをスキャンし、AIエージェント、MCP、モデル、データセットを棚卸しし、読み取り専用のクラウド、アイデンティティ、Snowflake、データソースに接続します。そのエビデンスを単一の Finding + UnifiedGraph モデルに正規化し、到達可能なリスクを関連付けてから、オーナー、修正、検証、コンプライアンスエビデンス、またはランタイムポリシーへと作業を進めます。

agent or tool entrypoint → MCP server → package → finding → impact → owner → fix → verify

アドホックにローカルまたはCIで実行するか、セルフホスト型コントロールプレーンを使用して、スケジュールまたは接続されたスキャン、履歴、割り当て、ランタイム強制を実行します。生のソースと認証情報は、顧客管理の実行境界内に留まります。収集、推論、静的、ランタイムの関係は明確に区別され、不完全なエビデンスは明示的に示されます。

クイックスタート · エビデンスワークフロー · 統合機能マトリックス · 測定されたマッチャーの証明 · コントロールプレーンアーキテクチャ

対象ユーザー

セキュリティエンジニアリングとGRCは別々のワークフローのままです。発見事項と到達可能性は監査認証として提示されません。製品境界を参照してください。

製品ジャーニー

以下のキャプチャは、明確にラベル付けされたサンプル環境を使用しています。ライブスキャンも同じ Finding + UnifiedGraph コントラクトを使用します。フルサイズの証明については、任意の画像を選択してください。

1 · インベントリの発見	2 · スキャン
3 · 到達可能なグラフ	4 · ランク付けされたパス
5 · 実行と検証

フル製品ギャラリーのランタイム強制に進む · キャプチャプロトコル

クイックスタート

ここから始めてください。これが正面玄関です — 2つのコマンド、アカウント不要、設定不要。 オフラインサンプルは、アドバイザリデータベースをダウンロードせずに完了し、インベントリ、発見事項、ブラスト半径の出力形式を示します。

pip install agent-bom
agent-bom scan --demo --offline

サンプルには既知の悪意のあるパッケージが意図的に含まれているため、終了ステータス 1 が期待され、印刷されたレポートは完全です。次にリポジトリをスキャンします:

agent-bom scan .

リポジトリスキャンは、インベントリ、発見事項、到達可能な影響を示します。 agent-bom scan . と agent-bom scan -p . は同じコマンドです。PATH は --project のエイリアスです。

切断されたスキャンが必要ですか？ まず最小のパッケージアドバイザリデータベースをシードします:

agent-bom db update --osv-ecosystem PyPI
agent-bom scan . --offline

そのデータベースが存在しないか読み取れない場合、スキャンは -o が設定されているときに部分的なアーティファクトを書き込み、1 で終了します。したがって、CIは利用できないアドバイザリカバレッジをクリーンなスキャンと誤認することはできません。

新しいデータベースでは、そのコマンドは選択したエコシステムのみをカバーします。他のエコシステムのパッケージは、明示的なオフラインカバレッジギャップのままです。ポリグロットリポジトリの場合は --osv-ecosystem を繰り返すか、OSVの全エコシステムアーカイブには agent-bom db update --source osv を使用します。完全なアーカイブは1 GBを超える可能性があり、数分かかる場合があり、サーバーが提供する場合は正確な合計でライブ進行状況を表示します。ディストリビューション、エクスプロイト確率、既知の悪用済み脆弱性フィードも必要な場合は、より広範な agent-bom db update を実行します。

非ゼロの終了はクラッシュではなく判定です。 scan は、ゲートに一致するものがなかった場合は 0 で終了し、一致した場合は 1 で終了します — 設定した --fail-on-* しきい値、既知の悪意のあるパッケージ、または完了しなかったスキャンです。レポートはどちらの場合も完全に印刷され、最後の行は一致したゲートを指定します。完全な終了コードコントラクト。

agent-bom scan . -f sarif -o findings.sarif でアーティファクトを保存するか、フォーマットとCIの使用法については初回実行ガイドに従ってください。

日常の開発者ループ

インストールせずにスキャナを試し、パッケージを追加する前に確認します:

uvx agent-bom scan .
uvx agent-bom check [email protected] --ecosystem pypi

check は、インストール前の許可/不安全/不完全な判定を返します。scan は、リポジトリに加えて検出されたAI/MCP設定をカバーします。依存関係とシークレットの両方のゲートをチームで自動化するには、同梱のコンシューマフックをピン留めします:

repos:
  - repo: https://github.com/msaad00/agent-bom
    rev: v0.102.0
    hooks:
      - id: agent-bom-secrets
      - id: agent-bom-scan

pre-commit install を一度実行します。フックはagent-bomを独自の分離環境にインストールするため、コントリビューターは別のグローバルインストールを必要としません。フックの動作とCIの例。

agent-bom scan --demo --offline

セルフホスト

ループバックコントロールプレーンを起動します:

pip install 'agent-bom[ui]'
agent-bom serve

共有デプロイの場合は、ドキュメント化されたDockerまたはHelmパスを使用し、公開する前に実際のアイデンティティ、TLS、PostgreSQL、暗号化、監査キーを設定します。

例はこのリリース候補を対象としています。正確なピンをコピーする前に、リリースの可用性を確認してください。それ以外の場合は、PyPIに表示されている最新バージョンを使用してください。

デプロイ概要 · エンタープライズ設定 · クラウド接続

信頼

• デフォルトで読み取り専用の発見。ランタイムの書き込み決定は別個かつ明示的です。
• 認証情報は、保存時に書き込み専用で、保存時に暗号化され、APIレスポンスによって返されることはありません。
• APIおよびコントロールプレーンルートは、明示的なローカルモード外ではテナントスコープで認証保護されています。
• 欠落しているエビデンスは、利用不可または部分的として表示され、事実上のゼロに変換されることはありません。
• 公開されている例とスクリーンショットは、決定的な合成識別子のみを使用します。

脅威モデル · リリース検証 · セキュリティポリシー · MCPセキュリティモデル

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

行き詰まっている、または質問の場所がわからない場合は、SUPPORT.md にルーティングと、期待できる応答についての正直な記述があります。

コントリビューションを行うには、CONTRIBUTING.md、AGENTS.md、およびオープンイシューから始めてください。

Apache-2.0ライセンス。