Comprendre et configurer Cloudflare Page Rules (tutoriel Page Rules)

Les règles Page Rules déclenchent certaines actions lorsqu’une requête correspond à l’un des modèles d’URL que vous définissez. Découvrez comment créer et modifier des règles Page Rules et comprenez les différents paramètres disponibles.

​​ Dans cet article

• Aperçu Open external link
• Avant de commencer Open external link
• Créer une règle Page Rules Open external link
• Modifier une règle Page Rules Open external link
• Comprendre les correspondances et le référencement avec des caractères génériques Open external link
• Résumé des paramètres Page Rules Open external link
• Problèmes connus Open external link
• Informations complémentaires Open external link
• Ressources associées Open external link

​​ Aperçu

Vous pouvez définir une règle Page Rules pour déclencher une ou plusieurs actions chaque fois qu’un certain modèle d’URL est détecté. Les règles Page Rules sont disponibles dans l’application Rules, sur l’onglet Page Rules.

Le nombre de règles Page Rules autorisées par défaut dépend de l’offre souscrite pour le domaine, comme indiqué ci-dessous.

Vous pouvez acheter des règles supplémentaires Open external link (jusqu’à 100) pour les domaines possédant des offres Free, Pro et Business.

​​ Avant de commencer

Deux principes fondamentaux des règles Page Rules sont particulièrement importants :

• Seule la règle Page Rule dont la priorité est la plus élevée est appliquée à une requête.
• Les règles Page Rules sont classées par ordre de priorité décroissante dans le tableau de bord Cloudflare, la règle ayant la priorité la plus élevée se trouvant en haut.

Une règle Page Rule correspond à un modèle d’URL selon le format suivant (composé de quatre segments) : <scheme>://<hostname><:port>/<path>?<query\_string>

Voici un exemple d’URL comportant ces quatre composants :

https://www.exemple.com:443/image.png?parameter1=value1

Les segments scheme et port sont facultatifs. S’il n’est pas spécifié, scheme correspond aux protocoles http:// et https://. Si port n’est pas spécifié, la règle s’applique à tous les ports.

Enfin, vous pouvez désactiver une règle Page Rules à tout moment. Lorsqu’une règle est désactivée, les actions ne se déclenchent pas, mais la règle apparaît toujours dans l’application Rules sur l’onglet Page Rules ; elle est modifiable et prise en compte dans le nombre de règles autorisées pour votre domaine. L’option Save as Draft (Enregistrer comme brouillon) crée une règle Page Rules désactivée par défaut.

​​ Créer une règle Page Rules

Voici les étapes à suivre pour créer une règle Page Rules :

1. Connectez-vous au tableau de bord Cloudflare.
2. Sélectionnez le domaine pour lequel vous souhaitez ajouter la règle Page Rules.
3. Cliquez sur l’application Rules.
4. Sur l’onglet Page Rules , cliquez sur Create Page Rule (Créer une règle Page Rule). La boîte de dialogue Create Page Rule for (Créer une règle Page Rules pour) s’affiche.
5. Sous If the URL matches (Si l’URL correspond à), saisissez l’URL ou le modèle d’URL devant correspondre à la règle. En savoir plus sur la correspondance avec les caractères génériques Open external link
6. Ensuite, sous Then the settings are: (Les paramètres sont alors les suivants :), cliquez sur + Add a setting (+ Ajouter un paramètre), puis sélectionnez le paramètre souhaité dans la liste déroulante. Vous pouvez spécifier plusieurs paramètres par règle. Pour en savoir plus sur les paramètres, reportez-vous au récapitulatif ci-dessous Open external link .
7. Indiquez l’ordre souhaité dans la liste déroulant Order (Ordre) : First, Last (Premier, Dernier) ou Custom (Personnalisé).
8. Pour enregistrer, cliquez sur l’une des options suivantes :
   • Save as Draft (Enregistrer comme brouillon) pour enregistrer la règle et la laisser désactivée.
   • Save and Deploy (Enregistrer et activer) pour enregistrer la règle et l’activer immédiatement.

