Sensei on DefectDojo Documentation

Sensei

Mon, 01 Jan 0001 00:00:00 +0000

注: Senseiは、DefectDojo Pro専用の機能です。

Senseiは、ソースコードリポジトリ向けのDefectDojoのAI搭載スキャン&修正機能で、DefectDojo Proでのみ利用できます。オープンソース版には含まれていません。

Senseiを使用すると、DefectDojo Proは以下を行うことができます。

GitHubリポジトリをスキャンし、その結果を検出事項としてインポートします。
大規模言語モデルを使用してそれらの検出事項を修正するプルリクエストを、プレビューファーストの承認ワークフロー(承認するまで何も実行されません)で開きます。
検出事項テーブルから、ステージングされた自動修正候補から、またはプルリクエストへの/fixコメントによって、修正を開始します。

Senseiの完全なドキュメントを見る

Senseiの完全なガイドは、Proドキュメントの一部です。読むには、ドキュメントバージョンの切り替え(左側ナビゲーション上部)をProに切り替えてください。

Senseiについて: それが何であるか、およびホスト型のスキャン&修正の仕組み
Senseiのセットアップ: GitHub Appを接続し、リポジトリをオンボーディングする
Senseiで検出事項を修正する: スキャン、候補のトリアージ、修正PRを開く
Senseiリファレンス: ステータス、クォータ、トラブルシューティング

DefectDojo Proについて詳しくは、defectdojo.comにアクセスするか、DefectDojoのアカウントチームにお問い合わせください。

Sensei について

Mon, 01 Jan 0001 00:00:00 +0000

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

Sensei は、ソースコードリポジトリ向けの DefectDojo の AI 搭載スキャンと修正機能です。リポジトリを(GitHub App、GitLab、Bitbucket、または Azure DevOps 経由で)接続すると、Sensei がそれをスキャンし、結果を DefectDojo の検出事項としてインポートし、その後大規模言語モデルを使用してプルリクエスト/マージリクエストを作成することでそれらの検出事項を修正します。これらはすべて DefectDojo から離れることなく行われます。

Sensei をセットアップする

Mon, 01 Jan 0001 00:00:00 +0000

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

Sensei のセットアップは2つの部分から構成されます。ソースコード管理プロバイダーを接続する、次に スキャン対象のリポジトリをオンボードする という流れです。これを行うには、グローバルの Maintainer または Owner ロールが必要です。Sensei は以下に対応しています。

Sensei で検出事項を修正する

Mon, 01 Jan 0001 00:00:00 +0000

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

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

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

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

Threat Modeling

Mon, 01 Jan 0001 00:00:00 +0000

注: Threat Modeling は DefectDojo Pro 限定機能であり、現在 BETA 版です。

Threat Modeling は、機能設計をレビュー済みの脅威モデルへと変換します。設計内容 — 貼り付けたテキスト、設計ドキュメント、任意でアーキテクチャ図 — を入力すると、DefectDojo はそこに記述されているコンポーネントとデータフロー、それらに対する脅威、そしてその脅威を緩和するセキュリティ要件を生成します。要件はその後 DefectDojo に検出事項としてプッシュできるため、設計段階の作業も他のすべてと同じトリアージ、SLA、Jira、レポートの仕組みに乗せることができます。

Sensei リファレンス

Mon, 01 Jan 0001 00:00:00 +0000

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

Sensei を使用する際に目にするステータス、アクション、制限事項についてのクイックリファレンスです。

リポジトリのステータス

Sensei ハブでオンボーディングされたリポジトリに表示されるステータスです。

ステータス	意味
Active	オンボーディング済みでスキャン可能な状態です。
Pull Request Open	Sensei がリポジトリに対してオープンなプルリクエストを持っています。
Pull Request Closed	Sensei のプルリクエストがクローズされました。
Error	直前の操作が失敗しました。根本原因については Scan Activity を確認してください。
Not Configured	リポジトリは接続済みですが、まだ設定されていません。

候補と修正のステータス

自動修正候補と修正レコードは、次の状態を経て遷移します。