Probleme mit der Umleitung und Weiterleitung von CDN-Domains in AEM Cloud- und AMS-Umgebungen

Adobe Experience Manager (AEM) stößt auf Probleme bei der Domain-Umleitung und dem Routing, wenn Domains nicht korrekt zugeordnet werden oder Umleitungen aufgrund nicht unterstützter Konfigurationen oder fehlender Voraussetzungen fehlschlagen. Dies tritt auf, weil das Umleitungsverhalten von der Ausführungsebene wie CDN, Dispatcher oder AEM abhängt und aufgrund von Einschränkungen wie fehlender Unterstützung für Platzhalterdomänen und erforderlicher SSL-Konfiguration. Um das Problem zu beheben, identifizieren Sie den richtigen Umleitungsmechanismus und konfigurieren Sie Domain-Registrierungs-, SSL- und Umleitungsregeln basierend auf der AEM-Laufzeit.

Beschreibung description

Umgebung

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Managed Services (AMS)
  • Adobe Experience Manager (AEM) On-Premise

Problem/Symptome

  • Die Domain wird immer zum Site-Stamm anstelle zur gewünschten Seite aufgelöst.
  • Weiterleitungen führen aufgrund eines falschen Host-Header-Verhaltens zu Endlosschleifen.
  • Umleitungen führen nicht zu Triggern, da die Domain nicht in Cloud Manager registriert ist.
  • Platzhalter-Subdomains (*.example.com) können nicht hinzugefügt werden und der Traffic schlägt fehl.
  • Die Bereitstellung der CDN-Pipeline schlägt aufgrund einer ungültigen Konfigurationssyntax fehl.

Grundursache

Das Umleitungsverhalten hängt davon ab, wo die Umleitung ausgeführt wird, z. B. CDN, Dispatcher oder AEM. AEM as a Cloud Service erfordert eine explizite Domain-Registrierung und gültige SSL-Zertifikate für die CDN-Verarbeitung. Platzhalter-Domain-Zuordnungen werden nicht unterstützt, und eine falsche Konfiguration von Umleitungsregeln oder Host-Headern verursacht Fehler oder Schleifen.

Lösung resolution

Führen Sie die folgenden Schritte aus, um das richtige domänenbasierte Umleitungs- und Routing-Verhalten zu konfigurieren:

  1. Geben Sie an, ob die Umleitung erfolgen muss, bevor AEM die Anfrage verarbeitet, oder nachdem sie AEM erreicht hat, um die richtige Ausführungsebene zu ermitteln.
  2. Verwenden Sie CDN-Umleitungen für das Routing von Domain zu Pfad in AEM as a Cloud Service.
  3. Verwenden Sie Dispatcher- oder Apache-Rewrite-Regeln für Adobe Managed Services oder On-Premise-Umgebungen.
  4. Verwenden Sie einen externen Umleitungs-Service, wenn die Anforderung dynamische Platzhalter-Subdomains umfasst, die von AEM nicht unterstützt werden.
  5. Verwenden Sie bei der Verwendung von Edge Delivery Services CDN-basierte Weiterleitungen für das Routing auf Host-Ebene, da nur exakte Pfadübereinstimmungen auf Anwendungsebene unterstützt werden.

Für AEM as a Cloud Service (AEMaaCS)

  1. Öffnen Sie Cloud Manager, navigieren Sie zu Umgebungen und greifen Sie auf Domain-Verwaltung zu, um alle für die Umleitung erforderlichen Domains hinzuzufügen.
  2. Laden Sie gültige SSL-Zertifikate für jede Domain hoch und konfigurieren Sie sie, einschließlich Nicht-WWW-Domains.
  3. Stellen Sie sicher, dass jede Domain einen aktiven Status mit einem gültigen Zertifikat aufweist.
  4. Erstellen oder aktualisieren Sie die cdn.yaml-Datei im Repository-Stamm, um Umleitungsregeln zu definieren.
  5. Umleitungsregeln mithilfe von Host-basierten Bedingungen mit dem erforderlichen Status-Code und Zielpfad oder der erforderlichen URL definieren.
  6. Führen Sie die Cloud Manager-Konfigurations-Pipeline aus, um CDN-Regeln bereitzustellen und zu überprüfen, ob die Bereitstellung erfolgreich abgeschlossen wurde.
  7. Korrigieren Sie alle Syntaxfehler in der Konfigurationsdatei, indem Sie die Pipeline-Protokolle überprüfen und die Regelstruktur korrigieren.
  8. Konfigurieren Sie musterbasierte Weiterleitungen ggf. unter Verwendung unterstützter Übereinstimmungsbedingungen.
  9. Verwenden Sie in CDN-Regeln möglichst keine Platzhalter-Hostnamen, da diese nicht unterstützt werden.

Für Adobe Managed Services (AMS) oder On-Premise

  1. Fügen Sie in Dispatcher- oder Apache-Konfigurationsdateien Neuschreibungsregeln hinzu, um Weiterleitungen auf Domain-Ebene zu implementieren.
  2. Konfigurieren Sie virtuelle Host-Einträge für jede Domain oder Subdomain, um ein ordnungsgemäßes Routing zu ermöglichen.
  3. Ordnen Sie jede Domain oder Subdomain dem entsprechenden Stamm der AEM-Site zu.
  4. Überprüfen Sie, ob die Konfiguration des virtuellen Hosts eine korrekte Domain-Auflösung und -Priorisierung ermöglicht.

Für Edge Delivery Services (EDS)

Konfigurieren Sie Weiterleitungen nur für exakte Pfadübereinstimmungen auf Anwendungsebene und verarbeiten Sie hostbasierte Weiterleitungen auf CDN-Ebene.

Validierung:

  1. Führen Sie HTTP-Anfragen mit Tools wie curl aus und überprüfen Sie, ob die Antwort den richtigen Umleitungsstatus und die richtige Speicherort-Kopfzeile enthält.
  2. Überprüfen Sie die CDN-Protokolle oder Bereitstellungsergebnisse, um sicherzustellen, dass die Umleitungsregeln ordnungsgemäß ausgeführt werden.
  3. Stellen Sie sicher, dass keine Umleitungsschleifen auftreten, indem Sie ein konsistentes Host- und weitergeleitetes Host-Verhalten über Anfragen hinweg sicherstellen.

Wann eskaliert werden soll:

  • Das Umleitungsverhalten stimmt nach der Implementierung des richtigen Umleitungsmechanismus nicht mit der erwarteten Logik überein.
  • Die Bereitstellung der CDN-Konfiguration schlägt aufgrund von nicht behobenen Validierungs- oder Syntaxfehlern fehl.
  • Domains können trotz ordnungsgemäßer Registrierung und gültiger SSL-Zertifikate nicht weitergeleitet werden.
  • Redirect-Schleifen bleiben aufgrund von Host-Header-Inkonsistenzen bestehen.
  • Anforderungen an Platzhalter oder dynamisches Domain-Routing können nicht mit unterstützten AEM-Funktionen implementiert werden.

Verwandtes Lesen

recommendation-more-help
experience-cloud-kcs-help-kbarticles