Sensei で検出事項を修正する (Pro)

注: Sensei は DefectDojo Pro 限定機能であり、現在 BETA(ベータ版)です。

リポジトリがオンボーディングされると、Sensei は検出事項および Sensei ハブに直接表示されるようになります。このページでは、リポジトリのスキャン、自動修正候補のトリアージ、個々の検出事項の修正について説明します。修正をトリガーするには、検出事項の製品に対して少なくとも Writer アクセス権が必要です。

リポジトリをスキャンする

スキャンは、検出事項をブランチ名にちなんだエンゲージメントにインポートします。Sensei ハブからオンデマンドでスキャンをトリガーできます。リポジトリの行アクションを開き、Scan now を選択してください。

Sensei でスキャンダイアログ

スキャンするブランチを選択し(デフォルトではリポジトリのデフォルトブランチになります)、Start scan を選択します。DefectDojo ホスト型モードでは、プルリクエストが作成されたときにもスキャンが自動的に実行されます。

検出事項の Sensei 列

オンボーディングされたリポジトリでは、検出事項テーブルに Sensei 列が追加されます。各検出事項には Fix ボタン(または現在の修正ステータス)が表示されるため、トリアージ画面を離れることなく修正できます。

検出事項テーブルの Sensei 列

このボタンには2つの状態があります。

Fix: 検出事項の製品が Sensei にオンボーディングされています。クリックすると修正が開始されます。
Configure Product: 検出事項の製品がまだオンボーディングされていません。クリックすると Sensei に移動し、その製品のリポジトリをオンボーディングできます。オンボーディング後、ボタンは Fix に変わります。

個々の検出事項を修正する

(検出事項テーブルまたは検出事項の詳細ヘッダーで)Fix をクリックすると、Fix with Sensei ダイアログが開きます。修正のプルリクエストの対象とするベースブランチを選択し、Fix をクリックします。

Fix with Sensei ダイアログ

Sensei は修正を生成し、プルリクエストを作成します。検出事項の修正ステータスは、in progress(進行中)→ PR open(PR オープン)(または failed(失敗))と遷移するバッジとして表示されます。プルリクエストが開かれると、バッジから直接そのプルリクエストにリンクします。

修正ステータスバッジ付きの検出事項詳細

💡 1つの修正、1つの PR: 承認された修正はそれぞれ、クォータから1件の修正を消費し、1つのプルリクエストを開きます。他の PR と同様に、GitHub でレビューとマージを行ってください。

自動修正候補のトリアージ

リポジトリで自動修正が有効になっている場合、各スキャンは一致する検出事項を Sensei ハブの Auto-fix Candidates タブに候補としてステージングします。これは Sensei のプレビューファーストのモデルであり、検出事項はステージングされますが、承認するまで何も実行されません(LLM のコストも発生しません)。承認すると、修正のプルリクエストが開かれ、修正数が消費されます。

自動修正候補のトリアージ

各候補には、検出事項、そのステータス、深刻度、リスク、優先度、対象リポジトリ、PR ブランチが表示されます。修正するには次のようにします。

1件を承認する: 行の Approve をクリックすると、ブランチピッカーが開き、その修正が開始されます。
複数を承認する: 複数の行を選択し、一括承認アクションを使用します。

承認された検出事項は、プルリクエストが紐付けられるまで In Progress(または Failed)として表示され続けるため、進行中または失敗した修正が PR を生成する前に消えてしまうことはありません。

🔎 ハンズオフでの修正: リポジトリで Automatically remediate candidates を有効にしている場合、バックグラウンドチェックが手動承認なしに、修正クォータの範囲内でステージングされた候補に対する修正 PR を自動的に開きます。

スキャンとインパクトを追跡する

Sensei ハブには、Sensei が何を行ったかを追跡できる2つの場所があります。

Scan Activity: すべてのスキャンおよび修正実行の台帳で、そのモード(Branch Scan、PR Scan、Fix (Finding))、トリガー(Manual、Webhook、Auto Remediated)、ステータス、実行時間、および生成されたエンゲージメントやプルリクエストへのリンクが記録されます。
Fix Impact: 適用された修正の概要で、最も頻繁に修正されたアセットとともに、ハブの上部に表示されます。