ダッシュボード on DefectDojo Documentation

DefectDojo メインダッシュボード

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

ダッシュボードは、DefectDojo を開いたときに最初に表示されるページであることが多いです。チームのパフォーマンスを要約し、脆弱性トラッキング環境の特定領域を監視するための追跡ツールを提供します。

💡 DefectDojo Pro: DefectDojo Pro では、ホームページは完全にカスタマイズ可能なダッシュボードです。以下で説明する固定レイアウトを使用する代わりに、ウィジェットからダッシュボードを組み立て、自分で配置できます。概念と UI の操作方法については カスタマイズ可能なダッシュボード を参照してください。このページの残りの部分では、オープンソース版のメインダッシュボードについて説明します。

ダッシュボードの構成要素

オープンソース版ダッシュボードでは、以下の組み込みコンポーネントによってセキュリティ体制の概要を把握できます。

サマリーカード

ダッシュボードの最上部の行には、アクティビティを一目で確認できる4つのサマリーカードが表示されます。

アクティブなエンゲージメント — すべての製品にわたる、現在オープン中のエンゲージメントの合計数。
過去7日間の検出事項 — 過去1週間に作成された新しい検出事項。
過去7日間にクローズ — 最近解決された検出事項。
過去7日間に受容 — 最近リスク受容された検出事項。

各カードは該当するフィルタ済みリストに直接リンクしているため、ワンクリックで詳細を確認できます。

マイワーク

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

マイワークが答える問いはただ一つ、「自分を待っているものは何か」です。これはユーザーごとのビューで、同じページが各人に自分専用のキューを表示します。

左サイドバーの Dashboards > My Work から開きます。

キュー

キュー	表示内容
自分に割り当て済み	自分個人に割り当てられた検出事項です。Work Assignment 機能が有効になっていない限り非表示です。
自分のチームのキュー	自分が所属するグループが所有する検出事項です。所有者はグループ単位のため、これは自分個人ではなくチームの作業です。
レビュー待ち	自分がレビューを依頼され、そのレビューがまだ完了していない検出事項です。
自分が依頼したレビュー	自分が開始したものの、まだ誰も完了していないレビューです。
自分のリスク受容	自分が所有しているものの、まだ誰も対応していないリスク受容です。期限切れのものも、対応されるまで一覧に残ります。

各キューは完全な検出事項またはリスク受容の一覧であるため、通常のフィルタリング、並べ替え、列の操作がすべて機能し、各タブは自分自身の列レイアウトを記憶します。

カスタマイズ可能なダッシュボード

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

注: カスタマイズ可能なダッシュボード(レイアウト、ウィジェット、ウィジェットカタログ)は DefectDojo Pro の機能です。デフォルトでは無効になっており、スーパーユーザーが Cloud および On-Premise の両方のインスタンスで Settings > Feature Flags から有効にできます。

DefectDojo Pro のカスタマイズ可能なダッシュボードでは、各ユーザーがウィジェット(カウント、チャート、リーダーボード、フィード、メモなど)をドラッグ&ドロップグリッド上に配置して、自分だけのホームページを組み立てることができます。全員共通の固定ダッシュボードを使う代わりに、エグゼクティブ概要、トリアージキュー、改善速度ボード、スキャナー有効性ビューなど、自分にとって重要なレイアウトを構築できます。レイアウトは非公開のままにしたり、チーム全体に公開したり、デフォルトのランディングページとして設定したり、任意のレイアウト(自分のものでも共有テンプレートでも)を出発点としてクローンしたりできます。

APIでダッシュボードを自動化する

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

注: カスタムダッシュボードREST API（レイアウト、ウィジェットカタログ、ウィジェットデータ）はDefectDojo Proの機能です。デフォルトでは無効になっており、スーパーユーザーがCloudおよびOn-Premiseの両方のインスタンスで設定 > 機能フラグからカスタムダッシュボードを有効にできます。

カスタムダッシュボードREST APIを使うと、ダッシュボードUIで手動で組み立てるのと同じダッシュボードを、すべてコードから構築できます。ウィジェットカタログを調べたり、レイアウトを作成・更新したり、デフォルトを設定したり、レイアウトをチームと共有したり、DefectDojoのフィルタリングを再実装することなくウィジェットのデータをオンデマンドでレンダリングしたりできます。レイアウト機能は、ダッシュボードを構築するAIエージェントのための主要な入口として設計されているため、リクエストの形式は意図的に内省しやすい構造になっています。

本ガイドでは、認証、ウィジェットの語彙の発見、レイアウトの作成、そしてその検証とレンダリングという一連のライフサイクル全体を解説します。

認証

すべてのリクエストは、AuthorizationヘッダーにTokenプレフィックス（Bearerではありません）を付けて送信する個人用APIトークンで認証します。

トークンはDefectDojo ProのUIのユーザー設定 → API v2キーから取得します。シェルの履歴やコミットされたスクリプトに残らないよう、環境変数として保存してください。

export DD_IMPORTER_DOJO_API_TOKEN="YOUR_API_TOKEN"

すべての呼び出しのベースURLは、インスタンスに/api/v2を付けたものです。

LLMでダッシュボードを構築する

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

注: REST APIとLLMによるカスタムダッシュボードの自動化はDefectDojo Proの機能です。デフォルトでは無効になっており、スーパーユーザーがCloudおよびOn-Premiseの両方のインスタンスで設定 > 機能フラグからカスタムダッシュボードを有効にできます。

DefectDojo Proのカスタムダッシュボードは完全にREST APIによって駆動されており、レイアウト機能はAIエージェントを念頭に置いて設計されています。つまり、作業全体をLLMに任せることができます。自己完結型のプロンプトを一つ、Claude、ChatGPT、その他の高性能なモデルに貼り付けて、欲しいダッシュボードを説明するだけで、モデルがテナントのライブウィジェットカタログを調べ、レイアウトを提案し、実行可能なPythonスクリプトを生成し、レイアウトを作成、検証し、必要に応じてデフォルトとして設定します。

パターンはシンプルです。ベースURL、APIトークン、そしてダッシュボードが誰のためのものかを簡単に説明するだけです。LLMが発見、設計、作成、検証を行い、テナントに対して何かを構築する前には承認を求めて一旦停止します。

本ガイドは、LLMが操作する生のリソースとリクエストの形式を解説したダッシュボードAPIガイドと対になっています。LLMが生成したものを理解したり、手動で調整したりしたい場合は、そのリファレンスを開いたままにしておいてください。

始める前に

APIトークンを取得します。 DefectDojo ProのUIでユーザー設定 → API v2キーに移動し、トークンをコピーします。次に、生成されたスクリプトがトークンを読み取れるように、チャットにトークンが表示されないよう環境変数として設定します。

export DD_IMPORTER_DOJO_API_TOKEN=<paste-token-here>

機能が有効になっていることを確認します。 インスタンスで設定 > 機能フラグからカスタムダッシュボードを有効にしておく必要があります。有効になっていないと、すべてのAPI呼び出しが403を返します。