Creare intestazioni personalizzate nelle mappe URL

Questa pagina descrive il funzionamento delle intestazioni personalizzate nelle mappe di URL utilizzate dai bilanciatori del carico delle applicazioni esterni regionali, dai bilanciatori del carico delle applicazioni interni regionali e dai bilanciatori del carico delle applicazioni interni tra regioni.

Le intestazioni delle richieste e delle risposte personalizzate ti consentono di specificare intestazioni aggiuntive che il bilanciatore del carico può aggiungere alle richieste e alle risposte HTTP(S). A seconda delle informazioni rilevate dal bilanciatore del carico, queste intestazioni possono includere le seguenti informazioni:

• Latenza al client
• Posizione geografica dell'indirizzo IP del client
• Parametri della connessione TLS

Prima di iniziare

Se necessario, esegui l'aggiornamento alla versione più recente di Google Cloud CLI:

gcloud components update

Come funzionano le intestazioni personalizzate

Le intestazioni personalizzate funzionano nel seguente modo:

• Quando il bilanciatore del carico invia una richiesta al backend, aggiunge le intestazioni di richiesta.

  Il bilanciatore del carico aggiunge le intestazioni delle richieste personalizzate solo alle richieste del client, non ai probe del controllo di integrità. Se il tuo backend richiede un'intestazione specifica per l'autorizzazione che non è presente nel pacchetto del controllo di integrità, il controllo di integrità potrebbe non riuscire.

• Il bilanciatore del carico imposta le intestazioni di risposta prima di restituire una risposta al client.

Per attivare le intestazioni personalizzate per i bilanciatori del carico delle applicazioni esterni regionali, i bilanciatori del carico delle applicazioni interni regionali e i bilanciatori del carico delle applicazioni interni tra regioni, specifica un elenco di nomi e valori di intestazione nel file di configurazione della mappa di URL.

I nomi delle intestazioni devono avere le seguenti proprietà:

• Il nome dell'intestazione deve essere una definizione valida del nome del campo dell'intestazione HTTP per RFC 7230.
• Il nome dell'intestazione non deve essere X-User-IP.
• Il nome dell'intestazione non deve iniziare con X-Google, X-Goog-, X-GFE o X-Amz-.
• Il nome dell'intestazione non deve essere Host o authority. Sia Host sia authority sono parole chiave speciali riservate a Google Cloud. Non puoi modificare queste righe di intestazione per i bilanciatori del carico basati su Envoy. Ti consigliamo invece di creare altre intestazioni personalizzate (ad es.MyHost) in modo da non interferire con i nomi delle intestazioni riservate.
• Un nome di intestazione non deve comparire più di una volta nell'elenco delle intestazioni.

I nomi delle intestazioni non fanno distinzione tra maiuscole e minuscole. Quando i nomi delle intestazioni vengono passati a un backend HTTP/2, il protocollo HTTP/2 codifica i nomi delle intestazioni in minuscolo.

I valori delle intestazioni devono avere le seguenti proprietà:

• Il valore dell'intestazione deve essere una definizione valida del campo di intestazione HTTP secondo il documento RFC 7230, con le forme obsolete non consentite.
• Il valore dell'intestazione non può essere vuoto. Le intestazioni vuote vengono rifiutate.
• Il valore dell'intestazione può includere una o più variabili, racchiuse tra parentesi graffe, che si espandono ai valori forniti dal bilanciatore del carico. Per un elenco completo delle variabili consentite nel valore dell'intestazione, consulta Variabili che possono apparire nel valore dell'intestazione.

Nei valori delle intestazioni, gli spazi iniziali e finali non sono significativi e non vengono trasmessi al backend. Per consentire le parentesi graffe nei valori dell'intestazione, il bilanciatore del carico interpreta due parentesi graffe di apertura ({{) come una singola parentesi graffa di apertura ({) e due parentesi graffe di chiusura (}}) come una singola parentesi graffa di chiusura (}).

