FeedNVDv2

This feed pulls CVE information from the NIST National Vulnerability Database using v2.0 of the API. By default, CVEs with a REJECTED status are excluded. Enable 'Include Rejected CVEs' to ingest them. This integration/feed deprecates the original National Vulnerability Database Feed integraiton as v1.0 of the API is being sunsetted in 2023.

Data Enrichment & Threat Intelligence · NVD Feed 2.0 · Feed

Details

IDFeedNVDv2
ProviderNIST
CategoryData Enrichment & Threat Intelligence
From Version6.10.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

CVE feed from the National Vulnerability Database.

This integration was built and tested with version 2.0 of National Vulnerability Database API. See the NVD Developer API documentation for more information.

An API key for this feed can be obtained at the NIST NVD Developer Website

This integration supports the latest CVSS - Common Vulnerability Scoring System standard - CVSS Version 4.0.

Configure National Vulnerability Database in Cortex

Parameter Description Required
Fetch indicators   False
API Key   False
Keyword Search Returns only the CVEs where the word or phrase is found in the description. False
CVSS Severity Filter Filter CVEs by severity. Queries each CVSS version selected in ‘CVSS Versions’. False
CVSS Versions CVSS versions to query when the severity filter is set. By default, covers most modern CVEs. False
Max Indicators Per Fetch The maximum number of indicators to fetch per interval. A lower value prevents timeouts during initial syncs with large lookback windows. The fetch will automatically resume from where it left off in the next interval. Without an API key, the recommended maximum is 40000. With an API key, the recommended maximum is 200000. True
First fetch time How far back should the integration fetch in its first run (1 day, 2 weeks, 3 months, etc.) False
Return Known Exploited Vulnerabilities (KEV) only. See the following for more information: https://nvd.nist.gov/developers/vulnerabilities#cves-hasKev False
Source Reliability Reliability of the source providing the intelligence data True
Indicator Reputation Indicators from this integration instance will be marked with this reputation. False
    False
Feed Fetch Interval   False
    False
Bypass exclusion list When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system. False
Trust any certificate (not secure)   False
Use system proxy settings   False
Tags Supports CSV values. False
Traffic Light Protocol Color The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed. False

NOTE ONE - Sample Debug Output - /var/log/demisto/integration_instance.log

Parameter Value Description
lastModStartDate DATE/TIME UTC The start date for the current CVE fetch cycle.
lastModEndDate DATE/TIME UTC The end date for the current CVE fetch cycle.
Fetch I teration Integer Current iteration of the overall fetch from NIST NVD.
Iteration Count Integer Iteration round through the current fetch cycle. NVD breaks up fetches into chunks to alleviate server load. This is the current count through one of the chunks of CVE data.
Total Results for Iteration Integer Total results returned for this fetch cycle chunk.
Current Total Fetched Indicator Count Integer Total number of CVEs fetched overall.
lastModStartDate: 2008-09-11T00:00:00.000
lastModEndDate: 2009-01-09T00:00:00.000 
Fetch Iteration: 5
Iteration Count: 0
Total Results for Iteration: 1
Current Total Fetched Indicator Count: 4184

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.

nvd-get-indicators


Manually retrieve CVEs from NVD using the history parameter for the duration back to fetch. CVSS severity and version filters can be overridden for this command.

Base Command

!nvd-get-indicators history="7 days"

Input

Argument Name Description Required
history Time back to retrieve CVEs, e.g. 7 days. Possible values are: 7 days. Required
keyword Keywords to query CVEs by. Optional
limit The maximum number of CVEs to return. Use a lower value to avoid timeouts due to large lookback windows. Default is 50. Optional
cvss_severity A comma-separated list of CVSS severities to use for this command. This overrides the instance-level CVSS Severity Filter. If left blank, the instance-level filter is used. Possible values are: CRITICAL, HIGH, MEDIUM, LOW. Optional
cvss_versions Override the instance-level CVSS Versions for this command. Comma-separated list. Possible values are: CVSS v4, CVSS v3, CVSS v2. Optional

Context Output

Path Type Description
CVE.ID String The ID of the CVE.
CVE.CVSS Number The CVSS score of the CVE.
CVE.Published Date The date the CVE was published.
CVE.Modified Date The date that the CVE was last modified.
CVE.Description String The description of the CVE.
CVE.CVSSVersion String The CVSS version used for scoring (e.g. 4.0, 3.1, 2.0).
CVE.Severity String The CVSS severity level (e.g. CRITICAL, HIGH, MEDIUM, LOW).

