解决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配置文件结构:

    • 确保根据Adobe推荐的环境级别结构对CDN配置文件进行整理。 例如,使用平面结构,每个环境一个文件,如暂存环境为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