Usa i vincoli dei criteri di sicurezza dei pod

Policy Controller include una libreria predefinita di modelli di vincolo che possono essere utilizzati con il pacchetto dei criteri di sicurezza dei pod per ottenere molte delle stesse protezioni del Criterio di sicurezza dei pod di Kubernetes (PSP), con la possibilità di testare i criteri prima di applicarli ed escludere la copertura di risorse specifiche.

Il bundle include questi vincoli che forniscono parametri mappati ai seguenti nomi dei campi (ID di controllo) dei seguenti criteri di sicurezza dei pod di Kubernetes:

Nome vincolo	Descrizione vincolo	ID controllo
psp-v2022-psp-allow-privilege-escalation	Limitazione dell'escalation ai privilegi root	allowPrivilegeEscalation
psp-v2022-psp-apparmor	Il profilo AppArmor utilizzato dai container	annotazioni
psp-v2022-psp-capabilities	Funzionalità Linux	allowCapabilities, requiredDropCapabilities
psp-v2022-flexvolume-drivers	Consenti driver FlexVolume specifici	allowedFlexVolumes
psp-v2022-psp-forbidden-sysctls	Il profilo sysctl utilizzato dai container	forbiddenSysctls
psp-v2022-psp-fsgroup	Allocazione di un FSGroup proprietario dei volumi del pod	fsGroup
psp-v2022-psp-host-filesystem	Utilizzo del file system dell'host	allowedHostPaths
psp-v2022-psp-host-namespace	Utilizzo degli spazi dei nomi host	hostPID, hostIPC
psp-v2022-psp-host-network-ports	Utilizzo del networking host e delle porte	HostNetwork, HostPorts
psp-v2022-psp-privileged-container	Esecuzione di container con privilegi	con privilegi
psp-v2022-psp-proc-mount	I tipi di montaggio Proc consentiti per il container	allowedProcMountTypes
psp-v2022-psp-readonlyrootfilesystem	Richiedono l'utilizzo di un file system radice di sola lettura	readOnlyRootFilesystem
psp-v2022-psp-seccomp	Il profilo seccomp utilizzato dai container	annotazioni
psp-v2022-psp-selinux-v2	Il contesto SELinux del container	seLinux
psp-v2022-psp-pods-allowed-user-ranges	Gli ID utente e gruppo del contenitore	runAsUser, runAsGroup, supplementareGroups, fsGroup
psp-v2022-psp-volume-types	Utilizzo dei tipi di volume	volumi

Prima di iniziare

1. Installa e inizializza Google Cloud CLI, che fornisce i comandi gcloud e kubectl utilizzati in queste istruzioni. Se utilizzi Cloud Shell, Google Cloud CLI è preinstallato.
2. Installa Policy Controller sul tuo cluster con la libreria predefinita di modelli di vincolo.

Controlla bundle dei criteri di sicurezza dei pod

Policy Controller consente di applicare i criteri per il cluster Kubernetes. Per testare i tuoi carichi di lavoro e la loro conformità con le best practice consigliate da Google descritte nella tabella precedente, puoi eseguire il deployment di questi vincoli in modalità di controllo per rilevare le violazioni e, soprattutto, darti la possibilità di correggerle prima di applicarle al tuo cluster Kubernetes.

Puoi applicare questi criteri con spec.enforcementAction impostato su dryrun mediante kubectl, kpt o Config Sync.

kubectl

1. (Facoltativo) Visualizza l'anteprima dei vincoli dei criteri con kubectl:

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

2. Applica i vincoli dei criteri con kubectl:

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

   L'output è il seguente:

   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 che i vincoli dei criteri siano stati installati e controlla se esistono violazioni in tutto il cluster:

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

   L'output è simile al seguente:

   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. (Facoltativo) Modifica il nome campo PSP parameters nei file dei vincoli in base alle esigenze dell'ambiente del cluster. Per ulteriori dettagli, consulta il link per il nome campo specifico per il PSP nella tabella precedente. Ad esempio in psp-host-network-ports:

   parameters:
     hostNetwork: true
     min: 80
     max: 9000
   

kpt

1. Installa e configura kpt. kpt viene utilizzato in queste istruzioni per personalizzare ed eseguire il deployment delle risorse Kubernetes.

2. Scarica il bundle di criteri v2022 del criterio di sicurezza dei pod (PSP) da GitHub utilizzando kpt:

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

3. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione dei criteri su dryrun:

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

4. Inizializza la directory di lavoro con kpt, che crea una risorsa per tenere traccia delle modifiche:

   cd psp-v2022
   kpt live init
   

5. (Facoltativo) Modifica il nome campo PSP parameters nei file dei vincoli in base alle esigenze dell'ambiente del cluster. Per ulteriori dettagli, consulta il link per il nome campo specifico per il PSP nella tabella precedente. Ad esempio in psp-host-network-ports:

   parameters:
     hostNetwork: true
     min: 80
     max: 9000
   

6. Applica i vincoli dei criteri con kpt:

   kpt live apply
   

