Problemi di reindirizzamento e routing del dominio CDN in ambienti AEM Cloud e AMS
Adobe Experience Manager (AEM) riscontra problemi di reindirizzamento e routing del dominio quando i domini non vengono mappati correttamente o i reindirizzamenti non riescono a causa di configurazioni non supportate o prerequisiti mancanti. Ciò si verifica perché il comportamento di reindirizzamento dipende dal livello di esecuzione come CDN, Dispatcher o AEM e da limitazioni quali la mancanza di supporto del dominio con caratteri jolly e la configurazione SSL richiesta. Per risolvere il problema, identifica il meccanismo di reindirizzamento corretto e configura la registrazione del dominio, SSL e le regole di reindirizzamento in base al runtime di AEM.
Descrizione description
Ambiente
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- Adobe Managed Services (AMS)
- Adobe Experience Manager (AEM) On-Premise
Problema/Sintomi
- Il dominio viene sempre risolto nella directory principale del sito anziché nella pagina desiderata.
- I reindirizzamenti si traducono in cicli infiniti a causa di un comportamento errato dell’intestazione host.
- I reindirizzamenti non vengono attivati perché il dominio non è registrato in Cloud Manager.
- Impossibile aggiungere i sottodomini con caratteri jolly (
*.example.com) e il traffico non riesce. - La distribuzione della pipeline CDN non riesce a causa di una sintassi di configurazione non valida.
Causa principale
Il comportamento di reindirizzamento dipende da dove viene eseguito il reindirizzamento, ad esempio CDN, Dispatcher o AEM. AEM as a Cloud Service richiede una registrazione esplicita del dominio e certificati SSL validi per l’elaborazione CDN. Le mappature di dominio con caratteri jolly non sono supportate e la configurazione non corretta delle regole di reindirizzamento o delle intestazioni host causa errori o loop.
Risoluzione resolution
Per configurare i reindirizzamenti e il comportamento di indirizzamento basati sul dominio corretti, effettua le seguenti operazioni:
- Identifica se il reindirizzamento deve verificarsi prima che AEM elabori la richiesta o dopo che ha raggiunto AEM per determinare il livello di esecuzione corretto.
- Utilizza i reindirizzamenti CDN per il routing da dominio a percorso in AEM as a Cloud Service.
- Utilizza le regole di riscrittura Dispatcher o Apache per gli ambienti Adobe Managed Services o on-premise.
- Utilizza un servizio di reindirizzamento esterno se il requisito coinvolge sottodomini con caratteri jolly dinamici non supportati da AEM.
- Quando si utilizza Edge Delivery Services, i reindirizzamenti basati su CDN vengono utilizzati per il routing a livello di host, perché a livello di applicazione sono supportate solo le corrispondenze esatte del percorso.
Per AEM as a Cloud Service (AEMaaCS)
- Apri Cloud Manager, passa a Ambienti e accedi a Gestione dominio per aggiungere tutti i domini necessari per il reindirizzamento.
- Carica e configura certificati SSL validi per ciascun dominio, inclusi i domini non www.
- Verifica che ogni dominio presenti uno stato attivo con un certificato valido.
- Crea o aggiorna il file
cdn.yamlnella directory principale dell’archivio per definire le regole di reindirizzamento. - Definisci le regole di reindirizzamento utilizzando condizioni basate su host con il codice di stato e il percorso o l’URL di destinazione richiesti.
- Esegui la pipeline di configurazione Cloud Manager per distribuire le regole CDN e verificare che la distribuzione sia stata completata correttamente.
- Correggi eventuali errori di sintassi nel file di configurazione esaminando i registri della pipeline e correggendo la struttura delle regole.
- Configura i reindirizzamenti basati su pattern utilizzando le condizioni di corrispondenza supportate, se applicabili.
- Evita di utilizzare nomi host con caratteri jolly nelle regole CDN perché non sono supportati.
Per Adobe Managed Services (AMS) o On-Premise
- Aggiungi regole di riscrittura nei file di configurazione Dispatcher o Apache per implementare i reindirizzamenti a livello di dominio.
- Configura le voci host virtuali per ciascun dominio o sottodominio per abilitare il routing corretto.
- Mappa ciascun dominio o sottodominio alla directory principale del sito AEM appropriata.
- Verificare che la configurazione dell’host virtuale consenta la risoluzione corretta del dominio e la definizione delle priorità.
Per Edge Delivery Services (EDS)
Configura i reindirizzamenti solo per corrispondenze esatte del percorso a livello di applicazione e gestisci i reindirizzamenti basati su host a livello di CDN.
Convalida:
- Esegui le richieste HTTP utilizzando strumenti come curl e verifica che la risposta contenga lo stato di reindirizzamento e l’intestazione della posizione corretti.
- Controlla i registri CDN o i risultati della distribuzione per verificare che le regole di reindirizzamento vengano eseguite correttamente.
- Verifica che non si verifichino loop di reindirizzamento garantendo un comportamento coerente di host e host inoltrati tra le richieste.
Quando effettuare l’inoltro:
- Il comportamento di reindirizzamento non corrisponde alla logica prevista dopo l’implementazione del meccanismo di reindirizzamento corretto.
- La distribuzione della configurazione CDN non riesce a causa di errori di convalida o sintassi non risolti.
- I domini non vengono indirizzati nonostante la corretta registrazione e i certificati SSL validi.
- I loop di reindirizzamento persistono a causa di incoerenze nell’intestazione dell’host.
- I requisiti di routing dei domini con caratteri jolly o dinamici non possono essere implementati utilizzando le funzionalità di AEM supportate.