Exemples pratiques de redirection

Tout ce qui suit /v1/ est conservé dans la capture $1. Un véritable front-end peut ainsi utiliser une API locale ou un proxy inverse sans modifier son build.

Ne sélectionnez que les méthodes gérées localement et limitez l’initiateur à app.example.com.

            Match type    Simple wildcard
Match         https://api.staging.example.com/v1/*
Resources     XMLHttpRequest
Methods       GET, POST, PUT, PATCH, DELETE
Initiator     app.example.com
Action        Redirect
Destination   http://localhost:3000/v1/$1

https://api.staging.example.com/v1/users/42
→ http://localhost:3000/v1/users/42
          

Le chemin complet des scripts, styles, images et polices est conservé sur le nouvel hôte. Cette règle peut servir de pont temporaire pendant la mise à jour du site.

La redirection est systématique, pas conditionnelle : elle ne revient pas à l’ancien CDN si le nouveau échoue.

            Match type    Simple wildcard
Match         https://static.legacy.example.com/*
Resources     Script, Stylesheet, Image, Font
Initiator     www.example.com
Action        Redirect
Destination   https://cdn.example.com/$1

https://static.legacy.example.com/assets/app.css
→ https://cdn.example.com/assets/app.css
          

Deux captures conservent la famille de ressource et son identifiant tout en remplaçant /v1/ par /v2/. La méthode GET évite de modifier la sémantique des écritures.

Le navigateur actif vérifie la compatibilité de l’expression lors de l’enregistrement. Si chaque * désigne clairement une partie à conserver, le joker simplifié est plus lisible.

            Match type    Regular expression
Match         ^https://api\.example\.com/v1/(users|projects)/([^?]+)$
Resources     XMLHttpRequest
Methods       GET
Initiator     app.example.com
Action        Redirect
Destination   https://api.example.com/v2/$1/$2

https://api.example.com/v1/projects/alpha
→ https://api.example.com/v2/projects/alpha
          

Un filtre URL exact remplace un script précis par un build local sans rediriger tous les fichiers du site.

Utilisez cette technique uniquement sur une application que vous contrôlez. Un serveur HTTPS local évite les restrictions de contenu mixte.

            Match type    URL filter
Match         https://app.example.com/assets/checkout.js
Resources     Script
Initiator     app.example.com
Action        Redirect
Destination   http://localhost:5173/checkout.js
          

Tous les exemples utilisent le domaine documentaire example.com. Remplacez-le par une adresse que vous gérez, créez la règle désactivée, puis testez-la avec plusieurs URL réelles.

Les redirections et les en-têtes changent ce que reçoit réellement une page. Limitez les types de ressources et les domaines initiateurs pour ne pas affecter d’autres sites.

La redirection s’exécute dès que toutes les conditions correspondent. Elle ne peut pas attendre une 404, lire le corps d’une réponse, choisir après une panne réseau ni calculer une URL en JavaScript.

• La cible doit utiliser HTTP ou HTTPS.
• Les captures du joker simplifié et de l’expression régulière sont référencées de $1 à $9.
• L’ordre, le décodage et les clés répétées d’une requête ne sont pas normalisés.
• Les auto-redirections et cycles détectés sont bloqués.