KubeBolt docs
ENES GitHub

Configuración

RBAC y permisos

Lo que KubeBolt puede hacer en tu clúster: las credenciales que usa, el ClusterRole que crea el chart, cómo comprueba sus permisos y cómo se degrada la interfaz cuando son limitados.

En esta página
  1. Qué credenciales usa KubeBolt
  2. El ClusterRole del chart
  3. Detección de permisos
  4. Niveles de acceso
  5. Comportamiento del frontend
  6. Los niveles de RBAC del agente
  7. Endpoint de la API

Esta página trata de lo que KubeBolt puede hacer en el clúster. Lo que cada usuario de KubeBolt puede hacer dentro de KubeBolt (los roles Viewer, Editor y Admin) se explica en Autenticación. Una acción necesita las dos cosas: un rol que la permita y permisos en el clúster que la permitan.

KubeBolt nunca suplanta al usuario que inició sesión. Cada lectura y cada acción se ejecuta con las credenciales de Kubernetes propias de KubeBolt, así que esas credenciales son el techo para todos, Kobi incluido.

Qué credenciales usa KubeBolt

ConexiónCredencialesDónde se define el alcance
Dentro del clúster (el chart de Helm)La ServiceAccount del chartEl ClusterRole del chart: más abajo
Contexto de kubeconfig (en disco o subido desde la interfaz)El usuario que lleve el contextoTu kubeconfig y el RBAC del clúster
Conectado por agenteLa ServiceAccount del agenteEl rbac.mode del chart del agente: más abajo

En KubeBolt Cloud todos los clústeres se conectan por agente.

El ClusterRole del chart

Con rbac.create=true (el valor por defecto), el chart kubebolt vincula un ClusterRole a su ServiceAccount. Concede:

PermisoPara qué
get / list / watch sobre recursos de core, apps, batch, networking, policy, autoscaling, storage, RBAC, discovery y Gateway API, más CRDs opcionales (cert-manager, Argo CD, VPA, Cilium, External Secrets, Trivy, informes de políticas de Kyverno)Inventario, topología, insights, el panel de Security
get / list sobre pods y nodes de metrics.k8s.ioCPU y memoria en vivo desde Metrics Server
create sobre selfsubjectaccessreviewsLa comprobación de permisos descrita más abajo
create sobre pods/exec, pods/portforward, pods/evictionTerminal, explorador de archivos, port-forward, evict
create / update / delete sobre workloads, Jobs, CronJobs, Pods, Services, PVCs, NetworkPolicies, Ingresses, HPAs, StorageClasses y objetos de Gateway API (más patch sobre workloads, Jobs, CronJobs, HPAs y objetos de Gateway API); get / update sobre deployments/scale y statefulsets/scaleEditar YAML, crear desde un manifiesto, reiniciar, escalar, eliminar
create / update / delete sobre Secrets, ConfigMaps, ServiceAccounts y objetos de RBAC; create sobre Namespaces y DaemonSets; escalate / bind sobre Roles y ClusterRolesEl Secret con la contraseña de admin del primer arranque, los Secrets con los tokens de ingesta del agente y el asistente de instalación del agente
create sobre tokenreviewsSolo con agentIngest.rbac.enableTokenReview=true (por defecto): agentes que se autentican con el token proyectado de su ServiceAccount

El rol no concede escrituras sobre Nodes ni patch sobre kinds de core como Services, ConfigMaps y Secrets. En el clúster donde corre KubeBolt, cordon, uncordon y drain, y la edición de etiquetas o anotaciones en esos kinds, devuelven 403 salvo que vincules a la ServiceAccount del chart un ClusterRole adicional que los conceda.

Para ejecutar KubeBolt con menos permisos, define rbac.create=false y vincula tu propio ClusterRole (o Roles) a la ServiceAccount del chart, que por defecto se llama como la release (kubebolt para una release llamada kubebolt), o como hayas definido en serviceAccount.name. Un rol de solo lectura funciona: KubeBolt comprueba lo que se le concedió, la interfaz se degrada como se describe más abajo y las acciones de escritura devuelven 403 desde el apiserver. Mantén create sobre selfsubjectaccessreviews, o la comprobación no podrá saber qué concediste.

Detección de permisos

KubeBolt comprueba sus permisos al conectarse a un clúster, sea cual sea el clúster y las credenciales que use:

La comprobación principal se ejecuta una vez por conexión. Después de cambiar el RBAC, reinicia la API de KubeBolt para que se reconecte y vuelva a comprobar.

Niveles de acceso

NivelBackendFrontend
Cluster-admin o lectura totalSe inician informers para todos los tiposInterfaz completa, sin restricciones
A nivel de clúster, con algunos tipos denegadosInformers solo para los tipos permitidosElementos restringidos atenuados, banner “Limited access”
Limitado a namespaces (RoleBindings)Fábricas de informers por namespace, con los resultados combinadosSolo recursos de los namespaces permitidos

Comportamiento del frontend

Solución de problemas explica el banner en un clúster conectado por agente.

Los niveles de RBAC del agente

En los clústeres conectados por agente eliges el alcance del agente de antemano con --set rbac.mode= en el chart del agente, y después KubeBolt comprueba ese alcance como cualquier otro:

Encontrarás más sobre cómo elegir un nivel en Conectar clústeres.

Endpoint de la API

GET /api/v1/cluster/permissions devuelve el resultado de la comprobación para el clúster seleccionado, indexado por tipo de recurso. Cada entrada lleva resource, group, canList, canWatch y canGet, más namespaceScoped y namespaces cuando el acceso viene de RoleBindings, y absent para un CRD opcional que el clúster no sirve.

{
  "pods":   { "resource": "pods", "group": "", "canList": true, "canWatch": true, "canGet": true },
  "nodes":  { "resource": "nodes", "group": "", "canList": false, "canWatch": false, "canGet": false },
  "argocdapps": { "resource": "applications", "group": "argoproj.io", "canList": false, "canWatch": false, "canGet": false, "absent": true }
}