docs: asset exposure and deployment context - #15679
Open
devGregA wants to merge 2 commits into
Open
Conversation
Documents the Asset Exposure beta feature in DefectDojo Pro: the five exposure verdicts and how conflicting sources resolve, why automated sources may report exposure but never assert isolation, the per-asset override, deployment context from environment mapping and a production branch, how both signals adjust priority, the optional risk floor and ceiling, and the separate opt-in for using exposure in VDR remediation tiers. Also cross-links the existing Reachability page, since the two answer different questions (code reachable inside the app, versus asset reachable from outside) and are easy to confuse.
An asset can be reachable without anything having scanned it, because of what it is deployed onto. Documents the deploys-to relationship, the effective-exposure badge, and the two limits that will otherwise surprise people: inherited exposure does not move priority, and you only inherit from assets your permissions let you see. Folded into this page rather than a new one because it is the same question the page already answers, and a reader looking up "is this asset reachable" should not have to know that the answer is split across two documents.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Documents the Asset Exposure beta feature in DefectDojo Pro, which records how reachable an asset is from outside and whether a Finding's code is actually deployed in production, and feeds both into the computed priority.
New page:
docs/content/triage_findings/finding_scoring/asset_exposure.md, alongside the existing CVSS, EPSS/KEV and Reachability pages in Scoring & Prioritization.It covers:
Also adds a short cross-reference on the Reachability page. The two features are easy to confuse: reachability asks whether the vulnerable code can be reached inside the application, exposure asks whether the asset can be reached from outside and whether the code is deployed at all.
Documentation only. No code changes.