Configurer des tags de cache personnalisés - Edge Security Acceleration

Lorsque les points de présence (POPs) d'Edge Security Acceleration (ESA) reçoivent une ressource d'un serveur d'origine, ils recherchent un tag de cache, identifié par défaut dans l'en-tête Cache-Tag. La configuration de tags de cache personnalisés permet de modifier le nom du tag et d'ignorer la casse des valeurs.

Introduction

Fonctionnement de l'interaction des filtres

Lorsque vous envoyez une tâche de Purge du cache par tag, ESA actualise le contenu mis en cache selon les tags de cache et le paramètre de sensibilité à la casse. Le processus d'actualisation se déroule comme suit :

Remarque

La réponse du serveur d'origine doit inclure un tag de cache. Sinon, cette fonctionnalité ne fonctionne pas.

Vérifier si la réponse du serveur d'origine contient un tag de cache
- Aucun tag de cache : La fonctionnalité de purge par tag est indisponible.
- Tag de cache présent : Vérifiez la configuration des tags de cache du site.
Vérifier la configuration des tags de cache du site
- Aucun nom personnalisé configuré
  - La réponse du serveur d'origine inclut le tag de cache par défaut (Cache-Tag) :
    - Mode insensible à la casse désactivé : les ressources mises en cache sur les nœuds ESA reçoivent le tag Cache-Tag: Cat,Dog. Utilisez les valeurs Cat ou Dog pour actualiser le cache.
    - Mode insensible à la casse activé : une ressource mise en cache sur les nœuds ESA reçoit le tag Cache-Tag: cat,dog. Utilisez la valeur cat ou dog pour actualiser le cache.
  - Si une réponse du serveur d'origine contient un tag de cache personnalisé, tel que Edge-Cache-Tag, la fonctionnalité d'actualisation du cache par tag est inutilisable car ce tag n'est pas ajouté lors de la mise en cache de la ressource sur un nœud ESA.
- Nom personnalisé configuré (par exemple, Edge-Cache-Tag)
  - Les ressources dans la réponse du serveur d'origine portent le tag de cache par défaut (Cache-Tag). Ce tag n'est pas conservé lors de la mise en cache sur les nœuds ESA. Par conséquent, la fonctionnalité d'actualisation du cache par tag ne fonctionne pas.
  - La réponse du serveur d'origine inclut le tag de cache avec le nom personnalisé (par exemple, Edge-Cache-Tag) :
    - Correspondance insensible à la casse désactivée : le système ajoute le tag Edge-Cache-Tag: Cat,Dog lors de la mise en cache des ressources sur les nœuds ESA. Les valeurs Cat ou Dog permettent d'actualiser le cache.
    - Mode insensible à la casse activé : le tag Edge-Cache-Tag: cat,dog est ajouté lors de la mise en cache sur les nœuds ESA, ce qui permet d'utiliser les valeurs cat ou dog pour actualiser le cache.

Paramètres de configuration clés

Les tags de cache comportent les paramètres suivants :

Nom du tag de cache

Le nom par défaut est Cache-Tag.
Un nom de tag de cache personnalisé doit comporter entre 1 et 64 caractères.
Ce nom peut contenir des lettres majuscules (A–Z), des lettres minuscules (a–z), des chiffres (0–9) et des traits d'union (-).

Ignore Case

Cette fonctionnalité est désactivée par défaut. Ainsi, ESA considère CAT et cat comme des valeurs distinctes lors d'une opération d'actualisation du cache.
Une fois cette fonctionnalité activée, ESA convertit les valeurs des tags de cache des réponses d'origine en minuscules. Lors d'une opération d'actualisation du cache, CAT et cat sont alors traitées comme des valeurs identiques.

Configurer les tags de cache

Procédure

Dans la console ESA, accédez à Websites. Dans la colonne Website, cliquez sur le site cible.
Dans le volet de navigation de gauche, choisissez Caching > Settings.
Dans la section Cache Tag, cliquez sur le bouton Configuration situé à droite.
Configurez le Tag Name ainsi que le paramètre de sensibilité à la casse des valeurs de tag :
- Tag Name : Sélectionnez Use Custom Cache Tag Name et saisissez le nom de tag personnalisé ESA-Cache-Tag.
- Ignore Case : Activez ou désactivez ce paramètre selon vos besoins.

Exemples

Lors de la mise à jour d'images ou de pages sur un site e-commerce, il est souvent nécessaire de purger le cache ESA correspondant. Pour les images disposant de plusieurs versions recadrées, énumérer chaque variante est fastidieux. Privilégiez plutôt une purge groupée du cache ESA pour toutes les variantes associées au nom de l'image. De même, lors de l'itération sur des pages d'événements, purgez tout le cache ESA associé via un tag de version :

Purge par nom d'image

Scénario

Les trois images suivantes sont des versions recadrées de dog.jpg. Le serveur d'origine ajoute le tag ESA-Cache-Tag:dog.jpg aux trois fichiers :

dog_100_200.jpg
dog_200_200.jpg
dog_300_200.jpg

Les trois images ci-dessous sont des versions recadrées de cat.jpg. Le serveur d'origine ajoute le tag ESA-Cache-Tag:cat.jpg aux trois fichiers :

cat_100_200.jpg
cat_200_200.jpg
cat_300_200.jpg

Supprimez les images originales pour purger simultanément toutes les variantes mises en cache.

Exemple de configuration

Dans la console ESA, accédez à Site Management. Dans la colonne Website, cliquez sur le site cible.
Dans le volet de navigation de gauche, choisissez Caching > Settings.
Dans la section Cache Tag, cliquez sur le bouton Configuration situé à droite.
Configurez le Tag Name ainsi que le paramètre de sensibilité à la casse des valeurs de tag :
- Tag Name : Sélectionnez Use Custom Cache Tag Name et saisissez le nom de tag personnalisé ESA-Cache-Tag.
- Ignore Case : Activez ou désactivez ce paramètre selon vos besoins.
Dans le volet de navigation de gauche, choisissez Caching > Purge Cache.
Sous l'onglet Purge Cache, configurez la règle de purge et cliquez sur Submit :
- Type : Sélectionnez By Tag.
- Purge Method : Sélectionnez Delete.
- Purge Content : Saisissez les valeurs de tag à purger : cat.jpg,dog.jpg.

Purge par numéro de version

Scénario

Les six images suivantes ont été générées pour la version v0820. Le serveur d'origine ajoute le tag ESA-Cache-Tag:v0820 aux six fichiers :

dog_100_200_v0820.jpg
dog_200_200_v0820.jpg
dog_300_200_v0820.jpg
cat_100_200_v0820.jpg
cat_200_200_v0820.jpg
cat_300_200_v0820.jpg

Exemple de configuration

Dans la console ESA, accédez à Site Management. Dans la colonne Website, cliquez sur le site cible.
Dans le volet de navigation de gauche, choisissez Caching > Settings.
Dans la section Cache Tag, cliquez sur le bouton Configuration situé à droite.
Configurez le Tag Name ainsi que le paramètre de sensibilité à la casse des valeurs de tag :
- Tag Name : Sélectionnez Use Custom Cache Tag Name et saisissez le nom de tag personnalisé ESA-Cache-Tag.
- Ignore Case : Activez ou désactivez ce paramètre selon vos besoins.
Dans le volet de navigation de gauche, choisissez Caching > Purge Cache.
Sous l'onglet Purge Cache, configurez la règle de purge et cliquez sur Submit :
- Type : Sélectionnez By Tag.
- Purge Method : Sélectionnez Delete.
- Purge Content : Saisissez la valeur de tag à purger : v0820.