CSPM IOM
CSPM IOM is the CSPM configuration-detection collection for this CID —
GetConfigurationDetectionEntities (PEP 8
get_configuration_detection_entities), the IOM-id list —
GetConfigurationDetectionIDsV2 (PEP 8
get_configuration_detection_ids_v2), and the deprecated v1 list —
GetConfigurationDetections (PEP 8
get_configuration_detections). The entities path is
GET /detects/entities/iom/v2. The ids path is
GET /detects/queries/iom/v2. The v1 list path is
GET /detects/entities/iom/v1. Image assessment policies / remaining cloud and other cloud/container
collections are not implemented (not yet). This is not Cloud IOA
(/detects/entities/ioa/v1 GetBehaviorDetections,
/detects/queries/cloud-events/v1 GetCloudEventIDs), not Alerts
(/alerts/…), not Custom IOA (/ioarules/…), and not the
deferred Detects API. This is not Kubernetes IOM
(/container-security/…kubernetes-ioms…). This is not Cloud AWS
(/cloud-connect-cspm-aws/…) and not Kubernetes
(/kubernetes-protection/…). Cloud IOA is a separate collection:
CSPM IOA. Alerts is a separate collection:
Alerts. Custom IOA is a separate collection:
Custom IOA. Kubernetes IOM is a separate
collection: K8s IOMs. CSPM AWS is a separate
collection: CSPM AWS. 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. Filter syntax: FQL.
GetConfigurationDetectionEntities uses query params, not FQL.
GetConfigurationDetectionEntities filter this slice is optional ids.
GetConfigurationDetectionIDsV2 does use FQL (cloud_provider and
status this slice). GetConfigurationDetections uses query params, not
FQL (cloud_provider and status this slice). Extra unused query keys
(filter, limit, offset, next_token, parameters on entities;
sort, limit, offset, next_token, parameters on ids v2;
account_id, azure_subscription_id, azure_tenant_id, region,
severity, service, next_token, limit, parameters on v1) are
ignored. Clone success is JSON MSA 200 CspmIom for entities and
v1, and 200 MSA strings for ids v2. SOURCE marks
GetConfigurationDetections deprecated; clone still 200 (not 410).
There is no detail GET this slice.
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 configuration detections or IOM ids
(403). GetConfigurationDetectionEntities,
GetConfigurationDetectionIDsV2, and GetConfigurationDetections 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/iom/v2 | List CSPM configuration detections (IOMs). RPC GetConfigurationDetectionEntities. PEP 8 get_configuration_detection_entities. Query: optional ids. Success 200 MSA CspmIom. Extra unused query keys ignored. Distinct from GetConfigurationDetections /detects/entities/iom/v1, GetConfigurationDetectionIDsV2 /detects/queries/iom/v2, Cloud IOA /detects/entities/ioa/v1, Alerts /alerts, Custom IOA /ioarules, Kubernetes IOM, and deferred Detects. |
GET | /detects/entities/iom/v1 | List CSPM configuration detections (IOMs) on deprecated v1. RPC GetConfigurationDetections. PEP 8 get_configuration_detections. Query: optional cloud_provider + status this slice. Success 200 MSA CspmIom. Extra unused query keys ignored. SOURCE deprecated; clone still 200 (not 410). Distinct from GetConfigurationDetectionEntities /detects/entities/iom/v2, GetConfigurationDetectionIDsV2 /detects/queries/iom/v2, Kubernetes IOM, Alerts, and deferred Detects. |
GET | /detects/queries/iom/v2 | List CSPM configuration detection ids. RPC GetConfigurationDetectionIDsV2. PEP 8 get_configuration_detection_ids_v2. Query: optional FQL filter (cloud_provider, status this slice). Success 200 MSA strings. Extra unused query keys ignored. Distinct from GetConfigurationDetectionEntities /detects/entities/iom/v2, GetConfigurationDetections /detects/entities/iom/v1, Kubernetes IOM, Alerts, Custom IOA, and deferred Detects. |
Empty ids on entities returns every configuration detection in this
CID. Unknown ids are omitted (empty 200 if none match). Extra unused
query keys are ignored. Default sort is id ascending.
Empty filter on ids v2 returns every configuration detection id in
this CID ordered id ASC. Allowed FQL properties: cloud_provider,
status. Unknown property or invalid filter → 400. Extra unused
query keys (sort, limit, offset, next_token, parameters) are
ignored. filter=cloud_provider:'aws' returns iom-lab-1.
filter=status:'new' returns iom-lab-1.
Empty filters on v1 return every configuration detection in this CID
ordered id ASC. Allowed query params this slice: cloud_provider,
status. cloud_provider empty = all; allowed aws | azure |
gcp (lowercase); unknown → 400 unknown cloud_provider. status
empty or all = no status filter; new matches stored new;
reoccurring (SOURCE) and reoccurred (stored) both match
iom-lab-2; unknown → 400 unknown status. Extra unused query
keys (account_id, azure_subscription_id, azure_tenant_id,
region, severity, service, next_token, limit, parameters)
are ignored. cloud_provider=aws returns iom-lab-1. status=new
returns iom-lab-1. SOURCE marks GetConfigurationDetections
deprecated; clone still 200 (not 410).
JSON for entities is SOURCE snake_case: id, cloud_provider,
account_id, region, service, severity, status, resource_id,
cid. Ids v2 JSON is MSA string resources: resources is an array of
id strings (never nested IOM objects).
This is not Cloud IOA, Alerts, Custom IOA, the deferred Detects API,
Cloud AWS, Cloud Azure, Cloud GCP, Kubernetes IOM, Kubernetes, or the
HelloService template. Cloud IOA uses /detects/entities/ioa/v1:
CSPM IOA. Alerts uses /alerts/…: Alerts.
Custom IOA uses /ioarules/…: Custom IOA. CSPM AWS
uses /cloud-connect-cspm-aws/entities/account/v1:
CSPM AWS. Kubernetes IOM uses
/container-security/combined/kubernetes-ioms/v1:
K8s IOMs. Image assessment policies / remaining cloud and other cloud collections are
not implemented (not yet).
Seed detections
id | cloud_provider | account_id | region | service | severity | status | resource_id |
|---|---|---|---|---|---|---|---|
iom-lab-1 | aws | 111111111111 | us-west-2 | S3 | High | new | s3-lab-1 |
iom-lab-2 | azure | sub-lab-1 | eastus | Storage | Medium | reoccurred | storage-lab-1 |
cid is cid-local-1. Empty ids returns both.
ids=iom-lab-1 returns iom-lab-1. Empty ids-v2 filter returns both
ids. filter=cloud_provider:'aws' returns iom-lab-1. Empty v1
filters return both. cloud_provider=aws on v1 returns iom-lab-1.
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 ids returns at least the two seed ids, including iom-lab-1
and iom-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/iom/v2'
ids=iom-lab-1 returns iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/iom/v2?ids=iom-lab-1'
Unknown ids are omitted (empty 200 if none match):
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/iom/v2?ids=not-an-iom'
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/iom/v2?limit=1'
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/iom/v2'
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. Cloud IOA is a
separate collection: CSPM IOA. This is not
the deferred Detects API, not Kubernetes IOM, 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/iom/v2'
cspm-registration:read → 200. A token without that scope
(including hosts:read only, e.g. cs-local-hosts) → 403. Missing
or revoked token → 401. GetConfigurationDetectionEntities stays
cspm-registration:read. PEP 8 get_configuration_detection_entities.
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.
List v1 (cookie)
Empty filters return iom-lab-1 and iom-lab-2 (order id ASC).
Success is 200 MSA CspmIom. Extra unused query keys are ignored.
SOURCE marks GetConfigurationDetections deprecated; clone still 200
(not 410). This is not GetConfigurationDetectionEntities
(/detects/entities/iom/v2), not GetConfigurationDetectionIDsV2
(/detects/queries/iom/v2), not Kubernetes IOM, not Alerts,
and not the deferred Detects API:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/iom/v1'
cloud_provider=aws returns iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/iom/v1?cloud_provider=aws'
status=new returns iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/entities/iom/v1?status=new'
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/iom/v1?cloud_provider=bogus'
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/iom/v1?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/entities/iom/v1'
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/entities/iom/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. Cloud IOA is a
separate collection: CSPM IOA. This is not
the deferred Detects API, not Kubernetes IOM, and not the
HelloService template (GET /api/hello).
List v1 (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/iom/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. GetConfigurationDetections stays
cspm-registration:read. PEP 8 get_configuration_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.
List IDs (cookie)
Empty filter returns iom-lab-1 and iom-lab-2 (order id ASC).
Success is 200 MSA strings. Extra unused query keys are ignored.
This is not GetConfigurationDetectionEntities
(/detects/entities/iom/v2), not GetConfigurationDetections
(/detects/entities/iom/v1), not Kubernetes IOM, not Alerts,
and not the deferred Detects API:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/iom/v2'
filter=cloud_provider:'aws' returns iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/iom/v2?filter=cloud_provider:%27aws%27'
filter=status:'new' returns iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/detects/queries/iom/v2?filter=status:%27new%27'
Unknown FQL property 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/queries/iom/v2?filter=bogus:%27x%27'
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/iom/v2?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/iom/v2'
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/iom/v2'
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. Cloud IOA is a
separate collection: CSPM IOA. This is not
the deferred Detects API, not Kubernetes IOM, and not the
HelloService template (GET /api/hello).
List 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/iom/v2'
cspm-registration:read → 200. A token without that scope
(including hosts:read only, e.g. cs-local-hosts) → 403. Missing
or revoked token → 401. GetConfigurationDetectionIDsV2 stays
cspm-registration:read. PEP 8 get_configuration_detection_ids_v2.
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.