Skip to content

docs(psirt): Feed Rules, the no-SBOM matching path, and advisory-to-case - #15735

Merged
Maffooch merged 1 commit into
devfrom
docs/psirt-feed-rules
Aug 19, 2026
Merged

docs(psirt): Feed Rules, the no-SBOM matching path, and advisory-to-case#15735
Maffooch merged 1 commit into
devfrom
docs/psirt-feed-rules

Conversation

@devGregA

Copy link
Copy Markdown
Contributor

Description

Documentation for three PSIRT changes landing in DefectDojo Pro.

Feed Rules gets a page. The pre-filter subsystem it describes — scoring,
tagging, starring and suppressing an advisory from its own text before anything
touches the inventory — previously had no way in from the UI, so there was nothing
to document. It is placed before Matching Rules in the setup flow, mirroring the
menu, because reading advisory text is what works before any inventory exists.

Matching Rules gains two sections that answer the question people actually
arrive with:

  • Start From a Template covers the template picker, and in particular the
    "No SBOM needed" / "Needs SBOM" labelling. A dependency-target rule on an
    instance with no inventory matches nothing however well written, and that
    silence is the most common reason people conclude matching is broken.
  • What to do when you have no SBOM says the same thing directly. The
    asset-target path has always existed and nothing pointed at it.

Feed Findings documents the Feed Rules column and the Add to case action, and
states plainly that escalating an advisory to a case does not require it to have
matched anything — an advisory the inventory could not answer for is frequently
the one most worth investigating.

Page weights shift by one from Feed Rules onward.

Docs-only: no code changes.

Feed Rules had no page at all — the subsystem it documents was previously
unreachable from the UI. It gets one, placed before Matching Rules in the setup
flow to match the menu, because reading the advisory text is what works before
any inventory exists.

Matching Rules gains two sections that answer the question people actually arrive
with. "Start From a Template" covers the template picker and, more importantly,
the No SBOM needed / Needs SBOM labelling — a dependency-target rule on an
instance with no inventory matches nothing however well written, and that silence
is the most common reason people conclude matching is broken. "What to do when
you have no SBOM" says the same thing directly, since the asset-target path has
always existed and nothing pointed at it.

Feed Findings documents the Feed Rules column and the Add to case action, and
states plainly that escalating an advisory does not require it to have matched
anything.

Page weights shift by one from Feed Rules onward.
@github-actions github-actions Bot added the docs label Aug 19, 2026
@Maffooch Maffooch added this to the 3.3.0 milestone Aug 19, 2026
@Maffooch
Maffooch merged commit 77ea8ac into dev Aug 19, 2026
23 checks passed
@Maffooch
Maffooch deleted the docs/psirt-feed-rules branch August 19, 2026 23:09
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