Gestionar recursos de reglas de cortafuegos de VPC mediante restricciones personalizadas

Google Cloud La política de organización te ofrece un control centralizado y programático sobre los recursos de tu organización. Como administrador de políticas de la organización, puedes definir una política de la organización, que es un conjunto de restricciones llamadas "restricciones" que se aplican a losGoogle Cloud recursos y a los elementos descendientes de esos recursos en la Google Cloud jerarquía de recursos. Puedes aplicar políticas de organización a nivel de organización, carpeta o proyecto.

La política de organización proporciona restricciones predefinidas para varios servicios deGoogle Cloud . Sin embargo, si quieres tener un control más granular y personalizable sobre los campos específicos que están restringidos en las políticas de tu organización, también puedes crear restricciones personalizadas y aplicarlas en una política de organización personalizada.

Herencia de políticas

De forma predeterminada, las políticas de organización se heredan de los descendientes de los recursos en los que se aplican. Por ejemplo, si aplicas una política a una carpeta, Google Cloud se aplicará a todos los proyectos de la carpeta. Para obtener más información sobre este comportamiento y cómo cambiarlo, consulta las reglas de evaluación de la jerarquía.

Recursos compatibles con Cloud NGFW

En el caso de las reglas de cortafuegos de VPC, puede definir restricciones personalizadas en los siguientes recursos y campos.

  • Cortafuegos: compute.googleapis.com/Firewall
    • Nombre: resource.name
    • Descripción: resource.description
    • Red: resource.network
    • Prioridad: resource.priority
    • Intervalos de origen: resource.sourceRanges[]
    • Intervalos de destino: resource.destinationRanges[]
    • Etiquetas de origen: resource.sourceTags[]
    • Etiquetas de destino: resource.targetTags[]
    • Reglas de permiso: resource.allowed[]
      • Protocolo: resource.allowed[].IPProtocol
      • Puertos: resource.allowed[].ports[]
    • Reglas de denegación: resource.denied[]
      • Protocolo: resource.denied[].IPProtocol
      • Puertos: resource.denied[].ports[]
    • Dirección: resource.direction
    • Está inhabilitado: resource.disabled

Definir restricciones personalizadas

Una restricción personalizada se define mediante los recursos, los métodos, las condiciones y las acciones que admite el servicio en el que se aplica la política de la organización. Las condiciones de tus restricciones personalizadas se definen mediante el lenguaje de expresión común (CEL). Para obtener más información sobre cómo crear condiciones en restricciones personalizadas mediante CEL, consulta la sección sobre CEL del artículo Crear y gestionar políticas de la organización.

Además de las funciones CEL estándar, puedes usar la función CEL personalizada containsFirewallPort para crear restricciones personalizadas para las reglas de cortafuegos. Puedes usar esta función para crear una restricción que haga referencia a un protocolo concreto o a una combinación de protocolo y puerto.

  • Solo protocolo: resource.allowed.containsFirewallPort('PROTOCOL')
  • Protocolo y puerto: resource.allowed.containsFirewallPort('PROTOCOL', 'PORT_NUMBER')

Para obtener información sobre los protocolos permitidos, consulta Protocolos y puertos.

Antes de empezar

  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    REST

    Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

      Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

* Asegúrate de que conoces el ID de tu organización.

Roles obligatorios

Para obtener los permisos que necesitas para gestionar las políticas de la organización de los recursos de Cloud Next Generation Firewall, pide a tu administrador que te conceda los siguientes roles de IAM:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para gestionar las políticas de la organización de los recursos de Cloud Next Generation Firewall. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para gestionar las políticas de la organización de los recursos de Cloud Next Generation Firewall, se necesitan los siguientes permisos:

  • orgpolicy.constraints.list
  • orgpolicy.policies.create
  • orgpolicy.policies.delete
  • orgpolicy.policies.list
  • orgpolicy.policies.update
  • orgpolicy.policy.get
  • orgpolicy.policy.set

También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.

Configurar una restricción personalizada

Puedes crear una restricción personalizada y configurarla para usarla en políticas de organización mediante la Google Cloud consola o la CLI de Google Cloud.

