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.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
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.