Skip to content

docs(exposure): name every exposure source and document the CMDB criticality sync - #16407

Merged
blakeaowens merged 1 commit into
devfrom
docs/exposure-sources
Oct 19, 2026
Merged

blakeaowens merged 1 commit into
devfrom
docs/exposure-sources

Conversation

@blakeaowens

Copy link
Copy Markdown
Contributor

Description

Brings the Asset Exposure documentation and the pages around it in line with what DefectDojo Pro does today.

Asset Exposure (triage_findings/finding_scoring/asset_exposure.md)

  • New "Exposure sources" table naming every source that reports exposure verdicts, what each one reports and its confidence: the Wiz, CrowdStrike Falcon, Shodan and Censys connectors, the reachability probe, Universal Parser imports that map the Asset exposure field, and the exposure API.
  • New "Submitting verdicts through the API" section documenting POST /api/v2/exposure/verdicts/: the request shape, the accepted verdicts (no isolation from automated sources), the evidence fields and the required permission.

Connector pages

  • Shodan, Censys and CrowdStrike Falcon each gain an Asset Exposure section, matching the existing one on the Wiz page. The CrowdStrike section explains why Spotlight's No and Pending answers record nothing, and which API scope the assessment needs.
  • ServiceNow CMDB gains a Business Criticality section: how CI business criticality maps onto Asset Criticality, that a value set by a person is never overwritten, and that an unmapped value is skipped. The Priority page links to it from the Criticality field.

Corrections to pages that had fallen behind

  • Asset Hierarchy lists the deploys_to relationship (four default relationship types, not three) and explains that it carries exposure and does not roll Findings up.
  • Working with SBOMs and Locations Overview no longer describe container image and cloud resource Locations as future types.
  • API v3 (alpha) no longer says Locations are URL-only: the list returns every Location type, with the URL detail fields filled in for URL Locations only.

Past release notes are left unchanged.

Test results

Docs only. Every internal link added resolves to an existing page and heading anchor. English pages only; translated copies are generated separately.

Checklist

  • Make sure to rebase your PR against the very latest dev.
  • Your code is flake8 compliant (no code changes).
  • Your code is python 3.13 compliant (no code changes).
  • Add applicable tests to the unit tests (no code changes).
  • Add the proper label to categorize your PR.

🤖 Generated with Claude Code

…icality sync

Asset Exposure lists the sources that report verdicts (Wiz, CrowdStrike Falcon,
Shodan, Censys, the reachability probe, Universal Parser imports and the
/api/v2/exposure/verdicts/ endpoint) with their confidence, and documents the
provider API. The Shodan, Censys and CrowdStrike Falcon connector pages gain an
Asset Exposure section. The ServiceNow CMDB page documents the business
criticality sync, linked from the Priority page.

Corrects pages that had fallen behind the code: Asset Hierarchy lists the
deploys_to relationship, the SBOM and Locations pages no longer call container
image and cloud resource locations future types, and the API v3 page no longer
says locations are URL-only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@blakeaowens
blakeaowens requested a review from Maffooch as a code owner October 19, 2026 03:28
@blakeaowens blakeaowens added this to the 3.4.300 milestone Oct 19, 2026
@blakeaowens
blakeaowens added this pull request to the merge queue Oct 19, 2026
Merged via the queue into dev with commit 5eb4477 Oct 19, 2026
31 checks passed
@blakeaowens
blakeaowens deleted the docs/exposure-sources branch October 19, 2026 06:18
@Maffooch Maffooch modified the milestones: 3.4.300, 3.4.200 Oct 19, 2026
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.

3 participants