Policy Controller include una libreria predefinita di modelli di vincolo che possono essere utilizzati con il bundle di criteri della guida Kubernetes Hardening v1.2 della National Security Agency (NSA) e della Cybersecurity and Infrastructure Security Agency (CISA) per valutare la conformità delle risorse del cluster ad alcuni aspetti della NSA CISA Kubernetes Hardening Guide v1.2.
Questa pagina contiene le istruzioni per applicare manualmente un bundle di norme. In alternativa, puoi applicare direttamente i set di criteri.
Questa pagina è rivolta agli amministratori IT e agli operatori che vogliono assicurarsi che tutte le risorse in esecuzione all'interno della piattaforma cloud soddisfino i requisiti di conformità dell'organizzazione fornendo e mantenendo l'automazione per eseguire controlli o applicare le norme. Per scoprire di più sui ruoli comuni e sulle attività di esempio a cui facciamo riferimento nei contenuti di Google Cloud, consulta Ruoli e attività utente comuni di GKE Enterprise.
Vincoli del pacchetto di criteri di Kubernetes Hardening del CISA della NSA v1.2
Nome vincolo | Descrizione del vincolo |
---|---|
nsa-cisa-k8s-v1.2-apparmor | Limita il profilo "AppArmor" per i pod. |
nsa-cisa-k8s-v1.2-automount-serviceaccount-token-pod | Impedisce ai pod di utilizzare "automountServiceAccountToken". |
nsa-cisa-k8s-v1.2-block-all-ingress | Limita la creazione di oggetti "Ingress". |
nsa-cisa-k8s-v1.2-block-secrets-of-type-basic-auth | Limita l'utilizzo dei secret di tipo "kubernetes.io/basic-auth". |
nsa-cisa-k8s-v1.2-capabilities | I container devono eliminare tutte le funzionalità e non è consentito aggiungerne altre. |
nsa-cisa-k8s-v1.2-cpu-and-memory-limits-required | Tutti i pod di workload devono specificare i limiti di "cpu" e "memory". |
nsa-cisa-k8s-v1.2-host-namespaces | Limita i container con "hostPID" o "hostIPC" impostato su "true". |
nsa-cisa-k8s-v1.2-host-namespaces-hostnetwork | La condivisione degli spazi dei nomi dell'host non deve essere consentita. |
nsa-cisa-k8s-v1.2-host-network | Impedisce l'esecuzione dei container con il flag "hostNetwork" impostato su "true". |
nsa-cisa-k8s-v1.2-hostport | Impedisce l'esecuzione dei container con "hostPort" configurato. |
nsa-cisa-k8s-v1.2-privilege-escalation | Limita i container con "allowPrivilegeEscalation" impostato su "true". |
nsa-cisa-k8s-v1.2-privileged-containers | Limita i container con "securityContext.privileged" impostato su "true". |
nsa-cisa-k8s-v1.2-readonlyrootfilesystem | Richiede l'utilizzo di un file system principale di sola lettura da parte dei container pod. |
nsa-cisa-k8s-v1.2-require-namespace-network-policies | Richiede che ogni spazio dei nomi definito nel cluster abbia un "NetworkPolicy". |
nsa-cisa-k8s-v1.2-restrict-clusteradmin-rolebindings | Limita l'uso del ruolo "cluster-admin". |
nsa-cisa-k8s-v1.2-restrict-edit-rolebindings | Limita l'uso del ruolo "modifica". |
nsa-cisa-k8s-v1.2-restrict-hostpath-volumes | Limita l'utilizzo dei volumi "HostPath". |
nsa-cisa-k8s-v1.2-restrict-pods-exec | Limita l'uso di "pods/exec" in "Roles" e "ClusterRoles". |
nsa-cisa-k8s-v1.2-running-as-non-root | Impedisce l'esecuzione dei container come utente root. |
nsa-cisa-k8s-v1.2-seccomp | Il profilo seccomp non deve essere impostato esplicitamente su "Senza restrizioni". |
nsa-cisa-k8s-v1.2-selinux | Impossibile impostare il tipo SELinux o un'opzione di ruolo o utente SELinux personalizzato. |
Prima di iniziare
- Installa e inizializza Google Cloud CLI, che fornisce i comandi
gcloud
ekubectl
utilizzati in queste istruzioni. Se utilizzi Cloud Shell, Google Cloud CLI è preinstallato. - Installa Policy Controller sul tuo cluster con la libreria predefinita di modelli di vincolo. Devi anche attivare il supporto per i vincoli di referenza poiché questo pacchetto contiene vincoli di referenza.
Configura Policy Controller per i vincoli di referenza
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: "networking.k8s.io" version: "v1" kind: "NetworkPolicy"
Applica il manifest
policycontroller-config.yaml
:kubectl apply -f policycontroller-config.yaml
Controllare il pacchetto di criteri NSA CISA Kubernetes Hardening v1.2
Policy Controller ti consente di applicare criteri per il tuo cluster Kubernetes. Per aiutarti a verificare la conformità dei tuoi carichi di lavoro ai criteri della versione 1.2 della Guida all'hardening di Kubernetes della NSA CISA descritti nella tabella precedente, puoi implementare questi vincoli in modalità "audit" per rilevare le violazioni e, soprattutto, darti la possibilità di correggerle prima di applicarli facoltativamente al tuo cluster Kubernetes.
Puoi applicare questi criteri con spec.enforcementAction
impostato su dryrun
utilizzando
kubectl,
kpt
, o
Config Sync
.
kubectl
(Facoltativo) Visualizza l'anteprima dei vincoli dei criteri con kubectl:
kubectl kustomize https://github.com/GoogleCloudPlatform/gke-policy-library.git/anthos-bundles/nsa-cisa-k8s-v1.2
Applica i vincoli delle norme con kubectl:
kubectl apply -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/anthos-bundles/nsa-cisa-k8s-v1.2
L'output è il seguente:
k8sblockallingress.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-block-all-ingress created k8sblockobjectsoftype.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-block-secrets-of-type-basic-auth created k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-privilege-escalation created k8spspallowedusers.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-running-as-non-root created k8spspapparmor.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-apparmor created k8spspautomountserviceaccounttokenpod.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-automount-serviceaccount-token-pod created k8spspcapabilities.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-capabilities created k8spsphostfilesystem.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-hostpath-volumes created k8spsphostnamespace.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-host-namespaces created k8spsphostnetworkingports.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-host-network created k8spsphostnetworkingports.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-hostport created k8spspprivilegedcontainer.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-privileged-containers created k8spspreadonlyrootfilesystem.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-readonlyrootfilesystem created k8spspselinuxv2.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-selinux created k8spspseccomp.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-seccomp created k8srequirenamespacenetworkpolicies.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-require-namespace-network-policies created k8srequiredresources.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-cpu-and-memory-limits-required created k8srestrictrolebindings.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-clusteradmin-rolebindings created k8srestrictrolebindings.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-edit-rolebindings created k8srestrictrolerules.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-pods-exec created
Verifica che i vincoli dei criteri siano stati installati e controlla se esistono violazioni nel cluster:
kubectl get constraints -l policycontroller.gke.io/bundleName=nsa-cisa-k8s-v1.2
L'output è simile al seguente:
NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8sblockallingress.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-block-all-ingress dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8sblockobjectsoftype.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-block-secrets-of-type-basic-auth dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspallowedusers.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-running-as-non-root dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspallowprivilegeescalationcontainer.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-privilege-escalation dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspapparmor.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-apparmor dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspautomountserviceaccounttokenpod.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-automount-serviceaccount-token-pod dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspcapabilities.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-capabilities dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spsphostfilesystem.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-hostpath-volumes dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spsphostnamespace.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-host-namespaces dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spsphostnetworkingports.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-host-network dryrun 0 k8spsphostnetworkingports.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-hostport dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspprivilegedcontainer.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-privileged-containers dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspreadonlyrootfilesystem.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-readonlyrootfilesystem dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspseccomp.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-seccomp dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8spspselinuxv2.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-selinux dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8srequiredresources.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-cpu-and-memory-limits-required dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8srequirenamespacenetworkpolicies.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-require-namespace-network-policies dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8srestrictrolebindings.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-clusteradmin-rolebindings dryrun 0 k8srestrictrolebindings.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-edit-rolebindings dryrun 0 NAME ENFORCEMENT-ACTION TOTAL-VIOLATIONS k8srestrictrolerules.constraints.gatekeeper.sh/nsa-cisa-k8s-v1.2-restrict-pods-exec dryrun 0
kpt
Installa e configura kpt.
In queste istruzioni, kpt viene utilizzato per personalizzare ed eseguire il deployment delle risorse Kubernetes.
Scarica il bundle di criteri della guida NSA CISA Kubernetes Hardening Guide v1.2 da GitHub utilizzando kpt:
kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/anthos-bundles/nsa-cisa-k8s-v1.2
Esegui la funzione kpt
set-enforcement-action
per impostare l'azione di applicazione dei criteri sudryrun
:kpt fn eval nsa-cisa-k8s-v1.2 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 \ -- enforcementAction=dryrun
Inizializza la directory di lavoro con kpt, che crea una risorsa per monitorare le modifiche:
cd nsa-cisa-k8s-v1.2 kpt live init
Applica i vincoli delle norme con kpt:
kpt live apply
Verifica che i vincoli dei criteri siano stati installati e controlla se esistono violazioni nel cluster:
kpt live status --output table --poll-until current
Uno stato
CURRENT
conferma l'installazione riuscita delle limitazioni.
Config Sync
Installa e configura kpt.
In queste istruzioni, kpt viene utilizzato per personalizzare ed eseguire il deployment delle risorse Kubernetes.
Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei loro cluster possono utilizzare le seguenti istruzioni:
Passa alla directory di sincronizzazione per Config Sync:
cd SYNC_ROOT_DIR
Per creare o aggiungere
.gitignore
aresourcegroup.yaml
:echo resourcegroup.yaml >> .gitignore
Crea una directory
policies
dedicata:mkdir -p policies
Scarica il bundle di criteri della guida NSA CISA Kubernetes Hardening Guide v1.2 da GitHub utilizzando kpt:
kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/anthos-bundles/nsa-cisa-k8s-v1.2 policies/nsa-cisa-k8s-v1.2
Esegui la funzione kpt
set-enforcement-action
per impostare l'azione di applicazione dei criteri sudryrun
:kpt fn eval policies/nsa-cisa-k8s-v1.2 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
(Facoltativo) Visualizza l'anteprima dei vincoli dei criteri da creare:
kpt live init policies/nsa-cisa-k8s-v1.2 kpt live apply --dry-run policies/nsa-cisa-k8s-v1.2
Se la directory di sincronizzazione per Config Sync utilizza Kustomize, aggiungi
policies/nsa-cisa-k8s-v1.2
al tuokustomization.yaml
principale. In caso contrario, rimuovi il filepolicies/nsa-cisa-k8s-v1.2/kustomization.yaml
:rm SYNC_ROOT_DIR/policies/nsa-cisa-k8s-v1.2/kustomization.yaml
Esegui push delle modifiche nel repository Config Sync:
git add SYNC_ROOT_DIR/policies/nsa-cisa-k8s-v1.2 git commit -m 'Adding NSA CISA Kubernetes Hardening v1.2 policy audit enforcement' git push
Verifica lo stato dell'installazione:
watch gcloud beta container fleet config-management status --project PROJECT_ID
Uno stato
SYNCED
conferma l'installazione dei criteri.
Visualizzare le violazioni delle norme
Una volta installati i vincoli dei criteri in modalità di controllo, 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=nsa-cisa-k8s-v1.2 -o json | jq -cC '.items[]| [.metadata.name,.status.totalViolations]'
Se sono presenti violazioni, è possibile visualizzare un elenco dei messaggi di violazione per vincolo con:
kubectl get constraint -l policycontroller.gke.io/bundleName=nsa-cisa-k8s-v1.2 -o json | jq -C '.items[]| select(.status.totalViolations>0)| [.metadata.name,.status.violations[]?]'
Modificare l'azione di applicazione del pacchetto di criteri di Kubernetes Hardening della NSA CISA v1.2
Dopo aver esaminato le violazioni delle norme nel cluster, puoi valutare la possibilità di cambiare la modalità di applicazione in modo che il controller di ammissione warn
attivi o addirittura deny
blocchi l'applicazione della risorsa non conforme al cluster.
kubectl
Utilizza kubectl per impostare l'azione di applicazione dei criteri su
warn
:kubectl get constraints -l policycontroller.gke.io/bundleName=nsa-cisa-k8s-v1.2 -o name | xargs -I {} kubectl patch {} --type='json' -p='[{"op":"replace","path":"/spec/enforcementAction","value":"warn"}]'
Verifica che l'azione di applicazione dei vincoli dei criteri sia stata aggiornata:
kubectl get constraints -l policycontroller.gke.io/bundleName=nsa-cisa-k8s-v1.2
kpt
Esegui la funzione kpt
set-enforcement-action
per impostare l'azione di applicazione dei criteri suwarn
:kpt fn eval -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
Applica i vincoli dei criteri:
kpt live apply
Config Sync
Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei loro cluster possono utilizzare le seguenti istruzioni:
Passa alla directory di sincronizzazione per Config Sync:
cd SYNC_ROOT_DIR
Esegui la funzione kpt
set-enforcement-action
per impostare l'azione di applicazione dei criteri suwarn
:kpt fn eval policies/nsa-cisa-k8s-v1.2 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
Esegui push delle modifiche nel repository Config Sync:
git add SYNC_ROOT_DIR/policies/nsa-cisa-k8s-v1.2 git commit -m 'Adding NSA CISA Kubernetes Hardening v1.2 policy warn enforcement' git push
Verifica lo stato dell'installazione:
gcloud alpha anthos config sync repo list --project PROJECT_ID
La visualizzazione del tuo repo nella colonna
SYNCED
conferma l'installazione dei criteri.
Testare l'applicazione delle norme
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 deve generare un avviso che elenca le violazioni delle norme che questa risorsa viola, come mostrato nell'esempio seguente:
Warning: [nsa-cisa-k8s-v1.2-automount-serviceaccount-token-pod] Automounting service account token is disallowed, pod: wp-non-compliant Warning: [nsa-cisa-k8s-v1.2-running-as-non-root] Container wordpress is attempting to run without a required securityContext/runAsGroup. Allowed runAsGroup: {"ranges": [{"max": 65536, "min": 1000}], "rule": "MustRunAs"} Warning: [nsa-cisa-k8s-v1.2-running-as-non-root] Container wordpress is attempting to run without a required securityContext/runAsUser Warning: [nsa-cisa-k8s-v1.2-privilege-escalation] Privilege escalation container is not allowed: wordpress Warning: [nsa-cisa-k8s-v1.2-cpu-and-memory-limits-required] container <wordpress> does not have <{"cpu", "memory"}> limits defined Warning: [nsa-cisa-k8s-v1.2-capabilities] container <wordpress> is not dropping all required capabilities. Container must drop all of ["ALL"] or "ALL" Warning: [nsa-cisa-k8s-v1.2-readonlyrootfilesystem] only read-only root filesystem container is allowed: wordpress pod/wp-non-compliant created
Rimuovi il pacchetto di criteri NSA CISA Kubernetes Hardening v1.2
Se necessario, il bundle di criteri di Kubernetes Hardening v1.2 della NSA CISA può essere rimosso dal cluster.
kubectl
Utilizza kubectl per rimuovere i criteri:
kubectl delete constraint -l policycontroller.gke.io/bundleName=nsa-cisa-k8s-v1.2
kpt
Rimuovi i criteri:
kpt live destroy
Config Sync
Gli operatori che utilizzano Config Sync per eseguire il deployment dei criteri nei loro cluster possono utilizzare le seguenti istruzioni:
Esegui push delle modifiche nel repository Config Sync:
git rm -r SYNC_ROOT_DIR/policies/nsa-cisa-k8s-v1.2 git commit -m 'Removing NSA CISA Kubernetes Hardening Guide v1.2 policies' git push
Verifica lo stato:
gcloud alpha anthos config sync repo list --project PROJECT_ID
La visualizzazione del tuo repo nella colonna
SYNCED
conferma la rimozione dei criteri.