Skip to main content

Cloud security detections

Cloud security detections is the cloud-security-evaluations combined collection for this CID — GetCombinedIOMByRule (PEP 8 get_combined_iom_by_rule). The path is GET /cloud-security-evaluations/combined/ioms-by-rule/v1. Query ids, entity get, and entity POST are not implemented. No further roadmap row. Remaining operations stay under Not yet implemented. This is not cloud security assets (/cloud-security-assets/…): Cloud security assets. This is not cloud security groups (/cloud-security/…): Cloud security. This is not CSPM IOM (/detects/…iom…): CSPM IOM. 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: CloudSecurityDetectionsService. REST schemas: API reference. Unused query keys filter, sort, limit, offset, and parameters are ignored. Extra unused parameters 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 cloud-security-detections: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-csdt with cloud-security-detections:read; that client can list. GetCombinedIOMByRule stays cloud-security-detections:read. There is no write scope and no seeded production client with cloud-security-detections:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/cloud-security-evaluations/combined/ioms-by-rule/v1List detections combined by rule. RPC GetCombinedIOMByRule. PEP 8 get_combined_iom_by_rule. cloud-security-detections:read. Extra unused query filter, sort, limit, offset, parameters ignored. Success 200 MSA detections (id, rule_id, severity, cloud_provider, misconfigurations, assessed_assets). Order by id ascending. Distinct from cloud security assets and cloud security groups. Query ids / entity get / entity POST are not implemented.

Empty query params on GET combined return every detection in this CID. Default sort is id ascending. Empty store → empty detections, still 200.

JSON is snake_case MSA. Clone success is 200.

GET /cloud-security-evaluations/queries/ioms/v1, GET /cloud-security-evaluations/entities/ioms/v1, and POST /cloud-security-evaluations/entities/ioms/v1 are not implemented. No further roadmap row. Remaining operations stay under Not yet implemented.

Seed detections​

idrule_idseveritycloud_providermisconfigurationsassessed_assets
det-lab-1rule-lab-1highaws32
det-lab-2rule-lab-2moderateaws11
det-lab-3rule-lab-3lowaws04

Combined returns det-lab-1 then det-lab-2 then det-lab-3 in id order. First row rule_id is rule-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'
curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/cloud-security-evaluations/combined/ioms-by-rule/v1'

Success returns det-lab-1 then det-lab-2 then det-lab-3.

Query ids, entity get, and entity POST are not implemented (not yet). No further roadmap row. Remaining operations stay under Not yet implemented. This is not cloud security assets or cloud security groups.