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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithcspm-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
| Method | Path | Use |
|---|---|---|
GET | /detects/entities/ioa/v1 | List 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/v1 | List 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_id | cloud_provider | account_id | service | state | severity | resource_id |
|---|---|---|---|---|---|---|
ioa-lab-1 | aws | 111111111111 | EC2 | open | High | i-lab-1 |
ioa-lab-2 | azure | sub-lab-1 | VirtualMachine | closed | Medium | vm-lab-1 |
cid is cid-local-1. Empty filters return both.
cloud_provider=aws returns ioa-lab-1.
state=open returns ioa-lab-1.
Seed related events
id (IOA aggregate) | event ids |
|---|---|
ioa-lab-1 | evt-lab-1, evt-lab-2 |
ioa-lab-2 | evt-lab-3 |
cid is cid-local-1. id=ioa-lab-1 returns both event ids in
ascending order.
Session cookie
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
List detections (cookie)
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.
Related event IDs (cookie)
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).
Related event IDs (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/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.