Skip to content

Commit

Permalink
Add example information for NIST EO 14028 to Appendix G
Browse files Browse the repository at this point in the history
This commit adds an example to Appendix G.1 describing how users can
reference vulnerability reports using the ExternalRefs `SECURITY`
category in accordance with Executive Order 14028.

This example and language was agreed upon at the SPDX Defects WG meeting
on June 29th.

Signed-off-by: Rose Judge <rjudge@vmware.com>
  • Loading branch information
rnjudge authored and kestewart committed Jul 6, 2022
1 parent c7dd875 commit fca3630
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions chapters/how-to-use.md
Expand Up @@ -179,6 +179,23 @@ One can also use it to refer to guidance related to a vulnerability such as CISA
} ]
```

### G.1.9 Linking to an SBOM vulnerability report for a Software Product (per NIST Executive Order 14028)

The National Institute of Standards and Technology (NIST) describes the concept of correlating vulnerability and SBOM information for a software product at the component level in “[Software Security in Supply Chains: Software Bill of Materials (SBOM)](https://www.nist.gov/itl/executive-order-14028-improving-nations-cybersecurity/software-security-supply-chains-software-1)”. Use the ExternalRefs `SECURITY` category and `advisory` referenceType to report on vulnerabilities related to the components contained in a software product’s SBOM.

This enables a software producer to articulate to software consumers the status of vulnerabilities contained in the software product, by means of reporting vulnerability information at either the SBOM document or component level.

Providing a link to such data at the time the SBOM is published provides a pointer for where to find this relevant vulnerability information without promulgating vulnerability information inside the SBOM. This is advantageous because the vulnerability information has a short shelf-life (it will change frequently) while the SBOM component data isn’t likely to change if the software has not changed.

```
"externalRefs" : [ {
"referenceCategory" : "SECURITY",
"referenceLocator" : "https://github.com/rjb4standards/REA-Products/blob/master/SBOM_and_VDRbaseline/sag-pm-118_VDR.json",
"referenceType" : "advisory"
} ]
```


## G.2 Satisfying NTIA Minimum Elements for an SBOM using SPDX

### G.2.1 US Executive Order 14028 Minimum Elements for an SBOM
Expand Down

0 comments on commit fca3630

Please sign in to comment.