Utilizzare i vincoli dei criteri di sicurezza di Cloud Service Mesh

Policy Controller include una libreria predefinita di modelli di vincolo che possono essere utilizzati con il pacchetto di sicurezza Cloud Service Mesh per verificare la conformità delle vulnerabilità e delle best practice per la sicurezza del mesh.

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

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

Questo insieme di vincoli risolve e applica i criteri nei seguenti ambiti:

• Cloud Service Mesh applica il traffico mTLS
• Best practice per AuthorizationPolicy di Cloud Service Mesh
• Applicazione della sicurezza del carico di lavoro di Cloud Service Mesh

Vincoli del bundle di criteri di Cloud Service Mesh

Nome vincolo	Descrizione del vincolo	ID controllo
asm-policy-v0.0.1-asm-ingressgateway-label	Applica l'utilizzo dell'etichetta istio ingressgateway solo ai pod ingressgateway	1.1.1
asm-policy-v0.0.1-asm-sidecar-injection	Impostare il sidecar proxy Istio in modo che venga sempre iniettato nei pod del carico di lavoro	1.1.2
asm-policy-v0.0.1-asm-authz-policy-mesh-default-deny	Applica il criterio AuthorizationPolicy default deny a livello di mesh	1.2.1
asm-policy-v0.0.1-asm-authz-policy-normalization	Applica la normalizzazione di AuthorizationPolicy	1.2.2
asm-policy-v0.0.1-asm-authz-policy-safe-pattern	Applica i pattern sicuri di AuthorizationPolicy	1.2.3
asm-policy-v0.0.1-asm-peer-authn-mesh-strict-mtls	Applica la modalità mTLS restrittiva a livello di mesh per PeerAuthentication	1.3.1
asm-policy-v0.0.1-asm-peer-authn-strict-mtls	L'applicazione di tutte le autenticazioni peer non può sovrascrivere mTLS restrittivo	1.3.2
asm-policy-v0.0.1-asm-request-authn-prohibited-output-headers	Imposta jwtRules outputPayloadToHeader in modo che non contenga intestazioni di richieste HTTP ben note	1.4.1

Profili del set

Nel bundle di criteri di sicurezza di Cloud Service Mesh puoi utilizzare due profili basati sul livello di severità. Al livello di severità basso vengono applicati meno vincoli, in modo da offrire maggiore flessibilità. Al livello di severità elevato vengono applicati più vincoli, che forniscono un controllo delle norme più sicuro.

Livello di severità basso

Il profilo con livello di severità basso presenta i seguenti vincoli delle norme:

• L'etichetta istio:ingressgateway può essere utilizzata solo dai pod di gateway di ingresso Istio.

• In AuthorizationPolicy, i campi hosts o notHosts possono essere utilizzati solo selezionando il gateway di ingresso Istio con l'etichetta istio:ingressgateway.

• In AuthorizationPolicy, quando vengono utilizzati i campi methods o notMethods, i valori devono essere in lettere maiuscole.

• In AuthorizationPolicy, quando viene utilizzato il campo request.headers, i valori non possono contenere spazi.

• In AuthorizationPolicy, quando vengono utilizzati i campi paths o notPaths, i valori devono essere normalizzati.

Livello di severità elevato

Il livello di severità elevato include tutti i vincoli del livello di severità basso, oltre ai seguenti:

• Per tutti i pod del carico di lavoro, l'annotazione sidecar.istio.io/inject: false non può essere applicata per bypassare l'iniezione di proxy.

• Viene applicato un livello di mesh AuthorizationPolicy che definisce una regola di rifiuto predefinita.

• AuthorizationPolicy deve seguire ALLOW-with-positive-matching o DENY-with-negative-match.

• In AuthorizationPolicy, quando vengono utilizzati i campi hosts o notHosts, i valori devono essere coppie di <host-name> e <host-name>:*.

• Viene applicato un livello di mesh PeerAuthentication che definisce la modalità mTLS restrittiva.

• Per tutti i PeerAuthentication nella rete mesh, la modalità mTLS può essere solo UNSET o STRICT, per rispettare il protocollo mTLS in modalità restrittiva.

Impostazioni del set

Impostazione KPT	Descrizione
strictness-level	Profilo del livello di severità del bundle Cloud Service Mesh. Le opzioni sono "Low" o "High" (predefinito)

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 v.1.11.2 o versioni successive 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.
3. Assicurati che Cloud Service Mesh sia installato sul tuo cluster.

