Skip to main content

Application permissions

Granted per role, per namespace, per cluster (or all clusters) under Admin → Roles. Admins hold all of them. A user's permission is checked on every request, in the namespace of the request.

Safe read-only marks the grants of the API access mode of the same name and of the API key template: list, get and logs, except on ConfigMaps and Secrets, whose data can hold credentials.

Endpoints come from the API description (/api/openapi.json); an endpoint that needs two permissions is listed under both. The Kubernetes rights behind each one are on Kubernetes permissions.

Pods​

PermissionOpensSafe read-onlyEndpoints
pods:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/metrics/pods
GET /api/namespaces/{namespace}/metrics/pods/{name}
GET /api/namespaces/{namespace}/pods
pods:getThe pod drawer: status, containers, events, restart history, CPU / memory; the YAML view.yesGET /api/namespaces/{namespace}/pods/{name}
GET /api/namespaces/{namespace}/pods/{name}/events
GET /api/namespaces/{namespace}/pods/{name}/restarts
GET /api/namespaces/{namespace}/pods/{name}/yaml
pods:logsPod logs: live, previous container, download, the REST log snapshot. With deployments:get / jobs:get, the logs of every pod of a Deployment or Job.yesGET /api/namespaces/{namespace}/pods/{name}/logs
GET /ws/namespaces/{namespace}/deployments/{name}/logs (with deployments:get)
GET /ws/namespaces/{namespace}/jobs/{name}/logs (with jobs:get)
GET /ws/namespaces/{namespace}/pods/{name}/logs
pods:execA shell in a container, and one command over the API. Every session is audited; sessions opened with an API key are always recorded.POST /api/namespaces/{namespace}/pods/{name}/exec
GET /ws/namespaces/{namespace}/pods/{name}/exec
pods:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

Deployments​

PermissionOpensSafe read-onlyEndpoints
deployments:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/deployments
deployments:getThe Deployment drawer (revisions read only, pods, usage); the YAML view.yesGET /api/namespaces/{namespace}/deployments/{name}
GET /api/namespaces/{namespace}/deployments/{name}/events
GET /api/namespaces/{namespace}/deployments/{name}/replicasets
GET /api/namespaces/{namespace}/deployments/{name}/restarts
GET /api/namespaces/{namespace}/deployments/{name}/yaml
GET /api/namespaces/{namespace}/metrics/deployments/{name}
GET /ws/namespaces/{namespace}/deployments/{name}/logs (with pods:logs)
deployments:restartRolling restart: patches the pod template's restartedAt annotation.POST /api/namespaces/{namespace}/deployments/{name}/restart
deployments:scaleChange the replica count (0 to MAX_REPLICAS).POST /api/namespaces/{namespace}/deployments/{name}/scale
deployments:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

DaemonSets​

PermissionOpensSafe read-onlyEndpoints
daemonsets:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/daemonsets
daemonsets:getThe DaemonSet drawer and the YAML view.yesGET /api/namespaces/{namespace}/daemonsets/{name}
GET /api/namespaces/{namespace}/daemonsets/{name}/events
GET /api/namespaces/{namespace}/daemonsets/{name}/restarts
GET /api/namespaces/{namespace}/daemonsets/{name}/yaml
GET /api/namespaces/{namespace}/metrics/daemonsets/{name}
daemonsets:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

StatefulSets​

PermissionOpensSafe read-onlyEndpoints
statefulsets:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/statefulsets
statefulsets:getThe StatefulSet drawer and the YAML view.yesGET /api/namespaces/{namespace}/metrics/statefulsets/{name}
GET /api/namespaces/{namespace}/statefulsets/{name}
GET /api/namespaces/{namespace}/statefulsets/{name}/events
GET /api/namespaces/{namespace}/statefulsets/{name}/restarts
GET /api/namespaces/{namespace}/statefulsets/{name}/yaml
statefulsets:scaleChange the replica count (0 to MAX_REPLICAS).POST /api/namespaces/{namespace}/statefulsets/{name}/scale
statefulsets:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

HorizontalPodAutoscalers​

PermissionOpensSafe read-onlyEndpoints
hpas:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/hpas
hpas:getOne object: its detail and the YAML view.yesGET /api/namespaces/{namespace}/hpas/{name}
GET /api/namespaces/{namespace}/hpas/{name}/yaml
hpas:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

Services​

PermissionOpensSafe read-onlyEndpoints
services:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/services
services:getOne object: its detail and the YAML view.yesGET /api/namespaces/{namespace}/services/{name}
GET /api/namespaces/{namespace}/services/{name}/yaml
services:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

ConfigMaps​

PermissionOpensSafe read-onlyEndpoints
configmaps:listThe resource's Dashboard tab and its list endpoint.GET /api/namespaces/{namespace}/configmaps
configmaps:getOne ConfigMap with its data; the YAML view.GET /api/namespaces/{namespace}/configmaps/{name}
GET /api/namespaces/{namespace}/configmaps/{name}/data
GET /api/namespaces/{namespace}/configmaps/{name}/yaml
configmaps:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

Secrets​

PermissionOpensSafe read-onlyEndpoints
secrets:listThe Secrets tab: names, types and key names. Never the values.GET /api/namespaces/{namespace}/secrets
secrets:getOne Secret's metadata, key names and value sizes. Never the values.GET /api/namespaces/{namespace}/secrets/{name}
secrets:revealShow one value of a Secret per request. Each reveal is audited with the key name.POST /api/namespaces/{namespace}/secrets/{name}/reveal
secrets:editThe Secret YAML editor, which shows every value, and apply. Opening it is audited as secret.view_yaml.GET /api/namespaces/{namespace}/secrets/{name}/yaml
POST /api/namespaces/{namespace}/{resource}/{name}/apply

Ingresses​

PermissionOpensSafe read-onlyEndpoints
ingresses:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/ingresses
ingresses:getOne object: its detail and the YAML view.yesGET /api/namespaces/{namespace}/ingresses/{name}/yaml
ingresses:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

CronJobs​

PermissionOpensSafe read-onlyEndpoints
cronjobs:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/cronjobs
cronjobs:getOne object: its detail and the YAML view.yesGET /api/namespaces/{namespace}/cronjobs/{name}/yaml
cronjobs:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply

Jobs​

PermissionOpensSafe read-onlyEndpoints
jobs:listThe resource's Dashboard tab and its list endpoint.yesGET /api/namespaces/{namespace}/jobs
jobs:getOne object: its detail and the YAML view.yesGET /api/namespaces/{namespace}/jobs/{name}/yaml
GET /ws/namespaces/{namespace}/jobs/{name}/logs (with pods:logs)
jobs:editEdit and apply the YAML, with a server-side dry run first.POST /api/namespaces/{namespace}/{resource}/{name}/apply