脆弱性コンテキストフロー
- プラン: Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
- ステータス: 実験的機能
この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。
脆弱性コンテキストフローを使用して、コードベースを読み取り、次のセキュリティカテゴリにわたるコンテキストを生成します:
- 認証モデル
- 認可モデル
- 機密データの分類
- セキュリティ境界
フローを有効にすると、人間によるプッシュがデフォルトブランチを更新した後、最大24時間に1回自動的に実行されます。ボットおよびサービスアカウントによるプッシュ、ならびにブランチの作成は、フローをトリガーしません。フローがトリガーされると、次の処理が完了します:
- プロジェクトのコードベースを読み取り、そのアーキテクチャとセキュリティ対策状況を把握します。
- 各セキュリティコンテキストカテゴリの構造化された出力を生成します。
- ダウンストリームのセキュリティ機能で使用できるように、コンテキストを保存します。
分析はバックグラウンドで実行されます。このフローを手動でトリガーすることはありません。
この機能を有効にすると、セキュリティコンテキストを生成するための分析を行う目的で、プロジェクトのソースコードが大規模言語モデル(LLM)に送信されます。この機能を有効にする前に、組織のデータポリシーを確認してください。
前提条件
- GitLab Duo Agent Platformの前提条件を満たしていること。
- ベータ版機能と実験的機能をオンにする。
- トップレベルグループで基本フローを許可および脆弱性コンテキストフローをオンにします。
- サービスアカウントを許可するようにプッシュルールを設定している。
- 独自のRunnerを設定しているか、プロジェクトでGitLabホストRunnerをオンにしている。
- ユーザー設定でデフォルトのGitLab Duoネームスペースを設定します。
脆弱性コンテキストフローをオンにする
この機能を使用するには、ルートグループで基本フローを有効にし、プロジェクトでもこの機能を有効にする必要があります:
グループで基本フローを許可する
グループ内のすべてのプロジェクトで基本フローを使用できるようにすることができます。個々のプロジェクトでは、引き続きプロジェクトの設定で機能を有効にする必要があります。
グループに対して脆弱性コンテキストフローを許可するには:
- 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
- 設定 > GitLab Duoを選択します。
- 基本フローを許可で、脆弱性コンテキストフローチェックボックスを選択します。
- 変更の保存を選択します。
プロジェクトでオンにする
前提条件:
- プロジェクトのメンテナーまたはオーナーロールが必要です。
- 名前がDuo Vulnerability Contextで始まるサービスアカウントユーザーのプロジェクトに対するメンテナーまたはオーナーロール。
プロジェクトに対して脆弱性コンテキストフローを許可するには:
- 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 設定 > 一般を選択します。
- GitLab Duoを展開します。
- 脆弱性コンテキストフローをオンにするトグルをオンにします。
- 変更を保存を選択します。
- 左側のサイドバーで、管理 > メンバーを選択します。
- 名前がDuo Vulnerability Contextで始まるサービスアカウントユーザーに、プロジェクトに対するメンテナーまたはオーナーロールがあることを確認します。
フローをオフにする
プロジェクトの脆弱性コンテキストフローをオフにすると、既存のコンテキストは脆弱性の詳細ページのリスクセクションに引き続き表示されます。フローはコンテキストの更新を停止します。フローをオフにしても、既存のコンテキストは削除されません。
フローがスキャンするセキュリティコンテキスト
フローは次のカテゴリでコンテキストを生成します。各カテゴリでは、脆弱性の影響を評価するのに役立つ構造化された情報が提供されます。
- 認証:
YesまたはNo。コンポーネントで認証が必要かどうかを示します。 - 認可:
ElevatedまたはStandard。コンポーネントの脆弱性を悪用するために、昇格された権限が必要かどうかを示します。 - 機密データ:
YesまたはNo。コンポーネントが個人情報、認証情報、トークン、決済データ、健康データなどの機密データを処理するかどうかを示します。 - セキュリティ境界:
Network access、User input、Partner boundary、Trusted service、Internal only、またはIsolatedのいずれか1つ以上。このコンポーネントがどの信頼境界上に位置するか、したがって脆弱なコードが信頼されていない呼び出し元にどの程度露出しているかを示します。
これらの値は、脆弱性の詳細ページのリスクセクションに表示されます。
サポートされているスキャナー
脆弱性コンテキストフローによって生成されたセキュリティコンテキストは、次のスキャナーと機能で使用されます:
既知の問題
- フローはソースコードのみを分析します。実行時のテレメトリ、動的な解析の結果、関数レベルの到達可能性データは入力として使用されません。
- コンテキストの生成は、リポジトリ内で利用可能な情報に依存します。ドキュメントが少ないプロジェクトや、標準的ではない構造のプロジェクトでは、生成されるコンテキストの詳細度が低くなる場合があります。
- 対象となるプッシュを受信すると、24時間のデバウンスが開始されます。この期間内にプッシュしても、新しい分析はトリガーされません。実行が失敗した場合、24時間のウィンドウが終了するまで再試行されません。