Configura le policy di limitazione di frequenza dei servizi

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questo documento descrive come configurare le policy di limitazione di frequenza servizi per Secure Web Proxy per proteggere i sistemi dai sovraccarichi di traffico e gestire i costi del traffico web in uscita.

Prima di iniziare

• Esamina le pagine Panoramica di Secure Web Proxy e Panoramica delle policy di limitazione di frequenza servizi.

• Abilita le seguenti API:

  • API Sicurezza di rete (networksecurity.googleapis.com)
  • API Network Services (networkservices.googleapis.com)

  Per abilitare le API, esegui il seguente comando:

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

• Assicurati che il tuo account utente disponga dei ruoli e delle autorizzazioni di amministratore necessari per configurare le risorse di Secure Web Proxy.

• Prima di poter creare una policy, un'istanza di Secure Web Proxy deve essere attiva. Per saperne di più, consulta Eseguire il deployment di un'istanza di Secure Web Proxy.

• (Facoltativo) Per creare una policy di limitazione di frequenza basata sulle identità dei certificati client (ad esempio CLIENT_CERT_COMMON_NAME), assicurati di configurare il protocollo TLS reciproco (mTLS) frontend.

Configurare una policy di limitazione di frequenza dei servizi

Per creare una policy di limitazione di frequenza dei servizi, definisci la configurazione in un file YAML e poi importala in Secure Web Proxy.

1. Crea il file my-rate-limit-policy.yaml e poi specifica i parametri della policy.

   L'esempio seguente limita il numero di richieste inviate a un fornitore di modelli linguistici di grandi dimensioni (LLM) (foo.com) a 100 richieste al minuto per ogni agente su un gateway Secure Web Proxy per il traffico in uscita. Ogni agente viene identificato dal nome comune nel relativo certificato client.

     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 "
   

   Sostituisci quanto segue:

   • PROJECT_ID: ID del tuo Google Cloud progetto
   • LOCATION: regione dell'istanza di Secure Web Proxy, ad esempio us-central1
   • GATEWAY_NAME: nome dell'istanza del gateway Secure Web Proxy

2. Importa il file YAML della policy di limitazione della frequenza utilizzando il seguente comando:

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

   Sostituisci LOCATION con la regione dell'istanza di Secure Web Proxy.

Passaggi successivi

• Informazioni su una voce di log della policy di limitazione della frequenza dei servizi
• Configurare gli avvisi di log per il traffico limitato