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
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ón | Credenciales | Dónde se define el alcance |
|---|---|---|
| Dentro del clúster (el chart de Helm) | La ServiceAccount del chart | El ClusterRole del chart: más abajo |
| Contexto de kubeconfig (en disco o subido desde la interfaz) | El usuario que lleve el contexto | Tu kubeconfig y el RBAC del clúster |
| Conectado por agente | La ServiceAccount del agente | El 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:
| Permiso | Para 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.io | CPU y memoria en vivo desde Metrics Server |
create sobre selfsubjectaccessreviews | La comprobación de permisos descrita más abajo |
create sobre pods/exec, pods/portforward, pods/eviction | Terminal, 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/scale | Editar 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 ClusterRoles | El 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 tokenreviews | Solo 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:
- Un
SelfSubjectAccessReviewpara el verbolisten cada uno de 31 tipos de recurso, ejecutado en un cliente dedicado con 10 como máximo en paralelo. Una comprobación tarda unos segundos. - Dos fases. Primero, a nivel de clúster. Para cada tipo con namespace que
se deniega a nivel de clúster, KubeBolt busca después acceso concedido por
RoleBindings: lista los namespaces, se queda con aquellos donde puede listar
Pods y vuelve a comprobar ahí los tipos denegados. Los tipos concedidos
reciben informers por namespace en lugar de informers de todo el clúster.
Desde la 2.6.5, si la lista de namespaces falla se reintenta, y si sigue
fallando esos tipos se quedan sin acceso y las vistas lo indican, en lugar de
servirse desde un conjunto supuesto;
default,kube-systemykube-publicsolo se prueban cuando las credenciales no pueden listar namespaces en absoluto. - Los CRDs opcionales (cert-manager, Argo CD, VPA, políticas de Cilium) además tienen que estar servidos por el clúster. Un CRD que el RBAC permite pero que el clúster no tiene cuenta como “no instalado”, no como una restricción, y estos se vuelven a comprobar cada 2 minutos, así que instalar uno más tarde no requiere reiniciar.
- El acceso de escritura es una comprobación más (
updatesobre Deployments). En los clústeres conectados por agente decide la insigniareader/operator(modeenGET /api/v1/clusters) y se actualiza mientras siguen conectados. - Si la propia API
SelfSubjectAccessReviewno está disponible, KubeBolt asume acceso total y deja que el apiserver rechace lo que deba rechazar.
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
| Nivel | Backend | Frontend |
|---|---|---|
| Cluster-admin o lectura total | Se inician informers para todos los tipos | Interfaz completa, sin restricciones |
| A nivel de clúster, con algunos tipos denegados | Informers solo para los tipos permitidos | Elementos restringidos atenuados, banner “Limited access” |
| Limitado a namespaces (RoleBindings) | Fábricas de informers por namespace, con los resultados combinados | Solo recursos de los namespaces permitidos |
Comportamiento del frontend
- Un banner ámbar Limited access, que se puede cerrar, cuenta los tipos de recurso que el RBAC restringe. Los CRDs opcionales que no están instalados no cuentan; reciben un aviso aparte y neutro.
- Los elementos de la barra lateral de los tipos restringidos aparecen atenuados y llevan un icono de escudo.
- Las tarjetas de resumen muestran “No access — insufficient permissions” en
lugar de
0. - Sin acceso a Nodes, los paneles de capacidad muestran “No access to Nodes — capacity data unavailable”.
- Abrir la lista de un recurso restringido muestra una página de permiso
denegado; la API responde
403(insufficient permissions to access <type>).
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:
metrics: un ClusterRole mínimo con las estadísticas del kubelet (nodes/stats,nodes/metrics,nodes/proxy),list/watchde Pods,listde Nodes ygetde Namespaces. El agente envía métricas y flujos de Hubble, y nada más; ninguna llamada al apiserver pasa por su túnel, así que el clúster queda solo de monitoreo (monitored-only): las vistas de recursos responden503y la interfaz muestra los paneles de métricas. Implicaproxy.enabled=false.reader(por defecto):get/list/watchsobre*/*en todo el clúster. El backend lee el inventario a través del túnel del agente para ofrecer un panel completo de solo lectura; los verbos de escritura devuelven403. Implicaproxy.enabled=true.operator: lectura y escritura sobre*/*, más exec, port-forward y eviction; en la práctica, cluster-admin limitado a la ServiceAccount del agente. Es necesario para exec, escalar, reiniciar, eliminar y editar YAML desde el panel. El chart no lo bloquea sin autenticación del agente, pero úsalo solo con unauth.modedistinto dedisabled: sin autenticación, cualquiera que llegue al puerto de agentes del backend obtiene cluster-admin en ese clúster.
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 }
}