Define encabezados personalizados

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

Los encabezados personalizados te permiten hacer lo siguiente:

• Devuelve datos geográficos sobre el cliente, como país, región o ciudad, que puedes usar para mostrar contenido localizado.
• Determinar si una respuesta se entregó desde la caché (en su totalidad o en parte) y desde qué ubicación de caché se entregó.
• Quitar, reemplazar o agregar a los encabezados de solicitud y respuesta

Cómo establecer encabezados personalizados

Los encabezados se configuran en cada ruta, lo que te permite agregar y quitar encabezados de distintos contenidos, como manifiestos o segmentos de video.

Configura encabezados de solicitud personalizados por ruta de forma anticipada en la ruta de procesamiento de la CDN, antes de las decisiones de almacenamiento en caché. Por ejemplo, si configuras un encabezado cache-control como un encabezado personalizado por ruta, se verá afectado el comportamiento del almacenamiento en caché en la CDN.

De forma predeterminada, los valores de encabezado agregados se separan con comas y se agregan a los encabezados de la solicitud o respuesta con los mismos nombres de campo.

Para reemplazar los valores existentes, establece replace en true.

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"
    }
  }
}

En este ejemplo, se realizan las acciones siguientes:

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

Para configurar encabezados personalizados específicos del origen, consulta Configura reescrituras del host o modificaciones de encabezado específicas del origen.

Variables de encabezado dinámico

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

Los encabezados de solicitud que forman parte de la política de claves de caché (cacheKeyPolicy.includedHeaderNames) pueden contener una o más 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:

• Se conservan los encabezados de solicitud y respuesta existentes, excepto los siguientes, que se quitan:

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

• Las claves y los valores de los encabezados deben cumplir con el RFC 7230, y no se permiten formatos obsoletos.

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

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

• Algunos encabezados se agregan o se les agregan valores. Media CDN siempre agrega o modifica ciertos encabezados, como X-Forwarded-For.

• Media CDN expande cualquier encabezado de respuesta con una variable compatible, incluso si la establece el cliente o el origen. Esto te permite establecer encabezados dinámicos desde tu cliente (como un reproductor de video) o infraestructura de origen, además de configurar encabezados personalizados. Media CDN no expande las variables en la ruta de acceso 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 que corresponden al nivel de caché que publicó la respuesta. Ten en cuenta los siguientes lineamientos para interpretar la variable de encabezado {cdn_cache_status}:

• Si el encabezado contiene hit, el contenido solicitado se recuperó de la caché.
• Si el encabezado contiene miss, el contenido solicitado no se encontró en un nodo de caché y se tuvo que recuperar de un nodo upstream.
• Si el encabezado contiene fetch, el contenido solicitado se recuperó del origen.

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

  • Si el encabezado también contiene hit o miss, algunos componentes de almacenamiento en caché consideraron que el contenido solicitado no se podía almacenar en caché, mientras que otros consideraron que sí.
  • Si el encabezado tampoco contiene hit o miss, todos los componentes de almacenamiento en caché consideraron que el contenido solicitado no se puede almacenar en caché, y todas las solicitudes de este contenido se recuperan del origen. Para asegurarte de que tu contenido se almacene en caché de forma adecuada, revisa los requisitos del origen de Media CDN.

Encabezados predeterminados

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

Las claves de encabezado están en minúsculas para los encabezados de solicitud y respuesta, ya que las claves de encabezado no distinguen mayúsculas de minúsculas.

Se pueden agregar otros encabezados, como la ubicación del punto de presencia (PoP) perimetral y el estado de la caché (como hit y miss), mediante variables de encabezado dinámicas.