DocumentazioneExperience Cloud KCS

Generare e distribuire una chiave X-AEM-Edge-Key in AEMaaCS

Ultimo aggiornamento: 3 settembre 2026

Questo articolo fornisce istruzioni dettagliate per generare, configurare e distribuire X-AEM-Edge-Key per un ambiente Adobe Experience Manager as a Cloud Service. Spiega anche come utilizzare la chiave in più domini e distribuirla tramite Cloud Manager.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS) (tutte le versioni)

Problema/Sintomi

  • È necessario configurare X-AEM-Edge-Key per un nuovo ambiente di staging o non di produzione.
  • Incertezza sull’utilizzo della stessa chiave edge per più domini all’interno dello stesso ambiente.
  • L’opzione di distribuzione Config non è visibile durante la creazione di una pipeline non di produzione in Cloud Manager, impedendo la distribuzione della configurazione CDN richiesta.

Causa

Il cliente gestisce X-AEM-Edge-Key e deve configurarlo e implementarlo tramite una pipeline di configurazione in Cloud Manager. È consentita una sola pipeline di configurazione per ambiente e la chiave si applica all’ambiente invece che ai singoli domini.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito:

  1. Genera la chiave X-AEM-Edge:

    1. Utilizza un generatore casuale sicuro per creare una stringa esadecimale a 32 byte. Ad esempio: openssl rand -hex 32
    2. Utilizza il valore generato come chiave di X-AEM-Edge.

  2. Creare una variabile di ambiente segreta in Cloud Manager:

    1. In Cloud Manager, aggiungere una variabile di ambiente segreta, ad esempio CDN_EDGEKEY_<date>, all’ambiente di destinazione.
    2. Imposta il relativo valore sulla chiave edge generata.

  3. Fai riferimento al segreto nella configurazione CDN:

    1. Nell’archivio aggiungere o aggiornare il file di configurazione CDN nel percorso di configurazione appropriato, ad esempio config/staging/cdn.yaml.
    2. Fai riferimento alla variabile segreta nel file YAML. Ad esempio: edgeKey1: ${{CDN_EDGEKEY_<date>}}

  4. Distribuisci la configurazione CDN tramite una pipeline di configurazione: Nota: può esistere una sola pipeline di configurazione per ogni ambiente. Se l’opzione Config non è visibile, verificare se una pipeline di configurazione è già destinata all’ambiente. Se non esiste alcuna pipeline di configurazione, contatta il supporto Adobe per abilitare l’opzione.

    1. In Cloud Manager, verifica che una pipeline di configurazione esegua il targeting dell’ambiente.

    2. Se esiste già una pipeline di configurazione, modificala per utilizzare le seguenti impostazioni:

      • Archivio: Archivio AEM
      • Ramo: Il ramo di sviluppo, ad esempio dev
      • Posizione codice: config o la sottocartella appropriata

    3. ​​​​​​​Esegui la pipeline per distribuire la configurazione cdn.yaml nel CDN di Adobe

  5. Configura la rete CDN esterna:

    • Imposta le seguenti intestazioni quando inoltri il traffico all’istanza Publish:

      • Host: nome host dell’istanza di pubblicazione
      • X-Forwarded-Host: dominio
      • X-AEM-Edge-Key: la chiave Edge generata

  6. Verifica la configurazione:

    1. Dopo la distribuzione, verificare che le richieste inoltrate dal CDN esterno ad AEM includano X-AEM-Edge-Key corretto.
    2. Conferma che la rete CDN di Adobe accetti le richieste.
recommendation-more-help
experience-cloud-kcs-help-kbarticles