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
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íntoma | Causa |
|---|---|
| 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 nada | Todos los resultados son pass/warn/skip/error: solo fail se convierte en hallazgo |
| Hay resultados fallidos y aun así no aparece nada | El clúster está conectado solo para métricas o (autoalojado) la autenticación está desactivada |
| Ningún informe | Kyverno está instalado, pero no tiene políticas |
| Una violación corregida nunca se resuelve | No 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.