Configurar políticas de limitação de taxa de serviço

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Este documento descreve como configurar políticas de limitação de taxa de serviço para o proxy seguro da Web para proteger seus sistemas contra sobrecarga de tráfego e gerenciar os custos do tráfego de saída da Web.

Antes de começar

• Consulte as páginas Visão geral do proxy seguro da Web e Visão geral das políticas de limitação de taxa de serviço.

• Ative as APIs a seguir:

  • API de segurança de rede (networksecurity.googleapis.com)
  • API Network Services (networkservices.googleapis.com)

  Para ativar as APIs, execute o seguinte comando:

  gcloud services enable \
      networksecurity.googleapis.com \
      networkservices.googleapis.com
  

• Verifique se sua conta de usuário tem os papéis e permissões administrativos necessários para configurar recursos do Secure Web Proxy.

• Uma instância do Secure Web Proxy precisa estar ativa antes que você possa criar uma política. Para mais informações, consulte Implantar uma instância do Secure Web Proxy.

• Opcional: para criar uma política de limitação de taxa com base em identidades de certificado do cliente (como CLIENT_CERT_COMMON_NAME), configure o TLS mútuo (mTLS) de front-end.

Configurar uma política de limitação de taxa de serviço

Para criar uma política de limitação de taxa de serviço, defina a configuração em um arquivo YAML e importe esse arquivo para o Secure Web Proxy.

1. Crie o arquivo my-rate-limit-policy.yaml e especifique os parâmetros da política.

   O exemplo a seguir limita o número de solicitações enviadas a um provedor de modelo de linguagem grande (LLM) (foo.com) a 100 solicitações por minuto para cada agente em um gateway de Secure Web Proxy para tráfego de saída. Cada agente é identificado pelo nome comum no certificado do cliente.

     name: "projects/ PROJECT_ID /locations/ LOCATION /rateLimitPolicies/test-policy"
     description: "Simple agent for LLM rate limiting."
     httpRules:
     # Match on the provider host name.
     - to:
         destination:
           hosts:
           - exact: "foo.com"
   
       # default RPM bucket
       rateLimitActions:
       - rateLimitBucket: "rl_default_rpm_limit"
   
     rateLimitBuckets:
     - name: "rl_default_rpm_limit"
       # Identify client by its client cert name
       keys:
       - keyType: PRINCIPAL
         principalType: CLIENT_CERT_COMMON_NAME
       defaultLimit:
         countLimit:
           count: 100
           interval: 1
           intervalUnit: MINUTES
   
     targets:
     - resource: "projects/ PROJECT_ID /locations/ LOCATION /gateways/ GATEWAY_NAME "
   

   Substitua:

   • PROJECT_ID: ID do seu Google Cloud projeto
   • LOCATION: região da instância do Secure Web Proxy; por exemplo, us-central1
   • GATEWAY_NAME: nome da instância do gateway do Secure Web Proxy

2. Importe o arquivo YAML da política de limitação de taxa usando o seguinte comando:

   gcloud alpha network-security rate-limit-policies import test-policy \
     --source=my-rate-limit-policy.yaml \
     --location=LOCATION
   

   Substitua LOCATION pela região da instância do Secure Web Proxy.

A seguir

• Entender uma entrada de registro de política de limitação de taxa de serviço
• Configurar alertas de registro para tráfego limitado