7. Verifica che i vincoli dei criteri siano stati installati e controlla se esistono violazioni in tutto il cluster:

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

   Lo stato CURRENT conferma che l'installazione dei vincoli è riuscita.

Config Sync

1. Installa e configura kpt. kpt viene utilizzato in queste istruzioni per personalizzare ed eseguire il deployment delle risorse Kubernetes.

Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei propri cluster possono utilizzare le seguenti istruzioni:

1. Passa alla directory di sincronizzazione per Config Sync:

   cd SYNC_ROOT_DIR
   

   Nota: Kpt v1.0.0-beta.17 e versioni successive crea automaticamente un file resourcegroup.yaml durante live init che non dovrebbe essere archiviato nel repository di Config Sync. Se non è già presente, aggiungi resourcegroup.yaml al file .gitignore del repository.

   Per creare o aggiungere .gitignore con resourcegroup.yaml:

   echo resourcegroup.yaml >> .gitignore
   

2. Crea una directory policies dedicata:

   mkdir -p policies
   

3. Scarica il bundle di criteri v2022 del criterio di sicurezza dei pod (PSP) da GitHub utilizzando kpt:

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

4. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione dei criteri su dryrun:

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

5. (Facoltativo) Modifica il nome campo PSP parameters nei file dei vincoli in base alle esigenze dell'ambiente del cluster. Per ulteriori dettagli, consulta il link per il nome campo specifico per il PSP nella tabella precedente. Ad esempio in psp-host-network-ports:

   parameters:
     hostNetwork: true
     min: 80
     max: 9000
   

6. (Facoltativo) Visualizza l'anteprima dei vincoli del criterio da creare:

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

   L'output è il seguente:

   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. Se la directory di sincronizzazione per Config Sync utilizza Kustomize, aggiungi policies/psp-v2022 al file kustomization.yaml principale. In caso contrario, rimuovi il file policies/psp-v2022/kustomization.yaml:

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

8. Esegui il push delle modifiche al repository di Config Sync:

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

9. Verifica lo stato dell'installazione:

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

   Lo stato SYNCED conferma l'installazione dei criteri.

Visualizza le violazioni delle norme

Una volta installati i vincoli dei criteri in modalità di controllo, le violazioni sul cluster possono essere visualizzate nell'interfaccia utente utilizzando la dashboard di Policy Controller.

Puoi anche utilizzare kubectl per visualizzare le violazioni nel cluster utilizzando il seguente comando:

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

Se sono presenti violazioni, può essere visualizzato un elenco dei messaggi di violazione per vincolo con:

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

Modifica l'azione di applicazione del pacchetto di criteri di sicurezza dei pod

Dopo aver esaminato le violazioni dei criteri nel cluster, puoi prendere in considerazione la modifica della modalità di applicazione forzata in modo che il controller di ammissione warn o addirittura deny blocchi la risorsa non conforme dall'applicazione al cluster.

Avviso: l'azione di applicazione di deny deve essere utilizzata con cautela, in quanto potrebbe bloccare le modifiche richieste con conseguente interruzione dei carichi di lavoro critici o del cluster. Ti consigliamo vivamente di utilizzare solo le azioni di applicazione warn o dryrun sui cluster con carichi di lavoro di produzione, durante il test di nuovi vincoli o l'esecuzione di migrazioni come l'upgrade delle piattaforme. Per saperne di più sulle azioni di applicazione, consulta Controllo con vincoli.

kubectl

1. Utilizza kubectl per impostare l'azione di applicazione dei criteri su 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 che l'azione di applicazione dei vincoli dei criteri sia stata aggiornata:

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

kpt

1. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione dei criteri su warn:

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

2. Applica i vincoli dei criteri:

   kpt live apply
   

Config Sync

Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei propri cluster possono utilizzare le seguenti istruzioni:

1. Passa alla directory di sincronizzazione per Config Sync:

   cd SYNC_ROOT_DIR
   

2. Esegui la funzione kpt set-enforcement-action per impostare l'azione di applicazione dei criteri su warn:

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

3. Esegui il push delle modifiche al repository di 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 lo stato dell'installazione:

   gcloud alpha anthos config sync repo list --project PROJECT_ID
   

   Il repository visualizzato nella colonna SYNCED conferma l'installazione dei criteri.

Testa l'applicazione dei criteri

Crea una risorsa non conforme sul cluster utilizzando il seguente 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

Il controller di ammissione dovrebbe generare un avviso che elenca le violazioni delle norme violate da questa risorsa, come mostrato nell'esempio seguente:

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

Rimuovi bundle dei criteri di sicurezza dei pod

Se necessario, il bundle del criterio di sicurezza dei pod può essere rimosso dal cluster.

kubectl

• Utilizza kubectl per rimuovere i criteri:

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

kpt

• Rimuovi i criteri:

  kpt live destroy
  

Config Sync

Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei propri cluster possono utilizzare le seguenti istruzioni:

1. Esegui il push delle modifiche al repository di Config Sync:

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

2. Verifica lo stato:

   gcloud alpha anthos config sync repo list --project PROJECT_ID
   

   Il repository visualizzato nella colonna SYNCED conferma la rimozione delle norme.