Lib4VEX is a library to parse and generate VEX documents. It supports VEX documents created in the OpenVEX, CycloneDX or CSAF specifications.
It has been developed on the assumption that having a generic abstraction of vulnerability regardless of the underlying format will be useful to developers.
The following facilities are provided:
- Generate OpenVEX, CycloneDX and CSAF VEX documents in JSON format
- Parse CycloneDX SBOM in JSON format and extract vulnerability information
- Parse OpenVEX and CSAF documents to extract vulnerability information
- Generated VEX document can be output to a file or to the console
To install use the following command:
pip install lib4vex
Alternatively, just clone the repo and install dependencies using the following command:
pip install -U -r requirements.txt
The tool requires Python 3 (3.8+). It is recommended to use a virtual python environment especially
if you are using different versions of python. virtualenv is a tool for setting up virtual python environments which
allows you to have all the dependencies for the tool set up in a single environment, or have different environments set
up for testing using different versions of Python.
Creating the environment variable LIB4VEX_DEBUG will result in some additional information being reported when a VEX document is being generated.
A number of example scripts are included in the examples subdirectory. Examples are provided for CSAF, CycloneDX and OpenVEX scenarios.
A tutorial showing a lifecycle of vulnerabilities is available. Whilst the tutorial uses CSAF as the VEX document, equivalent steps can be performed for producing a VEX document using CycloneDX or OpenVEX.
The following design decisions have been made in creating and processing VEX files:
-
VEXes should be produced with reference to an SBOM so that only vulnerabilities for components included in the SBOM are included in the VEX document.
-
The VEX document contains all reported vulnerabilities and the respective status. The latest VEX is indicated by the latest timestamp. The previous VEX documents are retained for audit purposes.
-
The VEX document is intended to be used for a single product.
- Add support for SPDX Security profile when released as part of the SPDX 3.0 release.
Licensed under the Apache 2.0 Licence.
This library is meant to support software development. The usefulness of the library is dependent on the data which is provided. Unfortunately, the library is unable to determine the validity or completeness of such a VEX file; users of the library and the resulting VEX file are therefore reminded that they should assert the quality of any data which is provided to the library.
Bugs and feature requests can be made via GitHub Issues.