Usar restricciones de políticas de seguridad de pods

Policy Controller incluye una biblioteca predeterminada de plantillas de restricciones que se pueden usar con el paquete de políticas de seguridad de pods para conseguir muchas de las mismas protecciones que la política de seguridad de pods (PSP) de Kubernetes, con la ventaja añadida de poder probar las políticas antes de aplicarlas y excluir la cobertura de recursos específicos.

En esta página se explica cómo aplicar manualmente un paquete de políticas. También puedes aplicar paquetes de políticas directamente.

Advertencia: Después de elegir un método para aplicar paquetes de políticas (manual, gcloud CLI o consola Google Cloud ), usar otro método para instalar paquetes de políticas puede provocar errores en tu entorno.

Esta página está dirigida a administradores y operadores de TI que quieran asegurarse de que todos los recursos que se ejecutan en la plataforma en la nube cumplen los requisitos de cumplimiento de la organización. Para ello, deben proporcionar y mantener la automatización para auditar o aplicar los requisitos. Para obtener más información sobre los roles habituales y las tareas de ejemplo a las que hacemos referencia en el contenido de Google Cloud , consulta Roles y tareas de usuario habituales de GKE.

El paquete incluye estas restricciones, que proporcionan parámetros que se asignan a los siguientes nombres de campos (IDs de control) de la política de seguridad de pods (PSP) de Kubernetes:

Nombre de la restricción	Descripción de la restricción	ID de control
psp-v2022-psp-allow-privilege-escalation	Restringir la escalada a privilegios de root	allowPrivilegeEscalation
psp-v2022-psp-apparmor	El perfil de AppArmor que usan los contenedores	anotaciones
psp-v2022-psp-capabilities	Funciones de Linux	allowedCapabilities, requiredDropCapabilities
psp-v2022-flexvolume-drivers	Permitir controladores FlexVolume específicos	allowedFlexVolumes
psp-v2022-psp-forbidden-sysctls	El perfil de sysctl que usan los contenedores	forbiddenSysctls
psp-v2022-psp-fsgroup	Asignación de un FSGroup que sea propietario de los volúmenes del pod	fsGroup
psp-v2022-psp-host-filesystem	Uso del sistema de archivos del host	allowedHostPaths
psp-v2022-psp-host-namespace	Uso de espacios de nombres de host	hostPID, hostIPC
psp-v2022-psp-host-network-ports	Uso de redes y puertos de host	hostNetwork, hostPorts
psp-v2022-psp-privileged-container	Ejecución de contenedores con privilegios	con privilegios
psp-v2022-psp-proc-mount	Tipos de montaje de Proc permitidos para el contenedor	allowedProcMountTypes
psp-v2022-psp-readonlyrootfilesystem	Requerir el uso de un sistema de archivos raíz de solo lectura	readOnlyRootFilesystem
psp-v2022-psp-seccomp	El perfil de seccomp que usan los contenedores	anotaciones
psp-v2022-psp-selinux-v2	El contexto de SELinux del contenedor	seLinux
psp-v2022-psp-pods-allowed-user-ranges	Los IDs de usuario y de grupo del contenedor	runAsUser, runAsGroup, supplementalGroups, fsGroup
psp-v2022-psp-volume-types	Uso de tipos de volumen	volúmenes

Antes de empezar

1. Instala e inicializa la CLI de Google Cloud, que proporciona los comandos gcloud y kubectl que se usan en estas instrucciones. Si usas Cloud Shell, Google Cloud CLI viene preinstalado.
2. Instala Policy Controller en tu clúster con la biblioteca predeterminada de plantillas de restricción.

Auditar el paquete de políticas de la política de seguridad de pods

Policy Controller te permite aplicar políticas en tu clúster de Kubernetes. Para probar tus cargas de trabajo y su cumplimiento de las prácticas recomendadas de Google que se describen en la tabla anterior, puedes implementar estas restricciones en modo "auditoría" para detectar infracciones y, lo que es más importante, tener la oportunidad de corregirlas antes de aplicarlas en tu clúster de Kubernetes.

