En bref. Preserve query string impose à Cloudflare d’utiliser la chaîne de requête entrante et de supprimer celle inscrite dans l’URL cible.

Définition : Cloudflare Bulk Redirects peut remplacer la chaîne de requête (query string) inscrite dans target_url par celle de la requête entrante. Ce remplacement se produit lorsque preserve_query_string est activé, même si la requête entrante ne comporte aucune chaîne de requête.

Points clés

Cloudflare définit Bulk Redirects comme des redirections configurées au niveau du compte, qui envoient un client d’une URL source vers une URL cible avec un code d’état HTTP.
La référence des paramètres de redirection d’URL de Cloudflare indique que target_url est obligatoire et que la cible finale dépend des paramètres de chaîne de requête et de suffixe de chemin.
preserve_query_string est un booléen dont la valeur par défaut est false.
Lorsque sa valeur est true, l’URL de redirection conserve la chaîne de requête de la requête d’origine.
La chaîne de requête entrante remplace celle de la cible. Cloudflare précise que la chaîne de requête cible est supprimée même lorsque la requête entrante n’en comporte aucune.
Pour ajouter un paramètre de requête fixe, Cloudflare indique de laisser cette option désactivée et de placer le paramètre dans target_url.

Que supprime exactement la redirection ?

La référence des paramètres de redirection d’URL de Cloudflare décrit target_url comme l’URL vers laquelle le client est redirigé lorsqu’une correspondance est trouvée. Lorsque la conservation de la chaîne de requête est activée, Cloudflare reprend celle de la requête qui correspond à l’URL source et l’utilise dans l’URL de redirection finale. La chaîne de requête propre à la cible n’est donc pas fusionnée avec la chaîne entrante.

La référence de Cloudflare donne cet exemple de redirection de /my-folder/ vers /other-folder/ : une requête pour /my-folder/?name=value devient /other-folder/?name=value lorsque l’option Preserve query string (conserver la chaîne de requête) est activée. Si l’option est désactivée, la même requête devient /other-folder/. La même référence précise qu’une chaîne de requête déjà présente dans l’URL cible est supprimée lorsque la conservation est activée, même si la requête ne comporte aucune chaîne de requête.

Quel réglage détermine le résultat ?

La référence des paramètres de Cloudflare présente les champs d’API concernés comme suit :

{
  "source_url": "String",
  "target_url": "String",
  "preserve_query_string": false
}

Les champs source_url et target_url sont des chaînes d’URL obligatoires. Cloudflare fixe pour chacun une longueur maximale de 32 KB. Le champ preserve_query_string vaut false par défaut : une chaîne de requête fixe dans target_url reste donc disponible lorsque l’option demeure désactivée. Son activation modifie l’URL finale pour utiliser à la place la chaîne de requête d’origine.

Ce réglage concerne les chaînes de requête. Preserve path suffix (conserver le suffixe de chemin) est un paramètre distinct qui s’applique uniquement lorsque Subpath matching (correspondance des sous-chemins) est activé. L’exemple de chemin de la référence redirige /my-folder/foo vers /another-folder/foo lorsque les deux réglages sont activés.

Quelles sont les autres caractéristiques de Bulk Redirects ?

La présentation de Bulk Redirects de Cloudflare décrit ces redirections comme essentiellement statiques. Elles ne prennent en charge ni les opérations de remplacement de chaînes ni les expressions régulières, bien que leurs paramètres modifient la correspondance des URL sources et le comportement des redirections. Les codes d’état documentés sont 301, 302, 307 et 308. Les codes 307 et 308 préservent la méthode HTTP d’origine lorsque le client suit la redirection.

Les redirections Bulk Redirects interviennent après le WAF dans la chaîne de traitement des requêtes de Cloudflare. La redirection Bulk Redirect ne s’exécute pas lorsqu’une règle WAF personnalisée ou une règle de limitation du débit bloque la requête. Cloudflare mentionne également l’outil Trace a request pour déterminer si une règle de redirection en masse se déclenche pour une URL donnée.

Termes associés

Questions fréquentes

Cloudflare ajoute-t-il la chaîne de requête entrante à celle de la cible ?

Non. Lorsque Preserve query string est activé, la chaîne de requête entrante remplace celle de la cible. Cloudflare indique que la chaîne de requête cible est supprimée.

Que se passe-t-il lorsque l’URL entrante ne comporte aucune chaîne de requête ?

La chaîne de requête cible est tout de même supprimée lorsque la conservation est activée. La redirection finale utilise donc l’URL cible sans la chaîne de requête configurée.

Comment conserver un paramètre de requête fixe lors d’une redirection ?

Laissez Preserve query string désactivé et placez le paramètre fixe directement dans target_url, comme l’indique la référence des paramètres de Cloudflare.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Pourquoi les redirections Cloudflare Bulk Redirects peuvent-elles supprimer les paramètres de requête d’une URL cible ?