Si l'URL d'une requête utilisateur contient des paramètres différents de ceux attendus par le serveur d'origine, utilisez la fonctionnalité de réécriture des paramètres pour modifier les paramètres de requête envoyés à l'origine. Cette fonctionnalité permet d'ajouter, de supprimer, de modifier ou de conserver des paramètres spécifiques, voire d'ignorer tous les paramètres.
Contexte
La réécriture des paramètres modifie les paramètres de requête d'une URL de requête d'origine. Vous pouvez configurer plusieurs règles de réécriture. Elles s'appliquent selon l'ordre de priorité suivant : Add > Delete > Ignore Parameters et Reserve Only > Modify. Si plusieurs règles ciblent le même paramètre, seule la règle de priorité la plus élevée s'applique.
Les options Ignore Parameters et Reserve Only sont mutuellement exclusives. Ne les configurez pas simultanément.
Conflits
La fonctionnalité de parameter rewrite peut entrer en conflit avec la règle enhance break de la fonctionnalité de réécriture d'URI et avec celle de filtrage des paramètres. Évitez les configurations conflictuelles. En cas de conflit, la dernière fonctionnalité configurée prévaut.
DCDN traite les règles de parameter rewrite au niveau du POP d'origine. Cela n'affecte ni le flux de requêtes interne ni la clé de cache.
DCDN traite les règles de parameter filtering au niveau du POP périphérique. Cela affecte le flux de requêtes interne et modifie la clé de cache.
Procédure
Connectez-vous à la console DCDN.
Dans le volet de navigation de gauche, cliquez sur Domain Names.
Sur la page Domain Names, recherchez le nom de domaine à gérer, puis cliquez sur Configure dans la colonne Actions.
Dans le volet de navigation de gauche du domaine, cliquez sur Origin Fetch.
Cliquez sur l'onglet Parameter Rewrite.
Dans l'onglet Parameter Rewrite, activez l'option Use Parameter Rewrite.
-
Configurez vos règles de réécriture.
Définissez les règles selon vos besoins métier. Pour plus d'informations, consultez la section Exemples de configuration.
-
Cliquez sur OK pour appliquer la configuration.
Vous pouvez également cliquer sur Modify Configuration dans la page Parameter Rewrite pour modifier les règles existantes.
Remarque : Si vous utilisez cette fonctionnalité comme action dans le Rules Engine, la priorité définie dans ce dernier remplace la priorité de fonctionnement interne de la fonctionnalité.
Exemples de configuration
-
Exemple 1 : Ignorer tous les paramètres.
Paramètre
Exemple
Ignore Parameters
Activé
Add
Aucun
Delete
Aucun
Reserve Only
Aucun
Modify
Aucun
Résultat attendu
Requête initiale :
http://example.com/index.html?code1=1&code2=2&code3=3Requête d'origine réécrite :
http://example.com/index.html -
Exemple 2 : Conserver un paramètre spécifique.
Paramètre
Exemple
Ignore Parameters
Aucun
Add
Aucun
Delete
Aucun
Reserve Only
code2
Modify
Aucun
Résultat attendu
Requête initiale :
http://example.com/index.html?code1=1&code2=2&code3=3Requête d'origine réécrite :
http://example.com/index.html?code2=2 -
Exemple 3 : Ajouter, supprimer et modifier des paramètres.
Paramètre
Exemple
Ignore Parameters
Aucun
Add
code4=4
Delete
code2
Reserve Only
Aucun
Modify
code3=0
Résultat attendu
Requête initiale :
http://example.com/index.html?code1=1&code2=2&code3=3Requête d'origine réécrite :
http://example.com/index.html?code1=1&code3=0&code4=4