​​ Modifier une règle Page Rules

Pour modifier une règle existante :

1. Connectez-vous au tableau de bord Cloudflare.
2. Sélectionnez le domaine pour lequel vous souhaitez modifier une règle Page Rules.
3. Cliquez sur l’application Rules.
4. Sur l’onglet Page Rules, trouvez la règle que vous souhaitez modifier.
5. Effectuez les modifications nécessaires comme suit :
   • Pour activer ou désactiver une règle, cliquez sur le commutateur On/Off.
   • Pour modifier le modèle d’URL, les paramètres et l’ordre, cliquez sur le bouton Modifier (icône clé anglaise). Dans la boîte de dialogue, indiquez les informations que vous souhaitez modifier.
   • Pour supprimer une règle, cliquez sur le bouton Supprimer (icône x), puis confirmez en cliquant sur OK dans la boîte de dialogue Confirmer.

​​ Comprendre les correspondances et le référencement avec des caractères génériques

Vous pouvez utiliser l’astérisque (*) dans n’importe quel segment d’URL pour établir une correspondance avec certaines structures. Par exemple :

exemple.com/t*st

Correspond à :

exemple.com/test
exemple.com/toast
exemple.com/trust

exemple.com/foo/* ne correspond pas à exemple.com/foo. Toutefois, exemple.com/foo* correspond à la chaîne saisie.

​​ Conseils utiles

• Pour détecter à la fois des URL http et https, écrivez simplement exemple.com. Vous n’avez pas besoin d’écrire *.exemple.com.
• Pour établir une correspondance avec chaque page d’un domaine, saisissez exemple.com/*. Simplement saisir exemple.com ne suffit pas.
• Pour rendre en compte chaque page d’un domaine, écrivez *exemple.com/*. Il ne suffit pas d’écrire simplement_exemple.com_.
• Un caractère générique (*) dans l’URL d’une règle page Rule donnera un résultat même si aucun caractère n’est présent, et peut inclure n’importe quelle partie de l’URL, y compris la chaîne de requêtes.

​​ Référencement des correspondances avec des caractères génériques

Vous pouvez référencer les correspondances avec des caractères génériques ultérieurement, avec la syntaxe $X.X indique l’index d’un motif glob. Ainsi, $1 représente le premier caractère générique, $2 le deuxième caractère générique et ainsi de suite.

Cela est particulièrement utile avec le paramètre Forwarding URL (URL de redirection). Par exemple :

Vous pouvez rediriger :

http://*.exemple.com/*

Vers :

http://exemple.com/images/$1/$2.jpg

Cette règle correspondrait à :

http://cloud.exemple.com/flare.jpg

qui serait ensuite redirigé vers :

http://exemple.com/images/cloud/flare.jpg

Pour utiliser un caractère littéral $ dans l’URL de redirection, annulez sa valeur spéciale en ajoutant une barre oblique inversée (\) devant : \$.

​​ Résumé des paramètres Page Rules

Les paramètres contrôlent le comportement de Cloudflare lorsqu’une requête correspond au modèle d’URL défini dans une règle Page Rules. Vous pouvez utiliser des paramètres pour activer et désactiver plusieurs fonctions Cloudflare dans différentes applications du tableau de bord. Notez que :

• Certains paramètres nécessitent que votre domaine comporte une offre Pro, Business ou Enterprise.
• Vous pouvez définir plusieurs paramètres à appliquer en cas de déclenchement de la règle.

Vous trouverez ci-dessous la liste complète des paramètres disponibles, présentés dans l’ordre dans lequel ils apparaissent dans l’interface Cloudflare Page Rules.

​​ Problèmes connus

Problème de configuration de Page Rule entraînant une erreur de serveur interne « Error 500 (Internal server error) »

Cause profonde : ce problème peut être dû à un problème de configuration sur une Page Rule. Lors de la création d’une Page Rule qui utilise deux caractères génériques, comme une règle de redirection d’URL, il est possible de créer une règle qui mentionne le second caractère générique avec l’espace réservé $2. Voir l’exemple ci-dessous :

Lors de la mise à jour de la même règle, vous pouvez supprimer un des caractères génériques dans le champ If the URL matches (Si l’URL correspond à) et enregistrer votre mise à jour. Voir l’exemple ci-dessous :

Si vous procédez ainsi, l’espace réservé $2 renvoie à un caractère générique qui n’existe plus et, en conséquence, une erreur de type « Error 500 (Internal server error) » survient quand une URL déclenche la Page Rule.

Résolution : mettez à jour la Page Rule et supprimez la référence $2 au second caractère générique. S’il n’y a qu’un caractère générique, alors $1 peut être utilisé.

​​ Informations complémentaires

​​ Paramètre Bypass Cache on Cookie

Ce paramètre est disponible pour les clients Business et Enterprise.

Le paramètre Bypass Cache on Cookie (Ignorer le cache en présence d’un cookie) prend en charge les expressions régulières de base (regex) comme suit :

• Un opérateur | pour faire correspondre plusieurs cookies avec une logique booléenne OR. Par exemple, bypass=.*|PHPSESSID=.* ignore le cache si un cookie appelé bypass ou PHPSESSID est défini, quelle que soit la valeur du cookie.
• Un caractère générique (par exemple, .*) permet à la valeur « t.*st » de correspondre à la fois à un cookie nommé « test » et un cookie nommé « teeest ».

Voici certaines limitations :

• Limite de 150 caractères par regex de cookie
• 12 caractères génériques par regex de cookie
• 1 caractère générique entre chaque caractère | dans les regex de cookie

Pour apprendre comment configurer Bypass Cache on Cookie sur différentes plates-formes, consultez ces articles suivants :

• Mise en cache des consultations de pages anonymes avec WordPress ou WooCommerce Open external link
• Mise en cache des consultations de pages anonymes avec Magento 1 et Magento 2 Open external link
• Comment mettre en cache des contenus statiques HTML ? Open external link

Remarque : si vous ajoutez à la fois ce paramètre et le paramètre Cache On Cookie (Mettre en cache en présence d’un cookie) réservé aux domaines Enterprise à la même règle Page Rules, l’option Cache On Cookie est prioritaire sur Bypass Cache on Cookie (Ignorer le cache en présence d’un cookie).

​​ Chaque fois que le nom d’une zone apparaît, il doit finir par une barre oblique

Lors de l’enregistrement d’une Page Rule, Cloudflare vérifie qu’il y a une barre oblique chaque fois que le nom de la zone actuelle apparaît dans le champ If the URL matches. Par exemple, si le nom de la zone actuelle est exemple.com, alors :

• exemple.com sera enregistré en tant que exemple.com/
• exemple.com/path/exemple.com sera enregistré en tant que exemple.com/path/exemple.com/

Remarque : exemple.com/some-path/cloudflare.com sera enregistré sans barre oblique, puisque le nom de la zone n’est pas cloudflare.com.

​​ Ports réseau pris en charge par Page Rules

Si vous spécifiez un port dans le champ If the URL matches (Si l’URL correspond) d’une Page Rule, celui-ci doit être l’un des suivants :

• Un des ports HTTP/HTTPS compatible avec le proxy de Cloudflare.
• Un port personnalisé d’une application Cloudflare Spectrum HTTPS.

​​ Utilisation de Page Rules avec Workers

Si l’URL de la requête actuelle correspond à la fois à une Page Rule et à une route Workers personnalisée, certains paramètres Page Rules ne seront pas appliqués. Pour plus d’informations sur l’utilisation de Page Rules avec Workers, consultez Workers : Page Rules dans la documentation destinée aux développeurs.

​​ Ressources associées

• Règles Page Rules recommandées à prendre en considération Open external link
• Quels sous-domaines sont adaptés à la configuration avec des nuages orange/gris ? Open external link
• Comment utiliser l’option Cache Everything avec Cloudflare ? Open external link
• Comment mettre en cache des contenus statiques HTML ? Open external link
• Message d’erreur hors ligne lors de la mise à jour ou de l’accès à la section d’administration de mon système de gestion de contenus Open external link