K8s IOMs
Kubernetes IOMs is the combined-IOM-list collection for this CID —
SearchAndReadKubernetesIomEntities and
PostSearchKubernetesIOMEntities (PEP 8 search_kubernetes_ioms).
The GET path is
GET /container-security/combined/kubernetes-ioms/v1. The POST path is
POST /container-security/combined/kubernetes-ioms/search/v1.
Remaining Kubernetes Protection mutations /
Image assessment policies / remaining cloud are not implemented (not yet). This is not
Kubernetes IOM ids SearchKubernetesIoms
(/container-security/queries/kubernetes-ioms/v1):
K8s IOM ids. This is not
Kubernetes IOM entities ReadKubernetesIomEntities
(/container-security/entities/kubernetes-ioms/v1):
K8s IOM entities. This is not
Kubernetes clusters
(/kubernetes-protection/entities/kubernetes/clusters/v1):
Kubernetes. This is not combined cloud
clusters (/kubernetes-protection/entities/cloud_cluster/v1):
K8s cloud clusters. This is not
combined Kubernetes clusters (/container-security/combined/clusters/v1):
K8s combined clusters. This is not
Custom IOA (/ioarules/…): Custom IOA. This is
not container vulnerabilities
(/container-security/combined/vulnerabilities/v1):
Container vulnerabilities. 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 IOMs does use FQL (unlike Kubernetes clusters and combined
cloud clusters). POST uses JSON optional filter, sort, limit,
and offset. Extra unused body keys 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: Bearerwithfalcon-container-image:read(GET) orfalcon-container-image:write(POST)
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list IOMs or run search (403).
falcon-container-image:read can list combined IOMs and
cannot POST (403). SearchAndReadKubernetesIomEntities stays
falcon-container-image:read. Unit tests use a client named
cs-local-cimg with falcon-container-image:read; that client can
list combined IOMs and cannot POST (403). Unit tests use a client
named cs-local-cimgw with falcon-container-image:write; that client
can POST. It is not in the production seed. There is no seeded
production client with falcon-container-image:read or
falcon-container-image:write — use the console cookie, or a client
you created with that scope. Missing or revoked token → 401. These
RPCs do not use kubernetes-protection:read.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /container-security/combined/kubernetes-ioms/v1 | List combined Kubernetes IOMs. Query: filter, limit, offset. |
POST | /container-security/combined/kubernetes-ioms/search/v1 | Search combined Kubernetes IOMs. JSON: optional filter, sort, limit, offset. |
Empty filter returns every IOM 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. On GET, omitted limit defaults to 100 (capped at
100). On POST, omitted limit defaults to 100 (capped at 500).
Default sort is detection_id.asc.
POST JSON {} returns both seed rows (iom-lab-1 and iom-lab-2).
filter cluster_name:'lab-eks-1' returns iom-lab-1 only.
Unknown FQL property → 400. Extra unused body keys (pit,
search_after) are ignored. falcon-container-image:read on POST →
403.
JSON is DESIGN snake_case flattened fields (no nested arrays this
slice): detection_id, detection_name, cluster_name, namespace,
resource_id, resource_name, resource_type, severity,
detection_type, prevented, cloud_service, cid.
This is not Kubernetes IOM ids SearchKubernetesIoms, Kubernetes IOM
entities ReadKubernetesIomEntities, Kubernetes clusters, combined cloud
clusters, Custom IOA, container vulnerabilities, or the HelloService
template. Kubernetes IOM ids uses
/container-security/queries/kubernetes-ioms/v1:
K8s IOM ids. Kubernetes IOM entities uses
/container-security/entities/kubernetes-ioms/v1:
K8s IOM entities. Kubernetes
clusters uses /kubernetes-protection/entities/kubernetes/clusters/v1:
Kubernetes. Combined cloud clusters uses
/kubernetes-protection/entities/cloud_cluster/v1:
K8s cloud clusters. Custom IOA uses
/ioarules/…: Custom IOA. Container vulnerabilities
uses /container-security/combined/vulnerabilities/v1:
Container vulnerabilities. Remaining
Kubernetes Protection mutations / Image assessment policies / remaining cloud are not
implemented (not yet).
Seed IOMs
detection_id | detection_name | cluster_name | namespace | resource_name | resource_type | severity | detection_type | prevented | cloud_service |
|---|---|---|---|---|---|---|---|---|---|
iom-lab-1 | Privileged container | lab-eks-1 | default | api | Pod | High | Misconfiguration | false | eks |
iom-lab-2 | HostPath volume | lab-aks-1 | kube-system | worker | Pod | Medium | Misconfiguration | true | aks |
cid is cid-local-1. resource_id equals detection_id. Empty
filters return both. filter=cluster_name:'lab-eks-1' returns
iom-lab-1. POST {} returns both. POST with filter
cluster_name:'lab-eks-1' 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 IOMs (cookie)
Empty filters return 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/combined/kubernetes-ioms/v1'
filter=cluster_name:'lab-eks-1' returns iom-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/kubernetes-ioms/v1?filter=cluster_name:%27lab-eks-1%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/combined/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/combined/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/combined/kubernetes-ioms/v1'
Run search (cookie)
POST {} returns both seed rows (iom-lab-1 and iom-lab-2).
Success is 200:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{}' \
'http://127.0.0.1:8088/container-security/combined/kubernetes-ioms/search/v1'
filter cluster_name:'lab-eks-1' returns iom-lab-1:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d "{\"filter\":\"cluster_name:'lab-eks-1'\"}" \
'http://127.0.0.1:8088/container-security/combined/kubernetes-ioms/search/v1'
Unknown FQL property is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d "{\"filter\":\"bogus:'x'\"}" \
'http://127.0.0.1:8088/container-security/combined/kubernetes-ioms/search/v1'
cs-local-cimg (falcon-container-image:read) is 403 on POST:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{}' \
'http://127.0.0.1:8088/container-security/combined/kubernetes-ioms/search/v1'
Remaining Kubernetes Protection mutations /
Image assessment policies / remaining cloud are not implemented (not yet). Kubernetes IOM ids is a
separate collection:
K8s IOM ids. Kubernetes IOM entities is a
separate collection:
K8s IOM entities. Kubernetes clusters is a
separate collection:
Kubernetes. Combined cloud clusters is a
separate collection:
K8s cloud clusters. Combined Kubernetes
clusters is a separate collection:
K8s combined clusters. Custom IOA is a
separate collection: Custom IOA. Container
vulnerabilities is a separate collection:
Container vulnerabilities. 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/combined/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. SearchAndReadKubernetesIomEntities stays
falcon-container-image:read. This RPC does not use
kubernetes-protection:read.
Run search (Bearer)
TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{}' \
'http://127.0.0.1:8088/container-security/combined/kubernetes-ioms/search/v1'
falcon-container-image:write → 200 on POST (including unit-test
client cs-local-cimgw). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or
falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:write — use the console cookie, or a client
you created with that scope.
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.