解決AEM as a Cloud Service中CDN快取清除的「未授權清除」錯誤

本文說明如何解決​ 未經授權的清除。 請透過設定管道設定PURGE金鑰。在Adobe Experience Manager as a Cloud Service中清除CDN快取時發生 ​錯誤。 解決方案包括檢閱並修正CDN設定檔案結構和清除金鑰設定。

說明 description

環境

Adobe Experience Manager as a Cloud Service (AEMaaCS) (任何環境型別)

症狀

  • CDN清除請求(例如透過curl)會失敗,並出現類似下列的回應:

    { "status": "error", "reason": "Unauthorized Purge. Please setup a PURGE key via Configuration Pipeline." }

  • 設定管道成功完成,且清除索引鍵會顯示為環境變數。

  • 該問題會影響一個或多個環境,具體取決於設定檔案結構。

原因

最常見的原因是CDN設定檔案未根據建議的環境層級結構來組織,或者有重複或衝突的變數定義。 因此,清除驗證器不會被套用,而且清除請求會因未授權而被拒絕。

解決方法 resolution

請依照下列步驟解決問題:

  1. 檢閱程式碼存放庫中的CDN設定檔案結構:

    • 請確定CDN設定檔案已根據Adobe建議的環境層級結構組織。 例如,使用平面結構,每個環境一個檔案,例如cdn-stage.yaml用於暫存,cdn-prod.yaml用於生產,每個檔案都指定適當的envTypes。

    • 避免將CDN設定檔案放置在Cloud Manager未針對環境層級設定評估的子資料夾中。

    • 移除可能套用至相同環境的任何重複或衝突的CDN設定檔案。

  2. 檢查清除金鑰密碼變數指派:

    • 在執行設定管道之前,請先確認清除金鑰機密(例如: CDN_PURGEKEY_PRIMARY、CDN_PURGEKEY_SECONDARY或環境特定等同專案)已設定為環境變數。

    • 請確定這些密碼的Service Applied欄位已設為​全部,而且不限於特定服務。

  3. 移除重複的變數定義:

    • 請勿將相同的變數設定為管道變數和環境變數。 每個變數僅使用一個方法。

    • 如果需要環境特定的變數,請僅保留環境變數並移除管道變數(反之亦然,若不需要)。

  4. 使用Cloud Manager設定管道重新部署設定。

    • 等候部署成功完成。
  5. 驗證永久刪除功能:

    • 請使用X-AEM-Purge-Key標頭中的正確清除金鑰重試CDN清除請求。

    • curl命令範例:

    code language-none
    curl -X PURGE "https:///content/..." \
    -H "X-AEM-Purge-Key: " \
    -H "X-AEM-Purge: soft"
    
    • 確認回應成功(例如: { "status": "ok" })。

相關閱讀

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