Skip to main content

Import supplier VEX and evidence packs

You can import the VEX files and signed evidence packs that your component suppliers publish. CVD Portal matches each supplier statement to your hardware components and SBOM components. A statement stays the supplier's claim until an admin confirms it. Nothing is copied into your own VEX automatically.

This supports your due diligence on integrated components under CRA Article 13(5). The feature is on the Compliance and Enterprise plans.

Import a file​

  1. Open Supply Chain Partners.
  2. In Upstream supplier VEX and signed evidence packs, select the supplier in Partner if it is in your partner list.
  3. Choose the file, or paste its text. The limit is 2 MB.
  4. Optionally, enter Source URL, the address where you got the file. CVD Portal stores the address and does not open it.
  5. Click Import supplier evidence.

Only an admin can import. If you import the same file again, nothing changes.

Accepted formats​

FormatWhat CVD Portal reads
CSAF 2.0 (VEX or security advisory)Publisher, document id, the product tree with model numbers, SKUs, CPE and package URL, and the status of each vulnerability per product
OpenVEX v0.2.0Author, each statement with its status, justification and products
CycloneDX 1.5 or 1.6 VEXThe components with CPE and package URL, and the analysis state of each vulnerability
evidence.jws from a CVD Portal trust portalThe supplier name, the product and its part numbers

CSAF statuses are merged into four VEX statuses. known_affected, first_affected and last_affected become Affected. fixed and first_fixed become Fixed.

Signed evidence packs​

An evidence.jws file is the signed evidence pack that an approved viewer downloads from a supplier's trust portal. See Signed evidence pack.

CVD Portal checks the signature against its own evidence key, the one published as #key-2 in https://cvdportal.com/.well-known/did.json. A pack that fails the check is refused. This happens when the file was changed after signing, or when it was not signed by CVD Portal. The import list marks a checked pack with signature checked.

A pack holds no VEX statements, so it adds no rows to review. It records that you hold the supplier's signed evidence for the product.

Match to your inventory​

Each statement is matched to your inventory on these values, without regard to upper or lower case:

  • A part number, CPE or package URL that is equal to the identifier of a hardware component.
  • A package URL that is equal to the package URL of an SBOM component. For an SBOM component with no package URL, the name and version must both be equal. A statement about version 2.0.0 never matches version 1.0.0.
  • When the statement names no package URL, a part number or product name that is equal to the name of an SBOM component.
  • A product name that is equal to the name or identifier of a hardware component.

In OpenVEX, a product @id that is a package URL or a CPE counts as that identifier.

The statement shows No match when nothing is equal. Check that the identifier in your hardware registry is the supplier's part number.

Review a statement​

Each statement shows the supplier's status, the label Supplier statement, the publisher and the match. A new statement is Not reviewed.

  • Confirm records that you checked the claim and accept it for your product.
  • Reject records that you do not accept the claim.
  • Reset sets the statement back to Not reviewed.

Only an admin can confirm, reject or reset. Each action writes an audit log entry.

The list shows up to 250 statements that are not reviewed, the oldest first, and the 100 most recent reviewed ones. Each review brings the next statement into the list. The tab counts always show the totals.