AppThreat's vulnerability database and package search library with a built-in file based storage. OSV, CVE, GitHub, npm are the primary sources of vulnerabilities.
Project description
Introduction
This repo is a vulnerability database and package search for sources such as Aqua Security vuln-list, OSV, NVD, GitHub, and NPM. Vulnerability data are downloaded from the sources and stored in a custom file based storage with indexes to allow offline access and quick searches.
Vulnerability Data sources
- AquaSecurity vuln-list
- OSV
- NVD
- GitHub
- NPM
Linux distros
- AlmaLinux
- Debian
- Alpine
- Amazon Linux
- Arch Linux
- RHEL/CentOS
- Rocky Linux
- Ubuntu
- OpenSUSE/SLES
- Photon
Installation
pip install appthreat-vulnerability-db
Usage
This package is ideal as a library for managing vulnerabilities. This is used by dep-scan, a free open-source dependency audit tool. However, there is a limited cli capability available with few features to test this tool directly.
Download pre-built database
Use the ORAS cli to download a pre-built database containing all application and OS vulnerabilities.
export VDB_HOME=$HOME/vdb
oras pull ghcr.io/ngcloudsec/vdb:v1 -o $VDB_HOME
Cache vulnerability data
Cache application vulnerabilities
vdb --cache
Typical size of this database is over 1.1 GB.
Cache application and OS vulnerabilities
vdb --cache-os
Note the size of the database with OS vulnerabilities is around 2.7 GB.
Cache from just OSV
vdb --cache --only-osv
It is possible to customise the cache behaviour by increasing the historic data period to cache by setting the following environment variables.
- NVD_START_YEAR - Default: 2018. Supports upto 2002
- GITHUB_PAGE_COUNT - Default: 2. Supports upto 20
Periodic sync
To periodically sync the latest vulnerabilities and update the database cache.
vdb --sync
Basic search
It is possible to perform simple search using the cli.
vdb --search android:8.0
vdb --search google:android:8.0
vdb --search android:8.0,simplesamlphp:1.14.11
Syntax is package:version,package:version or vendor : package : version (Without space)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for appthreat-vulnerability-db-4.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4611beb1e7c0cb52dc744e5cf67f5ce52765f68a9e32cff41da8731240a8910f |
|
MD5 | e9e2faa3c1391574d0b1f12d698cc8e5 |
|
BLAKE2b-256 | 20812f013d9d1b6fce579087b5683e8460261b0e4e04ddc3fb057675677b85fb |
Hashes for appthreat_vulnerability_db-4.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 10ab9ad040acec4e762ed3ee9d2a826d315fe2aaa727abfa271f92b9c1160d65 |
|
MD5 | 1dc1df3fef5e89851ad6d0dd46a72f0e |
|
BLAKE2b-256 | f13795f7110187430084e17358e3210e39853e94d4dcc4166fcb7db4d8e94495 |