Skip to content

Add OpenCVE analyzer#1458

Open
thunderstornX wants to merge 1 commit into
TheHive-Project:developfrom
thunderstornX:analyzer-opencve
Open

Add OpenCVE analyzer#1458
thunderstornX wants to merge 1 commit into
TheHive-Project:developfrom
thunderstornX:analyzer-opencve

Conversation

@thunderstornX

Copy link
Copy Markdown

Summary

Adds an OpenCVE analyzer that enriches a cve observable using the free OpenCVE API. This addresses #1236: the only existing CVE-enrichment analyzer (Vulners) is a commercial service, whereas OpenCVE is free and can also be self-hosted.

Closes #1236

What it returns

For a given CVE, the analyzer reports:

  • CVSS metrics (v3.1 / v4.0 / v3.0 / v2.0), score and vector
  • CISA KEV status (known-exploited) and EPSS score
  • CWE weaknesses
  • Affected vendors and products (OpenCVE's vendor$PRODUCT$product list is split into readable vendors and products)

Two taxonomies are produced:

  • OpenCVE:CVSS=<score>, level by severity (malicious if in CISA KEV or CVSS >= 9, suspicious if CVSS >= 4, otherwise info)
  • OpenCVE:KEV=CISA when the CVE is in the CISA KEV catalog

Configuration

Name Description Required Default
token OpenCVE organization API token (Bearer). The free plan includes API access. yes
base_url OpenCVE API base URL. Point it at a self-hosted instance if needed. no https://app.opencve.io/api

Files

  • analyzers/OpenCVE/OpenCVE.json, opencve_analyzer.py, requirements.txt, README.md
  • thehive-templates/OpenCVE_1_0/long.html, short.html

Testing

Tested live against the OpenCVE API:

  • CVE-2021-44228 (Log4Shell): CVSS v3.1 = 10, CISA KEV present, EPSS 0.94 → OpenCVE:CVSS=10 (malicious) + OpenCVE:KEV=CISA; 13 vendors and 177 products parsed.
  • Unknown CVE → clean "not found" report (no error).
  • Non-cve data type → rejected with a clear error message.
  • flake8 clean.

Enrich cve observables with OpenCVE data (CVSS metrics, CISA KEV status, EPSS score, CWE weaknesses and affected vendors/products) via the free OpenCVE API. A configurable base_url supports self-hosted instances. The only existing CVE analyzer (Vulners) is a commercial service.

Closes TheHive-Project#1236
@nusantara-self nusantara-self self-assigned this Jun 15, 2026
@nusantara-self nusantara-self added scope:analyzer Issue is analyzer related category:new-analyzer New analyzer submitted labels Jun 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

category:new-analyzer New analyzer submitted scope:analyzer Issue is analyzer related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants