Skip to content

Commit

Permalink
docs: add info about supporting cpe in vex
Browse files Browse the repository at this point in the history
* fixes intel#4012

Signed-off-by: Terri Oda <[email protected]>
  • Loading branch information
terriko committed Aug 23, 2024
1 parent 9f8d4d9 commit f592d34
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions doc/triaging_process.md
Original file line number Diff line number Diff line change
Expand Up @@ -263,6 +263,12 @@ There are some limitations associated with product identification. We mainly use

- Purl is used to identify products in the OpenVEX and CSAF formats. The format is `pkg:generic/{vendor}/{product}@{version}`. Here, the type is set to generic by default. However, if a language dependency file is being scanned and the CVE Binary Tool can generate a valid purl from processing it, the type is set to the respective dependency management type (e.g., go, pypi, gem, npm, etc.), and the namespace field is used for vendor information.

- As well as the identifiers above, cve-bin-tool can handle [CPE
identifiers](https://nvd.nist.gov/products/cpe) as used by NVD. These look like
`cpe:{cpe_version}:a:{vendor}:{product}:{version}` and can be useful in
ensuring that you get a specific set of records from NVD. We currently
support v2.2 and v2.3.

- Cve Binary Tool will also ignore the entries for components which are from VEX document but are not present in the file/binary being scanned and log a message asking weather the VEX document being scanned belongs to the file/binary being scanned, example: `Product: dio with Version: 1.3.2 not found in Parsed Data, is valid vex file being used?`

This holy trio of vendor, product, and version/release allows the CVE Binary Tool to identify the component exactly and use it for the VEX process. Thus, it's no secret that the CVE Binary Tool works wonderfully with these. However, any VEX document generated outside the CVE Binary Tool may not be fully supported in the same way.
Expand Down

0 comments on commit f592d34

Please sign in to comment.