Usa restricciones de la política de seguridad de pods

El controlador de políticas 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 muchas de las mismas protecciones que la política de seguridad de pods (PSP) de Kubernetes, con la capacidad adicional de probar tus políticas antes de aplicarlas y excluir la cobertura de recursos específicos.

El paquete incluye estas restricciones que proporcionan parámetros que se asignan a los siguientes nombres de campo de la Política de seguridad de pods (PSP) de Kubernetes:

Restricción	Nombres de los campos de PSP	Aspecto de control de PSP
psp-v2022-psp-allow-privileged-escalation	allowPrivilegeEscalation	Restringe la elevación a los privilegios de raíz
psp-v2022-psp-apparmor	anotaciones	El perfil de AppArmor que usan los contenedores
psp-v2022-psp-capabilities	allowedCapabilities, requiredDropCapabilities	Funciones de Linux
psp-v2022-flexvolume-drivers	allowedFlexVolumes	Permitir controladores específicos de FlexVolume
psp-v2022-psp-forbidden-sysctls	forbiddenSysctls.	El perfil sysctl que usan los contenedores
psp-v2022-psp-fsgroup	fsGroup	Asigna un FSGroup que posee los volúmenes del Pod
psp-v2022-psp-host-filesystem	allowedHostPaths	Uso del sistema de archivos del host
psp-v2022-psp-host-namespace	hostPID, hostIPC	Uso de espacios de nombres de host
psp-v2022-psp-host-network-ports	hostNetwork, hostPorts	Uso de puertos y redes de host
psp-v2022-psp-privileged-container	privilegiado	Ejecuta contenedores privilegiados
psp-v2022-psp-proc-mount	allowedProcMountTypes	Los tipos de activación de procesos permitidos para el contenedor
psp-v2022-psp-readonlyrootfilesystem	readOnlyRootFilesystem	Cómo solicitar el uso de un sistema de archivos raíz de solo lectura
psp-v2022-psp-seccomp	anotaciones	El perfil seccomp que usan los contenedores
psp-v2022-psp-selinux-v2	Linux	El contexto SELinux del contenedor
psp-v2022-psp-pods-allowed-user-ranges	runAsUser, runAsGroup, suplementariosGroups, fsGroup	Los ID de usuario y grupo del contenedor
psp-v2022-psp-volume-types	volúmenes	Uso de tipos de volúmenes

Antes de comenzar

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.
Instala el controlador de políticas en tu clúster con la biblioteca predeterminada de plantillas de restricciones.

Auditoría con el controlador de políticas

El Controlador de políticas te permite aplicar políticas a tu clúster de Kubernetes. Para ayudarte a probar tus cargas de trabajo y su cumplimiento en relación con las prácticas recomendadas de Google que se describen en la tabla anterior, puedes implementar estas restricciones en modo "auditoría" para revelar los incumplimientos y, lo que es más importante, tener la oportunidad de corregirlos antes de aplicarlos en tu clúster de Kubernetes.

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

kubectl

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

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

Aplica las restricciones de políticas mediante kubectl:

kubectl apply -k https://github.com/GoogleCloudPlatform/acm-policy-controller-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

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/acm-policy-controller-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

(Opcional) Ajusta el nombre del campo de PSP parameters en los archivos de restricción según sea necesario para el entorno de tu clúster. Para obtener más detalles, consulte el vínculo del nombre del campo de PSP específico en la tabla que aparece arriba. Por ejemplo, en psp-host-network-ports:
```
parameters:
  hostNetwork: true
  min: 80
  max: 9000
```

kpt

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

Descarga el paquete de políticas de la política de seguridad de pods (PSP) v2022 desde GitHub con kpt:

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

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 psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 \
  -- enforcementAction=dryrun
```
Inicializa el directorio de trabajo con kpt, que crea un recurso para realizar un seguimiento de los cambios:
```
cd psp-v2022
kpt live init
```
(Opcional) Ajusta el nombre del campo de PSP parameters en los archivos de restricción según sea necesario para el entorno de tu clúster. Para obtener más detalles, consulte el vínculo del nombre del campo de PSP específico en la tabla que aparece arriba. Por ejemplo, en psp-host-network-ports:
```
parameters:
  hostNetwork: true
  min: 80
  max: 9000
```
Aplica las restricciones de políticas con kpt:
```
kpt live apply
```
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

Instala y configura kpt. En estas instrucciones, se usa kpt para personalizar e implementar los recursos de Kubernetes.
Si usas Anthos Config Management por primera vez, habilita Anthos Config Management.

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

Cambia al directorio del Sincronizador de configuración:
```
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 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
```
Crea un directorio policies dedicado:
```
mkdir -p policies
```

Descarga el paquete de políticas de la política de seguridad de pods (PSP) v2022 desde GitHub con kpt:

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

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/psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
```
(Opcional) Ajusta el nombre del campo de PSP parameters en los archivos de restricción según sea necesario para el entorno de tu clúster. Para obtener más detalles, consulte el vínculo del nombre del campo de PSP específico en la tabla que aparece arriba. Por ejemplo, en psp-host-network-ports:
```
parameters:
  hostNetwork: true
  min: 80
  max: 9000
```

(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

Si el directorio de sincronización del 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
```

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

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 instaladas las restricciones de la política en el modo de auditoría, los incumplimientos en el clúster se pueden ver en la IU mediante el Panel del controlador de políticas.

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 infracciones, verás una lista de los mensajes de incumplimiento por restricción con los siguientes elementos:

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

Aplicar políticas de políticas de seguridad

Después de revisar los incumplimientos de política en su clúster y ajustar los parámetros de Nombre del campo de PSP según sea necesario, el siguiente paso es aplicar estas políticas para que el controlador de admisión bloquee la aplicación del recurso que no satisfaga las políticas.

kubectl

Usa kubectl para establecer la acción de aplicación de las políticas en deny:

kubectl get constraint -l policycontroller.gke.io/bundleName=psp-v2022 -o json | jq '.items[].spec.enforcementAction="deny"' | kubectl apply -f -

Verifique que se haya actualizado la acción de aplicación de restricciones de la política:

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

kpt

Ejecuta la función kpt set-enforcement-action para establecer la acción de aplicación de las políticas en deny:
```
kpt fn eval -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=deny
```
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:

Cambia al directorio del Sincronizador de configuración:
```
cd SYNC_ROOT_DIR
```
Ejecuta la función kpt set-enforcement-action para establecer la acción de aplicación de las políticas en deny:
```
kpt fn eval policies/psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=deny
```

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

git add SYNC_ROOT_DIR/policies/psp-v2022
git commit -m 'Enforcing Pod Security Policy policies for GKE'
git push

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

Realiza una prueba rápida para confirmar la aplicación de la política y el bloqueo de recursos que no cumplen con la política en el clúster.

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 un error que enumere los incumplimientos de política que este recurso infringe. Por ejemplo:

Error from server (Forbidden): error when creating "STDIN": admission webhook "validation.gatekeeper.sh" denied the request:
[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"}
[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"}
[psp-v2022-psp-pods-allowed-user-ranges] Container wordpress is attempting to run without a required securityContext/runAsUser
[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"}
[psp-v2022-psp-allow-privilege-escalation] Privilege escalation container is not allowed: wordpress
[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"}
[psp-v2022-psp-capabilities] container  is not dropping all required capabilities. Container must drop all of ["must_drop"] or "ALL"
[psp-v2022-psp-readonlyrootfilesystem] only read-only root filesystem container is allowed: wordpress