CrowdStrike SearchVulnerabilities

CrowdStrike SearchVulnerabilities

Certified
Enterprise Edition

Search CrowdStrike Falcon Spotlight vulnerabilities

Searches vulnerabilities with the CrowdStrike Falcon Query Language (FQL) — filter on CVE ID, severity, status, or host fields — and pages through every matching result using cursor-based pagination. Unlike most other CrowdStrike search endpoints, this one requires filter to be set. fetchType=STORE is recommended for large result sets: it streams results to internal storage instead of holding them all in memory or in the execution output.

yaml
type: io.kestra.plugin.ee.crowdstrike.spotlight.SearchVulnerabilities

Store every open critical vulnerability for downstream processing

yaml
id: search_vulnerabilities
namespace: company.team

tasks:
  - id: search_vulnerabilities
    type: io.kestra.plugin.ee.crowdstrike.spotlight.SearchVulnerabilities
    clientId: "{{ secret('CROWDSTRIKE_CLIENT_ID') }}"
    clientSecret: "{{ secret('CROWDSTRIKE_CLIENT_SECRET') }}"
    filter: "status:'open'+cve.severity:'CRITICAL'"
    fetchType: STORE
Properties

API client ID

Client ID of a CrowdStrike API client with the scopes required by the tasks and triggers being used.

API client secret

Client secret of the CrowdStrike API client. Exchanged for a short-lived OAuth2 Bearer token on every task run and trigger poll; never logged.

FQL filter

CrowdStrike Falcon Query Language expression (for example: status: 'open'+cve.severity: 'CRITICAL'). Required — unlike most other CrowdStrike search endpoints, the Spotlight vulnerabilities endpoint does not match everything when this is omitted.

Defaulthttps://api.crowdstrike.com

CrowdStrike API base URL

Base URL of the CrowdStrike Falcon API for your cloud region (for example: https://api.crowdstrike.com for US-1, https://api.us-2.crowdstrike.com for US-2, https://api.eu-1.crowdstrike.com for EU-1, or https://api.laggar.gcw.crowdstrike.com for US-GOV-1). Defaults to the US-1 endpoint. Using the wrong region for your tenant results in 403 Forbidden responses.

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Fetch type

FETCH_ONE outputs the first vulnerability, FETCH outputs every vulnerability, STORE streams every vulnerability to internal storage and returns a URI. Defaults to FETCH.

Default100

Page size

Internal pagination page size, from 1 to 400, used for FETCH and STORE (every matching vulnerability is fetched regardless of this value). Ignored for FETCH_ONE, which requests a single record directly. Defaults to 100.

Sort order

Sort field and direction (for example: cve.base_score.desc).

Number of vulnerabilities fetched

Total number of vulnerabilities matching the filter

Formaturi

Stored data URI

Populated only when fetchType=STORE.

Fetched vulnerabilities

Populated only when fetchType=FETCH.

Definitions
created_timestampstring

UTC timestamp this vulnerability was first detected, ISO-8601.

cve

CVE details for this vulnerability.

base_scorenumber

CVSS base score.

exploit_statusinteger

Known exploit status (for example EASILY_ACCESSIBLE).

idstring

CVE identifier (for example CVE-2024-12345).

severitystring

CVE severity: LOW, MEDIUM, HIGH, or CRITICAL.

host_info

Host the vulnerability was detected on.

device_idstring

Device ID (AID) of the affected host.

hostnamestring

Hostname of the affected host.

platform_namestring

Platform name (for example Windows).

idstring

Spotlight vulnerability ID.

remediation

Suggested remediation.

descriptionstring

Human-readable remediation guidance.

statusstring

Remediation status: open or closed.

updated_timestampstring

UTC timestamp this vulnerability was last updated, ISO-8601.

First fetched vulnerability

Populated only when fetchType=FETCH_ONE.

Definitions
created_timestampstring

UTC timestamp this vulnerability was first detected, ISO-8601.

cve

CVE details for this vulnerability.

base_scorenumber

CVSS base score.

exploit_statusinteger

Known exploit status (for example EASILY_ACCESSIBLE).

idstring

CVE identifier (for example CVE-2024-12345).

severitystring

CVE severity: LOW, MEDIUM, HIGH, or CRITICAL.

host_info

Host the vulnerability was detected on.

device_idstring

Device ID (AID) of the affected host.

hostnamestring

Hostname of the affected host.

platform_namestring

Platform name (for example Windows).

idstring

Spotlight vulnerability ID.

remediation

Suggested remediation.

descriptionstring

Human-readable remediation guidance.

statusstring

Remediation status: open or closed.

updated_timestampstring

UTC timestamp this vulnerability was last updated, ISO-8601.