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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithimage-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
| Method | Path | Use |
|---|---|---|
GET | /container-compliance/aggregates/compliance-by-images/v2 | List 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_id | image_repository | image_tag | compliant |
|---|---|---|---|
img-lab-1 | lab/repo | 1.0 | true |
img-lab-2 | lab/repo | 2.0 | false |
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.
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'
ExtAggregateImageAssessments (cookie)
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.
Related
- Container packages — container package list
- API reference
The other ten aggregates are not implemented (not yet). Next leftover is p10he Unidentified containers. This is not Container packages.