Consola

  1. En la Google Cloud consola, ve a la página Políticas de la organización.

    Ir a Políticas de organización

  2. En la parte superior de la página, selecciona el selector de proyectos.

  3. En el selector de proyectos, selecciona el recurso para el que quieras definir la política de la organización.

  4. Haz clic en Restricción personalizada.

  5. En el cuadro Nombre visible, introduce un nombre descriptivo para la restricción. Este campo tiene una longitud máxima de 200 caracteres. No utilices información personal identificable ni datos sensibles en los nombres de las restricciones, ya que podrían exponerse en mensajes de error.

  6. En el cuadro ID de la restricción, introduce el nombre que quieras para la nueva restricción personalizada. Una restricción personalizada debe empezar por custom. y solo puede incluir letras mayúsculas, letras minúsculas o números. Por ejemplo, custom.httpFirewallRule. La longitud máxima de este campo es de 70 caracteres, sin contar el prefijo, por ejemplo, organizations/123456789/customConstraints/custom..

  7. En el cuadro Descripción, escribe una descripción de la restricción que sea fácil de entender para que se muestre como mensaje de error cuando se infrinja la política. Este campo tiene una longitud máxima de 2000 caracteres.

  8. En el cuadro Tipo de recurso, selecciona el nombre del recurso REST que contenga el objeto y el campo que quieras restringir. Google Cloud Por ejemplo, compute.googleapis.com/Firewall.

  9. En Método de aplicación, selecciona si quieres aplicar la restricción solo al método REST CREATE o a los métodos REST CREATE y UPDATE.

  10. Para definir una condición, haz clic en Editar condición.

    1. En el panel Añadir condición, crea una condición de CEL que haga referencia a un recurso de servicio compatible. Este campo tiene una longitud máxima de 1000 caracteres.

    2. Haz clic en Guardar.

  11. En Acción, seleccione si quiere permitir o denegar el método evaluado si se cumple la condición anterior.

  12. Haz clic en Crear restricción.

Cuando haya introducido un valor en cada campo, aparecerá a la derecha la configuración YAML equivalente de esta restricción personalizada.

gcloud

Para crear una restricción personalizada con la CLI de Google Cloud, crea un archivo YAML.

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resource_types: compute.googleapis.com/RESOURCE_NAME
method_types:
– METHOD1
– METHOD2
condition: "CONDITION"
action_type: ACTION
display_name: DISPLAY_NAME
description: DESCRIPTION

Haz los cambios siguientes:

  • ORGANIZATION_ID: el ID de tu organización, como 123456789.

  • CONSTRAINT_NAME: el nombre que quieras asignar a la nueva restricción personalizada. Una restricción personalizada debe empezar por custom. y solo puede incluir letras mayúsculas, letras minúsculas o números. Por ejemplo, custom.httpFirewallRule. La longitud máxima de este campo es de 70 caracteres, sin contar el prefijo, por ejemplo, organizations/123456789/customConstraints/custom.

  • RESOURCE_NAME: nombre (no URI) del recurso REST de la API de Compute Engine que contiene el objeto y el campo que quieres restringir. Por ejemplo, Firewall.

  • METHOD1,METHOD2,...: lista de métodos RESTful para los que se debe aplicar la restricción. Puede ser CREATE o CREATE y UPDATE.

  • CONDITION: una condición de CEL que se escribe en una representación de un recurso de servicio compatible. Este campo tiene una longitud máxima de 1000 caracteres. Consulta los recursos admitidos para obtener más información sobre los recursos con los que puedes escribir condiciones.

  • ACTION: la acción que se debe llevar a cabo si se cumple la condición condition. Puede ser ALLOW o DENY.

  • DISPLAY_NAME: nombre descriptivo de la restricción. Este campo tiene una longitud máxima de 200 caracteres.

  • DESCRIPTION: descripción de la restricción que se mostrará como mensaje de error cuando se infrinja la política. Este campo tiene una longitud máxima de 2000 caracteres.

Para obtener más información sobre cómo crear una restricción personalizada, consulta Definir restricciones personalizadas.

Consola

