Configura políticas de autorización para balanceadores de cargas de aplicaciones

En esta página, se muestra cómo configurar políticas de autorización para los balanceadores de cargas de aplicaciones.

Antes de comenzar

Configura el balanceador de cargas

Si no creaste un balanceador de cargas, consulta las siguientes páginas para configurar el balanceador de cargas de aplicaciones que prefieras:

Crea una política de autorización

Para crear una política de autorización, crea un archivo YAML que defina el destino y las reglas y, luego, importa el archivo con el comando gcloud network-security authz-policies.

En esta sección, se proporcionan instrucciones para crear políticas de autorización adjuntas a la regla de reenvío de los balanceadores de cargas de aplicaciones.

Para obtener más información sobre cómo crear una política de autorización para un Agent Gateway que delega la autorización con Service Extensions, consulta Delega la autorización con Service Extensions.

Si quieres obtener más información para crear una política de autorización para un Secure Web Proxy, consulta Configura políticas de autorización para Secure Web Proxy.

Política de autorización para rechazar solicitudes

En esta sección, se proporcionan ejemplos de políticas de autorización que rechazan solicitudes en función de ciertos atributos de solicitud.

Rechazar solicitudes basadas en rangos de direcciones IP

En esta sección, se proporciona un ejemplo de política de autorización que rechaza las solicitudes en función de las solicitudes que se originan en rangos de direcciones IP específicos.

Global y entre regiones

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-deny.yaml para la regla de reenvío LB_FORWARDING_RULE en la ubicación global. La política deniega a los clientes con direcciones IP en el rango 10.0.0.0/24 para acceder a la ruta de URL /api/payments.

    cat >authz-policy-deny.yaml <<EOF
    name: my-authz-policy-deny
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules/LB_FORWARDING_RULE"
    httpRules:
    - from:
        sources:
        - ipBlocks:
          - prefix: "10.0.0.0"
            length: "24"
    - to:
        operations:
        - paths:
          - prefix: "/api/payments"
    action: DENY
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos globales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-deny \
        --source=authz-policy-deny.yaml \
        --location=global
    

Regional

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-deny.yaml para la regla de reenvío LB_FORWARDING_RULE en una regiónGoogle Cloud . La política deniega el acceso a la ruta de URL /api/payments a los clientes con direcciones IP en el rango 10.0.0.0/24.

    cat >authz-policy-deny.yaml <<EOF
    name: my-authz-policy-deny
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    httpRules:
    - from:
        sources:
        - ipBlocks:
          - prefix: "10.0.0.0"
            length: "24"
    - to:
        operations:
        - paths:
          - prefix: "/api/payments"
    action: DENY
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: Es tu región de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-deny \
        --source=authz-policy-deny.yaml \
        --location=LOCATION
    

Rechaza solicitudes según las principales del certificado de cliente

En esta sección, se proporciona un ejemplo de política de autorización que rechaza las solicitudes en función de las principales de certificados de cliente.

Global y entre regiones

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-deny.yaml para la regla de reenvío LB_FORWARDING_RULE en la ubicación global. La política deniega el acceso a la ruta de URL /api/payments a los clientes que tienen www.example.com en los SAN de nombre de DNS de su certificado de cliente.

    cat >authz-policy-deny.yaml <<EOF
    name: my-authz-policy-deny
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules/LB_FORWARDING_RULE"
    httpRules:
    - from:
        sources:
        - principals:
          - principalSelector: CLIENT_CERT_DNS_NAME_SAN
            principal:
              exact: "www.example.com"
      to:
        operations:
        - paths:
          - prefix: "/api/payments"
    action: DENY
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos globales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Para crear la política de autorización, importa el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-deny \
        --source=authz-policy-deny.yaml \
        --location=global
    

Regional

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-deny.yaml para la regla de reenvío LB_FORWARDING_RULE en una regiónGoogle Cloud . La política deniega el acceso a la ruta de URL /api/payments a los clientes que tienen www.example.com en los SAN de nombre de DNS de su certificado de cliente.

    cat >authz-policy-deny.yaml <<EOF
    name: my-authz-policy-deny
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    policyProfile: REQUEST_AUTHZ
    httpRules:
    - from:
        sources:
        - principals:
          - principalSelector: CLIENT_CERT_DNS_NAME_SAN
            principal:
              exact: "www.example.com"
      to:
        operations:
        - paths:
          - prefix: "/api/payments"
    action: DENY
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: Es tu región de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-deny \
        --source=authz-policy-deny.yaml \
        --location=LOCATION
    