Puedes aplicar estas políticas con spec.enforcementAction definido como dryrun mediante kubectl, kpt, o Config Sync.

kubectl

1. (Opcional) Obtén una vista previa de las restricciones de la política con kubectl:

   kubectl kustomize https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/psp-v2022
   

2. Aplica las restricciones de la política con kubectl:

   kubectl apply -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/psp-v2022
   

   El resultado es el siguiente:

   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/psp-v2022-psp-allow-privilege-escalation created
   k8spspallowedusers.constraints.gatekeeper.sh/psp-v2022-psp-pods-allowed-user-ranges created
   k8spspapparmor.constraints.gatekeeper.sh/psp-v2022-psp-apparmor created
   k8spspcapabilities.constraints.gatekeeper.sh/psp-v2022-psp-capabilities created
   k8spspfsgroup.constraints.gatekeeper.sh/psp-v2022-psp-fsgroup created
   k8spspflexvolumes.constraints.gatekeeper.sh/psp-v2022-psp-flexvolume-drivers created
   k8spspforbiddensysctls.constraints.gatekeeper.sh/psp-v2022-psp-forbidden-sysctls created
   k8spsphostfilesystem.constraints.gatekeeper.sh/psp-v2022-psp-host-filesystem created
   k8spsphostnamespace.constraints.gatekeeper.sh/psp-v2022-psp-host-namespace created
   k8spsphostnetworkingports.constraints.gatekeeper.sh/psp-v2022-psp-host-network-ports created
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/psp-v2022-psp-privileged-container created
   k8spspprocmount.constraints.gatekeeper.sh/psp-v2022-psp-proc-mount created
   k8spspreadonlyrootfilesystem.constraints.gatekeeper.sh/psp-v2022-psp-readonlyrootfilesystem created
   k8spspselinuxv2.constraints.gatekeeper.sh/psp-v2022-psp-selinux-v2 created
   k8spspseccomp.constraints.gatekeeper.sh/psp-v2022-psp-seccomp created
   k8spspvolumetypes.constraints.gatekeeper.sh/psp-v2022-psp-volume-types created
   

3. Verifica que se hayan instalado las restricciones de la política y comprueba si hay infracciones en el clúster:

   kubectl get -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/psp-v2022
   

   El resultado debería ser similar al siguiente:

   NAME                                                                                                         ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/psp-v2022-psp-allow-privilege-escalation   dryrun               0
   
   NAME                                                                                  ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspallowedusers.constraints.gatekeeper.sh/psp-v2022-psp-pods-allowed-user-ranges   dryrun               0
   
   NAME                                                              ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspapparmor.constraints.gatekeeper.sh/psp-v2022-psp-apparmor                        0
   
   NAME                                                                      ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspcapabilities.constraints.gatekeeper.sh/psp-v2022-psp-capabilities   dryrun               0
   
   NAME                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspfsgroup.constraints.gatekeeper.sh/psp-v2022-psp-fsgroup                        0
   
   NAME                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspflexvolumes.constraints.gatekeeper.sh/psp-v2022-psp-flexvolume-drivers                        0
   
   NAME                                                                               ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspforbiddensysctls.constraints.gatekeeper.sh/psp-v2022-psp-forbidden-sysctls                        0
   
   NAME                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostfilesystem.constraints.gatekeeper.sh/psp-v2022-psp-host-filesystem                        0
   
   NAME                                                                         ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnamespace.constraints.gatekeeper.sh/psp-v2022-psp-host-namespace   dryrun               0
   
   NAME                                                                                   ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnetworkingports.constraints.gatekeeper.sh/psp-v2022-psp-host-network-ports   dryrun               0
   
   NAME                                                                                     ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/psp-v2022-psp-privileged-container   dryrun               0
   
   NAME                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspprocmount.constraints.gatekeeper.sh/psp-v2022-psp-proc-mount                        0
   
   NAME                                                                                          ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspreadonlyrootfilesystem.constraints.gatekeeper.sh/psp-v2022-psp-readonlyrootfilesystem                        0
   
   NAME                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspselinuxv2.constraints.gatekeeper.sh/psp-v2022-psp-selinux-v2                        0
   
   NAME                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspseccomp.constraints.gatekeeper.sh/psp-v2022-psp-seccomp   dryrun               0
   
   NAME                                                                     ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspvolumetypes.constraints.gatekeeper.sh/psp-v2022-psp-volume-types                        0
   

