CycloneDX / CycloneDX/specification

[FEATURE]: EPSS Score on Vulnerability model

Open
#481 10 comments 3 reactions 0 assignees View on GitHub
proposed core enhancement
Dominant language
XSLT
Stars
547
Forks
93
Avg merge
7h 11m
Merged PRs (30d)
37

Description

## Describe the feature

Vulnerabilities can have an [EPSS](https://www.first.org/epss/) score attached to them. This describes the probability of a vulnerability being exploited. As of spec version 1.6, there is no clear way to attach this to a CycloneDX Vulnerability.

A vulnerability does have a slot for [`ratings`](https://cyclonedx.org/docs/1.6/json/#vulnerabilities_items_ratings), but it is not clear whether it can be used to include the EPSS, which consists of two values (the probability score itself, a percentile). It might be worth introducing a new slot for this vulnerability attribute.

## Possible solutions

Shooting from the hip.

```
type Vulnerability {
bom-ref string
// ...
epss EpssScore
}

type EpssScore {
probability float
percentile float
}
```

## Alternatives

Getting it into the `ratings`, but it does not really fit the "severity" category that `ratings` was intended for.

## Additional context

Support for EPSS was added to SPDX 3.0: https://spdx.github.io/spdx-spec/v3.0/model/Security/Classes/EpssVulnAssessmentRelationship/

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.