Creazione delle regole firewall di App Engine

In App Engine, puoi creare un firewall con un massimo di 1000 regole individuali con priorità che consentono o limitano un intervallo di indirizzi IP e sottoreti. L'app risponderà solo alle richieste consentite dal firewall.

Per scoprire come funziona il firewall di App Engine, consulta Informazioni sui firewall.

Prima di iniziare

Prima di poter creare regole firewall di App Engine per la tua app, devi avere uno dei seguenti ruoli IAM di App Engine, che includono i privilegi necessari per creare o modificare le regole firewall:

App Engine Admin
Editor
Proprietario

Creazione di regole firewall

Utilizza uno dei seguenti metodi per creare una regola firewall. Ripeti questi passaggi per ogni regola aggiuntiva:

Console

Utilizza la pagina Regole firewall nella console Google Cloud per creare una regola firewall:

Vai alla pagina Crea una regola firewall nella console Google Cloud:

Vai alla pagina Crea una regola firewall
Specifica i dettagli della regola firewall:
1. In Priorità, inserisci un numero intero per specificare l'importanza relativa della regola e definire l'ordine in cui viene valutata.
  I valori validi sono compresi tra 1 e 2147483646. La priorità 1 è la prima regola valutata. La priorità 2147483647 è l'ultima regola valutata ed è riservata alla regola "predefinita".
  
  Importante: dopo aver creato una regola, non puoi modificare il valore della priorità. Per modificare il valore della priorità di una regola, devi eliminare e ricrearla.
2. In Azione in caso di corrispondenza, specifica se consentire o negare l'accesso per le richieste che corrispondono alla regola. Le regole impostate su allow inoltrano la richiesta all'app. Le regole impostate su allow rispondono alle richieste con un errore 403 Forbidden.deny
3. In Intervallo IP, definisci l'intervallo di indirizzi IP applicabili alla regola. L'intervallo di indirizzi IP deve essere definito in notazione CIDR, può includere subnet mask e supportare sia IPv4 che IPv6.
4. (Facoltativo) In Descrizione, includi una descrizione della regola che non superi i 100 caratteri.
Fai clic su Salva per creare la regola.
Testa la regola per assicurarti che la priorità e l'azione forniscano il comportamento previsto:
1. Fai clic su Testa indirizzo IP.
2. Inserisci l'indirizzo IP da convalidare e poi fai clic su Test per assicurarti che la regola corrispondente venga valutata correttamente.

gcloud

Esegui i seguenti comandi gcloud app firewall-rules per creare una regola firewall:

Esegui il comando seguente per creare una regola firewall:
```
gcloud app firewall-rules create PRIORITY --action ALLOW_OR_DENY --source-range IP_RANGE --description DESCRIPTION
```
where:
- PRIORITY è un numero intero compreso tra 1 e 2147483646 che definisce l'importanza della regola e l'ordine in cui viene valutata. La priorità 1 è la prima regola valutata. La priorità 2147483647 è l'ultima regola valutata ed è riservata alla regola "predefinita".
  Importante: dopo aver creato una regola, non puoi modificare il valore della priorità. Per modificare il valore della priorità di una regola, devi eliminare e ricrearla.
- ALLOW_OR_DENY specifica se consentire o negare l'accesso per le richieste che corrispondono alla regola. I valori validi sono allow o deny. Regole impostate su allow inoltrano la richiesta all'app. Le regole impostate su deny rispondono alle richieste con un errore 403 Forbidden.
- IP_RANGE definisce l'intervallo di indirizzi IP applicabili alla regola. L'intervallo IP deve essere definito in notazione CIDR, può includere subnet mask e supportare sia IPv4 che IPv6.
- DESCRIPTION è una descrizione facoltativa della regola che non deve contenere più di 100 caratteri.
Esegui il seguente comando per testare la regola e assicurarti che la priorità e l'azione forniscano il comportamento previsto:
```
gcloud app firewall-rules test-ip IP_ADDRESS
```
dove IP_ADDRESS è l'indirizzo IP che vuoi testare rispetto al firewall.
Esegui il seguente comando per visualizzare un elenco delle regole esistenti:
```
gcloud app firewall-rules list
```
Esegui questo comando per eliminare una regola esistente:
```
gcloud app firewall-rules delete PRIORITY
```
dove PRIORITY è il valore della priorità della regola che vuoi eliminare.

Esempi:

Utilizza i seguenti esempi per creare il tuo firewall:

Aggiungi una regola che consenta un indirizzo IPv6 e una subnet mask, quindi testa la regola per assicurarti che venga valutata prima delle altre regole:
```
gcloud app firewall-rules create 123 --source-range fe80::3636:3bff:fecc:8778/128 --action allow
gcloud app firewall-rules test-ip fe80::3636:3bff:fecc:8778
```
Aggiungi una regola per negare un indirizzo IPv4 e una subnet mask, quindi testa la regola per assicurarti che venga valutata correttamente:
```
gcloud app firewall-rules create 123456 --source-range "74.125.0.0/16" --action deny
gcloud app firewall-rules test-ip 74.125.0.8
```
Aggiorna e poi testa la regola predefinita per assicurarti che limiti tutti gli indirizzi IP che non corrispondono a nessuna altra regola:
```
gcloud app firewall-rules update default --action deny
gcloud app firewall-rules test-ip 123.456.7.89
```

API

Per creare in modo programmatico regole firewall per la tua app App Engine, puoi utilizzare i metodi apps.firewall.ingressRules nell'API Admin.

Per testare una regola firewall e assicurarti che la priorità e l'azione forniscano il comportamento previsto, puoi utilizzare il metodo apps.firewall.ingressRules.list e specificare l'indirizzo IP che vuoi testare nel parammetro matchingAddress.

Informazioni sulle regole firewall di App Engine

Un firewall di App Engine è costituito da un elenco ordinato di regole che possono consentire o negare l'accesso alla tua app dall'indirizzo IP o dall'intervallo IP specificato. La regola si applica a tutte le risorse dell'applicazione App Engine.

Priorità della regola firewall

Le regole del firewall sono ordinate in base all'importanza, che definisci come valore numerico nella priorità di ogni regola. Devi specificare un valore di priorità univoco per ogni regola, in quanto definisce l'importanza rispetto alle altre regole del firewall. I valori della scala di priorità di una regola vanno dal valore più importante di 1 al valore meno importante di 2147483647.

Ogni firewall include una regola default creata automaticamente con la priorità 2147483647 e applicata all'intera gamma IP della tua app. La regola default viene sempre valutata dopo tutte le altre regole nel firewall e applicata a tutte le richieste su tutti gli indirizzi IP.

Il firewall valuta prima la regola con la priorità più alta. Tutte le regole rimanenti nel firewall vengono valutate in sequenza finché una regola non corrisponde all'intervallo IP della richiesta. Quando viene trovata una regola corrispondente, la connessione viene consentita o negata e tutte le regole rimanenti nel firewall vengono ignorate. Se nessuna delle regole definite manualmente nel firewall corrisponde alla richiesta, viene valutata la regola default.

Ad esempio, se crei una regola con priorità 1, viene sempre valutata prima. Se una richiesta in arrivo corrisponde alla regola con priorità 1, viene valutata solo quella regola e tutte le altre regole del firewall vengono ignorate, inclusa la regola default.

Il firewall di esempio riportato di seguito mostra come la priorità di una regola può modificare il comportamento del firewall.

Firewall di esempio

In questo esempio, un'azienda ha configurato un firewall per concedere l'accesso all'app in fase di sviluppo al team di ingegneria e alla rete aziendale interna. Le regole del firewall sono state create con ampi intervalli tra ogni priorità per consentire la crescita.

Priorità	Azione	Intervallo IP	Descrizione
1000	Rifiuta	192.0.2.1	Nega l'accesso a un malintenzionato DoS.
2000	Consenti	198.51.100.2	Consente l'accesso a un tecnico nell'ufficio satellite.
3000	Rifiuta	198.51.100.0/24	Nega l'accesso a tutti gli edifici non di ingegneria.
5000	Consenti	203.0.113.0/24	Consente l'accesso alla rete dell'edificio principale.
2147483647	Rifiuta	*	Azione predefinita

Dopo aver creato il firewall, ipotizza che le seguenti richieste siano indirizzate all'app di esempio e prendi nota della risposta dell'app:

La richiesta da 198.51.100.2 corrisponde alla regola con priorità 2000 ed è consentita.
La richiesta da 198.51.100.100 corrisponde alla regola con priorità 3000 e viene rifiutata.
La richiesta da 203.0.113.54 corrisponde alla regola con priorità 5000 ed è consentita.
La richiesta da 45.123.35.242 corrisponde alla regola predefinita e viene rifiutata.

Risolvere le regole in conflitto

Ad esempio, supponiamo che due delle priorità nel firewall dell'azienda siano scambiate. Se le regole per le priorità 2000 e 3000 vengono scambiate, nota il comportamento indesiderato.

Priorità	Azione	Intervallo IP	Descrizione
1000	Rifiuta	192.0.2.1	Nega l'accesso a un malintenzionato DoS.
2000	Nega	198.51.100.0/24	Nega l'accesso a tutti gli edifici non di ingegneria.
3000	Consenti	198.51.100.2	Consente l'accesso a un tecnico nell'ufficio satellite.
5000	Consenti	203.0.113.0/24	Consente l'accesso alla rete dell'edificio principale.
2147483647	Rifiuta	*	Azione predefinita

L'ingegnere dell'ufficio satellite non potrà accedere all'app dell'azienda perché la nuova priorità della regola ne impedisce la valutazione. L'indirizzo IP 198.51.100.2 dell'ingegnere corrisponde alla regola che nega l'accesso a tutti gli utenti non ingegneri nell'intervallo 198.51.100.0/24 prima della regola che consente l'accesso all'indirizzo IP dell'ingegnere.

Per risolvere il problema, devi impostare la priorità della regola che consente l'accesso a198.51.100.2 su un valore superiore a quello della regola che nega l'accesso per l'intervallo IP198.51.100.0/24.

Passaggi successivi

Per assicurarti di aver configurato in modo sicuro la tua app e impostato i livelli di accesso appropriati, consulta la sezione Sicurezza delle applicazioni e Controllo dell'accesso.