Correzione dei problemi di indirizzamento e intestazione CDN in AEMaaCS
Le configurazioni CDN personalizzate in AEMaaCS non riescono a causa di impostazioni di origine errate, intestazioni richieste mancanti o regole di routing non configurate correttamente. AEM indirizza sempre il traffico tramite Fastly gestito da Adobe, che richiede il targeting corretto del nome host e intestazioni specifiche per accettare le richieste. La configurazione errata comporta errori di routing, mancata corrispondenza SSL ed errori quali 421 o dominio sconosciuto. Correggi la configurazione dell’origine, l’inoltro delle intestazioni e il routing cdn.yaml per risolvere il problema e ripristinare il flusso di richieste corretto.
Descrizione description
Ambiente
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services
- Adobe Developer App Builder
Problema/Sintomi
- Le richieste ad AEM non riescono con 421 o errori di dominio sconosciuto.
- Il CDN del cliente non può raggiungere l’endpoint di pubblicazione.
- Si verificano errori di routing o mancata corrispondenza SSL.
- Vengono visualizzate incoerenze nella memorizzazione in cache.
- L’autenticazione basata su intestazione non riesce quando le intestazioni richieste vengono rimosse o sovrascritte.
Causa principale
AEM as a Cloud Service indirizza tutto il traffico attraverso Fastly prima di raggiungere il livello di pubblicazione. Le richieste provenienti da una rete CDN del cliente devono includere le intestazioni richieste come Host, SNI e X-AEM-Edge-Key durante il targeting del nome host di pubblicazione corretto. Una configurazione errata o mancante comporta il rifiuto momentaneo o l’instradamento errato delle richieste.
Risoluzione resolution
Per risolvere il problema, eseguire la procedura seguente:
- Identifica il nome host di pubblicazione dagli ambienti Cloud Manager e verificalo caricando l’URL direttamente in un browser in cui restituisce una risposta 403 o simile. Configura l’origine CDN o WAF in modo che punti al nome host di pubblicazione esatto e imposta l’intestazione Host, SNI, il protocollo HTTPS e la porta 443 in modo che l’handshake SSL abbia esito positivo.
- Inoltra le intestazioni richieste dalla rete CDN a Fastly configurando
X-AEM-Edge-Key,X-Forwarded-Host,X-Forwarded-Protoe facoltativamenteX-Forwarded-For. In questo modo Fastly riconosce la richiesta come attendibile, quindi verifica l’inoltro delle intestazioni tramite i registri e i test curl. - Se è richiesto il routing personalizzato, esegui il commit del file
cdn.yamlnell’archivio Git di Cloud Manager in /config e aggiungi le regole del selettore di origine, quindi esegui la pipeline di configurazione per garantire la corretta distribuzione. - Configura l’iniezione di intestazione geografica utilizzando le regole di trasformazione delle richieste cdn.yaml per mappare le intestazioni geografiche Adobe esistenti, come
x-aem-client-countryex-aem-client-continent, su intestazioni personalizzate comeX-Forwarded-CountryeX-Forwarded-Regione verificare la trasformazione tramite l’ispezione delle intestazioni. - Convalida il flusso DNS indicando il dominio pubblico alla rete CDN del cliente e garantendo che le destinazioni CDN siano Fastly e quindi AEM, evitando il mapping DNS diretto a Fastly per i domini personalizzati.
- Verifica che Fastly sia sempre posizionato tra la rete CDN del cliente e AEM e non possa essere rimosso o ignorato, quindi esegui la convalida end-to-end accedendo al sito tramite il dominio pubblico e verificando il comportamento di routing, intestazioni e caching utilizzando gli strumenti di sviluppo del browser.