Utilizzo dei vincoli dei criteri di benchmark CIS Kubernetes v1.5.1

Policy Controller include una libreria predefinita di modelli di vincolo che possono essere utilizzati con il bundle CIS per verificare la conformità del cluster con il benchmark CIS Kubernetes v1.5.1. Questo benchmark è un insieme di consigli per configurare Kubernetes al fine di supportare una solida security posture.

Questa pagina contiene le istruzioni per applicare manualmente un bundle di policy. In alternativa, puoi applicare i bundle di policy direttamente.

Avviso: dopo aver scelto un metodo per applicare i bundle di policy (manuale, gcloud CLI o Google Cloud console), l'utilizzo di un metodo diverso per installare i bundle di policy può causare errori nell'ambiente.

Questa pagina è rivolta agli amministratori IT e agli operatori che vogliono assicurarsi che tutte le risorse in esecuzione nella piattaforma cloud soddisfino i requisiti di conformità dell'organizzazione fornendo e mantenendo l'automazione per l'audit o l'applicazione. Per scoprire di più sui ruoli comuni e sulle attività di esempio a cui facciamo riferimento nei Google Cloud contenuti, consulta Ruoli e attività comuni degli utenti GKE.

Questo bundle di vincoli affronta e applica le policy nei seguenti domini:

• RBAC e account di servizio
• Policy di sicurezza dei pod
• Policy di rete e CNI
• Gestione dei secret
• Policy generali

Nota: questo bundle non è stato certificato da CIS.

Vincoli del bundle di policy CIS Kubernetes v1.5.1

Nome vincolo	Descrizione controllo	ID controllo
cis-k8s-v1.5.1-restrict-clusteradmin-rolebindings.yaml	Limita l'utilizzo del ruolo `cluster-admin`	5.1.1
cis-k8s-v1.5.1-prohibit-role-wildcard-access.yaml	Limita l'utilizzo di caratteri jolly in `Roles` e `ClusterRoles`	5.1.3
cis-k8s-v1.5.1-psp-privileged-container.yaml	Riduci al minimo l'ammissione di container con privilegi	5.2.1
cis-k8s-v1.5.1-psp-host-namespace.yaml	Riduci al minimo l'ammissione di container che vogliono condividere lo spazio dei nomi dell'ID processo host	5.2.2
	Riduci al minimo l'ammissione di container che vogliono condividere lo spazio dei nomi IPC host	5.2.3
cis-k8s-v1.5.1-psp-host-network-ports	Riduci al minimo l'ammissione di container che vogliono condividere lo spazio dei nomi di rete host	5.2.4
cis-k8s-v1.5.1-psp-allow-privilege-escalation-container	Riduci al minimo l'ammissione di container con allowPrivilegeEscalation	5.2.5
cis-k8s-v1.5.1-psp-pods-must-run-as-nonroot	Riduci al minimo l'ammissione di container root	5.2.6
cis-k8s-v1.5.1-psp-capabilities	Riduci al minimo l'ammissione di container con la funzionalità NET_RAW	5.2.7
	Riduci al minimo l'ammissione di container con funzionalità aggiunte	5.2.8
	Riduci al minimo l'ammissione di container con funzionalità assegnate	5.2.9
cis-k8s-v1.5.1-require-namespace-network-policies	Assicurati che tutti gli spazi dei nomi abbiano policy di rete definite	5.3.2
cis-k8s-v1.5.1-no-secrets-as-env-vars	Preferisci l'utilizzo dei secret come file rispetto ai secret come variabili di ambiente	5.4.1
cis-k8s-v1.5.1-psp-seccomp-default	Assicurati che il profilo seccomp sia impostato su `docker/default` nelle definizioni dei pod	5.7.2
cis-k8s-v1.5.1-pods-require-security-context	Applica il contesto di sicurezza a pod e container	5.7.3

Prima di iniziare

1. Installa e inizializza il 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 cluster con la libreria predefinita di modelli di vincolo. Devi anche abilitare il supporto per i vincoli referenziali, poiché questo bundle contiene vincoli referenziali.

Configurare Policy Controller per i vincoli referenziali

Avviso: puoi sovrascrivere le modifiche. Se hai già un Config esistente nello spazio dei nomi gatekeeper-system, devi includere tutte le impostazioni di personalizzazione precedenti per conservare le modifiche.

1. Salva il seguente manifest YAML in un file come policycontroller-config.yaml. Il manifest configura Policy Controller per monitorare tipi specifici di oggetti.

   apiVersion: config.gatekeeper.sh/v1alpha1
   kind: Config
   metadata:
     name: config
     namespace: "gatekeeper-system"
   spec:
     sync:
       syncOnly:
         - group: ""
           version: "v1"
           kind: "Namespace"
         - group: "networking.k8s.io"
           version: "v1"
           kind: "NetworkPolicy"
   