Configura Policy Controller per i vincoli di referenza

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 come policycontroller-config.yaml:

   apiVersion: config.gatekeeper.sh/v1alpha1
   kind: Config
   metadata:
     name: config
     namespace: "gatekeeper-system"
   spec:
     sync:
       syncOnly:
         - group: ""
           version: "v1"
           kind: "Namespace"
         - group: "security.istio.io"
           version: "v1beta1"
           kind: "AuthorizationPolicy"
         - group: "security.istio.io"
           version: "v1beta1"
           kind: "PeerAuthentication"
   

   Questo manifest configura Policy Controller per monitorare tipi specifici di oggetti.

2. Applica il manifest policycontroller-config.yaml:

   kubectl apply -f policycontroller-config.yaml
   

Controlla il bundle di criteri Cloud Service Mesh

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 di sicurezza di Cloud Service Mesh descritti nella tabella precedente, puoi implementare 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 utilizzando 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/asm-policy-v0.0.1
   

2. Applica i vincoli delle norme con kubectl:

   kubectl apply -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/asm-policy-v0.0.1
   

   L'output è il seguente:

   asmauthzpolicydefaultdeny.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-mesh-default-deny created
   asmauthzpolicynormalization.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-normalization created
   asmauthzpolicysafepattern.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-safe-pattern created
   asmingressgatewaylabel.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-ingressgateway-label created
   asmpeerauthnmeshstrictmtls.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-peer-authn-mesh-strict-mtls created
   asmpeerauthnstrictmtls.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-peer-authn-strict-mtls created
   asmrequestauthnprohibitedoutputheaders.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-request-authn-prohibited-output-headers created
   asmsidecarinjection.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-sidecar-injection created
   

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

   kubectl get -k https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/asm-policy-v0.0.1
   

   L'output è simile al seguente:

   NAME                                                                                                       ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmauthzpolicydefaultdeny.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-mesh-default-deny   dryrun               0
   
   NAME                                                                                                     ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmauthzpolicynormalization.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-normalization   dryrun               0
   
   NAME                                                                                                  ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmauthzpolicysafepattern.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-safe-pattern   dryrun               0
   
   NAME                                                                                          ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmingressgatewaylabel.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-ingressgateway-label   dryrun               0
   
   NAME                                                                                                     ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmpeerauthnmeshstrictmtls.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-peer-authn-mesh-strict-mtls   dryrun               0
   
   NAME                                                                                            ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmpeerauthnstrictmtls.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-peer-authn-strict-mtls   dryrun               0
   
   NAME                                                                                                                             ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmrequestauthnprohibitedoutputheaders.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-request-authn-prohibited-output-headers   dryrun               0
   
   NAME                                                                                    ENFORCEMENT-ACTION   TOTAL-VIOLATIONS
   asmsidecarinjection.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-sidecar-injection   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 dei criteri di sicurezza di Cloud Service Mesh da GitHub utilizzando kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/asm-policy-v0.0.1
   

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

   kpt fn eval asm-policy-v0.0.1 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 \
     -- enforcementAction=dryrun
   

4. Esegui la funzione di impostazione kpt per impostare campi specifici dei criteri di sicurezza di Cloud Service Mesh:

   kpt fn eval asm-policy-v0.0.1 --image gcr.io/kpt-fn/apply-setters:v0.2.0 -- \
   strictness-level="Low"
   

5. Inizializza la directory di lavoro con kpt, che crea una risorsa per monitorare le modifiche:

   cd asm-policy-v0.0.1
   kpt live init
   

6. Applica i vincoli delle norme con kpt:

   kpt live apply
   

   L'output è il seguente:

   asmauthzpolicydefaultdeny.constraints.gatekeeper.sh/asm-authz-policy-mesh-default-deny created
   asmauthzpolicynormalization.constraints.gatekeeper.sh/asm-authz-policy-normalization created
   asmauthzpolicysafepattern.constraints.gatekeeper.sh/asm-authz-policy-safe-pattern created
   asmingressgatewaylabel.constraints.gatekeeper.sh/asm-ingressgateway-label created
   asmpeerauthnmeshstrictmtls.constraints.gatekeeper.sh/asm-peer-authn-mesh-strict-mtls created
   asmpeerauthnstrictmtls.constraints.gatekeeper.sh/asm-peer-authn-strict-mtls created
   asmsidecarinjection.constraints.gatekeeper.sh/asm-sidecar-injection created
   7 resource(s) applied. 7 created, 0 unchanged, 0 configured, 0 failed
   

7. 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 corretta 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 dei criteri nei loro cluster possono utilizzare le seguenti istruzioni:

1. Passa alla directory di sincronizzazione per Config Sync:

   cd SYNC_ROOT_DIR
   

   Nota: Kpt 1.0.0-beta.17 e versioni successive creano automaticamente un resourcegroup.yaml file durante live init che non deve essere controllato nel tuo repository Config Sync. Se non è già presente, aggiungi resourcegroup.yaml al file .gitignore del tuo repo.

   Per creare o aggiungere .gitignore a resourcegroup.yaml:

   echo resourcegroup.yaml >> .gitignore
   

