Configura i criteri di sicurezza di Google Cloud Armor

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Per visualizzare una policy specifica, fai clic sul relativo nome nell'elenco delle policy nella pagina Policy di sicurezza.

gcloud

gcloud compute security-policies list

Ad esempio:

gcloud compute security-policies list

NAME
my-policy

Per ulteriori informazioni, vedi gcloud compute security-policies list.

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Per aggiornare una determinata norma, nella pagina Norme di sicurezza, nell'elenco delle norme, fai clic su more_vertMenu per la norma che vuoi aggiornare.

   • Per aggiornare la descrizione delle norme dell'azione della regola predefinita, seleziona Modifica, apporta le modifiche e fai clic su Aggiorna.
   • Per aggiungere una regola, seleziona Aggiungi regola e segui le istruzioni riportate in Aggiungere regole a un criterio di sicurezza.
   • Per modificare il servizio di backend di destinazione per la norma, seleziona Applica norma alla destinazione, fai clic su Aggiungi destinazione, seleziona una destinazione e poi fai clic su Aggiungi.

gcloud

Per aggiornare un criterio di sicurezza, utilizza le seguenti istruzioni di Google Cloud CLI:

• Per aggiornare una regola in un criterio di sicurezza, vedi Aggiornare una singola regola in un criterio di sicurezza.
• Per aggiungere una regola a un criterio di sicurezza, vedi Aggiungere regole a un criterio di sicurezza.
• Per eliminare una regola da un criterio di sicurezza, consulta Eliminazione di regole da un criterio di sicurezza.
• Per aggiornare più regole in un unico aggiornamento (aggiornamento atomico), vedi Aggiornamento atomico di più regole in un criterio di sicurezza.
• Per aggiornare i campi non di regole in un criterio di sicurezza (ad esempio il campo della descrizione), vedi Esportazione dei criteri di sicurezza e Importazione dei criteri di sicurezza.

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, seleziona la casella di controllo accanto al nome delle norme di sicurezza da eliminare.

3. Nell'angolo in alto a destra della pagina, fai clic su deleteElimina.

gcloud

Utilizza gcloud compute security-policies delete NAME. Sostituisci NAME con il nome della policy di sicurezza:

gcloud compute security-policies delete NAME

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, fai clic sul nome delle norme di sicurezza. Viene visualizzata la pagina Dettagli norma e le regole delle norme sono elencate nella scheda Regole al centro della pagina.

gcloud

Utilizza il seguente comando gcloud per elencare tutte le regole in un singolo criterio di sicurezza insieme a una descrizione del criterio:

gcloud compute security-policies describe NAME \

Utilizza il seguente comando gcloud per descrivere una regola con la priorità specificata nel criterio di sicurezza specificato:

gcloud compute security-policies rules describe PRIORITY \
    --security-policy POLICY_NAME

Ad esempio, il seguente comando descrive la regola con priorità 1000 nel criterio di sicurezza my-policy:

gcloud compute security-policies rules describe 1000 \
    --security-policy my-policy

Output:

action: deny(403)
description: block traffic from 192.0.2.0/24 and 198.51.100.0/24
kind: compute#securityPolicyRule
match:
  srcIpRanges:
  - '192.0.2.0/24'
  - '198.51.100.0/24'
preview: false
priority: 1000

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, fai clic sul nome delle norme di sicurezza. Viene visualizzata la pagina Dettagli norma.

3. Al centro della pagina, fai clic sulla scheda Regole.

4. Fai clic su Aggiungi regola.

5. (Facoltativo) Inserisci una descrizione della regola.

6. Seleziona la modalità:

   • Modalità base: consente o nega il traffico in base agli indirizzi IP o agli intervalli IP.
   • Modalità avanzata: consente o nega il traffico in base alle espressioni delle regole.