2. Applica il manifest policycontroller-config.yaml:

   kubectl apply -f policycontroller-config.yaml
   

Eseguire l'audit del bundle di policy CIS Kubernetes v1.5.1

Policy Controller consente di applicare le policy per il cluster Kubernetes. Per testare i workload e la loro conformità alle policy CIS descritte nella tabella precedente, puoi eseguire il deployment di questi vincoli in modalità "audit" per rivelare le violazioni e, soprattutto, darti la possibilità di correggerle prima di applicarle al cluster Kubernetes.

Puoi applicare queste policy con spec.enforcementAction impostato su dryrun utilizzando kubectl, kpt, o Config Sync.

kubectl

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

   kubectl kustomize https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/cis-k8s-v1.5.1
   

2. Applica i vincoli di policy con kubectl:

   kubectl apply -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/cis-k8s-v1.5.1
   

   L'output è il seguente:

   k8snoenvvarsecrets.constraints.gatekeeper.sh/cis-k8s-v1.5.1-no-secrets-as-env-vars created
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-allow-privilege-escalation created
   k8spspallowedusers.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-pods-must-run-as-nonroot created
   k8spspcapabilities.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-capabilities created
   k8spsphostnamespace.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-host-namespace created
   k8spsphostnetworkingports.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-host-network-ports created
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-privileged-container created
   k8spspseccomp.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-seccomp-default created
   k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/cis-k8s-v1.5.1-pods-require-security-context created
   k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/cis-k8s-v1.5.1-prohibit-role-wildcard-access created
   k8srequirenamespacenetworkpolicies.constraints.gatekeeper.sh/cis-k8s-v1.5.1-require-namespace-network-policies created
   k8srestrictrolebindings.constraints.gatekeeper.sh/cis-k8s-v1.5.1-restrict-clusteradmin-rolebindings created
   

3. Verifica che i vincoli di policy siano stati installati e controlla se esistono violazioni nel cluster:

   kubectl get -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/cis-k8s-v1.5.1
   

   L'output è simile al seguente:

   NAME                                                                                 ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8snoenvvarsecrets.constraints.gatekeeper.sh/cis-k8s-v1.5.1-no-secrets-as-env-vars   dryrun               0
   
   NAME                                                                                                              ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-allow-privilege-escalation   dryrun               0
   
   NAME                                                                                       ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspallowedusers.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-pods-must-run-as-nonroot   dryrun               0
   
   NAME                                                                           ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspcapabilities.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-capabilities   dryrun               0
   
   NAME                                                                              ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnamespace.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-host-namespace   dryrun               0
   
   NAME                                                                                        ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spsphostnetworkingports.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-host-network-ports   dryrun               0
   
   NAME                                                                                          ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspprivilegedcontainer.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-privileged-container   dryrun               0
   
   NAME                                                                         ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spspseccomp.constraints.gatekeeper.sh/cis-k8s-v1.5.1-psp-seccomp-default   dryrun               0
   
   NAME                                                                                                   ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8spodsrequiresecuritycontext.constraints.gatekeeper.sh/cis-k8s-v1.5.1-pods-require-security-context   dryrun               0
   
   NAME                                                                                                   ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8sprohibitrolewildcardaccess.constraints.gatekeeper.sh/cis-k8s-v1.5.1-prohibit-role-wildcard-access   dryrun               0
   
   NAME                                                                                                             ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8srequirenamespacenetworkpolicies.constraints.gatekeeper.sh/cis-k8s-v1.5.1-require-namespace-network-policies   dryrun               0
   
   NAME                                                                                                  ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   k8srestrictrolebindings.constraints.gatekeeper.sh/cis-k8s-v1.5.1-restrict-clusteradmin-rolebindings   dryrun               0
   

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 policy CIS da GitHub utilizzando kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/cis-k8s-v1.5.1
   

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

   kpt fn eval cis-k8s-v1.5.1 -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 monitorare le modifiche:

   cd cis-k8s-v1.5.1
   kpt live init
   

5. Applica i vincoli di policy con kpt:

   kpt live apply
   

   L'output è il seguente:

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

6. Verifica che i vincoli di policy siano stati installati e controlla se esistono violazioni nel cluster:

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

   Lo stato CURRENT conferma l'installazione riuscita dei vincoli.

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 delle policy nei 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 creano automaticamente un resourcegroup.yaml file durante live init, che non deve essere eseguito il check-in nel repository 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 policy CIS da GitHub utilizzando kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/cis-k8s-v1.5.1 policies/cis-k8s-v1.5.1
   

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

   kpt fn eval policies/cis-k8s-v1.5.1 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
   

5. (Facoltativo) Visualizza l'anteprima dei vincoli di policy da creare:

   kpt live init policies/cis-k8s-v1.5.1
   kpt live apply --dry-run policies/cis-k8s-v1.5.1
   

   L'output è il seguente:

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