Para crear una restricción personalizada, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Políticas de la organización.

    Ir a Políticas de organización

  2. En el selector de proyectos, selecciona el proyecto en el que quieras definir la política de la organización.
  3. Haz clic en Restricción personalizada.
  4. En el cuadro Nombre visible, introduce un nombre legible para la restricción. Este nombre se usa en los mensajes de error y se puede usar para la identificación y la depuración. No utilices información personal identificable ni datos sensibles en los nombres visibles, ya que estos nombres podrían mostrarse en mensajes de error. Este campo puede contener hasta 200 caracteres.
  5. En el cuadro ID de restricción, escribe el nombre que quieras asignar a la nueva restricción personalizada. Una restricción personalizada solo puede contener letras (incluidas mayúsculas y minúsculas) o números, como custom.disableGkeAutoUpgrade. Este campo puede contener hasta 70 caracteres, sin contar el prefijo (custom.). Por ejemplo, organizations/123456789/customConstraints/custom. No incluyas IPI ni datos sensibles en el ID de la restricción, ya que podría exponerse en mensajes de error.
  6. En el cuadro Description, introduce una descripción de la restricción que sea legible por humanos. Esta descripción se usa como mensaje de error cuando se infringe la política. Incluye detalles sobre por qué se ha producido la infracción de las políticas y cómo resolverla. No incluyas IPI ni datos sensibles en la descripción, ya que podrían exponerse en mensajes de error. Este campo puede contener hasta 2000 caracteres.
  7. En el cuadro Tipo de recurso, seleccione el nombre del Google Cloud recurso REST que contenga el objeto y el campo que quiera restringir. Por ejemplo, container.googleapis.com/NodePool. La mayoría de los tipos de recursos admiten hasta 20 restricciones personalizadas. Si intentas crear más restricciones personalizadas, la operación fallará.
  8. En Método de aplicación, selecciona si quieres aplicar la restricción al método CREATE de REST o a los métodos CREATE y UPDATE. Si aplicas la restricción con el método UPDATE en un recurso que la infringe, la política de la organización bloqueará los cambios en ese recurso, a menos que el cambio resuelva la infracción.

    9. No todos los Google Cloud servicios admiten ambos métodos. Para ver los métodos admitidos de cada servicio, busca el servicio en Servicios admitidos.

  9. Para definir una condición, haz clic en Editar condición.
    1. En el panel Añadir condición, crea una condición de CEL que haga referencia a un recurso de servicio compatible, por ejemplo, resource.management.autoUpgrade == false. Este campo puede contener hasta 1000 caracteres. Para obtener más información sobre el uso de CEL, consulta el artículo Lenguaje de expresión común. Para obtener más información sobre los recursos de servicio que puede usar en sus restricciones personalizadas, consulte Servicios admitidos en restricciones personalizadas.
    2. Haz clic en Guardar.
  10. En Acción, seleccione si quiere permitir o denegar el método evaluado si se cumple la condición.

    11. La acción de denegación significa que la operación para crear o actualizar el recurso se bloquea si la condición se evalúa como verdadera.

    La acción de permitir significa que la operación para crear o actualizar el recurso solo se permite si la condición se evalúa como verdadera. Se bloquean todos los demás casos, excepto los que se incluyan explícitamente en la condición.

  11. Haz clic en Crear restricción.

    12. Cuando haya introducido un valor en cada campo, aparecerá a la derecha la configuración YAML equivalente de esta restricción personalizada.

gcloud

  1. Para crear una restricción personalizada, crea un archivo YAML con el siguiente formato: 
    2.       name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
      resourceTypes:
      - RESOURCE_NAME
      methodTypes:
      - CREATE
      condition: "CONDITION"
      actionType: ACTION
      displayName: DISPLAY_NAME
      description: DESCRIPTION

    Haz los cambios siguientes:

    • ORGANIZATION_ID: el ID de tu organización, como 123456789.
    • CONSTRAINT_NAME: el nombre que quieras asignar a la nueva restricción personalizada. Una restricción personalizada solo puede contener letras (incluidas mayúsculas y minúsculas) o números. Por ejemplo, custom.httpFirewallRule. Este campo puede contener hasta 70 caracteres.
    • RESOURCE_NAME: nombre completo del recurso Google Cloud que contiene el objeto y el campo que quieres restringir. Por ejemplo, compute.googleapis.com/Firewall.
    • CONDITION: una condición de CEL que se escribe en una representación de un recurso de servicio admitido. Este campo puede contener hasta 1000 caracteres. Por ejemplo, "resource.allowed.containsFirewallPort('tcp', '80')".

      • Para obtener más información sobre los recursos disponibles para escribir condiciones, consulta Recursos admitidos.

    • ACTION: la acción que se debe llevar a cabo si se cumple la condition. Solo puede ser ALLOW.

      • La acción de permitir significa que, si la condición se evalúa como verdadera, se permite la operación para crear o actualizar el recurso. Esto también significa que se bloquearán todos los demás casos, excepto el que se haya incluido explícitamente en la condición.

    • DISPLAY_NAME: nombre descriptivo de la restricción. Este campo puede contener hasta 200 caracteres.
    • DESCRIPTION: descripción de la restricción que se puede leer fácilmente y que se muestra como mensaje de error cuando se infringe la política. Este campo puede contener hasta 2000 caracteres.
  2. Una vez que hayas creado el archivo YAML de una nueva restricción personalizada, debes configurarla para que esté disponible en las políticas de organización de tu organización. Para configurar una restricción personalizada, usa el comando gcloud org-policies set-custom-constraint: 
    3.         gcloud org-policies set-custom-constraint CONSTRAINT_PATH

    Sustituye CONSTRAINT_PATH por la ruta completa del archivo de restricción personalizada. Por ejemplo, /home/user/customconstraint.yaml.

    Una vez completada esta operación, las restricciones personalizadas estarán disponibles como políticas de la organización en la lista de Google Cloud políticas de la organización.

  3. Para verificar que la restricción personalizada existe, usa el comando gcloud org-policies list-custom-constraints: 
    4.       gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

    Sustituye ORGANIZATION_ID por el ID del recurso de tu organización.

    Para obtener más información, consulta Ver las políticas de una organización.

