search

fkie-cad / nvd-json-data-feeds

Community reconstruction of the legacy JSON NVD Data Feeds. This project uses and redistributes data from the NVD API but is neither endorsed nor certified by the NVD.
114 stars 16 forks source link

readme

nvd-json-data-feeds

monitor-release monitor-sync validate-schema

Community reconstruction of the deprecated JSON NVD Data Feeds. Releases each day at 00:00 AM UTC. Repository synchronizes with the NVD every 2 hours.

Repository at a Glance

Last Repository Update

2024-11-19T19:00:26.573949+00:00

Most recent CVE Modification Timestamp synchronized with NVD

2024-11-19T18:42:44.733000+00:00

Last Data Feed Release

Download and Changelog: Click

2024-11-19T01:00:10.094879+00:00

Total Number of included CVEs

270591

CVEs added in the last Commit

Recently added CVEs: 269

CVEs modified in the last Commit

Recently modified CVEs: 54

Download and Usage

There are several ways you can work with the data in this repository:

1) Release Data Feed Packages

The most straightforward approach is to obtain the latest Data Feed release packages here.

Each day at 00:00 AM UTC we package and upload JSON files that aim to reconstruct the legacy NVD CVE Data Feeds. Those are aggregated by the year part of the CVE identifier:

# CVE-<YEAR>.json
CVE-1999.json
CVE-2001.json
CVE-2002.json
CVE-2003.json
[...]
CVE-2023.json
CVE-2024.json

We also upload the well-known Recent and Modified feeds. Furthermore, we provide the All feed, which contains a recent snapshot of all NVD records. Once your local copy is synchronized and the last synchronization is no older than 8 days, you can rely on these to stay up to date:

CVE-Recent.json   # CVEs that were added in the previous eight days
CVE-Modified.json # CVEs that were modified or added in the previous eight days

Note that all feeds are distributed in xz-compressed format to save storage and bandwidth. For decompression execute:

xz -d -k <feed>.json.xz

Automation using Release Data Feed Packages

You can fetch the latest releases for each package with the following static link layout:

https://github.com/fkie-cad/nvd-json-data-feeds/releases/latest/download/CVE-<YEAR>.json.xz

Example:

wget https://github.com/fkie-cad/nvd-json-data-feeds/releases/latest/download/CVE-2024.json.xz
xz -d -k CVE-2024.json.xz

2) Clone the Repository (with Git History)

As you can see by browsing this repository, there is a slight difference between the release packages format and the repository folder structure. This is because we want to maintain explorability of the dataset.

Each CVE gets its own JSON file, e.g., CVE-1999-0001.json. Here, each file is put into a folder layout that first sorts by CVE year identifier part and then by number part. We mask (xx) the last two digits to create easily navigable folders that hold a maximum of 100 CVE JSON files:

.
├── CVE-1999
│   ├── CVE-1999-00xx
│   │   ├── CVE-1999-0001.json
│   │   ├── CVE-1999-0002.json
│   │   └── [...]
│   ├── CVE-1999-01xx
│   │   ├── CVE-1999-0101.json
│   │   └── [...]
│   └── [...]
├── CVE-2000
│   ├── CVE-2000-00xx
│   ├── CVE-2000-01xx
│   └── [...]
└── [...]

A byproduct of managing and continuously updating this dataset via Git is that we can track changes over time through the Git history.

If you are interested in having the NVD data as organized above, including the historical data of changes, just clone this repository (large!):

git clone https://github.com/fkie-cad/nvd-json-data-feeds.git

(Optional) Meta Files

Similar to the old official feeds, we provide meta files with each release. They can be fetched for each feed via:

https://github.com/fkie-cad/nvd-json-data-feeds/releases/latest/download/CVE-<YEAR>.meta

The structure is as follows:

lastModifiedDate:1970-01-01T00:00:00.000+00:00                          # ISO 8601 timestamp of last CVE modification
size:1000                                                               # size of uncompressed feed (bytes)
xzSize:100                                                              # size of lzma-compressed feed (bytes)
sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 # sha256 hexdigest of uncompressed feed

3) Clone the Repository (without Git History)

Don't need the history? Then create a shallow copy:

git clone --depth 1 -b main https://github.com/fkie-cad/nvd-json-data-feeds.git

Update Timetable

Motivation

On 2023-12-15, the NIST deprecated all JSON-based NVD Data Feeds. The new NVD CVE API 2.0 is, without a doubt, a great way to obtain CVE information. However, we from Fraunhofer FKIE - Cyber Analysis and Defense believe that the API does not cover a variety of use cases.

The legacy NVD Data Feeds provided a convenient way to quickly obtain a complete, file-based offline database snapshot; just download the CVE-<YEAR>.tar.gz, decompress it, and use it as you please, e.g.:

Unfortunately, the new NVD API 2.0 adds complexity to this process. We want to preserve ease of use by reconstructing these data sources.

Non-Endorsement Clause

This project uses and redistributes data from the NVD API but is not endorsed or certified by the NVD.