6. Se la directory di sincronizzazione per Config Sync utilizza Kustomize, aggiungi policies/cis-k8s-v1.5.1 al file kustomization.yaml root. In caso contrario, rimuovi il file policies/cis-k8s-v1.5.1/kustomization.yaml:

   rm SYNC_ROOT_DIR/policies/cis-k8s-v1.5.1/kustomization.yaml
   

7. Esegui il push delle modifiche nel repository Config Sync:

   git add SYNC_ROOT_DIR/policies/cis-k8s-v1.5.1
   git commit -m 'Adding CIS policy audit enforcement'
   git push
   

8. Verifica lo stato dell'installazione:

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

   Lo stato SYNCED conferma l'installazione delle policy.

Visualizzare le violazioni delle norme

Una volta installati i vincoli di policy in modalità di audit, le violazioni nel 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=cis-k8s-v1.5.1 -o json | jq -cC '.items[]| [.metadata.name,.status.totalViolations]'

Se sono presenti violazioni, puoi visualizzare un elenco dei messaggi di violazione per vincolo con:

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

Modificare l'azione di applicazione del bundle di policy CIS Kubernetes v1.5.1

Dopo aver esaminato le violazioni delle policy nel cluster, puoi prendere in considerazione la modifica della modalità di applicazione in modo che il controller di ammissione warn o addirittura deny blocchi l'applicazione al cluster delle risorse non conformi.

Avviso: l'azione di applicazione deny deve essere utilizzata con cautela, in quanto può potenzialmente bloccare le modifiche richieste, causando interruzioni ai workload o al cluster critici. È vivamente consigliabile utilizzare solo le azioni di applicazione warn o dryrun sui cluster con workload di produzione, durante il test di nuovi vincoli o l'esecuzione di migrazioni come l'upgrade delle piattaforme. Per ulteriori informazioni sulle azioni di applicazione, consulta Eseguire l'audit utilizzando i vincoli.

kubectl

1. Utilizza kubectl per impostare l'azione di applicazione delle policy su warn:

   kubectl get constraint -l policycontroller.gke.io/bundleName=cis-k8s-v1.5.1 -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 di policy sia stata aggiornata:

   kubectl get constraint -l policycontroller.gke.io/bundleName=cis-k8s-v1.5.1
   

kpt

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

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

2. Applica i vincoli di policy:

   kpt live apply
   

Config Sync

Gli operatori che utilizzano Config Sync per eseguire il deployment delle policy nei 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 delle policy su warn:

   kpt fn eval policies/cis-k8s-v1.5.1 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
   

3. Esegui il push delle modifiche nel repository Config Sync:

   git add SYNC_ROOT_DIR/policies/cis-k8s-v1.5.1
   git commit -m 'Adding CIS Kubernetes v1.5.1 policy bundle warn enforcement'
   git push
   

4. Verifica lo stato dell'installazione:

   nomos status
   

   Il cluster dovrebbe mostrare lo stato SYNCED con le policy installate.

Testare l'applicazione delle policy

Crea una risorsa non conforme nel 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 policy che questa risorsa viola, come mostrato nell'esempio seguente:

Warning: [cis-k8s-v1.5.1-psp-pods-must-run-as-nonroot] Container wordpress is attempting to run without a required securityContext/runAsNonRoot or securityContext/runAsUser != 0
Warning: [cis-k8s-v1.5.1-psp-allow-privilege-escalation] Privilege escalation container is not allowed: wordpress
Warning: [cis-k8s-v1.5.1-psp-seccomp-default] Seccomp profile 'not configured' is not allowed for container 'wordpress'. Found at: no explicit profile found. Allowed profiles: {"RuntimeDefault", "docker/default", "runtime/default"}
Warning: [cis-k8s-v1.5.1-psp-capabilities] container <wordpress> is not dropping all required capabilities. Container must drop all of ["NET_RAW"] or "ALL"
Warning: [cis-k8s-v1.5.1-pods-require-security-context] securityContext must be defined for all Pod containers
pod/wp-non-compliant created

Rimuovere il bundle di policy CIS Kubernetes v1.5.1

Se necessario, il bundle di policy CIS K8s può essere rimosso dal cluster.

kubectl

Utilizza kubectl per rimuovere le policy:

  kubectl delete constraint -l policycontroller.gke.io/bundleName=cis-k8s-v1.5.1
  

kpt

Rimuovi le policy:

  kpt live destroy
  

Config Sync

Gli operatori che utilizzano Config Sync per eseguire il deployment delle policy nei cluster possono utilizzare le seguenti istruzioni:

1. Esegui il push delle modifiche nel repository Config Sync:

   git rm -r SYNC_ROOT_DIR/policies/cis-k8s-v1.5.1
   git commit -m 'Removing CIS policies'
   git push
   

2. Verifica lo stato:

   nomos status
   

   Il cluster dovrebbe mostrare lo stato SYNCED con le risorse rimosse.