Política de autorización para permitir solicitudes

En esta sección, se proporciona un ejemplo de política de autorización que permite solicitudes que se originan en rangos de direcciones IP específicos.

Global y entre regiones

Si usas un balanceador de cargas de aplicaciones externo global o un balanceador de cargas de aplicaciones interno entre regiones, sigue estos pasos para crear una política de autorización:

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-allow.yaml para la regla de reenvío LB_FORWARDING_RULE en la ubicación global. La política permite que los clientes con direcciones IP en el rango 10.0.0.0/24 accedan a la ruta de URL /api/payments.

    cat >authz-policy-allow.yaml <<EOF
    name: my-authz-policy-allow
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules/LB_FORWARDING_RULE"
    httpRules:
    - from:
        sources:
        - ipBlocks:
          - prefix: "10.0.0.0"
            length: "24"
      to:
        operations:
        - paths:
          - exact: "/api/payments"
    action: ALLOW
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos globales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-allow \
        --source=authz-policy-allow.yaml \
        --location=global
    

Regional

Si usas un balanceador de cargas de aplicaciones externo regional o un balanceador de cargas de aplicaciones interno regional, sigue estos pasos para crear e importar una política de autorización:

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-allow.yaml para la regla de reenvío LB_FORWARDING_RULE en una región Google Cloud específica. La política permite que los clientes con direcciones IP en el rango 10.0.0.0/24 accedan a la ruta de URL /api/payments.

    cat >authz-policy-allow.yaml <<EOF
    name: my-authz-policy-allow
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    policyProfile: REQUEST_AUTHZ
    httpRules:
    - from:
        sources:
        - ipBlocks:
          - prefix: "10.0.0.0"
            length: "24"
      to:
        operations:
        - paths:
          - exact: "/api/payments"
    action: ALLOW
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: Es tu región de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-allow \
        --source=authz-policy-allow.yaml \
        --location=LOCATION
    

Política de autorización basada en cuentas de servicio o etiquetas

Puedes aplicar una política de autorización basada en cuentas de servicio o etiquetas seguras adjuntas a varios recursos de Google Cloud .

En este ejemplo, se supone que ya hiciste lo siguiente:

Cuenta de servicio

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-deny.yaml para la regla de reenvío LB_FORWARDING_RULE de un balanceador de cargas de aplicaciones interno regional. La política está configurada para rechazar solicitudes de un recurso Google Cloud , como una VM de Compute Engine, con la cuenta de servicio my-sa-123@PROJECT_ID.iam.gserviceaccount.com para alcanzar la ruta de acceso /api/payments.

    cat >authz-policy-deny.yaml <<EOF
    name: my-authz-policy-deny
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    policyProfile: REQUEST_AUTHZ
    httpRules:
    - from:
        sources:
        - resources:
           - iamServiceAccount:
               exact: "my-sa-123@PROJECT_ID.iam.gserviceaccount.com"
      to:
        operations:
        - paths:
          - prefix: "/api/payments"
    action: DENY
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones internos regionales y entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: Es tu región de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-deny \
        --source=authz-policy-deny.yaml \
        --location=LOCATION
    

    Reemplaza LOCATION por tu región de Google Cloud .

Etiqueta

  1. Define la política de autorización en un archivo YAML.

    En el siguiente ejemplo, se crea un archivo authz-policy-allow.yaml para la regla de reenvío LB_FORWARDING_RULE de un balanceador de cargas de aplicaciones interno regional. La política solo permite solicitudes que se originan en un recurso de Google Cloud , como una VM de Compute Engine, con un valor de etiqueta segura TAG_VALUE_PERMANENT_ID para acceder a la ruta de URL de/api/payments.

    cat >authz-policy-allow.yaml <<EOF
    name: my-authz-policy-allow
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    policyProfile: REQUEST_AUTHZ
    httpRules:
    - from:
      sources:
        resources:
        - tagValueIdSet:
          - ids: "TAG_VALUE_PERMANENT_ID"
      to:
        operations:
        - paths:
          - exact: "/api/payments"
    action: ALLOW
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones internos regionales y entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: Es tu región de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
    • TAG_VALUE_PERMANENT_ID: Es el ID permanente de un valor de etiqueta.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-allow \
        --source=authz-policy-allow.yaml \
        --location=LOCATION
    

    Reemplaza lo siguiente:

    • LOCATION: Es tu región de Google Cloud .