Aggiungere intestazioni di richiesta o risposta

Per aggiungere intestazioni di richiesta o risposta, utilizza gcloud CLI per modificare la mappa URL nel seguente modo:

    gcloud compute url-maps edit URL_MAP_NAME \
        --region=REGION
    

   defaultService: regions/REGION/backendServices/BACKEND_SERVICE_1
   name: regional-lb-map
   region: region/REGION
   hostRules:
   - hosts:
     - '*'
     pathMatcher: matcher1
   pathMatchers:
   - defaultService: regions/REGION/backendServices/BACKEND_SERVICE_1
     name: matcher1
     routeRules:
       - matchRules:
           - prefixMatch: /PREFIX
         priority: PRIORITY # 0 is highest
         routeAction:
           weightedBackendServices:
             - backendService: regions/REGION/backendServices/BACKEND_SERVICE_1
               weight: 100
               headerAction:
                 requestHeadersToAdd:
                 - headerName: X-header-1-client-region
                   headerValue: "{client_region}"
                 - headerName: X-header-2-client-ip-port
                   headerValue: "{client_ip_address}, {client_port}"
                   replace: True
                 requesteHeadersToRemove:
                 - header-3-name
                 responseHeadersToAdd:
                 - headerName: X-header-4-server-ip-port
                   headerValue: "{server_ip_address}, {server_port}"
                   replace: True
                 responseHeadersToRemove:
                 - header-5-name
                 - header-6-name
    

Tieni presente i seguenti comportamenti:

• Se un'intestazione di risposta con variabili personalizzate risolve in una stringa vuota, viene rimossa.
• Se un'intestazione della richiesta con variabili personalizzate risolve in una stringa vuota, viene conservata con un segnaposto di stringa vuota.
• Se un'intestazione della richiesta personalizzata include una variabile personalizzata e una richiesta del client in arrivo include anche la stessa intestazione, il valore dell'intestazione della richiesta del client verrà sostituito con il nuovo valore fornito dall'intestazione personalizzata del bilanciatore del carico.

Variabili che possono apparire nel valore dell'intestazione

Le seguenti variabili possono essere visualizzate nei valori delle intestazioni personalizzate.

Il bilanciatore del carico espande le variabili in stringhe vuote quando non riesce a determinare i relativi valori. Ad esempio:

• Variabili di posizione geografica quando la posizione dell'indirizzo IP è sconosciuta
• Parametri TLS quando TLS non è in uso
• {origin_request_header} quando la richiesta non include un'intestazione Origin

I valori geografici sono stime basate sull'indirizzo IP del client. Di volta in volta, Google aggiorna i dati che forniscono questi valori per migliorare la precisione e riflettere i cambiamenti geografici e politici. Anche se l'intestazione X-Forwarded-For originale contiene informazioni sulla posizione valide, Google stima le posizioni dei client utilizzando le informazioni sull'indirizzo IP di origine contenute nei pacchetti ricevuti dal bilanciatore del carico.

Intestazioni personalizzate mutual TLS

Le seguenti variabili di intestazione aggiuntive sono disponibili se TLS mutuale (mTLS) è configurato su TargetHttpsProxy del bilanciatore del carico.

Limitazioni

La seguente limitazione si applica alle intestazioni personalizzate utilizzate con i bilanciatori del carico regionali:

• Non puoi configurare intestazioni personalizzate sui servizi di backend regionali utilizzati dai bilanciatori del carico delle applicazioni esterni regionali, dai bilanciatori del carico delle applicazioni interni regionali e dai servizi di backend globali utilizzati dai bilanciatori del carico delle applicazioni interni tra regioni.
• Le seguenti variabili di intestazione personalizzate non sono supportate con i bilanciatori del carico delle applicazioni esterni regionali:
  • cdn_cache_id
  • cdn_cache_status
  • client_region_subdivision
  • client_city
  • client_city_lat_long