Configuration de l’invalidation push pour le réseau de diffusion de contenu de production BYO

L’invalidation push purge automatiquement le contenu sur le réseau de diffusion de contenu de production du client (par ex. www.yourdomain.com), chaque fois qu’un auteur publie des modifications de contenu.

Le contenu est purgé par l’URL et par la balise/clé du cache.

La configuration de l’invalidation push nécessite 2 étapes :

Configuration

L’invalidation push est actuellement prise en charge pour les CDN des fournisseurs suivants :

L’invalidation push est activée en ajoutant des propriétés spécifiques à la configuration du projet (un classeur Excel nommé .helix/config.xlsx dans SharePoint ou une feuille Google nommée .helix/config dans Google Drive).

Les sections suivantes décrivent les propriétés spécifiques au fournisseur requises pour configurer l’invalidation push.

Fastly

Propriétés de configuration :

key
value
commentaire
cdn.prod.host
<Production Host>
Nom d’hôte du site de production, par exemple : www.yourdomain.com
cdn.prod.type
fastly
cdn.prod.serviceId
<Fastly Service ID>
Identifiant du service de production
cdn.prod.authToken
<Fastly API Token>

Création d’un jeton d’API rapide

  • accéder à Jetons API personnels,
  • cliquez sur "Créer un jeton",
  • saisissez un nom (par ex. "Production Site Purge Token"),
  • Sélectionnez "Un service spécifique" et votre service de production dans la liste déroulante,
  • cochez la case "Purge select content (purge_select) — Purge par URL ou clé de substitution",
  • sélectionnez "Ne jamais expirer",
  • cliquez sur "Créer un jeton",
  • copiez la valeur de jeton générée affichée dans la fenêtre contextuelle.

Vous pouvez valider les informations d’identification avec cette outil.

Akamai

Propriétés de configuration

key
value
commentaire
cdn.prod.host
<Production Host>
Nom d’hôte du site de production, par exemple : www.yourdomain.com
cdn.prod.type
akamai
cdn.prod.endpoint
<host>
Informations d’identification de l’API de purge rapide
cdn.prod.clientSecret
<client_secret>
Informations d’identification de l’API de purge rapide
cdn.prod.clientToken
<client_token>
Informations d’identification de l’API de purge rapide
cdn.prod.accessToken
<access_token>
Informations d’identification de l’API de purge rapide

L’invalidation push utilise la méthode API de purge rapide d’Akamai, en particulier Supprimer par URL et Supprimer par balise de cache.

Les informations d’identification de l’API de purge rapide se composent de

host = akaa-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.luna.akamaiapis.net
client_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX
client_secret = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
access_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX

Ils peuvent être générés en suivant les instructions de la section Création d’un client API avec des autorisations personnalisées.

Gestion des identités et des accès

Création d’un client API



Autorisations de groupe/rôle requises :

Vous pouvez valider les informations d’identification avec cette outil.

Cloudflare

Propriétés de configuration

key
value
commentaire
cdn.prod.host
<Production Host>
Nom d’hôte du site de production, par exemple : www.yourdomain.com
cdn.prod.type
cloudflare
cdn.prod.plan
e.g. free

values : free, pro, business, enterprise

par défaut : free

seul enterprise plan prend en charge la purge par balise

cdn.prod.zoneId
<Cloudflare Zone ID>
Identifiant de la zone de production
cdn.prod.apiToken
<Cloudflare API Token>

Création d’un jeton API

  • accéder à Jetons API
  • cliquez sur "Créer un jeton",
  • Accédez à "Créer un jeton personnalisé" en bas de l’écran et cliquez sur "Commencer".
  • saisissez un nom de jeton (par ex. "Production Site Purge Token"),
  • Autorisations : "Zone", "Purge du cache", "Purge"
  • Ressources de zone : "Inclure", "Zone spécifique", "&quot;<your production="" zone="">"
  • Cliquez sur "Continuer vers le résumé".
  • cliquez sur "Créer un jeton",
  • copiez la valeur de jeton générée.

Notez que seuls les sites sur le plan d’entreprise sont urgemment purgés par l’URL et la clé de cache. A Purger tout sera exécuté à la place sur des sites hors entreprise chaque fois qu’un auteur publie un changement de contenu.

Vous pouvez valider les informations d’identification avec cette outil.

CloudFront

NB: CloudFront ne prend PAS en charge la purge par balise/clé de cache. La purge par balise/clé de cache déclenche toujours une purge.

Propriétés de configuration

key
value
commentaire
cdn.prod.host
<Production Host>
Nom d’hôte du site de production, par exemple : www.yourdomain.com
cdn.prod.type
cloudfront
cdn.prod.distributionId
<Cloudfront Distribution ID>
cdn.prod.accessKeyId
<AWS Access key ID>
Informations d’identification AWS
cdn.prod.secretAccessKey
<AWS Secret access key>
Informations d’identification AWS

Création des informations d’identification AWS

Dans la console AWS, ouvrez le tableau de bord IAM :

Sélectionnez Utilisateurs -> Ajouter utilisateurs :

Saisissez un nom d'utilisateur et cochez "Access key - Programmatic access" :

Dans le volet "Définir les autorisations", cliquez sur "Créer un groupe" :

Saisissez un nom de groupe et sélectionnez la stratégie CloudFrontFullAccess :

Créez l’utilisateur :

Enfin, copiez les valeurs Identifiant de la clé d'accès et Clé d'accès secrète :

Vous pouvez valider les informations d’identification avec cette outil.

En-tête de requête d’opt-in

Le réseau de diffusion de contenu de production doit envoyer l’en-tête d’inclusion suivant à l’origine afin d’activer les TTL de cache long :

X-Push-Invalidation: enabled

recommendation-more-help
10a6ce9d-c5c5-48d9-8ce1-9797d2f0f3ec