AEM雲端和AMS環境中的CDN網域重新導向和路由問題
當網域未正確對應,或由於不支援的設定或缺少必要條件而重新導向失敗時,Adobe Experience Manager (AEM)會遇到網域重新導向和路由問題。 發生此情況是因為重新導向行為取決於執行層,例如CDN、Dispatcher或AEM,以及由於缺乏萬用字元網域支援和必要的SSL設定等限制。 若要解決此問題,請識別正確的重新導向機制,並根據AEM執行階段設定網域註冊、SSL和重新導向規則。
說明 description
環境
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- Adobe Managed Services (AMS)
- Adobe Experience Manager (AEM) On-Premise
問題/症狀
- 網域一律會解析為網站根目錄,而非預期的頁面。
- 由於錯誤的主機標頭行為,重新導向會導致無限回圈。
- 網域未在Cloud Manager中註冊,因此不會觸發重新導向。
- 無法新增萬用字元子網域(
*.example.com),流量失敗。 - CDN管道部署因無效的設定語法而失敗。
根本原因
重新導向行為取決於執行重新導向的位置,例如CDN、Dispatcher或AEM。 AEM as a Cloud Service需要明確的網域註冊和有效的SSL憑證才能進行CDN處理。 不支援萬用字元網域對應,且重新導向規則或主機標頭的設定不正確會導致失敗或回圈。
解決方法 resolution
請依照下列步驟設定正確的網域型重新導向和路由行為:
- 識別在AEM處理請求之前或到達AEM之後必須發生重新導向,以判斷正確的執行層。
- 在AEM as a Cloud Service中,針對網域對路徑路由使用CDN重新導向。
- 對Adobe Managed Services或內部部署環境使用Dispatcher或Apache重寫規則。
- 如果需求涉及AEM不支援的動態萬用字元子網域,請使用外部重新導向服務。
- 使用Edge Delivery Services時,請使用CDN型重新導向進行主機層級路由,因為應用程式層僅支援完全相符的路徑。
適用於AEM as a Cloud Service (AEMaaCS)的
- 開啟Cloud Manager,瀏覽至環境,並存取 網域管理 以新增重新導向所需的所有網域。
- 上傳並設定每個網域的有效SSL憑證,包括非www網域。
- 確認每個網域都顯示具有有效憑證的有效狀態。
- 建立或更新存放庫根目錄中的
cdn.yaml檔案,以定義重新導向規則。 - 使用具有必要狀態代碼和目的地路徑或URL的主機型條件,定義重新導向規則。
- 執行Cloud Manager設定管道以部署CDN規則並驗證部署是否成功完成。
- 透過檢視管道日誌並更正規則結構來修復設定檔案中的任何語法錯誤。
- 在適用的情況下,使用支援的符合條件來設定圖樣式重新導向。
- 避免在CDN規則中使用萬用字元主機名稱,因為這些主機名稱不受支援。
適用於Adobe Managed Services (AMS)或內部部署
- 在Dispatcher或Apache設定檔案中新增重寫規則,以實施網域層級的重新導向。
- 設定每個網域或子網域的虛擬主機專案,以啟用適當的路由。
- 將每個網域或子網域對應至適當的AEM網站根目錄。
- 驗證虛擬主機設定是否允許正確的網域解析度和優先順序。
適用於Edge Delivery Services (EDS)的
僅針對應用程式層級的完全相符路徑設定重新導向,並在CDN層處理主機型重新導向。
驗證:
- 使用curl等工具執行HTTP要求,並確認回應包含正確的重新導向狀態和位置標頭。
- 檢查CDN記錄或部署結果,確認重新導向規則可正確執行。
- 透過確保請求間的主機與轉送主機行為一致,確認不會發生重新導向回圈。
何時上報:
- 實作正確的重新導向機制後,重新導向行為不符合預期的邏輯。
- CDN設定部署因未解決的驗證或語法錯誤而失敗。
- 網域無法路由,儘管已正確註冊且具備有效的SSL憑證。
- 由於主機標頭不一致,重新導向回圈持續存在。
- 無法使用支援的AEM功能實作萬用字元或動態網域路由需求。
相關閱讀
- AEMaaCS CDN設定
- AEM網域對應
- Dispatcher設定
- AEM as a Cloud Service中的CDN
- AEM as a Cloud Service發行說明(2023.11.0)
recommendation-more-help
experience-cloud-kcs-help-kbarticles