Política de autorización para delegar decisiones de autorización

En los ejemplos de esta sección, se crea una política de autorización que delega las decisiones de autorización a los siguientes servicios a través de las extensiones de servicio:

Delega la decisión de autorización a un servicio administrado por el usuario

Puedes configurar una política de autorización para delegar la decisión de autorización a un servicio administrado por el usuario a través de extensiones de servicio, específicamente una extensión de autorización.

  • Para los balanceadores de cargas globales y entre regiones, la extensión de autorización se puede ejecutar en un servicio de backend de Google Cloud administrado por el usuario.

  • En el caso de los balanceadores de cargas regionales, la extensión de autorización se puede ejecutar tanto en un servicio de backend de Google Cloud administrado por el usuario como en un servicio basado en FQDN.

En este ejemplo de configuración, se supone que creaste un servicio de backend Google Cloud administrado por el usuario, también conocido como servicio de backend de texto destacado, llamado authz-service. Para obtener más información sobre cómo crear uno, consulta Configura un servicio de backend de texto destacado administrado por el usuario.

Para un servicio basado en FQDN, en esta configuración de ejemplo, se supone que el servicio personalizado se implementa en tu propia VPC, admite el protocolo ext_authz y se puede acceder a él con el nombre de dominio completamente calificado mycustomauthz.internal.net.

Global y entre regiones

Si usas un balanceador de cargas de aplicaciones externo global o un balanceador de cargas de aplicaciones interno entre regiones, sigue estos pasos para delegar la decisión de autorización al servicio administrado por el usuario.

  1. Define la extensión de autorización en un archivo YAML. La extensión de autorización se ejecuta en un servicio de backend (authz-service) y admite el protocolo ext_authz.

    cat >authz-extension.yaml <<EOF
    name: my-authz-ext
    authority: ext11.com
    loadBalancingScheme: LB_SCHEME
    service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/authz-service
    forwardHeaders:
      - Authorization
    failOpen: false
    timeout: "0.1s"
    wireFormat: EXT_AUTHZ_GRPC
    EOF
    
  2. Importa el archivo YAML de la extensión de autorización con el comando gcloud service-extensions authz-extensions import para crear la extensión de autorización.

    gcloud service-extensions authz-extensions import my-authz-ext \
        --source=authz-extension.yaml \
        --location=global
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos globales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  3. Define la política de autorización en un archivo YAML. La política de autorización delega la autorización a la extensión de autorización en el campo customProvider.

    La política llama a la extensión de autorización my-authz-ext para todo el tráfico a la ruta de URL example.com/api/payments cuando la solicitud contiene un encabezado Authorization no vacío.

    cat >authz-policy-custom.yaml <<EOF
    name: my-authz-policy-custom
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules/LB_FORWARDING_RULE"
    httpRules:
    - to:
        operations:
        - hosts:
          - exact: "example.com"
        - paths:
          - exact: "/api/payments"
      when: 'request.headers["Authorization"] != ""'
    action: CUSTOM
    customProvider:
      authzExtension:
        resources:
        - "projects/PROJECT_ID/locations/global/authzExtensions/my-authz-ext"
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos globales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  4. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-custom \
        --source=authz-policy-custom.yaml \
        --location=global
    

Regional

