K8s IOM ids
Kubernetes IOM ids is the IOM-id-query collection for this CID —
SearchKubernetesIoms (PEP 8 search_ioms). The path is
GET /container-security/queries/kubernetes-ioms/v1.
Remaining Kubernetes Protection mutations /
Image assessment policies / remaining cloud are not implemented (not yet). This is not
combined Kubernetes IOM entities SearchAndReadKubernetesIomEntities
(/container-security/combined/kubernetes-ioms/v1):
K8s IOMs. This is not
Kubernetes IOM entities ReadKubernetesIomEntities
(/container-security/entities/kubernetes-ioms/v1):
K8s IOM entities. This is not
Kubernetes IOM counts ReadKubernetesIomCount
(/container-security/aggregates/kubernetes-ioms/count/v1):
K8s IOM count. 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 Container Image cloud.
RPC field notes: ContainerImagesService. REST schemas: API reference. Filter syntax: FQL. Kubernetes IOM ids does use FQL (same eleven properties as combined Kubernetes IOMs). This is not the combined-IOM-list (objects) and not the entities ids query of objects.
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: Bearerwithfalcon-container-image:read
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list IOM ids (403) — it is missing
falcon-container-image:read. Unit tests use a client named
cs-local-cimg with falcon-container-image:read; that client can
list IOM ids. It is not in the production seed. Use the
console cookie, or a client you created with that scope. Missing or
revoked token → 401. This RPC does not use
kubernetes-protection:read.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /container-security/queries/kubernetes-ioms/v1 | Query Kubernetes IOM ids. Query: filter, limit, offset. |
Empty filter returns every IOM id in this CID. Allowed FQL
properties: cid, cloud_service, cluster_name, detection_type,
name (matches detection_name), namespace, prevented,
resource_id, resource_name, resource_type, severity. Unknown
property or invalid filter → 400. limit and offset must be ≥ 0
else 400. Omitted limit defaults to 100 (capped at 100).
Empty sort is ignored. Default sort is detection_id.asc.
JSON is DESIGN MSA string resources: resources is an array of id
strings (never nested IOM objects).
This is not combined Kubernetes IOM entities
SearchAndReadKubernetesIomEntities, Kubernetes IOM entities
ReadKubernetesIomEntities, Kubernetes IOM counts
ReadKubernetesIomCount, or the HelloService template.
Combined Kubernetes IOM entities uses
/container-security/combined/kubernetes-ioms/v1:
K8s IOMs. Kubernetes IOM
entities uses
/container-security/entities/kubernetes-ioms/v1:
K8s IOM entities. Kubernetes IOM
counts uses
/container-security/aggregates/kubernetes-ioms/count/v1:
K8s IOM count. Remaining
Kubernetes Protection mutations / Image assessment policies / remaining cloud are not
implemented (not yet).
Seed IOM ids
id |
|---|
iom-lab-1 |
iom-lab-2 |
Empty GET returns both (detection_id ASC: iom-lab-1 then
iom-lab-2). filter=severity:'High' 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 IOM ids (cookie)
Empty GET returns at least the two seed ids, including
iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/queries/kubernetes-ioms/v1'
filter=severity:'High' returns iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/queries/kubernetes-ioms/v1?filter=severity:%27High%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/container-security/queries/kubernetes-ioms/v1?filter=bogus:%27x%27'
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/container-security/queries/kubernetes-ioms/v1'
cs-local-hosts (hosts:read only, missing
falcon-container-image:read) is 403:
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/container-security/queries/kubernetes-ioms/v1'
Remaining Kubernetes Protection mutations /
Image assessment policies / remaining cloud are not implemented (not yet). Combined Kubernetes IOMs
is a separate collection:
K8s IOMs. Kubernetes IOM
entities is a separate collection:
K8s IOM entities. Kubernetes IOM
count is a separate collection:
K8s IOM count. This is not
the HelloService template (GET /api/hello).
List (Bearer)
TOKEN='<access_token from a client with falcon-container-image:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/queries/kubernetes-ioms/v1'
falcon-container-image:read → 200 (including unit-test client
cs-local-cimg). A token without that scope (including hosts:read
only, e.g. cs-local-hosts) → 403. Missing or revoked token →
401. This RPC does not use kubernetes-protection:read.
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.