Problèmes de redirection et de routage de domaine CDN dans les environnements AEM Cloud et AMS
Adobe Experience Manager (AEM) rencontre des problèmes de redirection et de routage de domaine lorsque les domaines ne sont pas correctement mappés ou que les redirections échouent en raison de configurations non prises en charge ou de conditions préalables manquantes. Cela se produit, car le comportement de redirection dépend de la couche d’exécution telle que le réseau CDN, Dispatcher ou AEM, et en raison de limitations telles que l’absence de prise en charge du domaine par des caractères génériques et la configuration SSL requise. Pour résoudre ce problème, identifiez le mécanisme de redirection approprié et configurez les règles d’enregistrement de domaine, SSL et de redirection en fonction de l’exécution d’AEM.
Description description
Environnement
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- Adobe Managed Services (AMS)
- Adobe Experience Manager (AEM) On-Premise
Problème/Symptômes
- Le domaine est toujours résolu à la racine du site au lieu de la page prévue.
- Les redirections entraînent des boucles infinies en raison du comportement incorrect de l’en-tête hôte.
- Les redirections ne se déclenchent pas car le domaine n’est pas enregistré dans Cloud Manager.
- Impossible d’ajouter les sous-domaines génériques (
*.example.com) et le trafic échoue. - Le déploiement du pipeline CDN échoue en raison d’une syntaxe de configuration non valide.
Cause première
Le comportement de la redirection dépend de l’endroit où elle s’exécute, par exemple le réseau CDN, Dispatcher ou AEM. AEM as a Cloud Service nécessite un enregistrement de domaine explicite et des certificats SSL valides pour le traitement CDN. Les mappages de domaine avec caractères génériques ne sont pas pris en charge et une configuration incorrecte des règles de redirection ou des en-têtes d’hôte entraîne des échecs ou des boucles.
Résolution resolution
Pour configurer des redirections basées sur des domaines et un comportement de routage corrects, procédez comme suit :
- Déterminez si la redirection doit avoir lieu avant qu’AEM ne traite la requête ou après qu’elle ait atteint AEM afin de déterminer la couche d’exécution correcte.
- Utilisez les redirections CDN pour le routage domaine à chemin dans AEM as a Cloud Service.
- Utilisez des règles de réécriture Dispatcher ou Apache pour les environnements Adobe Managed Services ou On-Premise.
- Utilisez un service de redirection externe si le besoin implique des sous-domaines de caractères génériques dynamiques non pris en charge par AEM.
- Utilisez des redirections basées sur un réseau CDN pour le routage au niveau de l’hôte lors de l’utilisation de Edge Delivery Services, car seules les correspondances de chemin exactes sont prises en charge au niveau de la couche d’application.
Pour AEM as a Cloud Service (AEMaaCS)
- Ouvrez , accédez à Environnements et accédez à Gestion des domaines pour ajouter tous les domaines requis pour la redirection.
- Téléchargez et configurez des certificats SSL valides pour chaque domaine, y compris les domaines autres que www.
- Vérifiez que chaque domaine affiche un statut actif avec un certificat valide.
- Créez ou mettez à jour le fichier
cdn.yamldans la racine du référentiel pour définir les règles de redirection. - Définissez des règles de redirection à l’aide de conditions basées sur l’hôte avec le code d’état et le chemin ou l’URL de destination requis.
- Exécutez le pipeline de configuration Cloud Manager pour déployer les règles du réseau CDN et vérifier que le déploiement s’est terminé avec succès.
- Corrigez les erreurs de syntaxe dans le fichier de configuration en examinant les journaux de pipeline et en corrigeant la structure des règles.
- Configurez les redirections basées sur des modèles à l’aide des conditions de correspondance prises en charge, le cas échéant.
- Évitez d’utiliser des noms d’hôtes génériques dans les règles du réseau CDN, car ils ne sont pas pris en charge.
Pour Adobe Managed Services (AMS) ou On-Premise
- Ajoutez des règles de réécriture dans les fichiers de configuration Dispatcher ou Apache pour implémenter des redirections au niveau du domaine.
- Configurez les entrées d’hôte virtuel pour chaque domaine ou sous-domaine afin d’activer le routage approprié.
- Mappez chaque domaine ou sous-domaine à la racine de site AEM appropriée.
- Vérifiez que la configuration de l’hôte virtuel permet une résolution et une hiérarchisation correctes des domaines.
Pour Edge Delivery Services (EDS)
Configurez les redirections uniquement pour les correspondances de chemin exactes au niveau de l’application et gérez les redirections basées sur l’hôte au niveau de la couche CDN.
Validation:
- Exécutez les requêtes HTTP à l’aide d’outils tels que curl et vérifiez que la réponse contient le statut de redirection et l’en-tête d’emplacement corrects.
- Vérifiez les journaux CDN ou les résultats de déploiement pour vous assurer que les règles de redirection s’exécutent correctement.
- Vérifiez qu’aucune boucle de redirection ne se produit en assurant un comportement cohérent de l’hôte et de l’hôte transféré entre les requêtes.
Moment de la réaffectation :
- Le comportement de redirection ne correspond pas à la logique attendue après l’implémentation du mécanisme de redirection correct.
- Le déploiement de la configuration du réseau CDN échoue en raison d’erreurs de validation ou de syntaxe non résolues.
- Le routage des domaines échoue malgré un enregistrement correct et des certificats SSL valides.
- Les boucles de redirection persistent en raison d’incohérences de l’en-tête de l’hôte.
- Les exigences de routage de domaine dynamique ou par caractère générique ne peuvent pas être implémentées en utilisant les fonctionnalités AEM prises en charge.