Skip to main content

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_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with falcon-container-image:read (GET) or falcon-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​

MethodPathUse
GET/container-security/combined/kubernetes-ioms/v1List combined Kubernetes IOMs. Query: filter, limit, offset.
POST/container-security/combined/kubernetes-ioms/search/v1Search 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_iddetection_namecluster_namenamespaceresource_nameresource_typeseveritydetection_typepreventedcloud_service
iom-lab-1Privileged containerlab-eks-1defaultapiPodHighMisconfigurationfalseeks
iom-lab-2HostPath volumelab-aks-1kube-systemworkerPodMediumMisconfigurationtrueaks

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.

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

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'

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.