DefectDojoのナビゲーション on DefectDojo Documentation

グローバル検索

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

DefectDojo Proには、トップバーの1つのボックスから検出事項と関連オブジェクトを横断的に検索できるグローバル検索が搭載されています。ネイティブのPostgres全文検索を基盤としており、あいまい検索やタイプミスに強いマッチングに対応しているため、正確な表記を覚えていなくてもオブジェクトを見つけられます。

検索の実行

トップバーの検索ボックス — 上部ナビゲーションのSearchボックスをクリックして入力を開始します。入力すると、ドロップダウンにオブジェクトタイプごとにグループ化された上位の一致結果がプレビュー表示され、各タイプの横に件数が、下部にSee all N resultsリンクが表示されます。
完全な結果ページ — Enterキーを押すか、See all N resultsをクリックすると、完全な結果ページが開きます。これは、すべてのオブジェクトタイプにわたる一致結果を1つにまとめた、並べ替えとフィルタリングが可能なテーブルです。

結果は常に閲覧権限のある範囲に限定されます。グローバル検索が、本来アクセスできないはずのオブジェクトを表示することはありません。（Finding Templatesはその唯一の例外です。DefectDojoの他の箇所と同様、サインインしているすべてのユーザーに表示されます。）

検索対象

グローバル検索は、以下のオブジェクトタイプを対象としています。

オブジェクトタイプ	補足
Findings
Assets	（Products）
Organizations	（Product Types）
Engagements
Tests
Endpoints または Locations	インスタンスの設定によって異なります — Locationsが有効なインスタンスではLocationsを検索し、それ以外ではEndpointsを検索します。
Finding Templates
Technologies
Vulnerability IDs	例: CVE

ほとんどのタイプでは、検索はオブジェクトの名前/タイトルと説明に対して一致判定を行います。Findings、Assets、Engagements、Testsについては、タグ（前方一致）にも一致します。Vulnerability IDsはID値そのものに一致します。

フィルターインデックス

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

注: 現在この記事では、DefectDojo Pro UIで利用可能な検出事項フィルターのみを扱っていますが、今後はOpen-Sourceのフィルターも含め、より多くのオブジェクトタイプを対象とするよう拡張される予定です。

以下は、DefectDojo Pro UIで検出事項のリストを並べ替えるために適用できるフィルターの一覧です。DefectDojoのフィルターは、オブジェクトのリストをナビゲートしたり、カスタムダッシュボードを構築したり、ルールエンジンによる自動化を作成したりする際に役立ちます。

日付フィルターの評価方法

日付を指定するフィルター（Date Created、SLA Expiration Date、Last Status Update、Planned Remediation Date、および以下に挙げるJiraの日付フィルター）には、5つの演算子が用意されています。

演算子	一致条件
On	指定した日の全体。
Before	指定した日の開始時点までのすべて。指定した日自体は含まれません。
After	指定した日の開始時点以降のすべて — つまり指定した日は含まれます。
During	開始日から終了日まで、両方とも含みます。
Within	現在時点までの直近期間: 過去7日、14日、30日、90日、180日、または過去1年。

BeforeとAfterは意図的に対称になっていない点に注意してください。Before 8 Augustは8月8日を除外しますが、After 8 Augustは8月8日を含みます。

設定メニュー

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

サイドバーの設定セクションには、DefectDojo Proのすべての管理ページがグループ化されています。表示されるレイアウトは、インスタンスがいつ作成されたかによって異なります。

新規インストールでは、以下で説明する再編成後のレイアウトが表示されます。
既存のインストールでは、管理者がMenu 2.0を有効にするまで（レイアウトの切り替えを参照）、以前のレイアウトが維持されます。

どちらの場合でも、すべての設定ページは同じURLを維持します。ブックマークや保存済みのリンク、自分自身のRunbookに記載したものは、どちらのレイアウトが有効であっても引き続き機能します。

再編成後のレイアウト

Settingsは7つのグループに分かれており、システムのどの部分に関わるかではなく、何をしたいかに基づいて名付けられています。

