Skip to main content

Drift indicators

Drift indicators is the container-security combined drift indicators collection for this CID — SearchAndReadDriftIndicatorEntities (PEP 8 search_and_read_drift_indicators). The path is GET /container-security/combined/drift-indicators/v1. Count-by-date, count, entities, and queries are not implemented. No further roadmap row. Remaining operations stay under Not yet implemented. This is not Image compliance (/container-compliance/aggregates/compliance-by-images/…): Image compliance. This is not the HelloService template sample (GET /api/hello).

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

RPC field notes: DriftIndicatorsService. REST schemas: API reference. Unused query keys filter, limit, offset, and sort are ignored.

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 drift-indicators:read

A session cookie bypasses OAuth scopes and can list. Seed client cs-local-hosts (hosts:read only) cannot list (403). Unit tests use a client named cs-local-drift with drift-indicators:read; that client can list. cs-local-drift is tests only. SearchAndReadDriftIndicatorEntities stays drift-indicators:read. There is no write scope and no seeded production client with drift-indicators:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/container-security/combined/drift-indicators/v1List drift indicators. RPC SearchAndReadDriftIndicatorEntities. PEP 8 search_and_read_drift_indicators. drift-indicators:read. Extra unused query filter, limit, offset, sort ignored. Success 200 MSA resources (detection_id, detection_name, severity, container_id, file_name, prevented, occurred_at) — not a detections envelope. prevented is bool. Order by detection_id ascending. Distinct from Image compliance. Count-by-date, count, entities, and queries are not implemented.

Empty query params on GET return every indicator in this CID. Default sort is detection_id ascending. Empty store → empty resources, still 200.

JSON is snake_case MSA. Clone success is 200.

GET /container-security/aggregates/drift-indicators/count-by-date/v1, GET /container-security/aggregates/drift-indicators/count/v1, GET /container-security/entities/drift-indicators/v1, and GET /container-security/queries/drift-indicators/v1 are not implemented. No further roadmap row. Remaining operations stay under Not yet implemented.

Seed indicators​

detection_iddetection_nameseveritycontainer_idfile_namepreventedoccurred_at
drift-lab-1Lab drift onehighctr-lab-1/usr/bin/labfalse2026-09-02T00:00:00Z
drift-lab-2Lab drift twomediumctr-lab-2/usr/bin/lab2true2026-09-04T00:00:00Z

List returns drift-lab-1 then drift-lab-2 in detection_id order. prevented is bool: drift-lab-1 is false; drift-lab-2 is true.

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'
curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/drift-indicators/v1'

Success returns drift-lab-1 then drift-lab-2.

Count-by-date, count, entities, and queries are not implemented (not yet). No further roadmap row. Remaining operations stay under Not yet implemented. This is not Image compliance.