DocumentaciónKCS de Experience Cloud

Generación e implementación de una clave X-AEM-Edge-Key en AEMaaCS

Última actualización: 3 de septiembre de 2026

Este artículo proporciona instrucciones paso a paso para generar, configurar e implementar la clave X-AEM-Edge para un entorno de Adobe Experience Manager as a Cloud Service. También se explica cómo utilizar la clave en varios dominios e implementarla a través de Cloud Manager.

Descripción description

Entorno

Adobe Experience Manager as a Cloud Service (AEMaaCS) (todas las versiones)

Problema/Síntomas

  • Es necesario configurar X-AEM-Edge-Key para un nuevo entorno de ensayo o de no producción.
  • Incertidumbre sobre el uso de la misma clave de Edge para varios dominios dentro del mismo entorno.
  • La opción de implementación Config no está visible al crear una canalización que no es de producción en Cloud Manager, lo que impide la implementación de la configuración de CDN necesaria.

Causa

El cliente administra X-AEM-Edge-Key y debe configurarlo e implementarlo a través de una canalización de configuración en Cloud Manager. Solo se permite una canalización de configuración por entorno y la clave se aplica al entorno en lugar de a los dominios individuales.

Resolución resolution

Siga estos pasos para resolver el problema:

  1. Genere la clave X-AEM-Edge:

    1. Utilice un generador aleatorio seguro para crear una cadena hexadecimal de 32 bytes. Por ejemplo: openssl rand -hex 32
    2. Utilice el valor generado como X-AEM-Edge-Key.

  2. Cree una variable de entorno secreta en Cloud Manager:

    1. En Cloud Manager, agregue una variable de entorno secreta, como CDN_EDGEKEY_<date>, al entorno de destino.
    2. Establezca su valor en la clave de Edge generada.

  3. Haga referencia al secreto en la configuración de CDN:

    1. En su repositorio, agregue o actualice el archivo de configuración de CDN en la ruta de configuración adecuada, como config/staging/cdn.yaml.
    2. Haga referencia a la variable secreta en el archivo YAML. Por ejemplo: edgeKey1: ${{CDN_EDGEKEY_<date>}}

  4. Implemente la configuración de CDN a través de una Canalización de configuración: Nota: Solo puede existir una canalización de configuración por entorno. Si la opción Config no está visible, compruebe si una canalización de configuración ya está dirigida al entorno. Si no existe ninguna canalización de configuración, póngase en contacto con el Soporte técnico de Adobe para habilitar la opción.

    1. En Cloud Manager, confirme que una canalización de configuración se dirige al entorno.

    2. Si ya existe una canalización de configuración, edítela para utilizar la siguiente configuración:

      • Repositorio: Su repositorio de AEM
      • Rama: Su rama de desarrollo, como dev
      • Ubicación del código: config o la subcarpeta apropiada

    3. ​​​​​ Ejecute la canalización para implementar la configuración de cdn.yaml en la CDN de Adobe

  5. Configure la CDN externa:

    • Establezca los siguientes encabezados cuando reenvíe el tráfico a la instancia de publicación:

      • Host: nombre de host de instancia de publicación
      • X-Forwarded-Host: su dominio
      • X-AEM-Edge-Key: clave de Edge generada

  6. Compruebe la configuración:

    1. Después de la implementación, confirme que las solicitudes reenviadas desde la CDN externa a AEM incluyen el X-AEM-Edge-Key correcto.
    2. Confirme que la CDN de Adobe acepta las solicitudes.
recommendation-more-help
experience-cloud-kcs-help-kbarticles