Usar restricciones de la política de Policy Essentials v2022

Policy Controller incluye una biblioteca predeterminada de plantillas de restricciones que se pueden usar con el paquete Policy Essentials v2022 para aplicar las prácticas recomendadas de Google a los recursos de tu clúster.

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

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.

Este paquete de restricciones aborda y aplica políticas en los siguientes dominios:

  • RBAC y cuentas de servicio
  • Políticas de seguridad de pods
  • Interfaz de red de contenedores (CNI)
  • Gestión de secretos
  • Políticas generales

Restricciones del paquete de políticas Policy Essentials

Nombre de la restricción Descripción de la restricción
policy-essentials-v2022-no-secrets-as-env-vars Es preferible usar secretos como archivos que como variables de entorno
policy-essentials-v2022-pods-require-security-context Aplicar un contexto de seguridad a tus pods y contenedores
policy-essentials-v2022-prohibit-role-wildcard-access Minimiza el uso de comodines en Roles y ClusterRoles.
policy-essentials-v2022-psp-allow-privilege-escalation-container Minimizar la admisión de contenedores con allowPrivilegeEscalation
policy-essentials-v2022-psp-capabilities Los contenedores deben quitar la función `NET_RAW` y no pueden volver a añadir ninguna función.
policy-essentials-v2022-psp-host-namespace Minimiza la admisión de contenedores con las propiedades `hostPID` o `hostIPC` establecidas en `true`.
policy-essentials-v2022-psp-host-network-ports Minimizar la admisión de contenedores que quieran compartir el espacio de nombres de la red del host
policy-essentials-v2022-psp-privileged-container Minimizar la admisión de contenedores privilegiados
policy-essentials-v2022-psp-pods-must-run-as-nonroot Minimizar la admisión de contenedores raíz
policy-essentials-v2022-psp-seccomp-default Asegúrate de que el perfil seccomp esté definido como `runtime/default` o `docker/default` en las definiciones de tu pod.
policy-essentials-v2022-restrict-clusteradmin-rolebindings Minimiza el uso del rol cluster-admin.

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 v1.14.3 o una versión posterior en tu clúster con la biblioteca predeterminada de plantillas de restricciones.

Paquete de políticas Audit Policy Essentials

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/policy-essentials-v2022

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

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

    El resultado es el siguiente:

    k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars created
k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation created
k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot created
k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities created
k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace created
k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports created
k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container created
k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-default created
k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context created
k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access created
k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings 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/policy-essentials-v2022

    El resultado debería ser similar al siguiente:

    NAME                                                                                          ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars   dryrun               0

NAME                                                                                                                       ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation   dryrun               0

NAME                                                                                                ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot   dryrun               0

NAME                                                                                    ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities   dryrun               0

NAME                                                                                       ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace   dryrun               0

NAME                                                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports   dryrun               0

NAME                                                                                                   ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container   dryrun               0

NAME                                                                                  ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-default   dryrun               0

NAME                                                                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context   dryrun               0

NAME                                                                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access   dryrun               0

NAME                                                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings   dryrun               0

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 Policy Essentials v2022 de GitHub con kpt:

    kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-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 policy-essentials-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 policy-essentials-v2022
kpt live init

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

    kpt live apply

    El resultado es el siguiente:

    k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-docker-default created
k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context created
k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access created
k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars created
k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation-container created
k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot created
k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports created
k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings created
k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities created
k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace created
k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container created
11 resource(s) applied. 11 created, 0 unchanged, 0 configured, 0 failed

  6. 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

    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 Policy Essentials v2022 de GitHub con kpt:

    kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/policy-essentials-v2022 policies/policy-essentials-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/policy-essentials-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun

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

    kpt live init policies/policy-essentials-v2022
kpt live apply --dry-run policies/policy-essentials-v2022

    El resultado es el siguiente:

    Dry-run strategy: client
inventory update started
inventory update finished
apply phase started
k8snoenvvarsecrets.constraints.gatekeeper.sh/policy-essentials-v2022-no-secrets-as-env-vars apply successful
k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-allow-privilege-escalation apply successful
k8spspallowedusers.constraints.gatekeeper.sh/policy-essentials-v2022-psp-pods-must-run-as-nonroot apply successful
k8spspcapabilities.constraints.gatekeeper.sh/policy-essentials-v2022-psp-capabilities apply successful
k8spsphostnamespace.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-namespace apply successful
k8spsphostnetworkingports.constraints.gatekeeper.sh/policy-essentials-v2022-psp-host-network-ports apply successful
k8spspprivilegedcontainer.constraints.gatekeeper.sh/policy-essentials-v2022-psp-privileged-container apply successful
k8spspseccomp.constraints.gatekeeper.sh/policy-essentials-v2022-psp-seccomp-default apply successful
k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/policy-essentials-v2022-pods-require-security-context apply successful
k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/policy-essentials-v2022-prohibit-role-wildcard-access apply successful
k8srestrictrolebindings.constraints.gatekeeper.sh/policy-essentials-v2022-restrict-clusteradmin-rolebindings apply successful
apply phase finished
inventory update started
inventory update finished
apply result: 11 attempted, 11 successful, 0 skipped, 0 failed

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

    rm SYNC_ROOT_DIR/policies/policy-essentials-v2022/kustomization.yaml

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

    git add SYNC_ROOT_DIR/policy-essentials-v2022
git commit -m 'Adding Policy Essentials v2022 policy audit enforcement'
git push

  8. 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=policy-essentials-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=policy-essentials-v2022 -o json | jq -C '.items[]| select(.status.totalViolations>0)| [.metadata.name,.status.violations[]?]'

Cambiar la medida de refuerzo del paquete de políticas Policy Essentials

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.

.

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=policy-essentials-v2022 -o name | xargs -I {} kubectl patch {} --type='json' -p='[{"op":"replace","path":"/https/cloud.google.com/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=policy-essentials-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/policy-essentials-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/policy-essentials-v2022
git commit -m 'Adding Policy Essentials 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: [policy-essentials-v2022-psp-capabilities] container <wordpress> is not dropping all required capabilities. Container must drop all of ["NET_RAW"] or "ALL"
pod/wp-non-compliant created

Eliminar el paquete de políticas Policy Essentials

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

kubectl

  • Usa kubectl para eliminar las políticas:

    kubectl delete constraint -l policycontroller.gke.io/bundleName=policy-essentials-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/policy-essentials-v2022
git commit -m 'Removing Policy Essentials v2022 policies'
git push

  2. Verifica el estado:

    nomos status

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