Si usas un balanceador de cargas de aplicaciones externo regional o un balanceador de cargas de aplicaciones interno regional, sigue estos pasos para delegar la decisión de autorización a un servicio administrado por el usuario.

  1. Define la extensión de autorización en un archivo YAML. La extensión de autorización puede ejecutarse en un servicio de backend o en un servicio basado en FQDN.

    cat >authz-extension.yaml <<EOF
    name: my-authz-ext
    authority: ext11.com
    loadBalancingScheme: LB_SCHEME
    service: BACKEND_SERVICE_URI_OR_FQDN
    forwardHeaders:
      - Authorization
    failOpen: false
    timeout: "0.1s"
    wireFormat: EXT_AUTHZ_GRPC
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
    • BACKEND_SERVICE_URI_OR_FQDN: El servicio puede ser cualquiera de los siguientes:
      • un URI de recurso de servicio de backend regional con el formato https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/backendServices/authz-service.
      • un nombre de dominio completamente calificado (por ejemplo, mycustomauthz.extension.net) que Cloud DNS pueda resolver.
  2. Importa el archivo YAML de la extensión de autorización con el comando gcloud service-extensions authz-extensions import para crear la extensión de autorización.

    gcloud service-extensions authz-extensions import my-authz-ext \
        --source=authz-extension.yaml \
        --location=LOCATION
    

    Reemplaza LOCATION por la región de Google Cloud en la que se configura el servicio de backend de llamada.

  3. Define la política de autorización en un archivo YAML. La política de autorización delega la autorización a la extensión de autorización en el campo customProvider.

    La política llama a la extensión de autorización my-authz-ext para todo el tráfico a la ruta de URL example.com/api/payments cuando la solicitud contiene un encabezado Authorization no vacío.

    cat >authz-policy-custom.yaml <<EOF
    name: my-authz-policy-custom
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    policyProfile: REQUEST_AUTHZ
    httpRules:
    - to:
        operations:
        - paths:
          - exact: "/api/payments"
      when: 'request.headers["Authorization"] != ""'
    action: CUSTOM
    customProvider:
      authzExtension:
        resources:
        - "projects/PROJECT_ID/locations/LOCATION/authzExtensions/my-authz-ext"
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: La Google Cloud región
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  4. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-custom \
        --source=authz-policy-custom.yaml \
        --location=LOCATION
    

    Reemplaza LOCATION por la región de Google Cloud en la que se configuró el balanceador de cargas.

Para obtener más información sobre las extensiones de autorización, consulta Cómo configurar una extensión de autorización.

Delega la decisión de autorización a Model Armor

Puedes configurar una política de autorización para delegar la decisión de autorización en Model Armor.

Antes de comenzar, crea una plantilla de Model Armor. En esta configuración de ejemplo, la política de autorización apunta a una extensión de autorización, que, a su vez, apunta a Model Armor.

Si usas un balanceador de cargas de aplicaciones externo regional o un balanceador de cargas de aplicaciones interno regional, sigue estos pasos para delegar la decisión de autorización a Model Armor.

Regional

  1. Define la extensión de autorización en un archivo YAML. La extensión de autorización apunta a las plantillas de solicitud y respuesta de Model Armor.

    cat >authz-extension.yaml <<EOF
    name: my-authz-extension
    loadBalancingScheme: INTERNAL_MANAGED
    service: modelarmor.LOCATION.rep.googleapis.com
    metadata:
      model_armor_settings: '[
        {
        "response_template_id": "projects/PROJECT_ID/locations/LOCATION/templates/RESPONSE_TEMPLATE_ID",
        "request_template_id": "projects/PROJECT_ID/locations/LOCATION/templates/REQUEST_TEMPLATE_ID"
        }
      ]'
    failOpen: true
    EOF
    

    Reemplaza lo siguiente:

    • LOCATION: Es la ubicación de la plantilla.
    • PROJECT_ID: Es el ID del proyecto al que pertenece la plantilla.
    • RESPONSE_TEMPLATE_ID: Es el ID de la plantilla de respuesta.
    • REQUEST_TEMPLATE_ID: Es el ID de la plantilla de solicitud.
  2. Importa el archivo YAML de la extensión de autorización con el comando gcloud service-extensions authz-extensions import para crear la extensión de autorización.

    gcloud service-extensions authz-extensions import my-authz-ext \
      --source=authz-extension.yaml \
      --location=LOCATION
    

    Reemplaza LOCATION por la región de Google Cloud en la que se encuentra el balanceador de cargas.

  3. Define la política de autorización en un archivo YAML. La política de autorización delega la autorización a la extensión de autorización en el campo customProvider.

    El valor de policyProfile es CONTENT_AUTHZ.

    cat >authz-policy-custom.yaml <<EOF
    name: my-authz-policy-custom
    target:
      loadBalancingScheme: INTERNAL_MANAGED
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    policyProfile: CONTENT_AUTHZ
    action: CUSTOM
    customProvider:
      authzExtension:
        resources:
        - "projects/PROJECT_ID/locations/LOCATION/authzExtensions/my-authz-ext"
    EOF
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: La Google Cloud región
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  4. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-custom \
      --source=authz-policy-custom.yaml \
      --location=LOCATION
    

    Reemplaza LOCATION por la región de Google Cloud en la que se configuró el balanceador de cargas.

