Encabezados de la solicitud

ID de región

REGION_ID es un código abreviado que Google asigna en función de la región que eliges cuando creas la app. El código no corresponde a un país ni a una provincia, aunque algunos ID de región puedan parecer similares a los códigos de país y provincia que se suelen usar. En el caso de las apps creadas después de febrero de 2020, REGION_ID.r se incluye en las URL de App Engine. En el caso de las apps existentes creadas antes de esta fecha, el ID de región es opcional en la URL.

Obtén más información acerca de los ID de región.

Usa esta página de referencia para obtener detalles sobre los encabezados HTTP compatibles. Para comprender cómo App Engine recibe solicitudes y envía respuestas, consulta Cómo se manejan las solicitudes.

Encabezados de la solicitud

Una solicitud HTTP entrante incluye los encabezados HTTP que envía el cliente. Por razones de seguridad, los proxies intermedios limpian, modifican o quitan algunos encabezados antes de que lleguen a la aplicación.

Encabezados que se quitan de las solicitudes entrantes

Los siguientes encabezados se quitan de las solicitudes entrantes si un cliente los envía:

  • Encabezados con nombres que coinciden con el patrón X-Google-*. Este patrón de nombre está reservado para Google

  • Encabezados con nombres que coinciden con encabezados específicos de App Engine. Solo se quitan las coincidencias exactas, que no distinguen entre mayúsculas y minúsculas. Por ejemplo, se quitarán los encabezados llamados X-Appengine-Country o X-AppEngine-Country, pero no X-Appengine-Cntry

Encabezados específicos de App Engine

Como un servicio para la app, App Engine agrega los siguientes encabezados a todas las solicitudes:

X-Appengine-Country
País donde se originó la solicitud, como un código de país ISO 3166-1 Alfa-2. App Engine define este código a partir de la dirección IP del cliente. Ten en cuenta que la información del país no proviene de la base de datos de WHOIS. Es posible que una dirección IP con información del país en la base de datos de WHOIS no tenga la información del país en el encabezado X-Appengine-Country. La aplicación debe controlar el código especial de país ZZ (país desconocido).
X-Appengine-Region
Nombre de la región donde se originó la solicitud. Este valor solo tiene sentido en el contexto del país en X -Appengine-Country. Por ejemplo, si el país es “EE.UU.” y la región es “ca”, significa “California”, no Canadá. La lista completa de valores de región válidos se encuentra en el estándar ISO-3166-2.
X-Appengine-City
Nombre de la ciudad donde se originó la solicitud. Por ejemplo, una solicitud de la ciudad de Mountain View puede tener el valor de encabezado mountain view. No hay una lista canónica de valores válidos para este encabezado. Si no se puede resolver la ciudad, el valor del encabezado se establece en ?.
X-Appengine-CityLatLong
La latitud y longitud de la ciudad donde se originó la solicitud. La string podría ser “37.386051,-122.083851” para una solicitud de Mountain View. Si no se puede resolver la ciudad, el valor del encabezado se establece en 0.000000,0.000000.
X-Cloud-Trace-Context
Un identificador único para la solicitud que se usa en Cloud Trace y Cloud Logging. No hay una opción para inhabilitar este encabezado o elegir la tasa de muestreo de seguimiento, ya que todas las apps del entorno estándar de App Engine se rastrean automáticamente.
X-Forwarded-For: CLIENT_IP,GLOBAL_FORWARDING_RULE_IP

Una lista delimitada por comas de direcciones IP a través de la que se enruta la solicitud del cliente. Cuando una solicitud pasa por el balanceador de cargas, este agrega dos direcciones IP al encabezado X-Forwarded-For en el siguiente orden:

  1. La dirección IP del cliente que se conecta al balanceador de cargas (CLIENT_IP).
  2. La dirección IP de la regla de reenvío del balanceador de cargas (GLOBAL_FORWARDING_RULE_IP).

Si una solicitud entrante no incluye este encabezado, el balanceador de cargas lo crea y lo agrega a la solicitud con el siguiente formato:

    X-Forwarded-For: CLIENT_IP,GLOBAL_FORWARDING_RULE_IP

Si una solicitud entrante ya incluye este encabezado (por ejemplo, si el cliente se enrutó a través de otros proxies), el balanceador de cargas agrega el encabezado con el siguiente formato:

    X-Forwarded-For: PREVIOUS_ENTRIES,CLIENT_IP,GLOBAL_FORWARDING_RULE_IP

En este ejemplo, las variables representan lo siguiente:

  • CLIENT_IP: Es la dirección IP del cliente que se conectó al balanceador de cargas.
  • GLOBAL_FORWARDING_RULE_IP: La dirección IP de la regla de reenvío del balanceador de cargas.
  • PREVIOUS_ENTRIES: Cualquier dirección IP anterior que haya enviado el cliente o los proxies anteriores.
X-Forwarded-Proto [http | https]

Muestra http o https según el protocolo que el cliente usó para conectarse a tu aplicación.

El balanceador de cargas de Google Cloud finaliza todas las conexiones https y reenvía el tráfico a instancias de App Engine a través de http. Por ejemplo, si un usuario solicita acceso a tu sitio a través de https://PROJECT_ID.REGION_ID.r.appspot.com, el valor del encabezado X- Forwarded-Proto es https.

Además, App Engine puede establecer los siguientes encabezados que son para su uso interno:

  • 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