Policy Controller include una libreria predefinita di modelli di vincolo che possono essere utilizzati con il bundle dei criteri di sicurezza dei pod per ottenere molte delle stesse protezioni dei criteri di sicurezza dei pod (PSP) di Kubernetes, con la possibilità aggiuntiva di testare i criteri prima di applicarli ed escludere la copertura di risorse specifiche.
Questa pagina contiene le istruzioni per applicare manualmente un bundle di norme. In alternativa, puoi applicare direttamente i pacchetti di criteri.
Questa pagina è rivolta agli amministratori e agli operatori IT 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 saperne di più sui ruoli comuni e sulle attività di esempio a cui facciamo riferimento nei contenuti di Google Cloud, Ruoli e attività utente comuni di GKE Enterprise.
Il bundle include questi vincoli che forniscono parametri che mappano ai seguenti nomi di campo (ID controllo) del Kubernetes Pod Security Policy (PSP):
Nome vincolo | Descrizione del 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 | allowedCapabilities, 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 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 contenitore | allowedProcMountTypes |
psp-v2022-psp-readonlyrootfilesystem | Richiede l'utilizzo di un file system principale 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
- Installare e inizializzare
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.
Eseguire l'audit del bundle di criteri di sicurezza dei pod
Policy Controller ti consente di applicare criteri per il tuo cluster Kubernetes. Per aiutarti a verificare i tuoi carichi di lavoro e la loro conformità alle best practice consigliate da Google descritte nella tabella precedente, puoi implementare questi vincoli in modalità "audit" per rilevare le violazioni e, soprattutto, darti la possibilità di correggerle prima di applicarle al tuo cluster Kubernetes.
Puoi applicare questi criteri con il criterio spec.enforcementAction
impostato su dryrun
mediante 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/bundles/psp-v2022
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
Verifica che i vincoli dei criteri siano stati installati e che se 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
(Facoltativo) Modifica il nome del campo PSP
parameters
nei file di vincolo in base alle esigenze del tuo ambiente cluster. Per maggiori dettagli, fai clic sul link relativo al nome del campo PSP specifico nella tabella sopra. Ad esempio inpsp-host-network-ports
:parameters: hostNetwork: true min: 80 max: 9000
kpt
Installazione e configurazione kpt. kpt viene utilizzato in queste istruzioni per personalizzare ed eseguire il deployment delle risorse Kubernetes.
Scarica il bundle di criteri Pod Security Policy (PSP) v2022 da GitHub utilizzando kpt:
kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/psp-v2022
Esegui
set-enforcement-action
. kpt per impostare i criteri provvedimento in merito adryrun
:kpt fn eval psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 \ -- enforcementAction=dryrun
Inizializza la directory di lavoro con kpt, che crea una risorsa tieni traccia delle modifiche:
cd psp-v2022 kpt live init
(Facoltativo) Modifica il nome campo PSP
parameters
nei file dei vincoli in base alle esigenze dell'ambiente del cluster. Per maggiori dettagli, fai clic sul link relativo al nome del campo PSP specifico nella tabella sopra. Ad esempio inpsp-host-network-ports
:parameters: hostNetwork: true min: 80 max: 9000
Applica i vincoli dei criteri 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
Lo stato
CURRENT
conferma l'avvenuta installazione dell'applicazione i vincoli.
Config Sync
- 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 il deployment dei criteri nei propri cluster possono utilizzare segui queste 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 Pod Security Policy (PSP) v2022 da GitHub utilizzando kpt:
kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/psp-v2022 policies/psp-v2022
Esegui
set-enforcement-action
. kpt per impostare i criteri provvedimento in merito adryrun
:kpt fn eval policies/psp-v2022 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
(Facoltativo) Modifica il nome campo PSP
parameters
nei file dei vincoli in base alle esigenze dell'ambiente del cluster. Per maggiori dettagli, fai clic sul link relativo al nome del campo PSP specifico nella tabella sopra. Ad esempio inpsp-host-network-ports
:parameters: hostNetwork: true min: 80 max: 9000
(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
Se la directory di sincronizzazione per Config Sync utilizza Kustomize, aggiungi
policies/psp-v2022
al tuokustomization.yaml
principale. In caso contrario, rimuovi il filepolicies/psp-v2022/kustomization.yaml
:rm SYNC_ROOT_DIR/policies/psp-v2022/kustomization.yaml
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
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, è possibile visualizzare 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 delle norme nel tuo cluster, puoi prendere in considerazione
modifica la modalità di applicazione forzata in modo che il controller di ammissione warn
su
o addirittura deny
, che impediscono che una risorsa non conforme venga applicata al cluster.
kubectl
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"}]'
Verifica che l'azione di applicazione dei vincoli dei criteri sia stata aggiornata:
kubectl get constraint -l policycontroller.gke.io/bundleName=psp-v2022
kpt
Esegui
set-enforcement-action
. kpt per impostare i criteri provvedimento in merito awarn
: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/psp-v2022 -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/psp-v2022 git commit -m 'Adding Pod Security Policy policy bundle warn enforcement' git push
Verifica lo stato dell'installazione:
gcloud alpha anthos config sync repo list --project PROJECT_ID
Il repository visualizzato nella colonna
SYNCED
conferma l'installazione del i criteri.
Testare l'applicazione dei criteri
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 mostrare un avviso che elenca il criterio violazioni 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
Rimuovere il bundle di criteri di sicurezza dei pod
Se necessario, il bundle di criteri di Pod Security Policy 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 il deployment dei criteri nei propri cluster possono utilizzare segui queste istruzioni:
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
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.