Delega la decisión de autorización a Identity-Aware Proxy

En el caso de los balanceadores de cargas de aplicaciones externos globales y los balanceadores de cargas de aplicaciones internos entre regiones, no puedes delegar la decisión de autorización a IAP a través de una extensión de autorización. Para estos balanceadores de cargas, puedes delegar la decisión de autorización a IAP a través del campo customProvider en el recurso de la política de autorización.

En el caso de los balanceadores de cargas de aplicaciones externos regionales y los balanceadores de cargas de aplicaciones internos regionales, puedes configurar una política de autorización para delegar la decisión de autorización a IAP a través de una extensión de autorización.

Global y entre regiones

En el siguiente ejemplo, todas las decisiones de autorización se delegan a IAP para todas las solicitudes que se originan en el bloque de direcciones IP 10.0.0.0/24. Si las solicitudes se originan en cualquier dirección IP fuera de 10.0.0.0/24, no coinciden con esta política y no las evalúa IAP según esta regla específica.

  1. Define la política de autorización en un archivo YAML. La política de autorización delega la autorización a IAP a través del campo customProvider.

    cat >authz-policy-iap.yaml <<EOF
    name: my-authz-policy-custom
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules/LB_FORWARDING_RULE"
    httpRules:
      - from:
          sources:
          - ipBlock:
            - prefix: "10.0.0.0"
              length: 24
    action: CUSTOM
    customProvider:
      cloudIap: {}
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos globales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-custom \
        --source=authz-policy-iap.yaml \
        --location=global
    

Regional

Si usas un balanceador de cargas de aplicaciones externo regional o un balanceador de cargas de aplicaciones interno regional, sigue estos pasos para delegar la decisión de autorización a IAP con una extensión de autorización.

  1. Define la extensión de autorización en un archivo YAML. La extensión de autorización apunta a IAP.

    cat >authz-extension.yaml <<EOF
    name: my-authz-ext
    loadBalancingScheme: LB_SCHEME
    service: iap.googleapis.com
    failOpen: false
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
  2. Importa el archivo YAML de la extensión de autorización con el comando gcloud service-extensions authz-extensions import para crear la extensión de autorización.

    gcloud service-extensions authz-extensions import my-authz-ext \
        --source=authz-extension.yaml \
        --location=LOCATION
    

    Reemplaza LOCATION por la región de Google Cloud en la que se configura la extensión de autorización.

  3. Define la política de autorización en un archivo YAML. La política de autorización delega la autorización a la extensión de autorización en el campo customProvider.

    cat >authz-policy-custom.yaml <<EOF
    name: my-authz-policy-custom
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    policyProfile: REQUEST_AUTHZ
    action: CUSTOM
    customProvider:
      authzExtension:
        resources:
        - "projects/PROJECT_ID/locations/LOCATION/authzExtensions/my-authz-ext"
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: La Google Cloud región
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  4. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-custom \
        --source=authz-policy-custom.yaml \
        --location=LOCATION
    

    Reemplaza LOCATION por la región de Google Cloud en la que se configuró el balanceador de cargas.

Política de autorización para rechazar solicitudes de forma predeterminada

Una política de autorización con una acción DENY_BY_DEFAULT aplica un modelo de referencia seguro en el recurso objetivo, ya que bloquea todas las solicitudes, a menos que una política ALLOW o CUSTOM las permita de forma explícita. Esto garantiza que tu recurso permanezca protegido incluso si no se configuran políticas de ALLOW, como cuando solo se depende de políticas de CUSTOM (como IAP o extensiones de servicio) o durante el mantenimiento de políticas cuando las políticas de ALLOW se pueden quitar o actualizar de forma temporal.

