Skip to main content

Spotlight

Spotlight vulnerabilities is the Spotlight collection for this CID — query/get only. Paths are under /spotlight/…. Combined vulnerabilities, remediations, after cursor pagination, and Intel extras are not implemented. There is no create or patch. Quarantine is a separate collection: Quarantine. Real Time Response is a separate collection: Real Time Response.

This collection is not CrowdStrike production. It does not call Falcon cloud.

RPC field notes: SpotlightService. REST schemas: API reference. Filter syntax: FQL.

These curls use Host: crowdstrike-api.localhost against Compose Traefik on :8088. If the hostname already resolves to Traefik, you can omit the Host header and call http://crowdstrike-api.localhost instead.

Auth​

Every call needs a console session or a Bearer token:

  • Cookie cs_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with spotlight-vulnerabilities:read for query and get

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot query vulnerabilities (403). There is no seeded client with spotlight-vulnerabilities:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/spotlight/queries/vulnerabilities/v1Query vulnerability ids. Query: filter, limit, offset, sort (cve_id.asc / cve_id.desc / severity.asc / status.asc and matching .desc). Empty filter returns all ids.
GET/spotlight/entities/vulnerabilities/v2?ids=Get vulnerabilities. Missing id → 200 with only found resources.

Allowed FQL properties: cve_id, severity, status (match is lowercase). Nested cve.id is not accepted. Unknown property or invalid filter → 400.

Vulnerability JSON: id, cve_id, severity, status.

Get is GET with query ids — not POST GET.

Seed vulnerabilities​

idcve_idseveritystatus
vuln-cve-2024-0001CVE-2024-0001highopen
vuln-cve-2024-0002CVE-2024-0002mediumopen
curl -sS -c cookies.txt -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"FalconLocal!1","cloud":"us-1"}' \
http://127.0.0.1:8088/identity/entities/sessions/v1

Empty filter returns at least the seed ids vuln-cve-2024-0001 and vuln-cve-2024-0002. severity:'high' returns CVE-2024-0001:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/spotlight/queries/vulnerabilities/v1?filter=severity:%27high%27'

Invalid FQL is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/spotlight/queries/vulnerabilities/v1?filter=not-fql'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/spotlight/entities/vulnerabilities/v2?ids=vuln-cve-2024-0001'

Combined, remediations, and after cursor pagination are not implemented. Intel actors are a separate collection: Intel actors. Intel indicators are a separate POST GET collection: Intel indicators. Quarantine is a separate collection: Quarantine. Real Time Response is a separate collection: Real Time Response.

Query (Bearer)​

TOKEN='<access_token from a client with spotlight-vulnerabilities:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/spotlight/queries/vulnerabilities/v1'

spotlight-vulnerabilities:read → 200. A token without that scope (including hosts:read only) → 403. Missing or revoked token → 401.

OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.