文档Experience Cloud KCS

在AEMaaCS中生成和部署X-AEM-Edge-Key

最近更新： 2026年9月4日

本文提供了针对Adobe Experience Manager as a Cloud Service环境生成、配置和部署X-AEM-Edge-Key的分步说明。 它还介绍了如何跨多个域使用密钥并通过Cloud Manager进行部署。

描述 description

环境

Adobe Experience Manager as a Cloud Service (AEMaaCS)（所有版本）

问题/症状

  • 需要为新暂存或非生产环境配置X-AEM-Edge-Key。
  • 关于在同一环境中为多个域使用同一边缘键的不确定性。
  • 在Cloud Manager中创建非生产管道时，配置部署选项不可见，导致无法部署所需的CDN配置。

原因

客户管理X-AEM-Edge-Key，并且必须通过Cloud Manager中的配置管道来配置和部署它。 每个环境只允许一个配置管道，并且键适用于环境而不是单个域。

解决方法 resolution

请按照以下步骤解决问题：

  1. 生成X-AEM-Edge-Key：

    1. 使用安全随机生成器创建32字节的十六进制字符串。 例如：openssl rand -hex 32
    2. 将生成的值用作X-AEM-Edge-Key。

  2. 在Cloud Manager中创建机密环境变量：

    1. 在Cloud Manager中，将机密环境变量（如CDN_EDGEKEY_<date>）添加到目标环境。
    2. 将其值设置为生成的边键。

  3. 引用CDN配置中的密码：

    1. 在您的存储库中，添加或更新相应配置路径（如config/staging/cdn.yaml）的CDN配置文件。
    2. 在YAML文件中引用密码变量。 例如：edgeKey1: ${{CDN_EDGEKEY_<date>}}

  4. 通过配置管道部署CDN配置： 注意：每个环境只能存在一个配置管道。 如果 Config 选项不可见，请检查配置管道是否已定位环境。 如果不存在配置管道，请联系Adobe支持以启用此选项。

    1. 在Cloud Manager中，确认配置管道针对该环境。

    2. 如果配置管道已存在，请编辑该管道以使用以下设置：

      • 存储库：您的AEM存储库
      • 分支：您的开发分支，如dev
      • 代码位置： config或相应的子文件夹

    3. ​ ​​ ​​ ​ ​运行管道以将cdn.yaml配置部署到Adobe CDN

  5. 配置外部CDN：

    • 在将流量转发到发布实例时，请设置以下标头：

      • Host：您的发布实例主机名
      • X-Forwarded-Host：您的域
      • X-AEM-Edge-Key：生成的边缘密钥

  6. 验证配置：

    1. 部署后，确认从外部CDN转发到AEM的请求包含正确的X-AEM-Edge-Key。
    2. 确认Adobe CDN接受请求。
recommendation-more-help
experience-cloud-kcs-help-kbarticles