Ignorer les paramètres

Lorsque vous activez l'ignorance des paramètres, les nœuds de périphérie CDN suppriment les paramètres de requête (la partie située après le ?) des URL de requête. Cette fonctionnalité permet aux requêtes comportant des paramètres différents d'accéder à la même copie mise en cache, ce qui améliore le taux de succès du cache. Cette rubrique explique comment configurer l'ignorance des paramètres, la compare à d'autres fonctionnalités et fournit des recommandations d'utilisation.

Comparaison des fonctionnalités

La fonction Custom Cache Key entre en conflit avec l'ignorance des paramètres. Si vous configurez simultanément l'ignorance des paramètres et Custom Cache Key, l'ignorance des paramètres devient invalide.

Custom Cache Key peut remplacer l'ignorance des paramètres pour la configuration de la clé de cache et offre des fonctionnalités plus complètes. Nous vous recommandons de privilégier cette option. Comparaison des configurations :

Scénario	Ignorer les paramètres	Custom Cache Key
Ignorer tous les paramètres de requête dans la clé de cache	Définissez Ignore Parameters sur Yes et laissez Retain Specified Parameters vide.	Ajoutez une règle de gestion des paramètres de requête : Action : Retain Nom du paramètre : définissez-le sur un nom de paramètre inexistant, par exemple example-argument.
Conserver uniquement le paramètre de requête key1 dans la clé de cache	Définissez Ignore Parameters sur Yes et définissez Retain Specified Parameters sur `key1`.	Ajoutez une règle de gestion des paramètres de requête : Action : Retain Nom du paramètre : key1
Supprimer uniquement le paramètre de requête key1 de la clé de cache	Supprimez le paramétrage pour `key1`.	Ajoutez une règle de gestion des paramètres de requête : Action : Delete Nom du paramètre : key1

La fonction Rewrite Origin Parameters peut remplacer l'ignorance des paramètres pour la réécriture des requêtes vers l'origine et offre des fonctionnalités plus complètes. Nous vous recommandons de privilégier cette option.

Présentation de la fonctionnalité

Fonction

Scénarios

Supprime les paramètres de requête (la partie située après ?) des URL de requête afin que les requêtes avec des paramètres différents accèdent au même fichier en cache. Cela améliore le taux de succès du cache et réduit le trafic vers l'origine.