7. Nel campo Corrispondenza, specifica le condizioni in base alle quali la regola si applica:

   • Modalità di base: inserisci da uno (1) a 10 intervalli di indirizzi IP da corrispondere nella regola. Puoi aggiungere un massimo di 10 intervalli di indirizzi IP. Per i limiti, vedi Quote e limiti di Google Cloud Armor.

   • Modalità avanzata: inserisci un'espressione o delle sottoespressioni da valutare in base alle richieste in entrata. Per informazioni su come scrivere le espressioni e leggere gli esempi seguenti, consulta il riferimento al linguaggio delle regole personalizzate.

     • La seguente espressione corrisponde alle richieste provenienti dall'indirizzo IP 1.2.3.4 e contiene la stringa example nell'intestazione user-agent:

       inIpRange(origin.ip, '1.2.3.4/32') && has(request.headers['user-agent']) && request.headers['user-agent'].contains('example')
       

     • La seguente espressione corrisponde alle richieste che hanno un cookie con un valore specifico:

       has(request.headers['cookie']) && request.headers['cookie'].contains('cookie_name=cookie_value')
       

     • La seguente espressione corrisponde alle richieste provenienti dalla regione AU:

       origin.region_code == 'AU'
       

     • La seguente espressione corrisponde alle richieste provenienti dalla regione AU che non rientrano nell'intervallo IP specificato:

       origin.region_code == "AU" && !inIpRange(origin.ip, '1.2.3.0/24')
       

     • La seguente espressione corrisponde alle richieste se l'URI corrisponde a un'espressione regolare:

       request.path.matches('/example_path/')
       

     • La seguente espressione corrisponde alle richieste se il valore decodificato in Base64 dell'intestazione user-id contiene un valore specifico:

       has(request.headers['user-id']) && request.headers['user-id'].base64Decode().contains('myValue')
       

     • La seguente espressione utilizza un insieme di espressioni preconfigurato per corrispondere agli attacchi SQLi:

       evaluatePreconfiguredWaf('sqli-stable')
       

8. Per Azione, seleziona Consenti o Nega.

9. Se stai configurando una regola di rifiuto, seleziona un messaggio di Stato di rifiuto.

10. Se vuoi attivare la modalità di anteprima per la regola, seleziona la casella di controllo Attiva.

11. Nel campo Priority (Priorità), inserisci un numero intero positivo.

12. Fai clic su Aggiungi.

gcloud

Utilizza il comando gcloud compute security-policies rules create PRIORITY. Sostituisci PRIORITY con la priorità della regola nel criterio:

gcloud compute security-policies rules create PRIORITY \
    --security-policy POLICY_NAME \
    --description DESCRIPTION \
    --src-ip-ranges IP_RANGES | --expression EXPRESSION \
    --action=[ allow | deny-403 | deny-404 | deny-502 ] \
    --preview

Ad esempio, il seguente comando aggiunge una regola per bloccare il traffico dagli intervalli di indirizzi IP 192.0.2.0/24 e 198.51.100.0/24. La regola ha priorità 1000 ed è una regola in un criterio denominato my-policy:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --description "block traffic from 192.0.2.0/24 and 198.51.100.0/24" \
    --src-ip-ranges "192.0.2.0/24","198.51.100.0/24" \
    --action "deny-403"

Utilizza il flag --expression per specificare una condizione nel riferimento per il linguaggio delle regole personalizzate. Il seguente comando aggiunge una regola per consentire il traffico dall'indirizzo IP 1.2.3.4 e contiene la stringa example nell'intestazione user-agent:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --expression "inIpRange(origin.ip, '1.2.3.4/32') && has(request.headers['user-agent']) && request.headers['user-agent'].contains('example')" \
    --action allow \
    --description "Block User-Agent 'example'"

Il comando seguente aggiunge una regola per bloccare le richieste se il cookie della richiesta contiene un valore specifico:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --expression "has(request.headers['cookie']) && request.headers['cookie'].contains('80=BLAH')" \
    --action deny-403 \
    --description "Cookie Block"

Il seguente comando aggiunge una regola per bloccare le richieste provenienti dalla regione AU:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --expression "origin.region_code == 'AU'" \
    --action deny-403 \
    --description "AU block"

Il seguente comando aggiunge una regola per bloccare le richieste provenienti dalla regione AU che non rientrano nell'intervallo IP specificato:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --expression "origin.region_code == "AU" && !inIpRange(origin.ip, '1.2.3.0/24')" \
    --action deny-403 \
    --description "country and IP block"

Il seguente comando aggiunge una regola per bloccare le richieste con un URI che corrisponde a un'espressione regolare:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --expression "request.path.matches('/example_path/')" \
    --action deny-502 \
    --description "regex block"