2. Crea una directory policies dedicata:

   mkdir -p policies
   

3. Scarica il bundle dei criteri di sicurezza di Cloud Service Mesh da GitHub utilizzando kpt:

   kpt pkg get https://github.com/GoogleCloudPlatform/gke-policy-library.git/bundles/asm-policy-v0.0.1 policies/asm-policy-v0.0.1
   

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

   kpt fn eval policies/asm-policy-v0.0.1 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=dryrun
   

5. Esegui la funzione di impostazione kpt per impostare campi specifici dei criteri di sicurezza di Cloud Service Mesh:

   kpt fn eval policies/asm-policy-v0.0.1 --image gcr.io/kpt-fn/apply-setters:v0.2.0 -- \
   strictness-level="Low"
   

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

   kpt live init policies/asm-policy-v0.0.1
   kpt live apply --dry-run policies/asm-policy-v0.0.1
   

   L'output è il seguente:

   Dry-run strategy: client
   inventory update started
   inventory update finished
   apply phase started
   asmauthzpolicydefaultdeny.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-mesh-default-deny apply successful
   asmauthzpolicynormalization.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-normalization apply successful
   asmauthzpolicysafepattern.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-authz-policy-safe-pattern apply successful
   asmingressgatewaylabel.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-ingressgateway-label apply successful
   asmpeerauthnmeshstrictmtls.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-peer-authn-mesh-strict-mtls apply successful
   asmpeerauthnstrictmtls.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-peer-authn-strict-mtls apply successful
   asmrequestauthnprohibitedoutputheaders.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-request-authn-prohibited-output-headers apply successful
   asmsidecarinjection.constraints.gatekeeper.sh/asm-policy-v0.0.1-asm-sidecar-injection apply successful
   apply phase finished
   inventory update started
   inventory update finished
   apply result: 8 attempted, 8 successful, 0 skipped, 0 failed
   

7. Se la directory di sincronizzazione per Config Sync utilizza Kustomize, aggiungi policies/asm-policy-v0.0.1 al tuo kustomization.yaml principale. In caso contrario, rimuovi il file policies/asm-policy-v0.0.1/kustomization.yaml:

   rm SYNC_ROOT_DIR/policies/asm-policy-v0.0.1/kustomization.yaml
   

8. Esegui push delle modifiche nel repository Config Sync:

   git add SYNC_ROOT_DIR/policies/asm-policy-v0.0.1
   git commit -m 'Adding ASM security policy audit enforcement'
   git push
   

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

Modificare l'azione di applicazione del bundle di criteri di Cloud Service Mesh

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.

Avviso: l'azione di applicazione deny deve essere utilizzata con cautela in quanto può potenzialmente bloccare le modifiche necessarie con conseguente interruzione dei carichi di lavoro critici o del cluster. Ti consigliamo vivamente di utilizzare solo le azioni di applicazione warn o dryrun nei cluster con carichi di lavoro di produzione, quando testi nuovi vincoli o esegui migrazioni come l'upgrade delle piattaforme. Per ulteriori informazioni 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=asm-policy-v0.0.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 dei criteri sia stata aggiornata:

   kubectl get constraint -l policycontroller.gke.io/bundleName=asm-policy-v0.0.1
   

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 loro 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/asm-policy-v0.0.1 -i gcr.io/kpt-fn/set-enforcement-action:v0.1 -- enforcementAction=warn
   

3. Esegui push delle modifiche nel repository Config Sync:

   git add SYNC_ROOT_DIR/policies/asm-policy-v0.0.1
   git commit -m 'Adding ASM security policy bundle warn enforcement'
   git push
   

4. 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: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
  name: non-compliant-authz-policy
spec:
  action: ALLOW
  rules:
  - to:
    - operation:
        methods: ["get"]
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: [asm-policy-v0.0.1-asm-authz-policy-normalization] in rules-to-operation, methods or notMethods must be uppercase
authorizationpolicy.security.istio.io/non-compliant-authz-policy created

Rimuovere il bundle di criteri Cloud Service Mesh

Se necessario, il bundle di criteri Cloud Service Mesh può essere rimosso dal cluster.

kubectl

• Utilizza kubectl per rimuovere i criteri:

  kubectl delete constraint -l policycontroller.gke.io/bundleName=asm-policy-v0.0.1
  

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:

1. Esegui push delle modifiche nel repository Config Sync:

   git rm -r SYNC_ROOT_DIR/policies/asm-policy-v0.0.1
   git commit -m 'Removing Cloud Service Mesh  policies'
   git push
   

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