Skip to main content

CSPM IOA

CSPM IOA is the CSPM behavior-detection list for this CID — GetBehaviorDetections (PEP 8 get_behavior_detections) and related cloud event IDs — GetCloudEventIDs (PEP 8 get_cloud_event_ids). The list path is GET /detects/entities/ioa/v1. The related-event path is GET /detects/queries/cloud-events/v1. Image assessment policies / remaining cloud and other cloud/container collections are not implemented (not yet). This is not GetIOAEvents (/ioa/entities/events/v1), not Alerts (/alerts/…), not Custom IOA (/ioarules/…), not the deferred Detects API, and not CDR event-details (/cdrapi/entities/event-details/v1). This is not Cloud AWS (/cloud-connect-cspm-aws/…) and not Kubernetes (/kubernetes-protection/…). Cloud IOA events is a separate collection: CSPM IOA events. Alerts is a separate collection: Alerts. Custom IOA is a separate collection: Custom IOA. CSPM AWS is a separate collection: CSPM AWS. CSPM Azure is a separate collection: CSPM Azure. CSPM GCP is a separate collection: CSPM GCP. 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: CspmRegistrationService. REST schemas: API reference. CSPM IOA uses query params, not FQL. GetBehaviorDetections filters this slice are cloud_provider and state. GetCloudEventIDs query id is required. Extra unused query keys (service, account_id, aws_account_id, azure_subscription_id, azure_tenant_id, date_time_since, since, severity, next_token, limit, resource_id, resource_uuid, parameters) are ignored. Clone success is JSON MSA 200 CspmIoaDetection for the list, and JSON MSA 200 string resources for related event IDs. SOURCE marks GetCloudEventIDs deprecated; the clone still serves GET. There is no detail GET this slice. This is not CDR logscale_related_events_query.

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 cspm-registration:read

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot list detections or related event IDs (403). GetBehaviorDetections and GetCloudEventIDs stay cspm-registration:read. There is no seeded production client with cspm-registration:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/detects/entities/ioa/v1List CSPM IOA behavior detections. RPC GetBehaviorDetections. PEP 8 get_behavior_detections. Query: cloud_provider (aws | azure), state (open | closed). Success 200 MSA CspmIoaDetection. Extra unused query keys ignored. Distinct from GetCloudEventIDs /detects/queries/cloud-events/v1, Alerts /alerts, and Custom IOA /ioarules.
GET/detects/queries/cloud-events/v1List related cloud event IDs for an IOA aggregate event. RPC GetCloudEventIDs. PEP 8 get_cloud_event_ids. Query: id (required). Success 200 MSA strings. Extra unused query keys ignored. Distinct from GetBehaviorDetections /detects/entities/ioa/v1, Alerts, Custom IOA, deferred Detects, and CDR. SOURCE deprecated; clone still serves GET.

Filters are exact match. Empty query params on the list return every detection in this CID. cloud_provider other than aws or azure → 400 "unknown cloud_provider". state other than open or closed → 400 "unknown state". Extra unused query keys are ignored. Default sort is detection_id ascending.

GetCloudEventIDs query id is required. Missing or blank id → 400 "id is required". Unknown id → 400 "unknown ioa aggregate event id". Extra unused query keys are ignored. id=ioa-lab-1 returns evt-lab-1, evt-lab-2 (order event_id ASC). id=ioa-lab-2 returns evt-lab-3. Clone success is 200 MSA strings (not SOURCE 207). SOURCE marks the operation deprecated; the clone still serves GET. This is not GetBehaviorDetections and not CDR event-details.

JSON for detections is SOURCE snake_case: detection_id, cloud_provider, account_id, service, state, severity, resource_id, cid. Related event IDs are string resources.

This is not Alerts, Custom IOA, the deferred Detects API, CDR, Cloud AWS, Cloud Azure, Cloud GCP, Kubernetes, or the HelloService template. Alerts uses /alerts/…: Alerts. Custom IOA uses /ioarules/…: Custom IOA. CSPM AWS uses /cloud-connect-cspm-aws/entities/account/v1: CSPM AWS. CSPM Azure uses /cloud-connect-cspm-azure/entities/account/v1: CSPM Azure. CSPM GCP uses /cloud-connect-cspm-gcp/entities/account/v1: CSPM GCP. Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet).

Seed detections​

detection_idcloud_provideraccount_idservicestateseverityresource_id
ioa-lab-1aws111111111111EC2openHighi-lab-1
ioa-lab-2azuresub-lab-1VirtualMachineclosedMediumvm-lab-1

cid is cid-local-1. Empty filters return both. cloud_provider=aws returns ioa-lab-1. state=open returns ioa-lab-1.

id (IOA aggregate)event ids
ioa-lab-1evt-lab-1, evt-lab-2
ioa-lab-2evt-lab-3

cid is cid-local-1. id=ioa-lab-1 returns both event ids in ascending order.

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 filters return at least the two seed ids, including ioa-lab-1 and ioa-lab-2:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/ioa/v1'

cloud_provider=aws returns ioa-lab-1:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/ioa/v1?cloud_provider=aws'

state=open returns ioa-lab-1:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/ioa/v1?state=open'

Extra unused query keys are ignored (limit does not paginate this slice):

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/ioa/v1?limit=1'

Unknown cloud_provider 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/detects/entities/ioa/v1?cloud_provider=bogus'

Unknown state 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/detects/entities/ioa/v1?state=bogus'

No cookie and no Bearer is 401:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/detects/entities/ioa/v1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Alerts is a separate collection: Alerts. Custom IOA is a separate collection: Custom IOA. This is not the deferred Detects API, not CDR, and not the HelloService template (GET /api/hello).

List (Bearer)​

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

cspm-registration:read → 200. A token without that scope (including hosts:read only, e.g. cs-local-hosts) → 403. Missing or revoked token → 401. GetBehaviorDetections stays cspm-registration:read. PEP 8 get_behavior_detections. There is no seeded production client with cspm-registration:read — use the console cookie, or a client you created with that scope.

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

GET id=ioa-lab-1 returns evt-lab-1 and evt-lab-2 (order event_id ASC). Success is 200 MSA strings. Extra unused query keys are ignored. SOURCE marks GetCloudEventIDs deprecated; the clone still serves GET. This is not GetBehaviorDetections (/detects/entities/ioa/v1), not Alerts, not Custom IOA, not the deferred Detects API, and not CDR event-details:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1?id=ioa-lab-1'

id=ioa-lab-2 returns evt-lab-3:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1?id=ioa-lab-2'

Missing id is 400 "id is required":

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1'

Unknown id is 400 "unknown ioa aggregate event id":

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1?id=not-an-ioa'

Extra unused query keys are ignored (limit does not paginate this slice):

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1?id=ioa-lab-1&limit=1'

cs-local-hosts (hosts:read only) is 403 on GET:

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1?id=ioa-lab-1'

No cookie and no Bearer is 401 on GET:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1?id=ioa-lab-1'

Image assessment policies / remaining cloud and other cloud collections are not implemented (not yet). Alerts is a separate collection: Alerts. Custom IOA is a separate collection: Custom IOA. This is not the deferred Detects API, not CDR, and not the HelloService template (GET /api/hello).

TOKEN='<access_token from a client with cspm-registration:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/detects/queries/cloud-events/v1?id=ioa-lab-1'

cspm-registration:read → 200. A token without that scope (including hosts:read only, e.g. cs-local-hosts) → 403. Missing or revoked token → 401. GetCloudEventIDs stays cspm-registration:read. PEP 8 get_cloud_event_ids. There is no seeded production client with cspm-registration:read — use the console cookie, or a client you created with that scope.

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