Il seguente comando aggiunge una regola per bloccare le richieste se il valore decodificato in Base64 dell'intestazione user-id contiene un valore specifico:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --expression "has(request.headers['user-id']) && request.headers['user-id'].base64Decode().contains('myValue')" \
    --action deny-403 \
    --description "country and IP block"

Il seguente comando aggiunge una regola che utilizza un insieme di espressioni preconfigurato per mitigare gli attacchi SQLi:

gcloud compute security-policies rules create 1000 \
    --security-policy my-policy \
    --expression "evaluatePreconfiguredWaf('sqli-stable')" \
    --action deny-403

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, fai clic sul nome delle norme di sicurezza. Viene visualizzata la pagina Dettagli norma.

3. Al centro della pagina, fai clic sulla scheda Regole.

4. Accanto alla regola che vuoi aggiornare, fai clic su editModifica. Viene visualizzata la pagina Modifica regola.

5. Apporta le modifiche e fai clic su Aggiorna.

gcloud

Utilizza questo comando per aggiornare una regola con la priorità specificata in un criterio di sicurezza designato. Puoi aggiornare un solo criterio di sicurezza alla volta utilizzando questo comando:

gcloud compute security-policies rules update PRIORITY [ \
    --security-policy POLICY_NAME  \
    --description DESCRIPTION  \
    --src-ip-ranges IP_RANGES  | --expression EXPRESSION \
    --action=[ allow | deny-403 | deny-404 | deny-502 ]  \
    --preview
  ]
  

Ad esempio, il seguente comando aggiorna una regola con priorità 1111 per consentire il traffico dall'intervallo di indirizzi IP 192.0.2.0/24:

gcloud compute security-policies rules update 1111 \
    --security-policy my-policy \
    --description "allow traffic from 192.0.2.0/24" \
    --src-ip-ranges "192.0.2.0/24" \
    --action "allow"

Per ulteriori informazioni su questo comando, consulta gcloud compute security-policies rules update.

Per aggiornare la priorità di una regola, devi utilizzare l'API REST. Per saperne di più, consulta securityPolicies.patchRule.

gcloud

1. Esporta la norma da aggiornare, come mostrato nell'esempio seguente:

   gcloud compute security-policies export my-policy \
       --file-name my-file \
       --file-format yaml
   

   La policy esportata sarà simile all'esempio seguente:

   description: my description
   fingerprint: PWfLGDWQDLY=
   id: '123'
   name: my-policy
   rules:
   - action: deny(404)
     description: my-rule-1
     match:
       expr:
         expression: evaluatePreconfiguredWaf('xss-stable')
       versionedExpr: SRC_IPS_V1
     preview: false
     priority: 1
   - action: allow
     description: my-rule-2
     match:
       config:
         srcIpRanges:
         - '1.2.3.4'
       versionedExpr: SRC_IPS_V1
     preview: false
     priority: 2
   - action: deny
     description: default rule
     kind: compute#securityPolicyRule
     match:
       config:
         srcIpRanges:
         - '*'
       versionedExpr: SRC_IPS_V1
     preview: false
     priority: 2147483647
   selfLink: https://www.googleapis.com/compute/v1/projects/my-project/global/securityPolicies/my-policy
   

2. Utilizza un editor di testo qualsiasi per modificare il criterio. Ad esempio, puoi modificare le priorità delle regole esistenti e aggiungere una nuova regola:

   description: my description
   fingerprint: PWfLGDWQDLY=
   id: '123'
   name: my-policy
   rules:
   - action: deny(404)
     description: my-rule-1
     match:
       expr:
         expression: evaluatePreconfiguredWaf('xss-stable')
       versionedExpr: SRC_IPS_V1
     preview: false
     priority: 1
   - action: allow
     description: my-new-rule
     match:
       config:
         srcIpRanges:
         - '1.2.3.1'
       versionedExpr: SRC_IPS_V1
     preview: false
     priority: 10
   - action: allow
     description: my-rule-2
     match:
       config:
         srcIpRanges:
         - '1.2.3.4'
       versionedExpr: SRC_IPS_V1
     preview: false
     priority: 11
   - action: deny
     description: default rule
     kind: compute#securityPolicyRule
     match:
       config:
         srcIpRanges:
         - '*'
       versionedExpr: SRC_IPS_V1
     preview: false
     priority: 2147483647
   selfLink: https://www.googleapis.com/compute/v1/projects/my-project/global/securityPolicies/my-policy
   

