Définir des en-têtes personnalisés

Media CDN vous permet de spécifier des en-têtes de requête et de réponse personnalisés.

Les en-têtes personnalisés vous permettent d'effectuer les opérations suivantes :

• Renvoyer les données géographiques du client, telles que le pays, la région ou la ville, que vous pouvez utiliser pour afficher du contenu localisé.
• Déterminer si une réponse a été diffusée à partir du cache (en partie ou complètement) et à partir de quel emplacement elle a été diffusée.
• Supprimez, remplacez ou ajoutez des en-têtes de requête et de réponse.

Vous pouvez également utiliser des en-têtes pour acheminer les requêtes vers différentes origines. Si vous devez configurer les en-têtes CORS (Cross-Origin Resource Sharing), configurez une règle CORS pour chaque route.

Appliquer des en-têtes personnalisés

Les en-têtes sont définis sur chaque route, ce qui vous permet d'ajouter et de supprimer des en-têtes pour différents contenus, tels que des fichiers manifestes ou des séquences vidéo.

Définissez des en-têtes de requête personnalisés par route au début du chemin de traitement du CDN, avant les décisions de mise en cache. Par exemple, si vous définissez un en-tête cache-control en tant qu'en-tête personnalisé par route, cela affecte le comportement de mise en cache dans le CDN.

Par défaut, les valeurs d'en-tête ajoutées sont séparées par une virgule et ajoutées aux en-têtes de réponse ou de requête avec les mêmes noms de champs.

Pour écraser les valeurs existantes, définissez replace sur true.

L'exemple .routing.pathMatchers[].routeRules[].headerAction suivant illustre l'ajout et la suppression d'en-têtes dans une ressource EdgeCacheService:

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"

Cet exemple effectue les opérations suivantes :

• Ajoute un en-tête client-geo personnalisé à la réponse à l'aide de la variable {client_region}, qui renvoie le pays (ou la région) associé à l'adresse IP du client.
• Ajoute un en-tête x-downstream-cdn personnalisé à la requête à l'aide d'une chaîne statique.
• Supprime deux en-têtes internes.

Pour configurer des en-têtes personnalisés spécifiques à l'origine, consultez la section Configurer des réécritures d'hôte ou des modifications d'en-tête spécifiques à l'origine.

Variables d'en-tête dynamiques

Les en-têtes personnalisés peuvent contenir une ou plusieurs variables dynamiques.

Les en-têtes de requête qui font partie de la règle de clé de cache (cacheKeyPolicy.includedHeaderNames) peuvent contenir une ou plusieurs variables personnalisées. Les en-têtes de requête contenant d'autres variables dynamiques ne peuvent pas faire partie de la clé de cache.

Les considérations suivantes s'appliquent aux variables personnalisées:

• Les en-têtes de requêtes et de réponses existants sont conservés, à l'exception des suivants, qui sont supprimés:

  • X-User-IP
  • Tous les en-têtes avec X-Google ou X-GFE

• Les clés et les valeurs d'en-tête doivent être conformes à la RFC 7230, les formats obsolètes n'étant pas acceptés.

• Toutes les clés d'en-tête sont en minuscules (conformément à la norme HTTP/2).

• Certains en-têtes sont fusionnés. Lorsqu'il existe plusieurs instances de la même clé d'en-tête (par exemple, Via), l'équilibreur de charge combine leurs valeurs dans une même liste d'éléments séparés par des virgules correspondant à une clé d'en-tête unique. Seuls les en-têtes dont les valeurs peuvent être représentées sous la forme d'une liste d'éléments séparés par des virgules sont fusionnés. Les autres en-têtes, tels que Set-Cookie, ne sont jamais fusionnés.

• Certains en-têtes sont ajoutés ou des valeurs leur sont ajoutées. Media CDN ajoute ou modifie toujours certains en-têtes, tels que Via et X-Forwarded-For.

• Media CDN développe tout en-tête de réponse contenant une variable compatible, même s'il est défini par le client ou l'origine. Cela vous permet de définir des en-têtes dynamiques provenant de votre client (tel qu'un lecteur vidéo) ou de votre infrastructure d'origine, en plus de configurer des en-têtes personnalisés. Media CDN ne développe pas les variables sur le chemin d'accès de la requête.

• Par exemple, conformément aux règles décrites précédemment, les en-têtes X-Goog- et X-Amz- sont conservés et mis en minuscules.

Valeurs d'état de cache

La variable d'en-tête {cdn_cache_status} peut renvoyer plusieurs valeurs correspondant au niveau de cache qui a diffusé la réponse. Tenez compte des consignes suivantes pour interpréter la variable d'en-tête {cdn_cache_status}:

• Si l'en-tête contient hit, le contenu demandé a été récupéré à partir du cache.
• Si l'en-tête contient miss, le contenu demandé n'a pas été trouvé dans un nœud de cache et a dû être extrait d'un nœud en amont.
• Si l'en-tête contient fetch, le contenu demandé a été extrait de l'origine.

• Si l'en-tête contient uncacheable, le contenu demandé a été considéré comme non mis en cache par certains ou tous les composants de l'infrastructure de mise en cache.

  • Si l'en-tête contient également hit ou miss, le contenu demandé a été considéré comme non mis en cache par certains composants de mise en cache et comme mis en cache par d'autres.
  • Si l'en-tête ne contient pas également hit ou miss, le contenu demandé a été considéré comme non enregistrable en cache par tous les composants de mise en cache, et toutes les requêtes pour ce contenu sont extraites de l'origine. Pour vous assurer que votre contenu est mis en cache de manière appropriée, consultez les exigences concernant les origines de Media CDN.

En-têtes par défaut

Media CDN ajoute respectivement les en-têtes de requête et de réponse suivants aux requêtes d'origine et aux réponses du client.

Les clés d'en-tête sont en minuscules pour les en-têtes de requête et de réponse, car elles ne sont pas sensibles à la casse.

D'autres en-têtes, y compris l'emplacement du point de présence (PoP) de périphérie et l'état du cache (hit et miss, par exemple), peuvent être ajoutés à l'aide de variables d'en-tête dynamiques.