Definir cabeçalhos personalizados

Com a Media CDN, é possível especificar cabeçalhos personalizados de solicitação e resposta.

Com os cabeçalhos personalizados, você pode fazer o seguinte:

• Retorna dados geográficos sobre o cliente, como país, região ou cidade, que podem ser usados para mostrar conteúdo localizado.
• Determine se uma resposta foi veiculada do cache (total ou parcialmente) e de qual local de cache ela foi veiculada.
• Remover, substituir ou anexar aos cabeçalhos de solicitação e resposta.

Definir cabeçalhos personalizados

Os cabeçalhos são definidos em cada rota, o que permite adicionar e remover cabeçalhos para conteúdo diferente, como manifestos ou segmentos de vídeo.

Defina cabeçalhos de solicitação personalizados por rota no início do caminho de processamento da CDN, antes das decisões de cache. Por exemplo, se você definir um cabeçalho cache-control como um cabeçalho personalizado por rota, isso vai afetar o comportamento de armazenamento em cache na CDN.

Por padrão, os valores de cabeçalho adicionados são separados por vírgulas e anexados aos cabeçalhos de resposta ou solicitação com os mesmos nomes de campo.

Para substituir os valores atuais, defina replace como 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"
    }
  }
}

Este exemplo faz o seguinte:

• Adiciona um cabeçalho client-geo personalizado à resposta usando a variável {client_region}, que retorna o país (ou região) associado ao endereço IP do cliente.
• Adiciona um cabeçalho x-downstream-cdn personalizado à solicitação usando uma string estática.
• Remove dois cabeçalhos internos.

Para configurar cabeçalhos personalizados específicos da origem, consulte Configurar reescritas de host ou modificações de cabeçalho específicas da origem.

Variáveis de cabeçalho dinâmicas

Os cabeçalhos personalizados podem conter uma ou mais variáveis dinâmicas.

Os cabeçalhos de solicitação que fazem parte da política de chave de cache (cacheKeyPolicy.includedHeaderNames) podem conter uma ou mais variáveis personalizadas. Os cabeçalhos de solicitação que contêm outras variáveis dinâmicas não podem fazer parte da chave de cache.

As seguintes considerações se aplicam a variáveis personalizadas:

• Os cabeçalhos de solicitação e resposta atuais são preservados, exceto os seguintes, que são removidos:

  • X-User-IP
  • Qualquer cabeçalho com X-Google ou X-GFE

• As chaves e os valores de cabeçalho precisam estar em conformidade com a RFC 7230, com formulários obsoletos não permitidos.

• Todas as chaves de cabeçalho são convertidas em minúsculas (por HTTP/2).

• Alguns cabeçalhos são agrupados. Quando houver várias instâncias da mesma chave de cabeçalho (por exemplo, Via), o balanceador de carga combinará os valores delas em uma lista separada por vírgulas para uma chave de cabeçalho. Serão agrupados somente cabeçalhos com valores que possam ser representados como uma lista separada por vírgulas. Outros cabeçalhos, como Set-Cookie, nunca são agrupados.

• Alguns cabeçalhos são adicionados ou têm valores anexados a eles. A Media CDN sempre adiciona ou modifica determinados cabeçalhos, como X-Forwarded-For.

• A Media CDN expande qualquer cabeçalho de resposta com uma variável compatível, mesmo que definida pelo cliente ou pela origem. Isso permite definir cabeçalhos dinâmicos do cliente (como um player de vídeo) ou da infraestrutura de origem, além de configurar cabeçalhos personalizados. A Media CDN não expande variáveis no caminho da solicitação.

• Por exemplo, de acordo com as regras descritas anteriormente, os cabeçalhos X-Goog- e X-Amz- são preservados e convertidos para minúsculas.

Valores de status do cache

A variável de cabeçalho {cdn_cache_status} pode retornar vários valores correspondentes ao nível do cache que veiculou a resposta. Considere as seguintes diretrizes para interpretar a variável de cabeçalho {cdn_cache_status}:

• Se o cabeçalho contiver hit, o conteúdo solicitado foi recuperado do cache.
• Se o cabeçalho contiver miss, o conteúdo solicitado não foi encontrado em um nó de cache e precisou ser recuperado de um nó upstream.
• Se o cabeçalho contiver fetch, o conteúdo solicitado foi recuperado da origem.

• Se o cabeçalho contiver uncacheable, o conteúdo solicitado foi considerado não armazenável em cache por alguns ou todos os componentes da infraestrutura de cache.

  • Se o cabeçalho também contiver hit ou miss, o conteúdo solicitado será considerado não armazenável em cache por alguns componentes e armazenável em cache por outros.
  • Se o cabeçalho também não contiver hit ou miss, o conteúdo solicitado será considerado não armazenável em cache por todos os componentes de cache, e todas as solicitações desse conteúdo serão buscadas na origem. Para garantir que seu conteúdo seja armazenado em cache corretamente, revise os requisitos de origem do Media CDN.

Cabeçalhos padrão

A Media CDN adiciona os seguintes cabeçalhos de solicitação e resposta às solicitações de origem e respostas do cliente, respectivamente.

As chaves de cabeçalho são convertidas em letras minúsculas para cabeçalhos de solicitação e resposta porque não diferenciam maiúsculas de minúsculas.

Outros cabeçalhos, incluindo o local do ponto de presença (PoP) da borda e o status do cache (como hit e miss), podem ser adicionados usando variáveis de cabeçalho dinâmicas.