Skip to main content

Intel indicators

Intel indicators is the Falcon Intelligence indicator collection for this CID — query + POST GET only. Paths are under /intel/…. Combined indicators, reports, malware, MITRE, and CAO are not implemented. There is no create or patch. Quarantine is a separate collection: Quarantine.

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

RPC field notes: IntelService. 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 intel:read for query and get

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot query indicators (403). Unit tests use a client named cs-local-intel; that client is not in the production seed. There is no seeded client with intel:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/intel/queries/indicators/v1Query indicator ids. Query: filter, limit, offset, sort (type.asc / type.desc / indicator.asc / malicious_confidence.asc and matching .desc). Empty filter returns all ids.
POST/intel/entities/indicators/GET/v1Get indicators. Body { "ids": [] }. Missing id → 200 with only found resources.

Allowed FQL properties: type, indicator, malicious_confidence (match is lowercase). Unknown property or invalid filter → 400.

Indicator JSON: id, type, indicator, malicious_confidence.

This is not custom IOC. Custom IOC uses /iocs/… with GET ?ids= and write methods: IOC indicators. Intel actors are a separate /intel/… GET collection: Intel actors.

Seed indicators​

idtypeindicatormalicious_confidence
intel-ind-domain-1domainadversary.intel.invalidhigh
intel-ind-hash-1hash_sha25664×bmedium

Seed types are domain and hash_sha256. Query matches any stored string for those FQL properties.

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 intel-ind-domain-1 and intel-ind-hash-1. type:'domain' returns the domain row:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/intel/queries/indicators/v1?filter=type:%27domain%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/intel/queries/indicators/v1?filter=not-fql'

Get is POST with a JSON body, like user-management GET/v1 — not GET query ids:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"ids":["intel-ind-domain-1"]}' \
http://127.0.0.1:8088/intel/entities/indicators/GET/v1

Combined indicators, reports, malware, MITRE, and CAO are not implemented. Custom IOC is a separate collection: IOC indicators. Intel actors are a separate collection: Intel actors. Spotlight is a separate collection: Spotlight. Quarantine is a separate collection: Quarantine.

Query (Bearer)​

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

intel: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.