フィルターインデックス

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

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

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

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

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

日付の境界とタイムゾーン#

On、Before、After、Duringは、ブラウザから検出されたご自身のタイムゾーンを基準に日付の境界を解決します。したがって日付範囲は、UTCやサーバーのタイムゾーンではなく、あなたが体験する深夜0時から深夜0時までをカバーします。異なるタイムゾーンにいる2人のユーザーは、日付の境界付近にある検出事項について、同じフィルターでもわずかに異なる結果を目にすることがあります。

Withinはこの影響を受けません。現在時点から遡って測定される直近期間であるため、解決すべき日付の境界がそもそも存在しないためです。

これが当てはまらないケース。 タイムゾーンが渡されるのはPro UIからのリクエストのみです。ブラウザを介さずに実行されるもの（/api/v2 REST API、スケジュールレポート、ルールエンジン）は、サーバーに設定されたタイムゾーン（DD_TIME_ZONE。管理者が変更していなければUTC）にフォールバックします。ブラウザのタイムゾーンがサーバーのものと異なる場合、同じ日付を使用していてもスケジュールレポートと画面上のフィルターでわずかに異なる行が返されることがあります。UI上のフィルター済みテーブルから開始したエクスポートはこの影響を受けません。表示していた内容と一致する、ご自身のタイムゾーンが使用されます。

数値フィルターの評価方法#

AgeやSLAを含む数値フィルターには、値とともに一致演算子（Equals、Not Equals、Greater Than、Greater Than or Equal To、Less Than、Less Than or Equal To、In List、Not In List）が用意されています。演算子を選択せずに値を入力すると、Equalsとして一致します。

SLAフィルター#

SLAに関するフィルターは3つあり、それぞれ異なる問いに答えます。

Mitigated Within SLAは、名前から想像されるより範囲が狭く、これに戸惑う人がよくいます。 どちらの値も、すでに緩和済みで、かつ深刻度がInfoではない検出事項にのみ一致します。

• True — SLAの期限日以前に緩和された。
• False — SLAの期限日より後に緩和された。

すでに期限を過ぎている未対応（open）の検出事項は、まだ緩和されていないため、どちらの値にも一致しません。それらを見つけるには、代わりにSLAのLess Than 0を使用してください。深刻度がInfoの検出事項は、どちらの側からも除外されます。

検出事項のSLA設定でCap SLA by CISA KEV Due Dateが有効になっている場合、SLAとSLA Expiration Dateはどちらも、単純な深刻度ベースの期間ではなく、短縮されたKEV上限付きの期限を反映します。フィルター上ではこれを示す個別のインジケーターはありません。詳しくはEPSS / KEVを参照してください。

検出事項#

これらのフィールドはDefectDojoの検出事項に固有のもので、検出事項を整理するために使用されます。これらのフィルターはそれぞれ、All Findingsテーブルの個別の列に対応しています。

DefectDojoの検出事項は、以下によってフィルタリングできます。

DefectDojoメタデータ#

これらのフィルターは、DefectDojoのコア機能に直接関連しています。

変更不可#

これらのフィルターは、Issue作成時に割り当てられるもので、Edit Findingから直接変更することはできません。

• Finding Severity（情報、低、中、高、重大のいずれか）
• Product
• Product Type
• Engagement
• Engagement Version
• Test
• Test Type
• Test Version
• Date Created
• Age（検出事項の経過日数）
• SLA（SLAクロックの残り日数 — 負の値は期限超過を意味します。SLAフィルターを参照）
• SLA Expiration Date（SLAフィルターを参照）
• Mitigated Within SLA（True または False — これはすでに緩和済みの検出事項にのみ一致する点に注意してください。SLAフィルターを参照）
• Reporter（検出事項を作成したユーザーまたはサービス）
• Found by（使用したツールを指します）

変更可能#

これらのフィールドはIssue作成時に設定されますが、Issueの進行に伴い変更できます。

• Status
• Last Status Update（タイムスタンプ）
• Mitigated（True または False）

その他のモデル機能#

これらのDefectDojoの機能を使うと、検出事項をさらに整理したり、修復状況を追跡したりできます。

• Finding Tags
• Reviewers（割り当てられたユーザー）
• Has Notes（メモの有無：True/False）
• Group（存在する場合、Finding Groupを指します）
• Risk Acceptance（リストから既存のリスク受容を1つ以上選択）

ツール固有のメタデータ#

これらのフィールドはDefectDojoの機能に直接影響しませんが、Issueの説明や緩和に役立つ追加情報を提供します。検出事項の初回作成時（受信したレポートの情報を使用）に設定することも、ユーザーが後から変更することもできます。

• CWE Value
• Vulnerability ID（通常はCVE）
• EPSS Score
• EPSS Percentile
• Service
• Planned Remediation Date
• Planned Remediation Version
• Has Component（True/False）
• Component Name
• Component Version
• File Path
• Effort for Fixing

Jiraメタデータ#

Jira連携を使用している場合、これらのフィルターはリンクされたJira Issueの更新を追跡します。

• Jira Issue（検出事項に紐づいているかどうかでフィルタリング可能）
• Jira Age（Jira Issueの経過日数）
• Jira Change（Jiraに変更が最後にプッシュされた日時）