4. (Opcional) Ajusta el nombre del campo PSP parameters en los archivos de restricciones según sea necesario para tu entorno de clúster. Para obtener más información, consulta el enlace del nombre de campo de PSP específico en la tabla anterior. Por ejemplo, en psp-host-network-ports:

   parameters:
     hostNetwork: true
     min: 80
     max: 9000
   

KPT

1. Instala y configura kpt. kpt se usa en estas instrucciones para personalizar y desplegar recursos de Kubernetes.

2. Descarga el paquete de políticas de Pod Security Policy (PSP) v2022 de GitHub mediante kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/psp-v2022
   

3. Ejecuta la función set-enforcement-action kpt para definir la acción de aplicación de las políticas en dryrun:

   kpt fn eval psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 \
     -- enforcementAction=dryrun
   

4. Inicializa el directorio de trabajo con kpt, que crea un recurso para monitorizar los cambios:

   cd psp-v2022
   kpt live init
   

5. (Opcional) Ajusta el nombre del campo PSP parameters en los archivos de restricciones según sea necesario para tu entorno de clúster. Para obtener más información, consulta el enlace del nombre de campo de PSP específico en la tabla anterior. Por ejemplo, en psp-host-network-ports:

   parameters:
     hostNetwork: true
     min: 80
     max: 9000
   

6. Aplica las restricciones de la política con kpt:

   kpt live apply
   

7. Verifica que se hayan instalado las restricciones de la política y comprueba si hay infracciones en el clúster:

   kpt live status --output table --poll-until current
   

   El estado CURRENT confirma que las restricciones se han instalado correctamente.

Config Sync

1. Instala y configura kpt. kpt se usa en estas instrucciones para personalizar y desplegar recursos de Kubernetes.

Los operadores que usen Config Sync para implementar políticas en sus clústeres pueden seguir estas instrucciones:

1. Cambia al directorio de sincronización de Config Sync:

   cd SYNC_ROOT_DIR
   

   Nota: Kpt v1.0.0-beta.17 y versiones posteriores crean automáticamente un archivo resourcegroup.yaml durante live init, que no se debe registrar en tu repositorio de Config Sync. Si aún no está presente, añade resourcegroup.yaml a tu archivo .gitignore del repositorio.

   Para crear o añadir .gitignore con resourcegroup.yaml, sigue estos pasos:

   echo resourcegroup.yaml >> .gitignore
   

2. Crea un directorio policies específico:

   mkdir -p policies
   

3. Descarga el paquete de políticas de Pod Security Policy (PSP) v2022 de GitHub mediante kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/psp-v2022 policies/psp-v2022
   

4. Ejecuta la función set-enforcement-action kpt para definir la acción de aplicación de las políticas en dryrun:

   kpt fn eval policies/psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
   

5. (Opcional) Ajusta el nombre del campo PSP parameters en los archivos de restricciones según sea necesario para tu entorno de clúster. Para obtener más información, consulta el enlace del nombre de campo de PSP específico en la tabla anterior. Por ejemplo, en psp-host-network-ports:

   parameters:
     hostNetwork: true
     min: 80
     max: 9000
   

