Usar las restricciones de la política de referencia de los estándares de seguridad de los Pods

El controlador de políticas viene con una biblioteca predeterminada de plantillas de restricciones que puedes usar con el paquete de modelos de referencia de los estándares de seguridad de los Pods. Este paquete te permite lograr muchas de las mismas protecciones que la política de modelo de referencia de los estándares de seguridad de los Pods (PSS) de Kubernetes, con la capacidad de probar tus políticas antes de aplicarlas y excluir la cobertura de recursos específicos.

Restricciones del paquete de políticas del modelo de referencia de los estándares de seguridad de los Pods

Nombre de la restricción	Descripción de la restricción	Nombre del control
pss-baseline-v2022-hostprocess	Uso de HostProcess de Windows	HostProcess
pss-baseline-v2022-host-namespaces-hostnetwork	Uso de la red del host	Espacios de nombres de host
pss-baseline-v2022-host-namespaces-host-pid-ipc	Uso de espacios de nombres del host
pss-baseline-v2022-privileged-containers	Ejecución de contenedores con privilegios	Contenedores con privilegios
pss-baseline-v2022-capabilities	Funciones de Linux	Capacidades
pss-baseline-v2022-hostpath-volumes	Uso del sistema de archivos del host	Volúmenes de HostPath
pss-baseline-v2022-host-ports	Uso de puertos de host	Puertos de host (configurable)
pss-baseline-v2022-apparmor	El perfil de AppArmor que usan los contenedores	AppArmor
pss-baseline-v2022-selinux	El contexto de SELinux del contenedor	SELinux
pss-baseline-v2022-proc-mount-type	Los tipos de Activación de procedimientos permitidos para el contenedor	Tipo de activación de /proc
pss-baseline-v2022-seccomp	El perfil de seccomp que usan los contenedores	Seccomp
pss-baseline-v2022-sysctls	El perfil de sysctl que usan los contenedores	Sysctl

Antes de comenzar

1. Instala y, luego, inicializa Google Cloud CLI, que proporciona los comandos gcloud y kubectl que se usan en estas instrucciones. Si usas Cloud Shell, Google Cloud CLI viene preinstalada.
2. Instala el controlador de políticas 1.14.1 o una versión posterior en tu clúster con la biblioteca predeterminada de plantillas de restricción.

Audita el paquete de políticas del modelo de referencia de los estándares de seguridad de los Pods

El Controlador de políticas te permite aplicar políticas a tu clúster de Kubernetes. Para ayudar a probar las 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 incumplimientos y, lo que es más importante, darte la oportunidad de corregirlos antes de aplicarlas en tu clúster de Kubernetes.

Puedes aplicar estas políticas con spec.enforcementAction configurado como 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/pss-baseline-v2022
   

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

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

   Esta es la salida:

   k8spspapparmor.constraints.gatekeeper.sh/pss-baseline-v2022-apparmor created
   k8spspcapabilities.constraints.gatekeeper.sh/pss-baseline-v2022-capabilities created
   k8spsphostfilesystem.constraints.gatekeeper.sh/pss-baseline-v2022-hostpath-volumes created
   k8spsphostnamespace.constraints.gatekeeper.sh/pss-baseline-v2022-host-namespaces-host-pid-ipc created
   k8spsphostnetworkingports.constraints.gatekeeper.sh/pss-baseline-v2022-host-namespaces-hostnetwork created
   k8spsphostnetworkingports.constraints.gatekeeper.sh/pss-baseline-v2022-host-ports created
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/pss-baseline-v2022-privileged-containers created
   k8spspprocmount.constraints.gatekeeper.sh/pss-baseline-v2022-proc-mount-type created
   k8spspselinuxv2.constraints.gatekeeper.sh/pss-baseline-v2022-selinux created
   k8spspseccomp.constraints.gatekeeper.sh/pss-baseline-v2022-seccomp created
   k8spspforbiddensysctls.constraints.gatekeeper.sh/pss-baseline-v2022-sysctls 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/pss-baseline-v2022
   

   El resultado es similar al siguiente:

   NAME                                                                   ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspapparmor.constraints.gatekeeper.sh/pss-baseline-v2022-apparmor                        0
   
   NAME                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspcapabilities.constraints.gatekeeper.sh/pss-baseline-v2022-capabilities   dryrun               0
   
   NAME                                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostfilesystem.constraints.gatekeeper.sh/pss-baseline-v2022-hostpath-volumes                        0
   
   NAME                                                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnamespace.constraints.gatekeeper.sh/pss-baseline-v2022-host-namespaces-host-pid-ipc   dryrun               0
   
   NAME                                                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnetworkingports.constraints.gatekeeper.sh/pss-baseline-v2022-host-namespaces-hostnetwork   dryrun               0
   k8spsphostnetworkingports.constraints.gatekeeper.sh/pss-baseline-v2022-host-ports                    dryrun               0
   
   NAME                                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/pss-baseline-v2022-privileged-containers   dryrun               0
   
   NAME                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspprocmount.constraints.gatekeeper.sh/pss-baseline-v2022-proc-mount-type                        0
   
   NAME                                                                   ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspselinuxv2.constraints.gatekeeper.sh/pss-baseline-v2022-selinux                        0
   
   NAME                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspseccomp.constraints.gatekeeper.sh/pss-baseline-v2022-seccomp   dryrun               0
   
   NAME                                                                          ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspforbiddensysctls.constraints.gatekeeper.sh/pss-baseline-v2022-sysctls   dryrun               0
   