En los siguientes pasos, se muestra cómo crear una política de autorización de DENY_BY_DEFAULT.

Interregión

  1. Define la política de autorización DENY_BY_DEFAULT en un archivo YAML.

    La política se orienta a la regla de reenvío del balanceador de cargas y bloquea todas las solicitudes que no estén permitidas de forma explícita por una política ALLOW o CUSTOM.

    cat >authz-policy-deny-by-default.yaml <<EOF
    name: my-authz-policy-deny-by-default
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules/LB_FORWARDING_RULE"
    action: DENY_BY_DEFAULT
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones internos entre regiones, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-deny-by-default \
        --source=authz-policy-deny-by-default.yaml \
        --location=global
    

    Esta política establece un modelo de referencia de seguridad de denegación predeterminada para tu balanceador de cargas. Para permitir o rechazar el tráfico de forma selectiva, crea políticas ALLOW, DENY o CUSTOM independientes.

Regional

  1. Define la política de autorización en un archivo YAML.

    La política se orienta a la regla de reenvío del balanceador de cargas y bloquea todas las solicitudes que no estén permitidas de forma explícita por una política ALLOW o CUSTOM.

    cat >authz-policy-deny-by-default.yaml <<EOF
    name: my-authz-policy-deny-by-default
    target:
      loadBalancingScheme: LB_SCHEME
      resources:
      - "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/LB_FORWARDING_RULE"
    action: DENY_BY_DEFAULT
    EOF
    

    Reemplaza lo siguiente:

    • LB_SCHEME: Es el esquema de balanceo de cargas. Para los balanceadores de cargas de aplicaciones externos regionales, establece el esquema en EXTERNAL_MANAGED. Para los balanceadores de cargas de aplicaciones internos regionales, establece el esquema en INTERNAL_MANAGED.
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • LOCATION: La Google Cloud región
    • LB_FORWARDING_RULE: el nombre de la regla de reenvío del balanceador de cargas.
  2. Crea la política de autorización importando el archivo YAML de la política de autorización con el comando gcloud network-security authz-policies import.

    gcloud network-security authz-policies import my-authz-policy-deny-by-default \
        --source=authz-policy-deny-by-default.yaml \
        --location=LOCATION
    

    Esta política establece un modelo de referencia de seguridad de denegación predeterminada para tu balanceador de cargas. Para permitir o rechazar el tráfico de forma selectiva, crea políticas ALLOW, DENY o CUSTOM independientes.

Registros de la política de autorización en Cloud Logging

Cuando se adjunta una política de autorización a la regla de reenvío de un balanceador de cargas, este registra las decisiones de autorización en Cloud Logging en el campo jsonPayload.authzPolicyInfo.

Entradas de registro

En los ejemplos de esta sección, se muestran entradas de registro abreviadas para las solicitudes HTTP que evalúa una política de autorización:

La solicitud no coincide con la política ALLOW ni con la política DENY

Cuando una solicitud no coincide con la política de DENY, la etapa de la política de DENY permite la solicitud y la registra como allowed_as_no_deny_policies_matched_request. Luego, la evaluación continúa con la etapa de la política ALLOW. Debido a que la solicitud no coincide con la política de ALLOW configurada, se rechaza y se registra como denied_as_no_allow_policies_matched_request.

Debido a que la etapa ALLOW rechazó la solicitud, el resultado general (jsonPayload.authzPolicyInfo.result) se registra como DENIED.

{
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry"
    authzPolicyInfo: {
      policies: [
        0: {
          details: "allowed_as_no_deny_policies_matched_request"
          result: "ALLOWED"
        }
        1: {
          details: "denied_as_no_allow_policies_matched_request"
          result: "DENIED"
        }
      ]
      result: "DENIED"
    }
  }
  ...
}

La solicitud coincide con la política DENY

Cuando una solicitud coincide con la política DENY, se rechaza de inmediato y se registra el nombre de la política que rechazó la solicitud.

{
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry"
    authzPolicyInfo: {
      policies: [
        0: {
          name: "projects/12345567/locations/global/authzPolicies/deny-authz-policy-test"
          result: "DENIED"
        }
      ]
      result: "DENIED"
    }
  }
  ...
}