6. (Opcional) Obtén una vista previa de las restricciones de la política que se van a crear:

   kpt live init policies/psp-v2022
   kpt live apply --dry-run policies/psp-v2022
   

   El resultado es el siguiente:

   Dry-run strategy: client
   inventory update started
   inventory update finished
   apply phase started
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/psp-v2022-psp-allow-privilege-escalation apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspallowedusers.constraints.gatekeeper.sh/psp-v2022-psp-pods-allowed-user-ranges apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspapparmor.constraints.gatekeeper.sh/psp-v2022-psp-apparmor apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspcapabilities.constraints.gatekeeper.sh/psp-v2022-psp-capabilities apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspfsgroup.constraints.gatekeeper.sh/psp-v2022-psp-fsgroup apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspflexvolumes.constraints.gatekeeper.sh/psp-v2022-psp-flexvolume-drivers apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspforbiddensysctls.constraints.gatekeeper.sh/psp-v2022-psp-forbidden-sysctls apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spsphostfilesystem.constraints.gatekeeper.sh/psp-v2022-psp-host-filesystem apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spsphostnamespace.constraints.gatekeeper.sh/psp-v2022-psp-host-namespace apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spsphostnetworkingports.constraints.gatekeeper.sh/psp-v2022-psp-host-network-ports apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/psp-v2022-psp-privileged-container apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspprocmount.constraints.gatekeeper.sh/psp-v2022-psp-proc-mount apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspreadonlyrootfilesystem.constraints.gatekeeper.sh/psp-v2022-psp-readonlyrootfilesystem apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspselinuxv2.constraints.gatekeeper.sh/psp-v2022-psp-selinux-v2 apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspseccomp.constraints.gatekeeper.sh/psp-v2022-psp-seccomp apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   k8spspvolumetypes.constraints.gatekeeper.sh/psp-v2022-psp-volume-types apply skipped: inventory policy prevented actuation (strategy: Apply, status: Empty, policy: MustMatch)
   apply phase finished
   inventory update started
   inventory update finished
   apply result: 16 attempted, 0 successful, 16 skipped, 0 failed
   

7. Si el directorio de sincronización de Config Sync usa Kustomize, añade policies/psp-v2022 a tu raíz kustomization.yaml. De lo contrario, elimina el archivo policies/psp-v2022/kustomization.yaml:

   rm SYNC_ROOT_DIR/policies/psp-v2022/kustomization.yaml
   

8. Envía los cambios al repositorio de Config Sync:

   git add SYNC_ROOT_DIR/policies/psp-v2022
   git commit -m 'Adding Pod Security Policy audit enforcement'
   git push
   

9. Verifica el estado de la instalación:

   watch gcloud beta container fleet config-management status --project PROJECT_ID
   

   El estado SYNCED confirma la instalación de las políticas.

Ver las infracciones de las políticas

Una vez que se hayan instalado las restricciones de la política en el modo de auditoría, las infracciones del clúster se podrán ver en la interfaz de usuario mediante el panel de control de Policy Controller.

También puedes usar kubectl para ver las infracciones del clúster con el siguiente comando:

kubectl get constraint -l policycontroller.gke.io/bundleName=psp-v2022 -o json | jq -cC '.items[]| [.metadata.name,.status.totalViolations]'

Si hay infracciones, se puede ver una lista de los mensajes de infracción por restricción con:

kubectl get constraint -l policycontroller.gke.io/bundleName=psp-v2022 -o json | jq -C '.items[]| select(.status.totalViolations>0)| [.metadata.name,.status.violations[]?]'

Cambiar la acción de aplicación del paquete de políticas de la política de seguridad de pods

Una vez que hayas revisado las infracciones de las políticas en tu clúster, puedes cambiar el modo de aplicación para que el controlador de admisión warn active o deny bloquee los recursos que no cumplan las políticas para que no se apliquen al clúster.

Advertencia: La acción de cumplimiento de deny debe usarse con precaución, ya que puede bloquear cambios necesarios y provocar interrupciones en cargas de trabajo críticas o en el clúster. Te recomendamos que solo uses las acciones de cumplimiento warn o dryrun en clústeres con cargas de trabajo de producción, cuando pruebes nuevas restricciones o realices migraciones, como la actualización de plataformas. Para obtener más información sobre las medidas de cumplimiento, consulta el artículo Auditoría mediante restricciones.

kubectl

1. Usa kubectl para definir la acción de aplicación de las políticas como warn:

   kubectl get constraint -l policycontroller.gke.io/bundleName=psp-v2022 -o name | xargs -I {} kubectl patch {} --type='json' -p='[{"op":"replace","path":"/spec/enforcementAction","value":"warn"}]'
   