4. Ajusta la restricción pss-baseline-v2022-host-ports para incluir una lista mínima de puertos conocidos restringidos para el entorno del clúster (opcional):

   parameters:
     # A minimum restricted known list can be implemented here.
     min: 0
     max: 0
   

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 Baseline v2022 de los estándares de seguridad de los Pods (PSS) desde GitHub con kpt:

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

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

   kpt fn eval pss-baseline-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 pss-baseline-v2022
   kpt live init
   

5. (Opcional) Ajusta el archivo de restricción pss-baseline-v2022-host-ports para incluir una lista de puertos conocidos y restringidos mínimo para el entorno del clúster:

   parameters:
     # A minimum restricted known list can be implemented here.
     min: 0
     max: 0
   

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 archivo resourcegroup.yaml durante live init que no debe registrarse 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 adjuntar .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 Baseline v2022 de los estándares de seguridad de los Pods (PSS) desde GitHub con kpt:

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

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

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

5. (Opcional) Ajusta el archivo de restricción pss-baseline-v2022-host-ports para incluir una lista de puertos conocidos y restringidos mínimo para el entorno del clúster:

   parameters:
     # A minimum restricted known list can be implemented here.
     min: 0
     max: 0
   

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

   kpt live init policies/pss-baseline-v2022
   kpt live apply --dry-run policies/pss-baseline-v2022
   

   Esta es la salida:

   Dry-run strategy: client
   inventory update started
   inventory update finished
   apply phase started
   k8spspapparmor.constraints.gatekeeper.sh/pss-baseline-v2022-apparmor apply successful
   k8spspcapabilities.constraints.gatekeeper.sh/pss-baseline-v2022-capabilities apply successful
   k8spsphostfilesystem.constraints.gatekeeper.sh/pss-baseline-v2022-hostpath-volumes apply successful
   k8spsphostnamespace.constraints.gatekeeper.sh/pss-baseline-v2022-host-namespaces-host-pid-ipc apply successful
   k8spsphostnetworkingports.constraints.gatekeeper.sh/pss-baseline-v2022-host-namespaces-hostnetwork apply successful
   k8spsphostnetworkingports.constraints.gatekeeper.sh/pss-baseline-v2022-host-ports apply successful
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/pss-baseline-v2022-privileged-containers apply successful
   k8spspprocmount.constraints.gatekeeper.sh/pss-baseline-v2022-proc-mount-type apply successful
   k8spspselinuxv2.constraints.gatekeeper.sh/pss-baseline-v2022-selinux apply successful
   k8spspseccomp.constraints.gatekeeper.sh/pss-baseline-v2022-seccomp apply successful
   apply phase finished
   inventory update started
   inventory update finished
   apply result: 10 attempted, 10 successful, 0 skipped, 0 failed
   

7. Si el directorio de sincronización del Sincronizador de configuración usa Kustomize, agrega policies/pss-baseline-v2022 a la raíz kustomization.yaml. De lo contrario, quita el archivo policies/pss-baseline-v2022/kustomization.yaml:

   rm SYNC_ROOT_DIR/policies/pss-baseline-v2022/kustomization.yaml
   

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

   git add SYNC_ROOT_DIR/pss-baseline-v2022
   git commit -m 'Adding Pod Security Standards Baseline 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 se instalan las restricciones de políticas en el modo de auditoría, los incumplimientos del clúster se pueden ver en la IU a través del 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=pss-baseline-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 los siguientes elementos:

kubectl get constraint -l policycontroller.gke.io/bundleName=pss-baseline-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 referencia de los estándares de seguridad de los 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 en el clúster.

Advertencia: La acción de aplicación deny debe usarse con cuidado, ya que puede bloquear los cambios necesarios y provocar la interrupción de las cargas de trabajo críticas o del clúster. Se recomienda que solo se usen las acciones de aplicación warn o dryrun en clústeres con cargas de trabajo de producción, cuando se prueben restricciones nuevas o se realicen migraciones, como actualizar plataformas. Para obtener más información sobre las acciones de aplicación, consulta Realiza auditorías 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=pss-baseline-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 la política:

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

kpt

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

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 acción de aplicación de las políticas en warn:

   kpt fn eval policies/pss-baseline-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/pss-baseline-v2022
   git commit -m 'Adding Pod Security Standards Baseline 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
        hostPort: 80
        name: wordpress
EOF

El controlador de admisión debe producir una advertencia en la que se mencionen los incumplimientos de políticas que infringe este recurso, como se muestra en el siguiente ejemplo:

Warning:  [pss-baseline-v2022-host-ports] The specified hostNetwork and hostPort are not allowed, pod: wp-non-compliant. Allowed values: {"max": 0, "min": 0}
pod/wp-non-compliant created

Quitar el paquete de políticas del modelo de referencia de los estándares de seguridad de los Pods

Si es necesario, el paquete de políticas del modelo de referencia de los estándares de seguridad de los Pods se puede quitar del clúster.

kubectl

• Usa kubectl para quitar las políticas:

  kubectl delete constraint -l policycontroller.gke.io/bundleName=pss-baseline-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/pss-baseline-v2022
   git commit -m 'Removing Pod Security Standards Baseline 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.