Intestazioni delle richieste

ID regione

REGION_ID è un codice abbreviato che Google assegna in base alla regione selezionata durante la creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici di paesi e province di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Utilizza questa pagina di riferimento per informazioni dettagliate sulle intestazioni HTTP supportate. Per capire come App Engine riceve le richieste e invia le risposte, consulta la sezione Gestione delle richieste.

Intestazioni delle richieste

Una richiesta HTTP in entrata include le intestazioni HTTP inviate dal client. Per motivi di sicurezza, alcune intestazioni vengono sanificate, modificate o rimosse dai proxy intermedi prima di raggiungere l'applicazione.

Intestazioni rimosse dalle richieste in entrata

Le seguenti intestazioni vengono rimosse dalle richieste in entrata se un client le invia:

  • Intestazioni con nomi che corrispondono al pattern X-Google-*. Questo pattern di nome è riservato a Google.

  • Intestazioni con nomi che corrispondono alle intestazioni specifiche di App Engine. Vengono rimosse solo le corrispondenze esatte senza distinzione tra maiuscole e minuscole. Ad esempio, le intestazioni denominate X-Appengine-Country o X-AppEngine-Country verranno rimosse, ma X-Appengine-Cntry no.

Intestazioni specifiche di App Engine

Come servizio per l'app, App Engine aggiunge le seguenti intestazioni a tutte le richieste:

X-Appengine-Country
Il paese di origine della richiesta, come codice paese ISO 3166-1 alpha-2. App Engine determina questo codice dall'indirizzo IP del client. Tieni presente che le informazioni sul paese non derivano dal database WHOIS; è possibile che un indirizzo IP con informazioni sul paese nel database WHOIS non abbia informazioni sul paese nell'intestazione X-Appengine-Country. La tua applicazione deve gestire il codice paese speciale ZZ (paese sconosciuto).
X-Appengine-Region
Nome della regione da cui ha avuto origine la richiesta. Questo valore ha senso solo nel contesto del paese in X -Appengine-Country. Ad esempio, se il paese è "US" e la regione è "ca", "ca" indica "California", non Canada. L'elenco completo dei valori di regione validi è disponibile nello standard ISO-3166-2.
X-Appengine-City
Nome della città da cui ha avuto origine la richiesta. Ad esempio, una richiesta della città di Mountain View potrebbe avere il valore di intestazione mountain view. Non esiste un elenco canonico di valori validi per questa intestazione. Se la città non può essere risolta, il valore dell'intestazione viene impostato su ?.
X-Appengine-CityLatLong
Latitudine e longitudine della città da cui ha avuto origine la richiesta. Questa stringa potrebbe essere "37.386051,-122.083851" per una richiesta da Mountain View. Se non è possibile risolvere la città, il valore dell'intestazione viene impostato su 0.000000,0.000000.
X-Cloud-Trace-Context
Un identificatore univoco per la richiesta utilizzato per Cloud Trace e Cloud Logging. Non è disponibile un'opzione per disattivare questa intestazione o scegliere la frequenza di campionamento per la tracciabilità, poiché tutte le app dell'ambiente standard di App Engine vengono tracciate automaticamente.
X-Forwarded-For: CLIENT_IP,GLOBAL_FORWARDING_RULE_IP

Un elenco delimitato da virgole di indirizzi IP attraverso i quali è stata instradata la richiesta del client. Quando una richiesta passa attraverso il bilanciatore del carico, questo aggiunge due indirizzi IP all'intestazione X-Forwarded-For nel seguente ordine:

  1. L'indirizzo IP del client che si connette al bilanciatore del carico (CLIENT_IP).
  2. L'indirizzo IP della regola di forwarding del bilanciatore del carico (GLOBAL_FORWARDING_RULE_IP).

Se una richiesta in entrata non include questa intestazione, il bilanciatore del carico la crea e la aggiunge alla richiesta utilizzando il seguente formato:

    X-Forwarded-For: CLIENT_IP,GLOBAL_FORWARDING_RULE_IP

Se una richiesta in entrata include già questa intestazione (ad esempio, se il client è stato instradato tramite altri proxy), il bilanciatore del carico la aggiunge utilizzando il seguente formato:

    X-Forwarded-For: PREVIOUS_ENTRIES,CLIENT_IP,GLOBAL_FORWARDING_RULE_IP

In questo esempio, le variabili rappresentano quanto segue:

  • CLIENT_IP: l'indirizzo IP del client che si è connesso al bilanciatore del carico.
  • GLOBAL_FORWARDING_RULE_IP: l'indirizzo IP della regola di forwarding del bilanciatore del carico.
  • PREVIOUS_ENTRIES: tutti gli indirizzi IP precedenti inviati dal client o dai proxy precedenti.
X-Forwarded-Proto [http | https]

Mostra http o https in base al protocollo utilizzato dal client per connettersi all'applicazione.

Il bilanciatore del carico di Google Cloud termina tutte le connessioni https e poi inoltra il traffico alle istanze App Engine tramite http. Ad esempio, se un utente richiede l'accesso al tuo sito tramite https://PROJECT_ID.REGION_ID.r.appspot.com, il valore dell'intestazione X- Forwarded-Proto è https.

Inoltre, App Engine potrebbe impostare le seguenti intestazioni per l'uso interno da parte di App Engine:

  • X-Appengine-Https
  • X-Appengine-User-IP
  • X-Appengine-Api-Ticket
  • X-Appengine-Request-Log-Id
  • X-Appengine-Default-Version-Hostname
  • X-Appengine-Timeout-Ms