Definir encabezados personalizados

Media CDN le permite especificar encabezados de solicitud y respuesta personalizados.

Los encabezados personalizados te permiten hacer lo siguiente:

• Devuelve datos geográficos sobre el cliente, como el país, la región o la ciudad, que puede usar para mostrar contenido localizado.
• Determina si una respuesta se ha servido desde la caché (total o parcialmente) y desde qué ubicación de la caché se ha servido.
• Eliminar, sustituir o añadir encabezados de solicitud y de respuesta.

Definir encabezados personalizados

Los encabezados se definen en cada ruta, lo que te permite añadir y quitar encabezados de diferentes contenidos, como manifiestos o segmentos de vídeo.

Define encabezados de solicitud personalizados por ruta al principio de la ruta de procesamiento de la CDN, antes de tomar decisiones sobre el almacenamiento en caché. Por ejemplo, si define un encabezado cache-control como encabezado personalizado por ruta, afectará al comportamiento de la caché en la CDN.

De forma predeterminada, los valores de encabezado añadidos se separan por comas y se añaden a los encabezados de respuesta o de solicitud con los mismos nombres de campo.

Para sobrescribir los valores actuales, asigna el valor true a replace.

gcloud edge-cache services describe prod-media-service

routeRules:
- priority: 1
   description: "video routes"
   matchRules:
      - prefixMatch: "/video/"
   headerAction:
      responseHeadersToAdd:
      # Return the country (or region) associated with the client's IP address.
      - headerName: "client-geo"
         headerValue: "{client_region}"
         replace: true
      requestHeadersToAdd:
      # Inform the upstream origin server the request is from Media CDN
      - headerName: "x-downstream-cdn"
         headerValue: "Media CDN"
      responseHeadersToRemove:
      - headerName: "X-User-ID"
      - headerName: "X-Other-Internal-Header"

route_rule {
  description = "video routes"
  priority    = 1
  match_rule {
    prefix_match = "/video/"
  }
  origin = google_network_services_edge_cache_origin.default.name
  header_action {
    response_header_to_add {
      # Return the country (or region) associated with the client's IP address.
      header_name  = "client-geo"
      header_value = "{client_region}"
      replace      = true
    }
    request_header_to_add {
      # Inform the upstream origin server that the request is from Media CDN.
      header_name  = "x-downstream-cdn"
      header_value = "Media CDN"
    }
    response_header_to_remove {
      header_name = "X-User-ID"
    }
    response_header_to_remove {
      header_name = "X-Other-Internal-Header"
    }
  }
}

Este ejemplo hace lo siguiente:

• Añade un encabezado client-geo personalizado a la respuesta mediante la variable {client_region}, que devuelve el país (o la región) asociado a la dirección IP del cliente.
• Añade un encabezado x-downstream-cdn personalizado a la solicitud mediante una cadena estática.
• Elimina dos encabezados internos.

Para configurar encabezados personalizados específicos de un origen, consulta Configurar reescrituras de host o modificaciones de encabezados específicos de un origen.

Variables de encabezado dinámicas

Los encabezados personalizados pueden contener una o varias variables dinámicas.

Los encabezados de solicitud que forman parte de la política de claves de caché (cacheKeyPolicy.includedHeaderNames) pueden contener una o varias variables personalizadas. Los encabezados de solicitud que contienen otras variables dinámicas no pueden formar parte de la clave de caché.

Las siguientes consideraciones se aplican a las variables personalizadas:

• Los encabezados de solicitud y respuesta se conservan, excepto los siguientes, que se eliminan:

  • X-User-IP
  • Cualquier encabezado con X-Google o X-GFE

• Las claves y los valores de los encabezados deben cumplir el RFC 7230 y no pueden tener formatos obsoletos.

• Todas las claves de encabezado están en minúsculas (según HTTP/2).

• Algunas cabeceras se han combinado. Cuando hay varias instancias de la misma clave de encabezado (por ejemplo, Via), el balanceador de carga combina sus valores en una sola lista separada por comas para una sola clave de encabezado. Solo se combinan los encabezados cuyos valores se pueden representar como una lista separada por comas. Otros encabezados, como Set-Cookie, nunca se combinan.

• Se añaden algunos encabezados o se les añaden valores. Media CDN siempre añade o modifica determinados encabezados, como X-Forwarded-For.

• Media CDN amplía cualquier encabezado de respuesta con una variable admitida, aunque la haya definido el cliente o el origen. De esta forma, puedes definir encabezados dinámicos desde tu cliente (como un reproductor de vídeo) o infraestructura de origen, además de configurar encabezados personalizados. Media CDN no sustituye las variables en la ruta de la solicitud.

• Por ejemplo, según las reglas descritas anteriormente, los encabezados X-Goog- y X-Amz- se conservan y se convierten a minúsculas.

Valores de estado de la caché

La variable de encabezado {cdn_cache_status} puede devolver varios valores correspondientes al nivel de caché que ha proporcionado la respuesta. Ten en cuenta las siguientes directrices para interpretar la variable de encabezado {cdn_cache_status}:

• Si el encabezado contiene hit, el contenido solicitado se ha obtenido de la caché.
• Si el encabezado contiene miss, significa que el contenido solicitado no se ha encontrado en un nodo de caché y se ha tenido que obtener de un nodo superior.
• Si el encabezado contiene fetch, el contenido solicitado se ha obtenido del origen.

• Si el encabezado contiene uncacheable, significa que algunos o todos los componentes de la infraestructura de almacenamiento en caché consideran que el contenido solicitado no se puede almacenar en caché.

  • Si el encabezado también contiene hit o miss, algunos componentes de la caché han considerado que el contenido solicitado no se puede almacenar en caché, mientras que otros sí.
  • Si el encabezado tampoco contiene hit ni miss, el contenido solicitado se ha considerado no almacenable en caché por todos los componentes de almacenamiento en caché y todas las solicitudes de este contenido se obtienen del origen. Para asegurarse de que su contenido se almacena en caché correctamente, consulte los requisitos de origen de Media CDN.

Encabezados predeterminados

Media CDN añade los siguientes encabezados de solicitud y respuesta a las solicitudes de origen y a las respuestas de cliente, respectivamente.

Las claves de encabezado se escriben en minúsculas tanto en los encabezados de solicitud como en los de respuesta, ya que no distinguen entre mayúsculas y minúsculas.

Se pueden añadir otros encabezados, como la ubicación del punto de presencia (PoP) de la periferia y el estado de la caché (por ejemplo, hit y miss), mediante variables de encabezado dinámicas.