Aplicar una restricción personalizada

Para aplicar una restricción, crea una política de organización que haga referencia a ella y, a continuación, aplica esa política de organización a un Google Cloud recurso.

Consola

  1. En la Google Cloud consola, ve a la página Políticas de la organización.

    Ir a Políticas de organización

  2. En el selector de proyectos, selecciona el proyecto en el que quieras definir la política de organización.
  3. En la lista de la página Políticas de organización, selecciona la restricción para ver la página Detalles de la política correspondiente.
  4. Para configurar la política de la organización de este recurso, haz clic en Gestionar política.
  5. En la página Editar política, selecciona Anular política del recurso superior.
  6. Haz clic en Añadir regla.
  7. En la sección Aplicación, selecciona si esta política de la organización se aplica o no.
  8. Opcional: Para que la política de la organización dependa de una etiqueta, haz clic en Añadir condición. Ten en cuenta que, si añades una regla condicional a una política de organización, debes añadir al menos una regla incondicional o la política no se podrá guardar. Para obtener más información, consulta el artículo Configurar una política de organización con etiquetas.
  9. Haz clic en Probar cambios para simular el efecto de la política de la organización. Para obtener más información, consulta Probar los cambios en las políticas de la organización con el simulador de políticas.
  10. Para aplicar la política de la organización en modo de prueba de funcionamiento, haz clic en Definir política de prueba de funcionamiento. Para obtener más información, consulta Crear una política de la organización en modo de prueba.
  11. Una vez que hayas verificado que la política de la organización en modo de prueba funciona correctamente, define la política activa haciendo clic en Definir política.

gcloud

  1. Para crear una política de organización con reglas booleanas, crea un archivo YAML de política que haga referencia a la restricción: 
    2.         name: projects/PROJECT_ID/policies/CONSTRAINT_NAME
        spec:
          rules:
          - enforce: true
        
        dryRunSpec:
          rules:
          - enforce: true

    Haz los cambios siguientes:

    • PROJECT_ID: el proyecto en el que quieras aplicar la restricción.
    • CONSTRAINT_NAME: el nombre que has definido para tu restricción personalizada. Por ejemplo, custom.httpFirewallRule.
  2. Para aplicar la política de la organización en el modo de prueba, ejecuta el siguiente comando con la marca dryRunSpec: 
    3.         gcloud org-policies set-policy POLICY_PATH \
          --update-mask=dryRunSpec

    Sustituye POLICY_PATH por la ruta completa al archivo YAML de la política de tu organización. La política tarda hasta 15 minutos en aplicarse.

  3. Una vez que haya verificado que la política de la organización en modo de prueba funciona correctamente, defina la política activa con el comando org-policies set-policy y la marca spec: 
    4.         gcloud org-policies set-policy POLICY_PATH \
          --update-mask=spec

    Sustituye POLICY_PATH por la ruta completa al archivo YAML de la política de tu organización. La política tarda hasta 15 minutos en aplicarse.

Ejemplo: Crear una restricción que impida crear reglas de cortafuegos que permitan conexiones SSH

Esta restricción impide la creación de reglas de cortafuegos de entrada que permitan conexiones SSH desde cualquier intervalo de direcciones IP que no sea uno de los siguientes:

  • 10.0.0.0/8: un intervalo de direcciones IP internas que se usa en la red VPC.
  • 192.168.0.0/16: un intervalo de direcciones IP internas que se usa en la red VPC.
  • 35.235.240.0/20: el intervalo de direcciones IP que usa Identity-Aware Proxy (IAP) para el reenvío de TCP.

