Skip to content

docs(smart_upload): document multi-Asset finding fan-out - #15738

Merged
Maffooch merged 1 commit into
bugfixfrom
docs/smart-upload-multi-asset
Aug 20, 2026
Merged

docs(smart_upload): document multi-Asset finding fan-out#15738
Maffooch merged 1 commit into
bugfixfrom
docs/smart-upload-multi-asset

Conversation

@Maffooch

@Maffooch Maffooch commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

[sc-14662]

What

Documents how Smart Upload behaves when a scanned Host belongs to more than one Asset.

The Smart Upload page previously described only the single-Asset case ("all subsequent Findings that share an Endpoint or Host will be sent to the same Asset") and said nothing about what happens when a Host matches multiple Assets.

Why

Smart Upload matches an incoming Finding's Host against every Asset that owns a Location with that host, then creates a copy of the Finding in each matching Asset (in that Asset's own Smart Upload Engagement and Test). Because a Location can be associated with multiple Assets, one scanned vulnerability can fan out to several Assets. This is intentional infrastructure-scan behavior, but it was undocumented, which led to real confusion about whether the finding lands in one Asset or all of them.

Changes

  • New "Findings that match more than one Asset" section on the Smart Upload page explaining the fan-out, that it is intentional (reports, SLAs, and metrics stay independent per Asset), and that matching is host-based (fully qualified domain name, falling back to the IP address).
  • Clarified the existing single-Asset sentence to point at the new section.
  • Added a matching one-line note to the Smart Upload glossary entry.
  • Propagated both edits to the de / es / fr / ja translations (page and glossary).

Documentation-only change. No behavior change.

Verification

Built the docs site locally with Hugo (clean build, no errors or warnings). Confirmed the new section renders in all five languages, the in-page anchor link resolves, and the surrounding sections remain intact.

Smart Upload matches an incoming Finding's Host against every Asset that
owns a Location with that host, and creates a copy of the Finding in each
matching Asset (its own Smart Upload Engagement and Test). The page only
ever described the single-Asset case, so the multi-Asset behavior was
undocumented.

Add a "Findings that match more than one Asset" section explaining the
fan-out, that it is intentional (independent reports/SLAs/metrics per
Asset), and that matching is host-based (FQDN, IP fallback). Clarify the
existing single-Asset line and add a matching note to the glossary.
Propagated to the de/es/fr/ja translations.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@Maffooch
Maffooch requested a review from blakeaowens as a code owner August 19, 2026 18:27
@github-actions github-actions Bot added the docs label Aug 19, 2026
@Maffooch Maffooch modified the milestones: 3.2.300, 3.3.200 Aug 19, 2026
@Maffooch
Maffooch added this pull request to the merge queue Aug 19, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Aug 20, 2026
@Maffooch
Maffooch added this pull request to the merge queue Aug 20, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Aug 20, 2026
@Maffooch
Maffooch added this pull request to the merge queue Aug 20, 2026
Merged via the queue into bugfix with commit dab0d61 Aug 20, 2026
31 checks passed
@Maffooch
Maffooch deleted the docs/smart-upload-multi-asset branch August 20, 2026 03:29
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