Skip to main content

Image compliance

Image compliance is the container-compliance aggregate assessments collection for this CID — ExtAggregateImageAssessments (PEP 8 aggregate_image_assessments). The path is GET /container-compliance/aggregates/compliance-by-images/v2. The other ten aggregates are not implemented. Next leftover is p10he Unidentified containers. This is not Container packages (/container-security/combined/packages/…): Container packages. 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: ImageComplianceService. REST schemas: API reference. Unused query keys filter, after, limit, and 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 image-compliance: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-icomp with image-compliance:read; that client can list. ExtAggregateImageAssessments stays image-compliance:read. There is no write scope and no seeded production client with image-compliance:read — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/container-compliance/aggregates/compliance-by-images/v2List image assessments. RPC ExtAggregateImageAssessments. PEP 8 aggregate_image_assessments. image-compliance:read. Extra unused query filter, after, limit, parameters ignored. Success 200 MSA resources (image_id, image_repository, image_tag, compliant). The published example uses results; this clone uses resources. Order by image_id ascending. Distinct from Container packages. The other ten aggregates are not implemented.

Empty query params on GET return every assessment in this CID. Default sort is image_id ascending. Empty store → empty resources, still 200.

JSON is snake_case MSA. Clone success is 200.

GET /container-compliance/aggregates/compliance-by-clusters/v2, GET /container-compliance/aggregates/compliance-by-rules/v2, GET /container-compliance/aggregates/rules-by-status/v2, GET /container-compliance/aggregates/failed-containers-by-rules/v2, GET /container-compliance/aggregates/failed-containers-count-by-severity/v2, GET /container-compliance/aggregates/failed-images-by-rules/v2, GET /container-compliance/aggregates/failed-images-count-by-severity/v2, GET /container-compliance/aggregates/failed-rules-by-clusters/v2, GET /container-compliance/aggregates/failed-rules-by-images/v2, and GET /container-compliance/aggregates/failed-rules-count-by-severity/v2 are not implemented. No further roadmap row. Remaining operations stay under Not yet implemented.

Seed assessments​

image_idimage_repositoryimage_tagcompliant
img-lab-1lab/repo1.0true
img-lab-2lab/repo2.0false

List returns img-lab-1 then img-lab-2 in image_id order. img-lab-1 is compliant true; img-lab-2 is compliant false.

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/container-compliance/aggregates/compliance-by-images/v2'

Success returns img-lab-1 then img-lab-2.

The other ten aggregates are not implemented (not yet). Next leftover is p10he Unidentified containers. This is not Container packages.