Usa restricciones de la política de seguridad de pods

Policy Controller viene con una biblioteca predeterminada de plantillas de restricciones que se pueden usar con el paquete de políticas de seguridad de Pods para lograr varias de las mismas protecciones que la política de seguridad de Pods (PSP) de Kubernetes, con la capacidad adicional de probar las políticas antes de aplicarlas y excluir la cobertura de recursos específicos.

Esta página está destinada a los administradores de TI y operadores que desean asegurarse de que todos los recursos que se ejecutan dentro de la plataforma en la nube cumplan con los requisitos de cumplimiento de la organización. Para ello, deben proporcionar y mantener la automatización para auditar o aplicar el cumplimiento. Para obtener más información sobre los roles comunes y las tareas de ejemplo a las que hacemos referencia en el contenido de Google Cloud, consulta Tareas y roles comunes de los usuarios de GKE Enterprise.

El paquete incluye estas restricciones que proporcionan parámetros que se asignan a los siguientes nombres de campo (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	Limita la derivación de privilegios raíz	allowPrivilegeEscalation
psp-v2022-psp-apparmor	El perfil de AppArmor que usan los contenedores	annotations
psp-v2022-psp-capabilities	Funciones de Linux	allowedCapabilities, requiredDropCapabilities
psp-v2022-flexvolume-drivers	Permite controladores FlexVolume específicos	allowedFlexVolumes
psp-v2022-psp-forbidden-sysctls	El perfil de sysctl que usan los contenedores	forbiddenSysctls
psp-v2022-psp-fsgroup	Asigna un FSGroup que posea 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 puertos y redes del host	hostNetwork, hostPorts
psp-v2022-psp-privileged-container	Ejecución de contenedores con privilegios	con privilegios
psp-v2022-psp-proc-mount	Los tipos de activación de Proc permitidos para el contenedor	allowedProcMountTypes
psp-v2022-psp-readonlyrootfilesystem	Requiere 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	annotations
psp-v2022-psp-selinux-v2	El contexto de SELinux del contenedor	seLinux:
psp-v2022-psp-pods-allowed-user-ranges	Controla los ID de grupo y usuario del contenedor.	runAsUser, runAsGroup, supplementalGroups, fsGroup
psp-v2022-psp-volume-types	Uso de tipos de volúmenes	volumes

Antes de comenzar

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

Audita el paquete de políticas de la política de seguridad de Pods

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

Puedes aplicar estas políticas con spec.enforcementAction configurado en dryrun mediante kubectl, kpt o el Sincronizador de configuración.

kubectl

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

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

2. Aplica las restricciones de políticas con kubectl:

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

   Esta es la salida:

   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 políticas y verifica si las infracciones existen en el clúster:

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

   El resultado es similar a este:

   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 restricción según sea necesario para tu entorno de clúster. Para obtener más información, consulta el vínculo 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. En estas instrucciones, se usa kpt para personalizar e implementar los recursos de Kubernetes.

2. Descarga el paquete de políticas de la versión 2022 de la política de seguridad de pods (PSP) desde GitHub mediante kpt:

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

3. Ejecuta la función kpt set-enforcement-action para establecer la medida por incumplimiento 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 realizar un seguimiento de los cambios:

   cd psp-v2022
   kpt live init
   

5. (Opcional) Ajusta el nombre del campo PSP parameters en los archivos de restricción según sea necesario para tu entorno de clúster. Para obtener más información, consulta el vínculo 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 políticas con kpt:

   kpt live apply
   

7. Verifica que se hayan instalado las restricciones de políticas y verifica si las infracciones existen en el clúster:

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

   Un estado CURRENT confirma que la instalación de las restricciones se realizó de forma correcta.

Sincronizador de configuración

1. Instala y configura kpt. En estas instrucciones, se usa kpt para personalizar e implementar los recursos de Kubernetes.

Los operadores que usan el Sincronizador de configuración para implementar políticas en sus clústeres pueden usar las siguientes instrucciones:

1. Cambia al directorio del Sincronizador de configuración:

   cd SYNC_ROOT_DIR
   

   Nota: Kpt v1.0.0-beta.17 y las versiones posteriores crean automáticamente un resourcegroup.yaml archivo durante live init que debe no se registrarán en el repositorio del Sincronizador de configuración. Si aún no está presente, agrega resourcegroup.yaml al archivo .gitignore del repositorio.

   Para crear o agregar .gitignore con resourcegroup.yaml, haz lo siguiente:

   echo resourcegroup.yaml >> .gitignore
   

2. Crea un directorio policies dedicado:

   mkdir -p policies
   

3. Descarga el paquete de políticas de la versión 2022 de la política de seguridad de pods (PSP) desde 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 kpt set-enforcement-action para establecer la medida por incumplimiento 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 restricción según sea necesario para tu entorno de clúster. Para obtener más información, consulta el vínculo 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 crearán:

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

   Esta es la salida:

   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 tu directorio de sincronización para el Sincronizador de configuración usa Kustomize, agrega policies/psp-v2022 a tu kustomization.yaml raíz. De lo contrario, quita el archivo policies/psp-v2022/kustomization.yaml:

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

8. Envía los cambios al repositorio del Sincronizador de configuración:

   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
   

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

Visualiza incumplimientos de políticas

Una vez que las restricciones de la política se instalan en modo de auditoría, los incumplimientos en el clúster se pueden ver en la IU mediante el panel de Policy Controller.

También puedes usar kubectl para ver los incumplimientos en el clúster mediante el siguiente comando:

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

Si hay incumplimientos, se puede ver una lista de los mensajes de incumplimiento por restricción con lo siguiente:

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

Cambia la medida por incumplimiento del paquete de políticas de la política de seguridad de pods

Una vez que hayas revisado los incumplimientos de políticas en tu clúster, puedes considerar cambiar el modo de aplicación para que el controlador de admisión warn o incluso deny bloquee los recursos que no cumplen con las políticas para que no se apliquen a lo siguiente: el clúster.

Advertencia: La acción de aplicación deny debe usarse con cuidado, ya que puede bloquear cambios obligatorios en la interrupción de cargas de trabajo críticas o el clúster. Se recomienda que solo las acciones de aplicación warn o dryrun se usen en clústeres con cargas de trabajo de producción, cuando se prueben restricciones nuevas o se realicen migraciones, como plataformas de actualización. Para obtener más información sobre las medidas por incumplimiento, consulta Audita mediante restricciones.

kubectl

1. Usa kubectl para establecer la acción de aplicación de las políticas en 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 haya actualizado la acción de aplicación de restricciones de políticas:

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

kpt

1. Ejecuta la función kpt set-enforcement-action para establecer la medida por incumplimiento 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
   

Sincronizador de configuración

Los operadores que usan el Sincronizador de configuración para implementar políticas en sus clústeres pueden usar las siguientes instrucciones:

1. Cambia al directorio del Sincronizador de configuración:

   cd SYNC_ROOT_DIR
   

2. Ejecuta la función kpt set-enforcement-action para establecer la medida por incumplimiento 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 del Sincronizador de configuración:

   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:

   gcloud alpha anthos config sync repo list --project PROJECT_ID
   

   El repositorio que aparece en la columna SYNCED confirma la instalación de las políticas.

Aplicación de la política de prueba

Crea un recurso que no cumpla con las políticas 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 debería producir una advertencia que enumere las incumplimientos de políticas que este recurso infringe, 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

Quita el paquete de políticas de la política de seguridad del pod

Si es necesario, el paquete de políticas de la Política de seguridad del Pod se puede quitar del clúster.

kubectl

• Usa kubectl para quitar las políticas:

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

kpt

• Quita las políticas:

  kpt live destroy
  

Sincronizador de configuración

Los operadores que usan el Sincronizador de configuración para implementar políticas en sus clústeres pueden usar las siguientes instrucciones:

1. Envía los cambios al repositorio del Sincronizador de configuración:

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

2. Verifica el estado:

   gcloud alpha anthos config sync repo list --project PROJECT_ID
   

   El repositorio que aparece en la columna SYNCED confirma la eliminación de las políticas.