Skip to content

docs(rules-engine-2): document exploit-evidence, reachability and asset-exposure condition fields - #15713

Merged
Maffooch merged 1 commit into
devfrom
docs/fedramp-rules-envelope
Aug 19, 2026
Merged

docs(rules-engine-2): document exploit-evidence, reachability and asset-exposure condition fields#15713
Maffooch merged 1 commit into
devfrom
docs/fedramp-rules-envelope

Conversation

@devGregA

Copy link
Copy Markdown
Contributor

Description

Documents new condition fields in the Rules Engine 2.0 rule-building guide. Pairs with a Pro change that adds these to the rule item envelope; this is the user-facing half.

The available-fields contract table gains two groups:

  • Exploit evidenceexploit_maturity, kev_due_date, vex_state
  • Reachabilityreachability, reachability_confidence

The asset block gains internet_accessible, business_criticality and exposure alongside id and name.

A new section explains what each one means, because several are not self-describing:

  • exploit_maturity is a number (0 none, 10 proof of concept, 20 weaponized, 30 observed exploited in the wild), so gte 20 means "weaponized or worse". Documented as a scale because "20" tells a rule author nothing on its own.
  • The distinction between reachability (can the vulnerable code be reached inside the application) and exposure (can the asset be reached from outside). These are separate enums on separate rollups and easy to conflate, so the guide names the difference explicitly rather than leaving a reader to infer it.
  • Why both exposure answers are offered: the checkbox is what somebody ticked, the verdict is computed from collected evidence, and they can disagree. A rule meaning "reachable from the internet" usually wants the verdict, falling back to the checkbox on an instance with no exposure evidence.

It also records that these fields read empty where the feature populating them is off (reachability reads unknown), so an author knows a rule written against them matches nothing rather than misbehaving.

English only. The translated variants of this page lag behind by design and are updated in dedicated translation passes — the risk-acceptance condition fields added earlier are likewise not yet in them.

Documentation only; no code or behavior change in this repository.

… exposure fields

Pairs with the dojo-pro change that adds these to the rule item envelope. Adds the two
new field groups to the available-fields contract table, extends the asset block to
name its three new keys, and adds a section explaining what each one means -- including
the exploit-maturity scale, since "20" is not self-describing, and the distinction
between reachability (can the vulnerable code be reached inside the app) and exposure
(can the asset be reached from outside), which are separate questions on separate
rollups and easy to conflate.

Also states why both exposure answers are offered: the manual checkbox is what somebody
ticked, the verdict is computed from connector evidence, and they can disagree. And it
records that these read empty where the feature populating them is off, so an author
knows a rule will match nothing rather than misbehave.

English only. The translated variants of this page lag behind by design and are
updated in dedicated translation passes -- the acceptance fields added earlier are
likewise not yet in them.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@devGregA devGregA added this to the 3.3.0 milestone Aug 18, 2026
@github-actions github-actions Bot added the docs label Aug 18, 2026
@Maffooch
Maffooch merged commit cf6b6a4 into dev Aug 19, 2026
23 checks passed
@Maffooch
Maffooch deleted the docs/fedramp-rules-envelope branch August 19, 2026 23:07
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