Skip to content

docs: asset exposure and deployment context - #15679

Open
devGregA wants to merge 2 commits into
devfrom
docs/asset-exposure
Open

docs: asset exposure and deployment context#15679
devGregA wants to merge 2 commits into
devfrom
docs/asset-exposure

Conversation

@devGregA

Copy link
Copy Markdown
Contributor

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:

  • The five normalized exposure verdicts, and how conflicting sources resolve (strongest wins, most recent among equals) so an observation of exposure outranks an assertion of non-exposure.
  • Why automated sources may report exposure but may never assert Isolated, while a person may. Several vendors report exposure as a plain true/false field where an absent value and a false value are indistinguishable, so treating a missing field as isolation would quietly bury a live internet-facing system.
  • The per-asset exposure override, and how an existing Internet Accessible setting carries into it on upgrade. An unticked checkbox is not converted, because "nobody has said" is not the same statement as "this asset is isolated".
  • Deployment context, its two inputs (environment mapping, then the asset's production branch), and the two cases that deliberately resolve to Unknown rather than to "not in production": the Development and Default environments, which a scan lands in automatically when no environment is named, and a test with no branch recorded.
  • How both signals adjust priority, that Unknown always scores neutrally, and that every weight is tunable per prioritization engine.
  • The optional exposed risk floor and isolated risk ceiling, including that neither closes or hides a Finding and that exploited-in-the-wild evidence always re-raises.
  • Using exposure for VDR remediation tiers, which is a separate opt-in from the feature flag because it changes remediation deadlines, and which can only ever tighten a deadline.

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.

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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant