Nota: Java 8 ha raggiunto la fine del supporto il 31 gennaio 2024. Le applicazioni Java 8 esistenti continueranno a essere eseguite e a ricevere traffico. Tuttavia, App Engine potrebbe bloccare il ri deployment di applicazioni che utilizzano runtime dopo la data di fine del supporto. Ti consigliamo di eseguire la migrazione alla versione più recente supportata di Java.

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 subnet. La tua 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 disporre di uno dei seguenti ruoli IAM di App Engine, che includono i privilegi necessari per creare o modificare le regole firewall:

Amministratore App Engine
Editor
Proprietario

Creazione delle regole firewall in corso...

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 da 1 a 2147483646. La priorità 1 è la prima regola valutata. La priorità 2147483647 è l'ultima regola valutata ed è riservata per la regola "default".
  
  Importante: dopo aver creato una regola, non puoi modificare il valore di priorità. Devi eliminare e poi ricreare una regola per modificare il valore della priorità di una regola.
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 deny rispondono alle richieste con un errore 403 Forbidden.
3. In Intervallo IP, definisci l'intervallo di indirizzi IP che si applicano alla regola. L'intervallo di indirizzi IP deve essere definito in notazione CIDR, può includere subnet mask e supportare sia IPv4 sia 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 Verifica indirizzo IP.
2. Inserisci l'indirizzo IP da convalidare e fai clic su Test per assicurarti che la regola corrispondente venga valutata correttamente.

gcloud

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

Esegui questo comando per creare una regola firewall:
```
gcloud app firewall-rules create PRIORITY --action ALLOW_OR_DENY --source-range IP_RANGE --description DESCRIPTION
```
dove:
- PRIORITY è un numero intero compreso tra 1 e 2147483646 che definisce l'importanza e l'ordine per cui la regola viene valutata. La priorità 1 è la prima regola valutata. La priorità 2147483647 è l'ultima regola valutata ed è riservata per la regola "predefinita".
  Importante: dopo aver creato una regola, non puoi modificare il valore di priorità. Devi eliminare e poi ricreare una regola per modificare il valore della priorità di una regola.
- ALLOW_OR_DENY consente di specificare se consentire o negare l'accesso per le richieste che corrispondono alla regola. I valori validi sono allow o deny. Le 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 che si applicano alla regola. L'intervallo IP deve essere definito in notazione CIDR, può includere subnet mask e supportare sia IPv4 sia IPv6.
- DESCRIPTION è una descrizione facoltativa della regola che non supera i 100 caratteri.
Esegui questo 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 nel firewall.
Esegui questo 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 di priorità della regola da eliminare.

Esempi:

Per creare il firewall, fai riferimento ai seguenti esempi:

Aggiungi una regola che consenta un indirizzo IPv6 e una subnet mask, quindi testala 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 ad altre regole:
```
gcloud app firewall-rules update default --action deny
gcloud app firewall-rules test-ip 123.456.7.89
```

API

Per creare in modo programmatico le 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 all'interno del parametro 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 o dall'intervallo IP specificato. La regola si applica a tutte le risorse dell'applicazione App Engine.

Priorità regola firewall

Le regole firewall sono ordinate per 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 nel firewall. I valori per la priorità di una regola scalano dal valore più importante di 1 al meno importante al valore 2147483647.

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

Il firewall valuta prima la regola con priorità più alta. Tutte le restanti regole del firewall vengono valutate in sequenza fino a quando una regola 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, questa viene sempre valutata per prima. Se una richiesta in entrata corrisponde alla regola con priorità 1, viene valutata solo la 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 al team di progettazione e alla rete aziendale interna all'app di sviluppo. Le regole firewall sono state create con ampi intervalli tra ciascuna priorità per consentire la crescita.

Priorità	Azione	Intervallo IP	Descrizione
1000	Nega	192.0.2.1	Nega l'accesso a un utente malintenzionato DoS.
2000	Consenti	198.51.100.2	Consente l'accesso a un ingegnere dell'ufficio satellite.
3000	Nega	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	Nega	*	Azione predefinita

Dopo aver creato il firewall, supponi 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.

Risoluzione di regole in conflitto

Supponiamo, ad esempio, che due delle priorità del firewall dell'azienda vengano scambiate. Se le regole per le priorità 2000 e 3000 vengono scambiate, nota il comportamento indesiderato.

Priorità	Azione	Intervallo IP	Descrizione
1000	Nega	192.0.2.1	Nega l'accesso a un utente 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 ingegnere dell'ufficio satellite.
5000	Consenti	203.0.113.0/24	Consente l'accesso alla rete dell'edificio principale.
2147483647	Nega	*	Azione predefinita

Il tecnico dell'ufficio satellite non potrà accedere all'app dell'azienda poiché, a causa della nuova priorità della regola, questa non verrà mai valutata. L'indirizzo IP 198.51.100.2 del tecnico corrisponde alla regola che nega tutti gli utenti non ingegneri nell'intervallo 198.51.100.0/24 prima della regola che consente l'accesso all'indirizzo IP del tecnico.

Per risolvere il problema, devi impostare la priorità della regola che consente l'accesso a 198.51.100.2 in modo che sia superiore alla regola che nega l'accesso per l'intervallo IP 198.51.100.0/24.

Passaggi successivi

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