2. Verifica que se hayan actualizado las medidas de cumplimiento de las restricciones de las políticas:

   kubectl get constraint -l policycontroller.gke.io/bundleName=psp-v2022
   

KPT

1. Ejecuta la función set-enforcement-action kpt para definir la acción de aplicación de las políticas en warn:

   kpt fn eval -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
   

2. Aplica las restricciones de la política:

   kpt live apply
   

Config Sync

Los operadores que usen Config Sync para implementar políticas en sus clústeres pueden seguir estas instrucciones:

1. Cambia al directorio de sincronización de Config Sync:

   cd SYNC_ROOT_DIR
   

2. Ejecuta la función set-enforcement-action kpt para definir la acción de aplicación de las políticas en warn:

   kpt fn eval policies/psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
   

3. Envía los cambios al repositorio de Config Sync:

   git add SYNC_ROOT_DIR/policies/psp-v2022
   git commit -m 'Adding Pod Security Policy policy bundle warn enforcement'
   git push
   

4. Verifica el estado de la instalación:

   nomos status
   

   El clúster debería mostrar el estado SYNCED con las políticas instaladas.

Probar la aplicación de las políticas

Crea un recurso no conforme en el clúster con el siguiente comando:

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: Pod
metadata:
  namespace: default
  name: wp-non-compliant
  labels:
    app: wordpress
spec:
  containers:
    - image: wordpress
      name: wordpress
      ports:
      - containerPort: 80
        name: wordpress
EOF

El controlador de admisión debe generar una advertencia en la que se enumeren las infracciones de la política que comete este recurso, como se muestra en el siguiente ejemplo:

Warning: [psp-v2022-psp-pods-allowed-user-ranges] Container wordpress is attempting to run without a required securityContext/fsGroup. Allowed fsGroup: {"ranges": [{"max": 200, "min": 100}], "rule": "MustRunAs"}
Warning: [psp-v2022-psp-pods-allowed-user-ranges] Container wordpress is attempting to run without a required securityContext/runAsGroup. Allowed runAsGroup: {"ranges": [{"max": 200, "min": 100}], "rule": "MustRunAs"}
Warning: [psp-v2022-psp-pods-allowed-user-ranges] Container wordpress is attempting to run without a required securityContext/runAsUser
Warning: [psp-v2022-psp-pods-allowed-user-ranges] Container wordpress is attempting to run without a required securityContext/supplementalGroups. Allowed supplementalGroups: {"ranges": [{"max": 200, "min": 100}], "rule": "MustRunAs"}
Warning: [psp-v2022-psp-allow-privilege-escalation] Privilege escalation container is not allowed: wordpress
Warning: [psp-v2022-psp-seccomp] Seccomp profile 'not configured' is not allowed for container 'wordpress'. Found at: no explicit profile found. Allowed profiles: {"RuntimeDefault", "docker/default", "runtime/default"}
Warning: [psp-v2022-psp-capabilities] container <wordpress> is not dropping all required capabilities. Container must drop all of ["must_drop"] or "ALL"
Warning: [psp-v2022-psp-readonlyrootfilesystem] only read-only root filesystem container is allowed: wordpress
pod/wp-non-compliant created

Eliminar el paquete de políticas de Pod Security Policy

Si es necesario, el paquete de políticas de Pod Security Policy se puede quitar del clúster.

kubectl

• Usa kubectl para eliminar las políticas:

  kubectl delete constraint -l policycontroller.gke.io/bundleName=psp-v2022
  

KPT

• Elimina las políticas:

  kpt live destroy
  

Config Sync

Los operadores que usen Config Sync para implementar políticas en sus clústeres pueden seguir estas instrucciones:

1. Envía los cambios al repositorio de Config Sync:

   git rm -r SYNC_ROOT_DIR/policies/psp-v2022
   git commit -m 'Removing PSP policies'
   git push
   

2. Verifica el estado:

   nomos status
   

   El clúster debería mostrar el estado SYNCED con los recursos eliminados.