K8s helm
Kubernetes Protection Helm values is the sample values.yaml collection
— GetHelmValuesYaml. The path is
GET /kubernetes-protection/entities/integration/agent/v1. Remaining
Kubernetes Protection mutations and remaining
cloud collections are not implemented (not yet). This is not
Kubernetes Azure accounts
(/kubernetes-protection/entities/accounts/azure/v1):
K8s Azure. This is not Kubernetes
clusters (/kubernetes-protection/entities/kubernetes/clusters/v1).
Kubernetes clusters is a separate collection:
Kubernetes. K8s Azure is a separate
collection: K8s Azure. K8s pods is a
separate collection: K8s pods. K8s nodes is a
separate collection: K8s nodes. K8s containers is a
separate collection: K8s containers. K8s
deployments is a separate collection:
K8s deployments. K8s scripts is a
separate collection: K8s scripts. K8s Azure
script is a separate collection:
K8s Azure script.
This collection is not CrowdStrike production. It does not call Falcon cloud. It is not CrowdStrike Kubernetes Protection cloud.
RPC field notes:
KubernetesProtectionService.
REST schemas: API reference. Kubernetes Helm values use query
params cluster_name and is_self_managed_cluster, not FQL.
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: Bearerwithkubernetes-protection:read
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot get Helm values (403). There is no seeded
client with kubernetes-protection:read — use the console cookie, or a
client you created with that scope. Missing or revoked token → 401.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /kubernetes-protection/entities/integration/agent/v1 | Get Helm values.yaml. Query: cluster_name (required), is_self_managed_cluster (true | false). |
Missing or empty cluster_name → 400. Unknown cluster_name →
404. is_self_managed_cluster other than omitted, true, or
false → 400 when set. is_self_managed_cluster does not filter
the stored row; lookup is by cluster_name only.
JSON is snake_case MSA: cluster_name, yaml. This slice returns
JSON, not application/yaml.
This is not Kubernetes Azure accounts, Kubernetes clusters, K8s
AWS, K8s locations, or K8s pods. Kubernetes Azure accounts uses
/kubernetes-protection/entities/accounts/azure/v1:
K8s Azure. Kubernetes clusters uses
/kubernetes-protection/entities/kubernetes/clusters/v1:
Kubernetes. K8s AWS uses
/kubernetes-protection/entities/accounts/aws/v1:
K8s AWS. K8s locations uses
/kubernetes-protection/entities/cloud-locations/v1:
K8s locations. K8s pods uses
/container-security/combined/pods/v1:
K8s pods. K8s nodes uses
/container-security/combined/nodes/v1:
K8s nodes. Kubernetes containers uses
/container-security/combined/containers/v1:
K8s containers. Kubernetes deployments uses
/container-security/combined/deployments/v1:
K8s deployments. Kubernetes static scripts uses
/kubernetes-protection/entities/gen/scripts/v1:
K8s scripts. Kubernetes Azure install script uses
/kubernetes-protection/entities/user-script/azure/v1:
K8s Azure script. Remaining Kubernetes Protection mutations
and Image assessment policies / remaining cloud
collections are not implemented (not yet).
Seed values
| cluster_name | is_self_managed_cluster | yaml contains |
|---|---|---|
| lab-eks-1 | false | clusterName: lab-eks-1 |
| lab-aks-1 | false | clusterName: lab-aks-1 |
cluster_name=lab-eks-1 returns that row. cluster_name=lab-aks-1
returns that row.
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
Get Helm values (cookie)
cluster_name=lab-eks-1 returns YAML that contains lab-eks-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/kubernetes-protection/entities/integration/agent/v1?cluster_name=lab-eks-1'
Missing cluster_name 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/kubernetes-protection/entities/integration/agent/v1'
Unknown cluster_name is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/kubernetes-protection/entities/integration/agent/v1?cluster_name=not-a-cluster'
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/kubernetes-protection/entities/integration/agent/v1?cluster_name=lab-eks-1'
cs-local-hosts (hosts:read only) 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/kubernetes-protection/entities/integration/agent/v1?cluster_name=lab-eks-1'
Remaining Kubernetes Protection mutations and Image assessment policies / remaining cloud collections are not implemented (not yet). Kubernetes Azure accounts is a separate collection: K8s Azure. Kubernetes clusters is a separate collection: Kubernetes. K8s AWS is a separate collection: K8s AWS. K8s locations is a separate collection: K8s locations. K8s pods is a separate collection: K8s pods. K8s nodes is a separate collection: K8s nodes. K8s containers is a separate collection: K8s containers. K8s deployments is a separate collection: K8s deployments. K8s scripts is a separate collection: K8s scripts. K8s Azure script is a separate collection: K8s Azure script.
Get (Bearer)
TOKEN='<access_token from a client with kubernetes-protection:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/kubernetes-protection/entities/integration/agent/v1?cluster_name=lab-eks-1'
kubernetes-protection:read → 200. A token without that scope
(including hosts:read only) → 403. Missing or revoked token →
401. There is no seeded client with kubernetes-protection:read —
use the console cookie, or a client you created with that scope.
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.