También se bloquean todos los intervalos de direcciones IP que incluyan el puerto TCP 22.

gcloud

  1. Crea un archivo de restricciones restrictSshRanges.yaml con la siguiente información.

    name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictSshRanges
resource_types: compute.googleapis.com/Firewall
condition: "resource.direction.matches('INGRESS') && resource.allowed.containsFirewallPort('tcp', '22') && !resource.sourceRanges.all(range, range == '35.235.240.0/20' || range.startsWith('10.') || range.startsWith('192.168.'))"
action_type: DENY
method_types: CREATE
display_name: Limit firewall rules that allow ingress SSH traffic
description: Firewall rules that allow ingress SSH traffic can only be created with allowed source ranges.

    Sustituye ORGANIZATION_ID por el ID de tu organización.

  2. Define la restricción personalizada.

    gcloud org-policies set-custom-constraint restrictSshRanges.yaml

  3. Crea un archivo de política restrictSshRanges-policy.yaml con la información que se proporciona en el siguiente ejemplo y aplica la restricción a nivel de proyecto. También puedes definir esta restricción a nivel de organización o de carpeta.

        name: projects/PROJECT_ID/policies/custom.restrictSshRanges
    spec:
      rules:
      – enforce: true

    Sustituye PROJECT_ID por el ID del proyecto.

  4. Aplica la política.

    gcloud org-policies set-policy restrictSshRanges-policy.yaml

  5. Para probar la restricción, crea una red de VPC automática.

    gcloud compute firewall-rules create ssh-firewall-rule \
    --action=ALLOW  --direction=INGRESS  --network=NETWORK \
    --priority=1000  --rules=tcp:22  --source-ranges=0.0.0.0/0
    Sustituye NETWORK por el nombre de tu red. El resultado debería ser similar al siguiente: 
    ERROR: (gcloud.compute.networks.create) Could not fetch resource:
- Operation denied by custom org policy: [customConstraints/custom.restrictSshRanges] : Firewall rules that allow ingress SSH traffic can only be created with allowed source ranges.

Ejemplo: Restringir el tráfico entrante solo a puertos web estándar

Esta restricción bloquea la creación de reglas de cortafuegos de entrada que permiten el tráfico de 0.0.0.0/0 en puertos TCP distintos de 80 o 443.

gcloud

  1. Crea un archivo de restricciones restrictWebPorts.yaml con la siguiente información.

    name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictWebPorts
resource_types: compute.googleapis.com/Firewall
condition: "resource.direction.matches('INGRESS') && resource.sourceRanges.all(range, range == '0.0.0.0/0') && resource.allowed.exists(allowed, allowed.IPProtocol != 'tcp' || allowed.ports.exists(port, port != '80' && port != '443'))"
action_type: DENY
method_types: CREATE
display_name: Limit firewall rules that allow ingress traffic from 0.0.0.0/0
description: Firewall rules that allow ingress traffic from 0.0.0.0/0 on TCP ports other than 80 or 443.
     Sustituye ORGANIZATION_ID por el ID de tu organización.

  2. Define la restricción personalizada.

    gcloud org-policies set-custom-constraint restrictWebPorts.yaml

  3. Crea un archivo de política restrictWebPorts-policy.yaml con la información que se proporciona en el siguiente ejemplo y aplica la restricción a nivel de proyecto. También puedes definir esta restricción a nivel de organización o de carpeta.

        name: projects/PROJECT_ID/policies/custom.restrictWebPorts
    spec:
      rules:
      – enforce: true

    Sustituye PROJECT_ID por el ID del proyecto.

  4. Aplica la política.

    gcloud org-policies set-policy restrictWebPorts-policy.yaml

  5. Para probar la restricción, crea una red de VPC automática.

    gcloud compute firewall-rules create ssh-firewall-rule \
    --action=ALLOW  --direction=INGRESS  --network=NETWORK \
    --priority=1000  --rules=tcp:22  --source-ranges=0.0.0.0/0
    Sustituye NETWORK por el nombre de tu red. El resultado debería ser similar al siguiente: 
    ERROR: (gcloud.compute.firewall-rules.create) Could not fetch resource:
- Operation denied by custom org policy: [customConstraints/custom.restrictWebPorts] : Firewall rules that allow ingress traffic from 0.0.0.0/0 on TCP ports other than 80 or 443.

Precios

El servicio Organization Policy, incluidas las políticas de organización predefinidas y personalizadas, se ofrece sin coste económico.

Siguientes pasos