Skip to content

Commit 39ae28d

Browse files
Maffoochclaude
andauthored
docs(dedup): document instance-wide mutual-candidate + config-persistence behavior (#15241)
Two behaviors surfaced in review of the Pro dedup work: - Two different tools set to the same instance-wide algorithm (Global Component or Global Vulnerability ID) share a constant grouping hash and become mutual deduplication candidates (F23) — document as intended cross-tool behavior, and add the missing Global Vulnerability ID algorithm entry. - A tool's saved Deduplication Settings stay in effect regardless of feature-flag state; disabling a flag does not retroactively revert dedup (F20). Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 185710f commit 39ae28d

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

docs/content/triage_findings/finding_deduplication/PRO__deduplication_tuning.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,11 @@ Attempts to use the tool's unique ID first, then falls back to the hash code if
5050
#### Global Component
5151
Matches findings by component name and version across **all Products** in the instance, rather than within a single Product or Engagement. Intended for SCA tools where the same vulnerable dependency appears in many Products. This algorithm is off by default and must be enabled by DefectDojo Support. See [Global Component Deduplication](/triage_findings/finding_deduplication/pro__global_component_deduplication/) for details.
5252

53+
#### Global Vulnerability ID
54+
Matches findings by their **vulnerability IDs** (CVE, GHSA, …) across **all Products** in the instance, rather than within a single Product or Engagement. Intended for tools that report the same CVE across many Products. Off by default and enabled by DefectDojo Support.
55+
56+
> **Two tools on the same instance-wide algorithm become mutual deduplication candidates.** When two *different* tools are both configured with an instance-wide algorithm (Global Component, or Global Vulnerability ID), their findings share a constant grouping hash, so a finding from either tool is considered for deduplication against the other on that shared dimension (component, or vulnerability ID). This is the intended cross-tool behavior — enable it only when you want those tools to dedupe together.
57+
5358
### Set-based Hash Code Fields (Vulnerability IDs and CWEs)
5459

5560
Two finding attributes hold a *set* of values rather than a single value: vulnerability IDs (CVE, GHSA, …) and CWEs. When using the **Hash Code** algorithm (Same Tool or Cross Tool), you can add the following fields to **Hash Code Fields** to control how those sets are compared:
@@ -127,6 +132,8 @@ If you make several configuration changes in quick succession, each one queues i
127132

128133
> **Note for self-hosted Pro:** The background job runs in the Celery worker pool. If you have starved or backlogged workers, the re-hash can take longer than expected — check worker health if results don't appear within the timeframe you would expect for your instance size.
129134
135+
> **Feature flags do not gate an existing configuration.** A tool's saved Deduplication Settings stay in effect for as long as they are configured; turning off a related feature flag does **not** retroactively revert that tool to default deduplication. To change or stop a tool's deduplication behavior, update its Deduplication Settings directly (which also queues the background re-hash described above).
136+
130137
## Deduplication Best Practices
131138

132139
For optimal results with Deduplication Tuning:

0 commit comments

Comments
 (0)