Nota: Go 1.11 alcanzó el fin de la asistencia el 30 de enero de 2024. Las aplicaciones existentes de Go 1.11 seguirán ejecutándose y recibiendo tráfico. Sin embargo, App Engine podría bloquear la reimplementación de aplicaciones que usan entornos de ejecución después de la fecha de finalización de la asistencia. Te recomendamos que migres a la versión compatible más reciente de Go.

Crea reglas de firewall de App Engine

En App Engine, puedes crear un firewall con hasta 1,000 reglas individuales priorizadas que pueden permitir o restringir un rango de direcciones IP y subredes. Tu app solo responderá a las solicitudes que el firewall permita.

Para obtener información sobre cómo funciona el firewall de App Engine, consulta Información sobre firewalls.

Antes de comenzar

Antes de crear reglas de firewall de App Engine para la app, debes tener una de las siguientes funciones de IAM de App Engine, que incluyen los privilegios necesarios que permiten crear o modificar reglas de firewall:

Administrador de App Engine
Editor
Propietario

Crea reglas de firewall

Crea una regla de firewall mediante uno de los métodos siguientes. Repite estos pasos para crear cada regla adicional:

Console

Usa la página Reglas de firewall en la consola de Google Cloud para crear una regla de firewall:

Ve a la página Crea una regla de firewall en la consola de Google Cloud:

Ir a la página Crea una regla de firewall
Específica los detalles de la regla de firewall:
1. En Prioridad, ingresa un número entero para especificar la importancia relativa de la regla y definir el orden en que se evalúa.
  Los valores válidos van desde 1 hasta 2147483646. La regla que tiene la prioridad 1 es la que se evalúa primero. La regla que tiene la prioridad 2147483647 es la última que se evalúa y se reserva para la regla predeterminada.
  
  Importante: Después de crear una regla, no puedes editar el valor de prioridad. Para cambiar el valor de prioridad de una regla, debes borrarla y volver a crearla.
2. En Acción en caso de coincidencia, especifica si deseas permitir o rechazar el acceso a las solicitudes que coinciden con la regla. Las reglas configuradas como allow reenvían la solicitud a la app. Las reglas configuradas como deny responden a las solicitudes con un error 403 Forbidden.
3. En Rango de IP, debes definir el rango de direcciones IP al que se aplica la regla. El rango de direcciones IP debe definirse con la notación CIDR; puede incluir máscaras de subred y admitir IPv4 e IPv6.
4. Opcional: en Descripción, incluye una descripción de la regla de hasta 100 caracteres.
Haz clic en Guardar para crear la regla.
Prueba la regla para asegurarte de que la prioridad y la acción se comporten de la manera esperada:
1. Haz clic en Probar dirección IP.
2. Ingresa la dirección IP que deseas validar y, luego, haz clic en Probar para asegurarte de que la regla correspondiente se evalúe de forma correcta.

gcloud

Ejecuta los siguientes comandos gcloud app firewall-rules para crear una regla de firewall:

Ejecuta el siguiente comando para crear una regla de firewall:
```
gcloud app firewall-rules create PRIORITY --action ALLOW_OR_DENY --source-range IP_RANGE --description DESCRIPTION
```
donde:
- PRIORITY es un número entero entre 1 y 2147483646 que define la importancia de la regla y el orden en que se evalúa. La regla que tiene la prioridad 1 es la que se evalúa primero. La regla que tiene la prioridad 2147483647 es la última que se evalúa y se reserva para la regla predeterminada.
  Importante: Después de crear una regla, no puedes editar el valor de prioridad. Para cambiar el valor de prioridad de una regla, debes borrarla y volver a crearla.
- ALLOW_OR_DENY especifica si se permite o se rechaza el acceso a las solicitudes que coinciden con la regla. Los valores válidos son allow o deny. Las reglas configuradas como allow reenvían la solicitud a la app. Las reglas configuradas como deny responden a las solicitudes con un error 403 Forbidden.
- IP_RANGE define el rango de direcciones IP al que se aplica la regla. El rango de IP debe definirse con la notación CIDR; puede incluir máscaras de subred y admitir IPv4 e IPv6.
- DESCRIPTION es una descripción opcional de la regla de hasta 100 caracteres.
Ejecuta el siguiente comando para probar tu regla y asegurarte de que la prioridad y la acción se comporten de la manera esperada:
```
gcloud app firewall-rules test-ip IP_ADDRESS
```
donde IP_ADDRESS es la dirección IP con la que deseas probar tu firewall.
Ejecuta el siguiente comando para ver una lista de las reglas existentes:
```
gcloud app firewall-rules list
```
Ejecuta el siguiente comando para borrar una regla existente:
```
gcloud app firewall-rules delete PRIORITY
```
donde PRIORITY es el valor de prioridad de la regla que deseas borrar.

Ejemplos:

Usa los siguientes ejemplos a modo de ayuda para crear el firewall:

Agrega una regla que permita una dirección IPv6 y una máscara de subred y, luego, prueba la regla para asegurarte de que se evalúe antes que las demás:

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

