KubeBolt docs
ENES GitHub

Seguridad

Kyverno: informes de políticas

KubeBolt lee los PolicyReports de wgpolicyk8s.io, que Kyverno escribe de serie. Instalación, verificación, qué necesita Gatekeeper y las dos trampas que parecen bugs.

En esta página
  1. Instalar
  2. Cómo lo encuentra KubeBolt
  3. Verificar
  4. Qué se convierte en hallazgo
  5. Gatekeeper y otros motores
  6. Dos trampas que conviene conocer
  7. De dónde sale el recurso

Kyverno hace cumplir las reglas que tú escribiste: nada de hostNetwork, imágenes de un registro aprobado, todo workload declara límites. Las comprobaciones que fallan llegan a la lente Configuration de Security & Compliance como hallazgos de violación de política, junto a los errores de configuración de workloads que reporta Trivy.

KubeBolt lee PolicyReports, no la API propia de Kyverno: PolicyReport y ClusterPolicyReport en wgpolicyk8s.io/v1alpha2. Es deliberado, y tiene una consecuencia útil: el formato es un estándar compartido, así que cualquier motor que escriba esos informes alimenta esta misma integración. Los informes de otro grupo o versión de API no se leen.

Nada se empuja. KubeBolt lista los informes en su barrido: sin token, sin webhook, sin endpoint que exponer.

Instalar

helm repo add kyverno https://kyverno.github.io/kyverno
helm install kyverno kyverno/kyverno -n kyverno --create-namespace

Kyverno por sí solo no reporta nada: necesita políticas. El conjunto de la comunidad es el punto de partida habitual:

helm install kyverno-policies kyverno/kyverno-policies -n kyverno \
  --set podSecurityStandard=baseline \
  --set validationFailureAction=Audit

Empieza con Audit, no con Enforce. En modo Audit, Kyverno escribe el informe y deja pasar el recurso; en Enforce, rechaza la admisión. Activar en Enforce un conjunto de políticas cuya salida nunca has visto es la manera de que un despliegue empiece a fallar un viernes. KubeBolt lee los dos modos igual: los hallazgos son los mismos, así que no se gana nada con las prisas.

Cómo lo encuentra KubeBolt

Por la etiqueta app.kubernetes.io/part-of=kyverno y, si no, por pods llamados kyverno* en los namespaces kyverno o kyverno-system, así que un manifiesto hecho a mano sin las etiquetas estándar se encuentra igualmente si sus pods siguen ese nombre. El resultado es la tarjeta Kyverno en Administration → Agents & Ingest → Integrations, para el clúster seleccionado en la barra superior.

La tarjeta solo te dice que Kyverno se está ejecutando. Los informes se leen tanto si se ejecuta como si no, y eso es lo que deja pasar los PolicyReports de otro motor (consulta Gatekeeper y otros motores).

Leer los informes requiere una conexión que pueda listarlos: directa, in-cluster o el agente con su proxy activado. Un agente solo de métricas no produce hallazgos (consulta Qué necesita).

Verificar

# Hay informes: uno por recurso en Kyverno 1.9 y posteriores
kubectl get policyreports -A
kubectl get clusterpolicyreports

# Un resultado fallido en uno de ellos
kubectl get policyreports -A -o json |
  jq '.items[].results[] | select(.result=="fail") | {policy, rule, message}' | head

Esos fallos aparecen en la lente Configuration después del siguiente barrido (cada 10 minutos).

SíntomaCausa
La tarjeta dice «not installed»Ningún pod coincide con la etiqueta ni está en los namespaces de respaldo
La tarjeta dice «degraded»Hay pods de Kyverno, pero no están Ready
Hay informes, pero KubeBolt no muestra nadaTodos los resultados son pass/warn/skip/error: solo fail se convierte en hallazgo
Hay resultados fallidos y aun así no aparece nadaEl clúster está conectado solo para métricas o (autoalojado) la autenticación está desactivada
Ningún informeKyverno está instalado, pero no tiene políticas
Una violación corregida nunca se resuelveNo se pueden listar policyreports o clusterpolicyreports. Un hallazgo nunca se resuelve a partir de un barrido parcial

Qué se convierte en hallazgo

Solo result: fail. pass y skip no son problemas, warn es ruido de auditoría por diseño, y error significa que el propio motor de políticas tropezó: reportarlo como una violación del recurso culparía al workload del mal día del motor.

La severidad es la que trae el resultado (critical, high, medium, low o info) y por defecto es medium cuando no trae ninguna. Es lo contrario de la regla de los CVE, donde una severidad desconocida se descarta, y la razón es que una política no es un hecho de la naturaleza: alguien la escribió a propósito, así que un fallo importa aunque Kyverno no indique cuánto. Para controlarla, pon la anotación policies.kyverno.io/severity en la política.

El mensaje que escribe Kyverno se convierte en el texto de remediación del hallazgo.

Gatekeeper y otros motores

Gatekeeper guarda sus resultados de auditoría en el status de cada constraint y no escribe PolicyReports por su cuenta, y KubeBolt no lee constraints. Sus violaciones solo llegan a KubeBolt si algo en tu clúster las escribe como PolicyReports wgpolicyk8s.io/v1alpha2. Lo mismo vale para cualquier otro motor: el contrato es el formato del informe, no el motor.

Los informes de otros motores se cuentan bajo la fuente Kyverno, y la tarjeta de Kyverno puede decir «not installed» mientras llegan: la tarjeta busca los pods de Kyverno, no informes.

Dos trampas que conviene conocer

Las dos vienen de la forma en que trabaja Kyverno, y las dos parecen bugs de KubeBolt cuando te muerden.

Un workload, dos nombres de regla

Kyverno valida un workload dos veces: el Pod contra tu regla, y la plantilla del controlador contra un gemelo autogenerado llamado autogen-<rule>. La misma política, el mismo defecto, dos nombres.

KubeBolt quita el prefijo autogen- para que ambos se fundan en una sola fila. Sin eso, un problema aparecería como dos hallazgos sobre el mismo workload, imposibles de cerrar para siempre: arreglar el Deployment elimina uno y deja el otro.

El título es la política, no el mensaje

Kyverno escribe la ruta JSON en el mensaje, así que la misma violación se lee distinto según dónde se detectó:

Pod:        …rule host-namespaces failed at path /spec/hostNetwork/
DaemonSet:  …rule autogen-host-namespaces failed at path /spec/template/spec/hostNetwork/

El título forma parte de la huella de un hallazgo. Llevar el mensaje en él convertía un problema en dos hallazgos, y cualquier cambio de redacción de Kyverno resolvía el hallazgo antiguo y creaba uno nuevo con el reloj de antigüedad otra vez en cero, lo que destruye sin hacer ruido la señal de «el más antiguo sin resolver». Así que el título es policy/rule y nada más. El mensaje conserva todo su valor como texto de remediación, donde se lee en lugar de compararse.

De dónde sale el recurso

Conviene saberlo si alguna vez aparece un hallazgo sin recurso.

El estándar wgpolicyk8s.io pone el sujeto en results[].resources, y ahí es donde KubeBolt mira primero: las versiones antiguas de Kyverno y otros generadores de informes lo rellenan.

Kyverno 1.9 y posteriores lo dejan vacío. Escribe un informe por recurso y nombra el sujeto en el scope de nivel superior del informe. KubeBolt recurre a scope y, después, a ownerReferences. Sin ese respaldo, cada violación llegaría sin ningún recurso asociado: contada en el panel, invisible en la lista e imposible de atender.