La solicitud no coincide con la política DENY, pero sí con la política ALLOW

Cuando una solicitud no coincide con la política de DENY, la etapa de la política de DENY permite la solicitud y la registra como allowed_as_no_deny_policies_matched_request. Luego, la evaluación continúa con la etapa de la política ALLOW. Debido a que la solicitud coincide con la política ALLOW, la etapa ALLOW registra el nombre del recurso de la política coincidente en policies[1].name con el resultado como ALLOWED.

Debido a que la etapa ALLOW permitió la solicitud, el resultado general (jsonPayload.authzPolicyInfo.result) se registra como ALLOWED.

{
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry"
    authzPolicyInfo: {
      policies: [
        0: {
          details: "allowed_as_no_deny_policies_matched_request"
          result: "ALLOWED"
        }
        1: {
          name: "projects/12345567/locations/global/authzPolicies/allow-authz-policy-test"
          result: "ALLOWED"
        }
      ]
      result: "ALLOWED"
    }
  }
  ...
}

La solicitud coincide con la política DENY_BY_DEFAULT

Cuando configuras una política DENY_BY_DEFAULT en la regla de reenvío de un balanceador de cargas y no se configura ninguna política ALLOW (o ninguna política CUSTOM permitió la solicitud), la solicitud alcanza la etapa de evaluación de denegación predeterminada y se bloquea. Esta acción se registra como denied_by_default.

{
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry"
    authzPolicyInfo: {
      policies: [
        {
          details: "denied_by_default",
          result: "DENIED"
        }
      ],
      result: "DENIED"
    }
  }
  ...
}

Configura alertas de registros

Puedes configurar alertas para los eventos que las políticas de autorización escriben en Logging, como las denegaciones de tráfico o las coincidencias de políticas específicas. Para obtener instrucciones generales sobre cómo configurar estas alertas, consulta Configura alertas basadas en registros.

En esta sección, se proporcionan ejemplos de consultas que puedes usar para configurar alertas de eventos de políticas de autorización específicos. Para obtener más información sobre los diferentes nombres de registros y tipos de recursos para los balanceadores de cargas, consulta Cloud Load Balancing en la documentación de registros de la plataforma.

En la siguiente tabla, se describen el nombre del registro y el tipo de recurso para los diferentes balanceadores de cargas de aplicaciones:

Tipo de balanceador de cargas de aplicaciones Nombre del registro Tipo de recurso
Balanceador de cargas de aplicaciones externo global projects/PROJECT_ID/logs/requests http_load_balancer
Balanceador de cargas de aplicaciones externo regional projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Fexternal_regional_requests http_external_regional_lb_rule
Balanceador de cargas de aplicaciones interno regional en comparación con el balanceador de cargas de aplicaciones interno entre regiones. projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Frequests internal_http_lb_rule

Alerta para el tráfico que rechazó una política de autorización

Usa la siguiente consulta para activar una alerta cuando se rechace una solicitud en cualquier etapa del orden de evaluación de la política de autorización.

logName: "projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Fexternal_regional_requests"
resource.type="http_external_regional_lb_rule"
jsonPayload.authzPolicyInfo.result="DENIED"

Alerta de tráfico que se rechazó porque no coincidía con ninguna política de ALLOW configurada

Usa la siguiente consulta para activar una alerta cuando se rechace una solicitud porque no coincidió con ninguna política de ALLOW configurada:

logName: "projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Fexternal_regional_requests"
resource.type="http_external_regional_lb_rule"
jsonPayload.authzPolicyInfo.policies.details="denied_as_no_allow_policies_matched_request"

Alerta de tráfico denegado por una política de DENY_BY_DEFAULT

Usa la siguiente consulta para activar una alerta cuando una política de autorización con una acción DENY_BY_DEFAULT rechace una solicitud:

logName: "projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Fexternal_regional_requests"
resource.type="http_external_regional_lb_rule"
(jsonPayload.authzPolicyInfo.policies.details="denied_by_default" OR
jsonPayload.authzPolicyInfo.policies.details="denied_as_no_allow_policies_matched_request")

¿Qué sigue?