URL de redirection de Dispatcher
<- Précédent : Purge du Dispatcher
Vue d’ensemble
Ce document vous aidera à comprendre comment AEM gère les URL de redirection et quelques techniques complémentaires utilisant les règles de réécriture pour mapper le contenu plus près de la zone de la diffusion.
Que sont les URL de redirection ?
Lorsque le contenu se trouve dans une structure de dossiers logique, il ne réside pas toujours dans une URL facile à référencer. Les URL de redirection sont l’équivalent de raccourcis. Des URL plus courtes ou uniques qui référencent l’emplacement du contenu réel.
Exemple : /aboutus redirigé sur /content/we-retail/us/en/about-us.html.
Les auteurs et autrices AEM ont la possibilité de définir les propriétés de l’URL de redirection sur un élément de contenu dans AEM et de le publier.
Pour que cette fonctionnalité soit opérationnelle, vous devez ajuster les filtres Dispatcher pour autoriser le transfert vers l’URL de redirection. Il devient impossible de le faire en ajustant les fichiers de configuration du Dispatcher au rythme auquel les auteurs et autrices devraient mettre en place ces entrées de page de redirection.
Pour cette raison, le module Dispatcher dispose d’une fonctionnalité permettant d’autoriser automatiquement tout élément répertorié comme une URL de redirection dans l’arborescence de contenu.
Fonctionnement
Créer des URL de redirection
L’auteur ou l’autrice consulte une page dans AEM, clique sur les propriétés de la page et ajoute les entrées dans la section URL de redirection. Lors de l’enregistrement des modifications et de l’activation de la page, l’URL de redirection est affectée à la page.
Les auteurs et autrices peuvent également cocher la case Rediriger l’URL de redirection lors de l’ajout des entrées URL de redirection, les URL de redirection se comportant ainsi comme des redirections 302. Cela signifie que le navigateur est invité à accéder à la nouvelle URL (via l’en-tête de réponse Location) et que le navigateur envoie une nouvelle requête à la nouvelle URL.
IU tactile :
Outil de recherche de contenu classique :
Résoudre/mapper des ressources
Chaque entrée de redirection est une entrée de mappage Sling pour une redirection interne.
Ces cartes sont visibles sur la console Felix des instances AEM (/system/console/jcrresolver).
Voici une capture d’écran d’une entrée de carte créée par une entrée de redirection :
Dans l’exemple ci-dessus, lorsque nous demandons à l’instance AEM de visiter /aboutus, la résolution est /content/we-retail/us/en/about-us.html.
Filtres d’autorisation automatique de Dispatcher
Dispatcher dans un état sécurisé filtre les requêtes sur le chemin d’accès / via Dispatcher, car il s’agit de la racine de l’arborescence JCR.
Il est important de s’assurer que les personnes chargées de la publication n’autorisent que le contenu de /content et d’autres chemins sûrs, et non les chemins tels que /system.
Voici le problème : les URL de redirection résident dans le dossier de base de /, alors comment leur permettre d’atteindre les personnes en charge de la publication tout en restant en sécurité ?
Le Dispatcher simple dispose d’un mécanisme d’autorisation de filtre automatique. Vous devez installer un package AEM, puis configurer Dispatcher pour qu’il pointe vers cette page de packages.
Dispatcher comporte une section de configuration dans son fichier de batterie :
/vanity_urls {
/url "/libs/granite/dispatcher/content/vanityUrls.html"
/file "/tmp/vanity_urls"
/delay 300
}
Le paramètre /delay, mesuré en secondes, ne fonctionne pas sur une base d’intervalle fixe mais plutôt sur une vérification basée sur l’état. Dispatcher évalue l’horodatage de modification de /file (qui stocke la liste des URL de redirection reconnues) lors de la réception d’une requête d’URL non répertoriée. /file ne sera pas actualisé si le décalage horaire entre le moment actuel et la dernière modification de /file est inférieur à la durée /delay. L’actualisation de /file se produit sous deux conditions :
- La requête entrante concerne une URL non mise en cache ou répertoriée dans
/file. - Au moins
/delaysecondes se sont écoulées depuis la dernière mise à jour de/file.
Ce mécanisme est conçu pour une protection contre les attaques par déni de service (DoS), qui pourraient autrement submerger Dispatcher de requêtes, en exploitant la fonctionnalité des URL de redirection.
En termes plus simples, le /file contenant des URL de redirection est mis à jour uniquement si une requête arrive pour une URL qui ne figure pas déjà dans /file et si la dernière modification de /file remonte à plus longtemps que la période /delay.
Pour déclencher explicitement une actualisation de /file, vous pouvez demander une URL inexistante après avoir vérifié que la durée /delay requise s’est bien écoulée depuis la dernière mise à jour. Exemples d’URL à cet effet :
https://dispatcher-host-name.com/this-vanity-url-does-not-existhttps://dispatcher-host-name.com/please-hand-me-that-planet-maestrohttps://dispatcher-host-name.com/random-vanity-url
Cette approche oblige Dispatcher à mettre à jour /file, à condition que l’intervalle /delay spécifié se soit écoulé depuis sa dernière modification.
Il stocke le cache de la réponse dans l’argument /file comme le montre cet exemple /tmp/vanity_urls.
Ainsi, si vous visitez l’instance AEM au niveau de l’URI, vous voyez ce qu’elle récupère :
Il s’agit en fait d’une liste, très simple.
Réécrire des règles en tant que règles de redirection
Pourquoi mentionnerions-nous l’utilisation de règles de réécriture au lieu du mécanisme par défaut intégré à AEM, comme décrit ci-dessus ?
Tout simplement parce que les problèmes d’espace de noms, de performances et de logique de niveau supérieur peuvent être mieux gérés.
Passons en revue un exemple de l’entrée de redirection /aboutus à son contenu /content/we-retail/us/en/about-us.html à l’aide du module Apache mod_rewrite pour y parvenir.
RewriteRule ^/aboutus /content/we-retail/us/en/about-us.html [PT,L,NC]
Cette règle recherche l’URL de redirection /aboutus et récupère le chemin d’accès complet à partir du rendu avec l’indicateur PT (passthrough).
Elle cessera également le traitement de toutes les autres règles avec un indicateur L (Last), ce qui signifie qu’elle n’aura pas à parcourir une grande liste de règles comme la résolution JCR doit le faire.
En plus du fait qu’il n’est pas nécessaire d’envoyer la requête par proxy et d’attendre la réponse de l’éditeur AEM, les deux éléments de cette méthode la rendent beaucoup plus performante.
Ensuite, la cerise sur le gâteau : l’indicateur NC (non sensible à la casse). Si un client ou une cliente se trompe dans l’URI avec /AboutUs au lieu de /aboutus, l’URL fonctionne toujours.
Pour créer une règle de réécriture à cet effet, vous devez créer un fichier de configuration sur le Dispatcher (par exemple : /etc/httpd/conf.d/rewrites/examplevanity_rewrite.rules) et l’inclure dans le fichier .vhost qui gère le domaine nécessitant l’application de ces URL de redirection.
Voici un exemple d’extrait de code d’inclusion dans /etc/httpd/conf.d/enabled_vhosts/we-retail.vhost.
<VirtualHost *:80>
ServerName weretail.com
ServerAlias www.weretail.com
........ SNIP ........
<IfModule mod_rewrite.c>
ReWriteEngine on
LogLevel warn rewrite:info
Include /etc/httpd/conf.d/rewrites/examplevanity_rewrite.rules
</IfModule>
........ SNIP ........
</VirtualHost>
Quelle méthode et où
L’utilisation d’AEM pour contrôler les entrées de redirection présente les avantages suivants.
- Les auteurs et autrices peuvent les créer à la volée.
- Elles vivent avec le contenu et peuvent être conditionnées avec le contenu.
L’utilisation de mod_rewrite pour contrôler les entrées de redirection présente les avantages suivants.
- Résolution du contenu plus rapide.
- Plus grande proximité avec les requêtes de contenu des personnes finales.
- Plus d’extensibilité et d’options pour contrôler la manière dont le contenu est mappé sur d’autres conditions.
- Peut ne pas respecter la casse.
Utilisez les deux méthodes, mais voici des conseils et critères à prendre en compte pour savoir laquelle utiliser et à quel moment :
- Si l’URL de redirection est temporaire et a un faible niveau de trafic prévu, utilisez la fonctionnalité intégrée d’AEM.
- Si l’URL de redirection est un point d’entrée de base qui ne change pas souvent et qui est fréquemment utilisé, utilisez une règle
mod_rewrite. - Si l’espace de noms de redirection (par exemple :
/aboutus) doit être réutilisé pour de nombreuses marques sur la même instance AEM, utilisez alors des règles de réécriture.
/brand1/aboutus, brand2/aboutus, brand3/aboutus.