Skip to main content

IOC indicators

IOC indicators is the Falcon IOC collection for this CID. Paths are under /iocs/…. Combined endpoints, aggregates, devices_ran_on, processes_ran_on, SDMF, reports, action catalog, type/platform/severity query helpers, legacy /indicators/entities/iocs/v1, and the Falcon create envelope indicators[] are not implemented.

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

RPC field notes: IocService. 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 ioc:read for query and get
  • ioc:write for create, patch, and delete

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-iocs; that client is not in the production seed. There is no seeded client with ioc:read — use the console cookie, or a client you created with that scope.

HTTP paths​

MethodPathUse
GET/iocs/queries/indicators/v1Query ids. Query: filter, limit, offset, sort (type.asc / type.desc / value.asc / action.asc / severity.asc and matching .desc). Empty filter returns all ids.
GET/iocs/entities/indicators/v1?ids=Get indicators. Missing id → 200 with only found resources.
POST/iocs/entities/indicators/v1Create. Body { "type", "value", "action", "severity", "description", "platforms", "applied_globally" } at the top level — not Falcon indicators[]. Empty value → 400. Unknown type → 400. Success 201.
PATCH/iocs/entities/indicators/v1Update. Body { "id", "action", "severity", "description" }.
DELETE/iocs/entities/indicators/v1?ids=Delete indicators.

Allowed FQL properties: type, value, action, severity (match is lowercase). Unknown property or invalid filter → 400.

type must be sha256, md5, domain, or ipv4. action must be detect or prevent. severity must be low, medium, high, or critical. Unknown action or severity → 400.

Indicator JSON: id, type, value, action, severity, platforms, description, applied_globally. Create ids are ioc- plus 16 hex.

Seed indicators​

idtypevalueactionseveritydescription
ioc-domain-1domainadversary.example.invaliddetecthighLab domain
ioc-sha256-1sha25664×adetectmediumLab SHA256

Both seeds have applied_globally true and empty platforms.

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 two seed ids, including ioc-domain-1. type:'domain' returns the domain row:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/iocs/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/iocs/queries/indicators/v1?filter=not-fql'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/iocs/entities/indicators/v1?ids=ioc-domain-1,ioc-sha256-1'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"type":"domain","value":"lab.example.invalid","action":"detect","severity":"medium","description":"lab","platforms":["windows"],"applied_globally":true}' \
http://127.0.0.1:8088/iocs/entities/indicators/v1

Success is 201. The new id is in resources. Empty value → 400. Falcon indicators[] is not implemented — send fields at the top level.

curl -sS -X PATCH -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"id":"ioc-domain-1","action":"prevent","severity":"critical","description":"patched"}' \
http://127.0.0.1:8088/iocs/entities/indicators/v1
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/iocs/entities/indicators/v1?ids=<indicator-id>'

Create, patch, and delete need ioc:write (or a session). A token with only ioc:read → 403 on those methods.

Combined, aggregates, devices_ran_on, processes_ran_on, SDMF, reports, type/platform/severity query helpers, and legacy /indicators/entities/iocs/v1 are not implemented. Custom IOA is a separate collection: Custom IOA. Intel actors are a separate /intel/… collection (not custom IOC): Intel actors. Intel indicators are a separate POST GET /intel/… collection — not custom IOC /iocs/…: Intel indicators.

Query (Bearer)​

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

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