Skip to main content

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_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 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​

MethodPathUse
GET/detects/entities/iom/v2List 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/v1List 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/v2List 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​

idcloud_provideraccount_idregionserviceseveritystatusresource_id
iom-lab-1aws111111111111us-west-2S3Highnews3-lab-1
iom-lab-2azuresub-lab-1eastusStorageMediumreoccurredstorage-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.

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

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.

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.