3. Crea un nuovo criterio di sicurezza di Google Cloud Armor e specifica il nome e il formato del file modificato, come mostrato nell'esempio seguente:

   gcloud compute security-policies create new-policy \
       --file-name modified-policy \
       --file-format yaml
   

4. Rimuovi la vecchia policy di sicurezza dal servizio di backend pertinente, come mostrato nell'esempio seguente:

   gcloud compute backend-services update my-backend \
       --security-policy ""
   

5. Aggiungi il nuovo criterio di sicurezza al servizio di backend, come mostrato nell'esempio seguente:

   gcloud compute backend-services update my-backend \
       --security-policy new-policy
   

6. Se il vecchio criterio non viene utilizzato, eliminalo:

   gcloud compute security-policies delete my-policy
   

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Fai clic sul nome del criterio di sicurezza. Viene visualizzata la pagina Dettagli norma.

3. Al centro della pagina, nella scheda Regole, seleziona la casella di controllo accanto alla regola da eliminare.

4. Fai clic su deleteElimina.

gcloud

Utilizza questo comando per rimuovere una regola con la priorità specificata da un criterio di sicurezza designato. Puoi modificare una sola norma di sicurezza alla volta, ma puoi eliminare più regole contemporaneamente:

gcloud compute security-policies rules delete PRIORITY [...] [
    --security-policy POLICY_NAME \
  ]

Ad esempio:

gcloud compute security-policies rules delete 1000 \
    --security-policy my-policy

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, fai clic sul nome delle norme di sicurezza. Viene visualizzata la pagina Dettagli norma.

3. Al centro della pagina, fai clic sulla scheda Target.

4. Fai clic su Applica criterio a una nuova destinazione.

5. Fai clic su Aggiungi target.

6. Nell'elenco Target, seleziona un target e poi fai clic su Aggiungi.

gcloud

Quando colleghi un criterio di sicurezza del backend a un servizio di backend, utilizza il comando gcloud compute backend-services e il flag --security-policy:

gcloud compute backend-services update my-backend \
    --security-policy my-policy

Quando colleghi un criterio di sicurezza perimetrale a un servizio di backend, utilizza il comando gcloud compute backend-services e il flag --edge-security-policy:

gcloud compute backend-services update my-backend \
    --edge-security-policy my-policy

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, fai clic sul nome delle norme di sicurezza. Viene visualizzata la pagina Dettagli norma.

3. Al centro della pagina, fai clic sulla scheda Target.

4. Seleziona il servizio di backend di destinazione da cui stai rimuovendo la policy.

5. Fai clic su Rimuovi.

6. Nel messaggio Rimuovi target, fai clic su Rimuovi.

gcloud

Quando rimuovi una policy di sicurezza del backend, utilizza il comando gcloud compute backend-services e il flag --security-policy:

gcloud compute backend-services update my-backend \
    --security-policy ""

Quando rimuovi una policy di sicurezza perimetrale, utilizza il comando gcloud compute backend-services e il flag --edge-security-policy:

gcloud compute backend-services update my-backend \
    --edge-security-policy ""

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, fai clic sul nome delle norme di sicurezza. Viene visualizzata la pagina Dettagli norma.

3. Al centro della pagina, fai clic sulla scheda Target.

4. Fai clic su Applica criterio a una nuova destinazione.

5. Fai clic su Aggiungi target.

6. Nell'elenco Target, seleziona un target e poi fai clic su Aggiungi.

gcloud

Quando colleghi un criterio di sicurezza perimetrale a un bucket di backend, utilizza il comando cloud compute backend-buckets e il flag --edge-security-policy:

gcloud compute backend-services update my-bucket \
    --edge-security-policy my-edge-policy

Console

1. Nella console Google Cloud , vai alla pagina Policy Google Cloud Armor.

   Vai ai criteri di Google Cloud Armor

