Usa 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 di Cloud Service Mesh per verificare la conformità delle vulnerabilità e le best practice della sicurezza mesh.

Questo pacchetto di vincoli gestisce e applica i criteri nei seguenti domini:

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

Vincoli dei pacchetti di criteri di Cloud Service Mesh

Nome vincolo	Descrizione vincolo	ID controllo
asm-policy-v0.0.1-asm-ingressgateway-label	Applica l'utilizzo dell'etichetta Ingressgateway istio solo sui pod del gateway in entrata	1.1.1
asm-policy-v0.0.1-asm-sidecar-injection	Applica il sidecar del proxy Istio sempre inserito nei pod dei carichi di lavoro	1.1.2
asm-policy-v0.0.1-asm-authz-policy-mesh-default-deny	Applica il criterio di autorizzazione Negativo predefinito 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 il livello mesh strict mtls PeerAuthentication	1.3.1
asm-policy-v0.0.1-asm-peer-authn-strict-mtls	L'applicazione forzata di tutte le PeerAuthentications non può sovrascrivere i mtl rigorosi	1.3.2
asm-policy-v0.0.1-asm-request-authn-prohibited-output-headers	Applica l'istruzione jwtRules outputPayloadToHeader in modo che non contenga intestazioni di richieste HTTP ben note	1.4.1

Raggruppa profili

Nel pacchetto dei criteri di sicurezza di Cloud Service Mesh, puoi utilizzare due profili in base al livello di severità. Un livello di severità basso ha meno vincoli applicati e quindi una maggiore flessibilità. Un livello di severità elevato ha più vincoli applicati, che offrono un controllo più sicuro dei criteri.

Livello di severità basso

Il profilo con livello di severità bassa ha i seguenti vincoli relativi alle norme:

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

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

• In AuthorizationPolicy, quando vengono utilizzati i campi methods o notMethods, i valori devono essere 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à alto

Il livello di severità elevata include tutti i vincoli del livello di severità basso nonché i seguenti:

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

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

• Il campo AuthorizationPolicy deve essere conforme a 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 mesh PeerAuthentication che definisce il protocollo mTLS massimo.

• Per tutti i PeerAuthentication nel mesh, la modalità mTLS può essere solo UNSET o STRICT, per rispettare il rigoroso mTLS.

Impostazioni bundle

Setter KPT	Descrizione
livello di severità	Profilo di livello di severità del bundle Cloud Service Mesh; le opzioni sono "Bassa" o "Alta" (impostazione predefinita)

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 successiva sul tuo cluster con la libreria predefinita dei modelli di vincoli. Devi anche abilitare il supporto per i vincoli referenziali, poiché questo bundle contiene vincoli referenziali.
3. Assicurati che Cloud Service Mesh sia installato sul cluster.

Configura Policy Controller per i vincoli di riferimento

Avviso: puoi sovrascrivere le modifiche. Se hai già un Config nello spazio dei nomi gatekeeper-system, devi includere tutte le impostazioni di personalizzazione precedenti per mantenere 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 il controllo di tipi specifici di oggetti.

2. Applica il manifest policycontroller-config.yaml:

   kubectl apply -f policycontroller-config.yaml
   

Controlla il pacchetto di criteri di Cloud Service Mesh

Policy Controller consente di applicare i criteri per il cluster Kubernetes. Per testare i tuoi carichi di lavoro e la loro conformità ai criteri di sicurezza di Cloud Service Mesh descritti 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/asm-policy-v0.0.1
   

2. Applica i vincoli dei criteri 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 in tutto il 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 setter kpt per impostare i 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 tenere traccia delle modifiche:

   cd asm-policy-v0.0.1
   kpt live init
   

6. Applica i vincoli dei criteri 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 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 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 setter kpt per impostare i 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 del criterio 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 file 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 il push delle modifiche al repository di 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
   

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

Modifica l'azione di applicazione forzata del pacchetto di criteri di Cloud Service Mesh

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ù sui provvedimenti, consulta Controllo tramite 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 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/asm-policy-v0.0.1 -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/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
   

   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: 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 dovrebbe generare un avviso che elenca le violazioni delle norme violate da questa risorsa, 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

Rimuovi il bundle di criteri di Cloud Service Mesh

Se necessario, il bundle di criteri di 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 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/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
   

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