Skip to main content

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

  • Linux vuln-list (Forked from AquaSecurity)
  • 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 over 3.1 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

appthreat-vulnerability-db-4.1.10.tar.gz (39.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

appthreat_vulnerability_db-4.1.10-py3-none-any.whl (47.2 kB view details)

Uploaded Python 3

File details

Details for the file appthreat-vulnerability-db-4.1.10.tar.gz.

File metadata

File hashes

Hashes for appthreat-vulnerability-db-4.1.10.tar.gz
Algorithm Hash digest
SHA256 a3805296338fac1b236412f5838b060fcd8d07604ba6d431202bedb26d38e070
MD5 363e8d5a2132f93d0f3a13e1ae5a682e
BLAKE2b-256 7fb2c8bef4ef9297245f4d22ee27b6221e5680617335b2680b14b2aeadf2c89e

See more details on using hashes here.

File details

Details for the file appthreat_vulnerability_db-4.1.10-py3-none-any.whl.

File metadata

File hashes

Hashes for appthreat_vulnerability_db-4.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 848f32ea2b7d5fe44ecf1255467905a13d4c442e304a9d6a27197f73304e87b8
MD5 4da90e182dab97ab90586457c685a7e2
BLAKE2b-256 134d1b01cc6a0cae442460817fad7a560ce68642d540c9286e128891c4472a41

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page