2. Nella pagina Norme di sicurezza, fai clic sul nome delle norme di sicurezza. Viene visualizzata la pagina Dettagli norma.

3. Al centro della pagina, fai clic sulla scheda Target.

4. Seleziona il servizio di backend di destinazione da cui stai rimuovendo la policy.

5. Fai clic su Rimuovi.

6. Nel messaggio Rimuovi target, fai clic su Rimuovi.

gcloud

Quando rimuovi una policy di sicurezza perimetrale da un bucket di backend, utilizza il comando cloud compute backend-buckets e il flag --edge-security-policy:

gcloud compute backend-services update my-bucket \
    --edge-security-policy ""

gcloud

Per importare i criteri di sicurezza, utilizza il comando gcloud compute security-policies import NAME. Sostituisci NAME con il nome della norma di sicurezza che stai importando. Se non fornisci il formato del file, viene presupposto il formato corretto in base alla struttura del file. Se la struttura non è valida, viene visualizzato un errore.

gcloud compute security-policies import NAME \
    --file-name FILE_NAME  \
   [--file-format FILE_FORMAT]

Ad esempio, il seguente comando aggiorna il criterio my-policy importando il file my-file.

gcloud compute security-policies import my-policy \
    --file-name my-file \
    --file-format json

Se l'impronta del criterio non è aggiornata quando lo importi, Google Cloud Armor mostra un errore. Ciò significa che le norme sono state modificate dall'ultima esportazione. Per risolvere il problema, utilizza il comando describe nella policy per ottenere l'ultima impronta. Unisci eventuali differenze tra la policy descritta e la tua policy, quindi sostituisci l'impronta obsoleta con quella più recente.

gcloud

1. Nel seguente comando, NAME è il nome del criterio di sicurezza. I formati di file validi sono YAML e JSON. Se non fornisci il formato del file, Google Cloud Armor utilizza il formato YAML predefinito.

   gcloud compute security-policies export NAME \
       --file-name FILE_NAME  \
       --file-format FILE_FORMAT
   

   L'esempio seguente esporta il criterio di sicurezza my-policy nel file my-file in formato YAML:

   gcloud compute security-policies export my-policy \
       --file-name my-file \
       --file-format yaml
    

   L'esempio seguente mostra un criterio di sicurezza esportato:

   description: my description
   fingerprint: PWfLGDWQDLY=
   id: '123'
   name: my-policy
   rules:
   - action: allow
     description: default rule
     match:
         config:
           srcIpRanges:
           - '*'
         versionedExpr: SRC_IPS_V1
       preview: false
       priority: 2147483647
     selfLink: https://www.googleapis.com/compute/v1/projects/my-project/global/securityPolicies/my-policy
     

2. Puoi modificare il file esportato con qualsiasi editor di testo e poi importarlo di nuovo in Google Cloud utilizzando il comandoimport.

gcloud

1. Esegui il comando gcloud compute security-policies list-preconfigured-expression-sets:

   gcloud compute security-policies list-preconfigured-expression-sets
   

   L'esempio seguente mostra la forma dell'output del comando:

   EXPRESSION_SET
   expression-set-1
      RULE_ID                SENSITIVITY
      expression-set-1-id-1  sensitivity-value-1
      expression-set-1-id-2  sensitivity-value-2
   expression-set-2
      alias-1
      RULE_ID                SENSITIVITY
      expression-set-2-id-1  sensitivity-value-1
      expression-set-2-id-2  sensitivity-value-2
   

   L'esempio seguente include un campione dell'output effettivo del comando. Tieni presente che l'output effettivo includerebbe tutte le regole elencate in Ottimizzazione delle regole WAF di Google Cloud Armor.

   gcloud compute security-policies list-preconfigured-expression-sets
   

   EXPRESSION_SET
   sqli-canary
       RULE_ID                          SENSITIVITY
       owasp-crs-v030001-id942110-sqli  2
       owasp-crs-v030001-id942120-sqli  2
       …
   xss-canary
       RULE_ID                         SENSITIVITY
       owasp-crs-v030001-id941110-xss  1
       owasp-crs-v030001-id941120-xss  1
   …
   sourceiplist-fastly
   sourceiplist-cloudflare
   sourceiplist-imperva