_{サポートされるバックエンドは機能によって異なります。機能マトリクス。}

散在するインフラストラクチャのエビデンスを、優先順位付けされ、相関され、検証可能なアクションに変える

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

ローカルリポジトリ、イメージ、SBOM、またはMCP設定から始めるか、セルフホスト型コントロールプレーンで読み取り専用のインフラストラクチャソースに接続します。生データ、認証情報、検出結果、ポリシー決定はすべてお客様の環境内に保持されます。

クイックスタート · ライブデモ · ドキュメント

エビデンスソースから検証済みアクションへ

セキュリティチームがスキャナーに困ることはほとんどありません。欠けているのは、何がスキャンされ、何が発見され、どの検出結果が実際に重要なシステムに接続されており、誰が修正を担当し、修正が維持されたかという、信頼できる単一のビューです。

agent-bom は、2つの正直なエントリーパスでこのループを閉じます:

両方のパスは収集後に収束します: エビデンスを同じFinding + UnifiedGraphコントラクトに正規化し、到達可能なリスクを相関させ、オーナーとSLAを割り当て、再スキャンして結果を検証します。インベントリは常に、名前付きターゲットまたは接続されたソースの出力であり、説明のないプリロードデータではありません。

製品の約束: 今日は1つの有用な成果物から始め、CI、接続されたソース、履歴、割り当て、コンプライアンスエクスポート、ランタイム強制をお客様の環境に追加する際も、同じエビデンスモデルを維持します。

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

製品の証明: 独立したエビデンス、1つの検証可能なパス

以下のビューは、コミットされた リファレンスエビデンスラボ — モデル化されたローカルインフラストラクチャ から取得したものです。認証情報不要の実行では、実際のリポジトリ、CycloneDX、Kubernetes IaC、MCPパーサーに加え、[email protected] / CVE-2023-4863 用のバンドルされたアドバイザリスキャナーを使用し、正確なOCIダイジェスト、Kubernetes UID、MCPツール、ワークロードアイデンティティ、ライブのローカルゲートウェイレシートを相関させます。これは顧客のエビデンスやライブクラウドの主張ではありません。

調査は最新の完了した相関を自動的に読み込み、ソースからパスへのジャーニーを最初に表示します。カスタムスナップショット選択は、鮮度ポリシーが可視化された明示的な高度なワークフローとして引き続き利用可能です。

結果として得られるパスは、すべての有向ホップがトラバース可能で来歴に裏付けられている場合にのみ確認されます: 公開サービス → ワークロード → ダイジェスト固定コンテナ → [email protected] / CVE-2023-4863 → MCP機能 → ワークロードアイデンティティ → モデル化された機密オブジェクトストア。同じラボは、観測されたゲートウェイ呼び出しと、修復ハンドオフ前の別個の厳格なオプトインブロックを記録します。

リファレンスラボを再生成 · 完全な製品ギャラリーを開く · キャプチャプロトコルを見る

役割別の価値

セキュリティエンジニアリングとGRCは別々のワークフローのままです: 検出結果と到達可能性は監査認証として提示されません。製品境界を参照してください。GitHub Actionsの収集と認証情報の要件は権限に文書化されています。シナリオの真実の境界はグラフコントラクトで定義されています。

クイックスタート

価値を証明する最小のパスを選択してください。リポジトリ、イメージ、SBOM、ワークステーション、またはMCP設定のスキャンには、アカウントやコントロールプレーンは不要です。

パスA — 今すぐスキャン、接続不要

オフラインサンプルは、アドバイザリデータベースをダウンロードせずに完了し、インベントリ、検出結果、到達可能なパス、修復出力の形状を示します。

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

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

agent-bom scan .

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

パスB — ソースを接続してからスキャン

ソースがローカルターゲットではなくアカウントやプラットフォームである場合にこのパスを使用します。顧客が管理するコントロールプレーンを起動し、Connections を開き、プロバイダーの読み取り専用グラントを追加し、最初のスキャンを実行します。ブラウザフローは検証後の明示的な初回スキャンをデフォルトとし、スケジュールスキャンは明示的なオペレーターのオプトインです。

pip install 'agent-bom[ui]'
AGENT_BOM_NO_AUTH_ROLE=analyst agent-bom serve --persist ~/.agent-bom/control-plane.db

明示的なSQLiteパスにより、再起動後もスキャンジョブ、検出結果、コンプライアンス履歴、グラフインベントリがまとめて利用可能になります。--persist は意図的に一時的なプロセスの場合にのみ省略してください。明示的なローカル analyst ロールは、このループバックオペレーターがスキャンを実行することを許可します。サーバーのデフォルトの匿名ロールは読み取り専用のままです。

ヘッドレスオンボーディングでは、agent-bom connect <provider> が正確なグラント、認証情報の境界、検証ステップ、次のスキャンコマンドを出力します。クラウド接続ガイドには、AWS、Azure、GCP、Snowflakeが、組織スコープとスケジューラの動作を含めて文書化されています。

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

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.103.2
    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_NO_AUTH_ROLE=analyst agent-bom serve --persist ~/.agent-bom/control-plane.db

次に Connections を開いてソースを追加するか、New Scan でリポジトリ、イメージ、SBOM、MCP設定、またはIaCパスをターゲットにします。スキャンがインベントリを生成します。サーバーを起動しただけではインベントリは投入されません。

共有デプロイメントには、本番向けのDockerまたはHelmパスを使用し、公開する前に実際のアイデンティティ、TLS、PostgreSQL、暗号化、監査キーを設定してください。

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

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

信頼

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

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

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

行き詰まった、または質問がどこに属するかわからない場合は、SUPPORT.mdにルーティングと、どのような応答を期待すべきかの正直な説明があります。

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

Apache-2.0ライセンス。