Configuration parameters

  • feed — Fetch indicators
  • apiKey
  • keyword_search — Keyword Search
  • cvssv3severity — CVSS 3 Severity Filter
  • cvss_severity — CVSS Severity Filter
  • cvss_versions — CVSS Versions
  • max_indicators — Max Indicators Per Fetch (required)
  • first_fetch — First fetch time
  • hasKev — Return Known Exploited Vulnerabilities (KEV) only.
  • include_rejected — Include Rejected CVEs
  • feedIncremental — Incremental feed
  • feedReliability — Source Reliability (required)
  • feedReputation — Indicator Reputation
  • feedExpirationPolicy
  • feedFetchInterval — Feed Fetch Interval
  • feedExpirationInterval
  • feedBypassExclusionList — Bypass exclusion list
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • feedTags — Tags
  • tlp_color — Traffic Light Protocol Color

Commands (1)

  • nvd-get-indicators

    Manually retrieve CVEs from NVD using the history parameter for the duration back to fetch. CVSS severity and version filters can be overridden for this command.

category: Data Enrichment & Threat Intelligence
provider: NIST
sectionorder:
- Connect
- Collect
commonfields:
  id: FeedNVDv2
  version: -1
configuration:
- defaultvalue: "true"
  display: Fetch indicators
  name: feed
  required: false
  type: 8
  section: Collect
- display: ""
  displaypassword: API Key
  hiddenusername: true
  name: apiKey
  required: false
  type: 9
  section: Connect
- name: keyword_search
  display: Keyword Search
  type: 0
  additionalinfo: Returns only the CVEs where the word or phrase is found in the description.
  required: false
  section: Collect
- name: cvssv3severity
  display: CVSS 3 Severity Filter
  additionalinfo: Select the severities you wish to get back from the feed.
  options:
  - CRITICAL
  - HIGH
  - MEDIUM
  - LOW
  defaultvalue:
  required: false
  type: 16
  section: Connect
  hidden: true
- name: cvss_severity
  display: CVSS Severity Filter
  additionalinfo: Filter CVEs by severity. Queries each CVSS version selected in 'CVSS Versions'.
  options:
  - CRITICAL
  - HIGH
  - MEDIUM
  - LOW
  defaultvalue:
  required: false
  type: 16
  section: Collect
- name: cvss_versions
  display: CVSS Versions
  additionalinfo: CVSS versions to query when the severity filter is set. By default, covers most modern CVEs.
  options:
  - CVSS v4
  - CVSS v3
  - CVSS v2
  defaultvalue: CVSS v4,CVSS v3
  required: false
  type: 16
  section: Collect
- name: max_indicators
  display: Max Indicators Per Fetch
  additionalinfo: The maximum number of indicators to fetch in a single interval. While not a strict limit, a lower value helps prevent timeouts during initial syncs with large lookback windows. The fetch will automatically resume from where it left off in the next interval. If you experience timeouts, reduce this value. Recommended maximum 40,000 (without API key) or 200,000 (with API key).
  defaultvalue: '10000'
  required: true
  type: 0
  section: Collect
- defaultvalue: 90 days
  display: First fetch time
  additionalinfo: How far back should the integration fetch in its first run (1 day, 2 weeks, 3 months, etc.)
  name: first_fetch
  required: false
  type: 0
  section: Collect
- additionalinfo: "See the following for more information: https://nvd.nist.gov/developers/vulnerabilities#cves-hasKev' # disable-secrets-detection."
  defaultvalue: "false"
  display: Return Known Exploited Vulnerabilities (KEV) only.
  name: hasKev
  required: false
  type: 8
  section: Collect
- additionalinfo: When enabled, CVEs with a REJECTED status are included in the feed. By default, rejected CVEs are excluded because they have no CVSS scores or useful threat intelligence data.
  defaultvalue: "false"
  display: Include Rejected CVEs
  name: include_rejected
  required: false
  type: 8
  section: Collect
- additionalinfo: Incremental feeds pull only new or modified indicators that have been sent from the integration. The determination if the indicator is new or modified happens on the 3rd-party vendor's side, so only indicators that are new or modified are sent to Cortex XSOAR. Therefore, all indicators coming from these feeds are labeled new or modified.
  defaultvalue: 'true'
  display: Incremental feed
  hidden: true
  name: feedIncremental
  type: 8
  required: false
  section: Collect
