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
| ID | FeedNVDv2 |
|---|---|
| Provider | NIST |
| Category | Data Enrichment & Threat Intelligence |
| From Version | 6.10.0 |
| Docker Image | demisto/python3:3.12.13.10116658 |
| Supported Modules | Agentix 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 indicatorsapiKey—keyword_search— Keyword Searchcvssv3severity— CVSS 3 Severity Filtercvss_severity— CVSS Severity Filtercvss_versions— CVSS Versionsmax_indicators— Max Indicators Per Fetch (required)first_fetch— First fetch timehasKev— Return Known Exploited Vulnerabilities (KEV) only.include_rejected— Include Rejected CVEsfeedIncremental— Incremental feedfeedReliability— Source Reliability (required)feedReputation— Indicator ReputationfeedExpirationPolicy—feedFetchInterval— Feed Fetch IntervalfeedExpirationInterval—feedBypassExclusionList— Bypass exclusion listinsecure— Trust any certificate (not secure)proxy— Use system proxy settingsfeedTags— Tagstlp_color— Traffic Light Protocol Color
Commands (1)
-
nvd-get-indicatorsManually 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)