グループ	含まれるもの
System	System Settings、Appearance、Announcement Banner、Login Banner、E-mail、Feature Flags
Users & Permissions	Users、Groups、Roles
Finding Workflow	3つのDeduplicationページ、Finding Enrichment、Service Level Agreements、Prioritization Engines、Mitigation Policies
Configuration	Environments、Regulations、Note Types、Test Types、CI/CD Infrastructure、Tool Types、Tool Configurations
Notifications	Notification Events、Notification Webhooks
Operations	Audit Logs、Usage Logs、Schedules、Celery Status、および — DefectDojo Cloudでは — Message Portal、Firewall Rules、Maintenance Windows
License & Support	License Manager、Version Manager、Contact Support

表示されるのは、自分のアカウントに開く権限がある項目だけであり、そのグループ内のページが1つも利用できない場合、グループ自体が表示されなくなります。

メニューバッジ

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

DefectDojo Proのサイドバーの項目には、小さな色付きタグが付いていることがあります。それぞれのタグは、隣接する機能について異なる問いに答えるものであり、そのうち2つはリンクになっています。

バッジ	色	意味	求められる対応
`NEW`	緑	最近リリースされた	特にありません — その機能に気づいてもらうためのものです
`BETA`	オレンジ	動作はするが、まだ完成途中。リリースごとに動作が変わる可能性がある	試してみてください。粗削りな部分がある前提で
`LEGACY`	赤	より新しい機能に置き換えられたが、削除予定日は未発表	新規の作業では代替機能を優先してください
`DEPRECATED`	赤	指定されたリリースで削除予定	そのリリースまでに移行してください

テーブルのカスタマイズ

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

DefectDojo Pro UIのほとんどのデータテーブル（Findings、Assets、Engagements、その他の一覧ビュー）は、自分の作業スタイルに合わせて調整できます。表示する列を選択したり、並べ替えたり、幅を調整したりできるほか、これらの組み合わせを名前付きのテーブル設定として保存し、切り替えたりチームと共有したりすることもできます。

これらの操作はすべて、一覧の上にあるテーブルツールバーから行えます。

表示する列を選択する

ツールバーのColumnsボタンを選択すると、列ピッカーが開きます。列のチェックボックスをオン/オフすることで、表示・非表示を切り替えられます。ピッカー上部の検索ボックスを使うと、ヘッダー名で列を検索できます。いくつかの構造的な列（選択用チェックボックスと行アクションメニュー）は常に表示され、ピッカーには一覧表示されません。

列を並べ替える

列ヘッダーを左右にドラッグすると、その列を移動できます。新しい順序は、現在のセッションに対して即座に反映されます。

列のサイズを変更する

データ列のヘッダーの右端にカーソルを合わせ、サイズ変更用のカーソルが表示されたらドラッグして、列を広げたり狭めたりします。

以下の2点に注意してください。

各列には最小幅が設定されており、タイトル、並べ替え矢印、フィルターアイコンが常に読み取れるようになっています。列は自由に広げられますが、この最小幅より狭くすることはできません。
選択列と行メニュー列は固定されており、サイズを変更できません。

列の順序や表示/非表示と同様、幅の変更も保存する（後述）まで現在のセッションにのみ適用されます。

テーブル設定を保存する

列の表示/非表示、列の順序、列の幅、ページサイズ、フィルター、並べ替え順序は、まとめて名前付きのテーブル設定として保存できます。ツールバー（現在有効なビューの名前が表示されているボタン）から設定メニューを開いて管理します。

Save as New Preference: 現在のテーブル設定を新しい名前で保存します。任意でデフォルトに設定したり、権限があれば他のユーザーと共有したりできます。
Save Column Layout: 有効な設定のうち、列（表示/非表示、順序、幅、ページサイズ）のみを更新し、保存済みのフィルターと並べ替えはそのままにします。
Save Filters and Sort: 有効な設定のうち、フィルターと並べ替えのみを更新し、列のレイアウトはそのままにします。
Set Preference as Default: テーブルを開くたびにこの設定を自動的に読み込みます。
Duplicate Preference: 有効な設定（列幅を含む）を新しい名前で複製し、元の設定を変更せずに調整できるようにします。
Update Preference Label: 有効な設定の名前を変更します。
Delete Preference: 有効な設定を削除します。
Reset All Preferences: このテーブルの保存済み設定をすべて削除し、組み込みのデフォルトに戻します。

設定を切り替えるには、設定メニューのリストから選択します。Defaultを選択すると、保存済みの設定を削除することなく、テーブルは組み込みの列とサイズに戻ります。