- additionalinfo: Reliability of the source providing the intelligence data
  defaultvalue: A - Completely reliable
  display: Source Reliability
  name: feedReliability
  options:
  - A - Completely reliable
  - B - Usually reliable
  - C - Fairly reliable
  - D - Not usually reliable
  - E - Unreliable
  - F - Reliability cannot be judged
  required: true
  type: 15
  section: Connect
- additionalinfo: Indicators from this integration instance will be marked with this reputation.
  display: Indicator Reputation
  name: feedReputation
  options:
  - None
  - Good
  - Suspicious
  - Bad
  required: false
  type: 18
  section: Connect
- defaultvalue: never
  display: ""
  name: feedExpirationPolicy
  options:
  - never
  - interval
  - indicatorType
  required: false
  type: 17
  section: Connect
- defaultvalue: '60'
  display: Feed Fetch Interval
  name: feedFetchInterval
  required: false
  type: 19
  section: Collect
- display: ""
  name: feedExpirationInterval
  required: false
  type: 1
  section: Connect
- additionalinfo: When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system.
  defaultvalue: "true"
  display: Bypass exclusion list
  name: feedBypassExclusionList
  required: false
  type: 8
  section: Connect
- defaultvalue: "false"
  display: Trust any certificate (not secure)
  name: insecure
  required: false
  type: 8
  section: Connect
- defaultvalue: "false"
  display: Use system proxy settings
  name: proxy
  required: false
  type: 8
  section: Connect
- additionalinfo: Supports CSV values.
  display: Tags
  name: feedTags
  required: false
  type: 0
  section: Connect
- additionalinfo: The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed.
  display: Traffic Light Protocol Color
  name: tlp_color
  options:
  - RED
  - AMBER
  - GREEN
  - WHITE
  type: 15
  required: false
  section: Connect
description: "This feed pulls CVE information from the NIST National Vulnerability Database using v2.0 of the API.\n\nBy default, CVEs with a REJECTED status are excluded. Enable 'Include Rejected CVEs' to ingest them.\n\nThis integration/feed deprecates the original National Vulnerability Database Feed integraiton as v1.0 of the API is being sunsetted in 2023."
display: National Vulnerability Database Feed v2
image: ''
name: FeedNVDv2
script:
  commands:
  - description: Manually retrieve CVEs from NVD using the history parameter for the duration back to fetch. CVSS severity and version filters can be overridden for this command.
    name: nvd-get-indicators
    arguments:
    - auto: PREDEFINED
      description: Time back to retrieve CVEs, e.g. `7 days`.
      name: history
      predefined:
      - "7 days"
      required: true
    - name: keyword
      description: Keywords to query CVEs by.
    - name: limit
      description: The maximum number of CVEs to return. Use a lower value to avoid timeouts due to large lookback windows.
      defaultValue: '50'
    - auto: PREDEFINED
      name: cvss_severity
      description: A comma-separated list of CVSS severities to use for this command. This overrides the instance-level CVSS Severity Filter. If left blank, the instance-level filter is used.
      isArray: true
      predefined:
      - CRITICAL
      - HIGH
      - MEDIUM
      - LOW
    - auto: PREDEFINED
      name: cvss_versions
      description: Override the instance-level CVSS Versions for this command. Comma-separated list. Note that the CVSS SeverityFilter only filters on Primary scores.
      isArray: true
      predefined:
      - CVSS v4
      - CVSS v3
      - CVSS v2
    outputs:
    - contextPath: CVE.ID
      description: The ID of the CVE.
      type: String
    - contextPath: CVE.CVSS
      description: The CVSS score of the CVE.
      type: number
    - contextPath: CVE.Published
      description: The date the CVE was published.
      type: Date
    - contextPath: CVE.Modified
      description: The date that the CVE was last modified.
      type: Date
    - contextPath: CVE.Description
      description: The description of the CVE.
      type: String
    - contextPath: CVE.CVSSVersion
      description: The CVSS version used for scoring (e.g. 4.0, 3.1, 2.0).
      type: String
    - contextPath: CVE.Severity
      description: The CVSS severity level (e.g. CRITICAL, HIGH, MEDIUM, LOW).
      type: String
  dockerimage: demisto/python3:3.12.13.10116658
  feed: true
  runonce: false
  script: ''
  subtype: python3
  type: python
fromversion: 6.10.0
tests:
- No tests (auto formatted)