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 seleccionas 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(s)], [global forwarding rule IP]

Una lista delimitada por comas de direcciones IP a través de la que se enruta la solicitud del cliente. La primera IP de esta lista suele ser la IP del cliente que creó la solicitud. Las IP subsiguientes proporcionan información sobre los servidores proxy que también controlaron la solicitud antes de que se alcanzara el servidor de aplicaciones. Por ejemplo:

X-Forwarded-For: clientIp, proxy1Ip, proxy2Ip
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