Agrega una regla para denegar una dirección IPv4 y una máscara de subred, y luego prueba la regla a fin de asegurarte de que se evalúe de forma apropiada:
```
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
```
Actualiza y prueba la regla predeterminada para asegurarte de que restringe todas las direcciones IP que no coinciden con otras reglas:
```
gcloud app firewall-rules update default --action deny
gcloud app firewall-rules test-ip 123.456.7.89
```

API

A fin de crear reglas de firewall de manera programática para la app de App Engine, puedes usar los métodos apps.firewall.ingressRules en la API de Administrador.

Para probar una regla de firewall y asegurarte de que la prioridad y la acción se comportan de la manera esperada, puedes usar el método apps.firewall.ingressRules.list y especificar la dirección IP que deseas probar dentro del parámetro matchingAddress.

Información sobre las reglas de firewall de App Engine

Un firewall de App Engine está compuesto por una lista ordenada de reglas que pueden permitir o rechazar el acceso de una dirección IP o un rango específico a la app. La regla se aplica a todos los recursos de la aplicación de App Engine.

Prioridad de la regla de firewall

Las reglas del firewall se ordenan según su importancia, que puedes definir con un valor numérico en la prioridad de cada regla. Debes especificar un valor de prioridad único para cada regla, ya que define la importancia en relación con las demás reglas del firewall. Los valores para la prioridad de las reglas van desde el más importante (1) hasta el menos importante (2147483647).

Cada firewall incluye una regla default que se crea de forma automática con la prioridad 2147483647 y se aplica al rango de IP completo de la app. La regla default siempre se evalúa después de todas las otras en el firewall y se aplica a todas las solicitudes en todas las direcciones IP.

El firewall evalúa primero la regla con mayor prioridad. Las reglas restantes se evalúan de forma secuencial hasta que una coincida con el rango de IP de esa solicitud. Cuando se encuentra una regla que coincide, se admite o se rechaza la conexión y se omiten las demás reglas de firewall. Si ninguna de las reglas definidas de forma manual en el firewall coincide con la solicitud, se evalúa la regla default.

Por ejemplo, si creas una regla con prioridad 1, siempre se evalúa primero. Si una solicitud entrante coincide con la regla de prioridad 1, solo se evalúa esa y se omiten las demás reglas de firewall, incluida la default.

En el siguiente firewall de ejemplo, se muestra cómo puede cambiar el comportamiento del firewall según la prioridad de una regla.

Firewall de ejemplo

En este ejemplo, una empresa configuró un firewall para que el equipo de ingenieros y la red corporativa interna tengan acceso a la app en desarrollo. Las reglas de firewall se crearon con espacios grandes entre cada prioridad para permitir el crecimiento.

Prioridad	Acción	Rango de IP	Descripción
1000	Rechazar	192.0.2.1	Rechaza el acceso a un ataque de DoS.
2000	Permitir	198.51.100.2	Permite el acceso a un ingeniero de la oficina satélite.
3000	Rechazar	198.51.100.0/24	Rechaza el acceso a los edificios que no son de ingeniería.
5000	Permitir	203.0.113.0/24	Permite el acceso a la red del edificio principal.
2147483647	Rechazar	*	Acción predeterminada

Luego de crear el firewall, imagina que las siguientes solicitudes se envían a la aplicación de muestra y observa la respuesta:

La solicitud desde 198.51.100.2 coincide con la regla con prioridad 2000 y se permite.
La solicitud desde 198.51.100.100 coincide con la regla con prioridad 3000 y se rechaza.
La solicitud desde 203.0.113.54 coincide con la regla con prioridad 5000 y se permite.
La solicitud desde 45.123.35.242 coincide con la regla predeterminada y se rechaza.

Resuelve los conflictos de reglas

Por ejemplo, supone que se intercambian dos de las prioridades del firewall de la empresa. Observa el comportamiento no deseado si se intercambian las reglas con prioridades 2000 y 3000.

Prioridad	Acción	Rango de IP	Descripción
1000	Rechazar	192.0.2.1	Rechaza el acceso a un ataque de DoS.
2000	Denegar	198.51.100.0/24	Rechaza el acceso a los edificios que no son de ingeniería.
3000	Permitir	198.51.100.2	Permite el acceso a un ingeniero de la oficina satélite.
5000	Permitir	203.0.113.0/24	Permite el acceso a la red del edificio principal.
2147483647	Rechazar	*	Acción predeterminada

El ingeniero en la oficina satélite no podrá acceder a la app de la empresa, ya que, por la nueva prioridad de la regla, esta nunca se evaluará. La dirección IP 198.51.100.2 del ingeniero coincide con la regla que rechaza el acceso a todas las personas que no son ingenieros en el rango 198.51.100.0/24 antes de la regla que permite el acceso a la dirección IP del ingeniero.

Para solucionar el problema, debes modificar la configuración a fin de que la regla que permite el acceso a 198.51.100.2 tenga mayor prioridad que la regla que rechaza el acceso al rango de IP 198.51.100.0/24.

¿Qué sigue?

A fin de asegurarte de que configuraste la app de forma segura y estableciste los niveles de acceso apropiados, consulta Seguridad para aplicaciones y Control de acceso.