Configurer l’invalidation push pour le réseau CDN de production BYO

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

Le contenu est purgé par URL et par balise/clé de cache.

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

Configuration

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

L’invalidation des notifications 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 des notifications push.

Rapide

Propriétés de configuration :

key
value
comment
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 de service du service de production
cdn.prod.authToken
<Fastly API Token>

Créer un jeton API Fastly

  • accédez à Jetons API personnels,
  • cliquez sur « Créer un jeton »,
  • saisissez un nom (par exemple, "Production Site Purge Token"),
  • sélectionnez « Un service spécifique » et votre service de production dans la liste déroulante.
  • cochez la case « Purger le contenu sélectionné (purge_select) — Purger par URL ou clé de substitution »,
  • sélectionner « Ne jamais expirer » ;
  • cliquez sur « Créer un jeton »,
  • copiez la valeur de jeton générée affichée dans la fenêtre pop-up.

Vous pouvez valider les informations d’identification à l’aide de cet outil.

Akamai

Propriétés de configuration

key
value
comment
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>
Purge rapide des informations d’identification d’API
cdn.prod.clientSecret
<client_secret>
Purge rapide des informations d’identification d’API
cdn.prod.clientToken
<client_token>
Purge rapide des informations d’identification d’API
cdn.prod.accessToken
<access_token>
Purge rapide des informations d’identification d’API

L’invalidation des notifications push utilise l’API de purge rapide Akamai, en particulier Supprimer par URL et Supprimer par balise de cache.

Les informations d’identification de l’API de purge rapide sont les suivantes :

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 à l’adresse Créer un client d’API avec des autorisations personnalisées.

Gestion des identités et des accès

Créer un client API



Autorisations de groupe/rôle requises :

Vous pouvez valider les informations d’identification à l’aide de cet outil.

Cloudflare

Propriétés de configuration

key
value
comment
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

valeurs : free, pro, business, enterprise

par défaut : free

seule la formule 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édez à Jetons API
  • cliquez sur « Créer un jeton »,
  • Accédez à « Créer un jeton personnalisé » en bas et cliquez sur « Commencer »
  • saisissez un nom de jeton (par exemple, "Production Site Purge Token"),
  • Autorisations : « Zone », « Purge du cache », « Purge »
  • Ressources de zone : « Inclure », « Zone spécifique », « <votre zone de production> »
  • 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 de l’offre d’entreprise seront purgés chirurgicalement par l’URL et la clé de cache. Une Tout purger sera effectuée à la place sur les sites qui ne sont pas des sites d’entreprise chaque fois qu’un auteur publie une modification de contenu.

Vous pouvez valider les informations d’identification à l’aide de cet 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 de tout.

Propriétés de configuration

key
value
comment
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 des utilisateurs :

Saisissez un nom d’utilisateur et cochez la case « Clé d’accès - Accès programmatique » :

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 ID de clé d’accès et Clé d’accès secrète :

Vous pouvez valider les informations d’identification à l’aide de cet 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 de souscription suivant à l’origine pour activer les TTL de cache longues :

X-Push-Invalidation: enabled

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