Activez l'ignorance des paramètres lorsque les paramètres d'URL ne sont pas liés au contenu de la ressource (comme l'UID utilisateur, la source de référence ou les codes promotionnels). Par exemple, ces deux requêtes accèdent à la même ressource mais contiennent des UID différents :

Utilisateur A : http://example.com/1.jpg?uid=123***

Utilisateur B : http://example.com/1.jpg?uid=654***

Sans l'ignorance des paramètres, les nœuds de périphérie CDN traitent ces requêtes comme des ressources distinctes et ne peuvent pas partager le même cache, ce qui nécessite une récupération depuis l'origine pour chaque requête. Avec l'ignorance des paramètres activée, les nœuds de périphérie CDN suppriment les paramètres et utilisent http://example.com/1.jpg pour faire correspondre le cache.

Remarque

La fonction URL signing est prioritaire sur l'ignorance des paramètres. La signature de type A inclut les paramètres d'URL dans sa signature. Le CDN effectue d'abord l'authentification et met en cache le réplica uniquement après validation réussie.

Conserver les paramètres d'origine

Fonction

Scénarios

Conserve tous les paramètres d'URL d'origine lors des récupérations depuis l'origine pour garantir que le serveur d'origine reçoit les informations utilisateur critiques.

Lorsque l'ignorance des paramètres est activée, les nœuds de périphérie CDN utilisent par défaut l'URL sans paramètres pour les récupérations depuis l'origine. Dans l'exemple ci-dessus, l'utilisateur A et l'utilisateur B déclencheraient tous deux une requête vers l'origine vers http://example.com/1.jpg, perdant ainsi des informations critiques telles que l'UID. L'activation de Retain Origin Parameters garantit que le CDN utilise l'URL d'origine pour les récupérations depuis l'origine, en conservant les paramètres tels que l'UID pour le serveur d'origine.

Procédure

Connectez-vous à la console CDN.
Dans le volet de navigation de gauche, cliquez sur Domain Names.
Dans la liste des domaines, cliquez sur le nom de domaine cible. Dans le volet de navigation de gauche, cliquez sur Optimization pour accéder à la page de configuration de l'optimisation des performances.
Cliquez sur Modify dans la section Ignore Parameters. Sélectionnez un mode et terminez la configuration selon vos besoins.
Une fois la configuration terminée, cliquez sur OK pour enregistrer.

Important

Le changement de mode efface les configurations existantes.
Après modification de la configuration d'ignorance des paramètres, les fichiers mis en cache sur les nœuds de périphérie ne se mettent pas à jour automatiquement. Vous devez effectuer une opération de URL refresh ou de directory refresh dans la console pour appliquer la nouvelle configuration et purger l'ancien cache. Sinon, les utilisateurs pourraient toujours accéder au contenu mis en cache selon l'ancienne politique, ce qui entraînerait des problèmes d'accès.

Mode : Conserver les paramètres spécifiés

Paramètre	Description	Exemple
Ignore Parameters	Yes : activez l'ignorance des paramètres pour supprimer tous les paramètres situés après `?` dans l'URL. Remarque Si vous activez Ignore Parameters mais laissez Retain Specified Parameters vide, tous les paramètres situés après `?` sont supprimés. No : désactivez l'ignorance des paramètres pour conserver tous les paramètres d'URL.	Supposons que l'URL d'origine soit `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Les résultats pour chaque configuration sont les suivants : Exemple 1, ignorer tous les paramètres, ne pas conserver les paramètres d'origine : Configuration : Ignore Parameters=Yes, Retain Specified Parameters vide, Retain Origin Parameters=No. Clé de cache : `http://example.com/1.jpg` URL d'origine : `http://example.com/1.jpg` Exemple 2, conserver les paramètres spécifiés, ne pas conserver les paramètres d'origine : Configuration : Ignore Parameters=Yes, Retain Specified Parameters=`key1`, Retain Origin Parameters=No. Clé de cache : `http://example.com/1.jpg?key1=1` URL d'origine : `http://example.com/1.jpg?key1=1` Exemple 3, ignorer tous les paramètres, conserver les paramètres d'origine : Configuration : Ignore Parameters=Yes, Retain Specified Parameters vide, Retain Origin Parameters=Yes. Clé de cache : `http://example.com/1.jpg` URL d'origine : `http://example.com/1.jpg?key1=1&key2=2&key3=3` Exemple 4, conserver les paramètres spécifiés, conserver les paramètres d'origine : Configuration : Ignore Parameters=Yes, Retain Specified Parameters=`key1`, Retain Origin Parameters=Yes. Clé de cache : `http://example.com/1.jpg?key1=1` URL d'origine : `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Specified Parameters	Saisissez les noms des paramètres à conserver. Vous pouvez spécifier jusqu'à 10 paramètres, séparés par des virgules (,).
Retain Origin Parameters	Yes : conserve tous les paramètres d'URL d'origine lors des récupérations depuis l'origine. No : lors des récupérations depuis l'origine, inclut uniquement les paramètres cohérents avec la clé de hachage du cache (c'est-à-dire les paramètres conservés).
Rule Condition	Une condition de règle identifie diverses informations de paramètre dans une requête utilisateur. Cela détermine si une configuration prend effet pour cette requête. Important Lorsque vous faites référence à des conditions de règle, elles sont mises en correspondance en fonction de la priorité des conditions de règle associées, et non de l'ordre de configuration de la fonctionnalité elle-même. Do not use : n'utilise pas de condition de règle. Pour ajouter ou modifier des conditions de règle, gérez-les dans le Rules Engine.

Mode : Supprimer les paramètres spécifiés

Paramètre	Description	Exemple
Remove Specified Parameters	Saisissez les noms des paramètres à supprimer. Vous pouvez spécifier jusqu'à 10 paramètres, séparés par des espaces.	Supposons que l'URL d'origine soit `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Les résultats pour chaque configuration sont les suivants : Exemple 1, supprimer les paramètres spécifiés, ne pas conserver les paramètres d'origine : Configuration : Delete Specified Parameters=`key1`, Retain Origin Parameters=No. Clé de cache : `http://example.com/1.jpg?key2=2&key3=3` URL d'origine : `http://example.com/1.jpg?key2=2&key3=3` Exemple 2, supprimer les paramètres spécifiés, conserver les paramètres d'origine : Configuration : Delete Specified Parameters=`key1`, Retain Origin Parameters=Yes. Clé de cache : `http://example.com/1.jpg?key2=2&key3=3` URL d'origine : `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Origin Parameters	Yes : conserve tous les paramètres d'URL d'origine lors des récupérations depuis l'origine. No : lors des récupérations depuis l'origine, inclut uniquement les paramètres cohérents avec la clé de hachage du cache (c'est-à-dire le résultat après suppression des paramètres spécifiés).
Rule Condition	Une condition de règle identifie diverses informations de paramètre dans une requête utilisateur. Cela détermine si une configuration prend effet pour cette requête. Important Lorsque vous faites référence à des conditions de règle, elles sont mises en correspondance en fonction de la priorité des conditions de règle associées, et non de l'ordre de configuration de la fonctionnalité elle-même. Do not use : n'utilise pas de condition de règle. Pour ajouter ou modifier des conditions de règle, gérez-les dans le Rules Engine.

Exemples de scénarios d'utilisation

Utiliser l'ignorance des paramètres pour atténuer les attaques de contournement du cache via les paramètres d'URL

Lorsque des attaquants ou des robots d'indexation ajoutent des paramètres aléatoires et insignifiants (tels que ?timestamp=xxx ou ?random=xxx) pour demander la même ressource, le CDN traite chaque requête paramétrée comme une ressource unique. Cela réduit le taux de succès du cache et fait augmenter brusquement le trafic vers l'origine.

Activez l'ignorance des paramètres (ou configurez-la pour ignorer tous les paramètres) afin que les requêtes avec des paramètres aléatoires différents accèdent au même cache, réduisant ainsi efficacement la pression sur l'origine. Par exemple, après activation de l'ignorance des paramètres, ces requêtes accèdent au même cache :

http://example.com/page.html?t=123456
http://example.com/page.html?t=789012
http://example.com/page.html?random=abc

Avec l'ignorance des paramètres activée, toutes ces requêtes utilisent http://example.com/page.html pour faire correspondre le cache, atténuant ainsi efficacement les attaques de contournement du cache via les paramètres d'URL.