DocumentationExperience Cloud KCS

Générer et déployer une clé X-AEM-Edge-Key dans AEMaaCS

Dernière mise à jour : 3 septembre 2026

Cet article fournit des instructions détaillées pour générer, configurer et déployer la clé X-AEM-Edge-Key pour un environnement Adobe Experience Manager as a Cloud Service. Elle explique également comment utiliser la clé sur plusieurs domaines et la déployer via Cloud Manager.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS) (toutes les versions)

Problème/Symptômes

  • Vous devez configurer la clé X-AEM-Edge-Key pour un nouvel environnement d’évaluation ou de non-production.
  • Incertitude quant à l’utilisation de la même clé Edge pour plusieurs domaines dans le même environnement.
  • L’option de déploiement Config n’est pas visible lors de la création d’un pipeline hors production dans Cloud Manager, ce qui empêche le déploiement de la configuration de réseau CDN requise.

Cause

Le client gère la clé X-AEM-Edge-Key et doit la configurer et la déployer via un pipeline de configuration dans Cloud Manager. Un seul pipeline de configuration est autorisé par environnement et la clé s’applique à l’environnement plutôt qu’aux domaines individuels.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Générez la clé X-AEM-Edge-Key :

    1. Utilisez un générateur aléatoire sécurisé pour créer une chaîne hexadécimale de 32 octets. Par exemple : openssl rand -hex 32
    2. Utilisez la valeur générée comme clé X-AEM-Edge.

  2. Créez une variable d’environnement secrète dans Cloud Manager :

    1. Dans Cloud Manager, ajoutez une variable d’environnement secrète, telle que CDN_EDGEKEY_<date>, à l’environnement cible.
    2. Définissez sa valeur sur la clé de périphérie générée.

  3. Référencez le secret dans la configuration du réseau CDN :

    1. Dans votre référentiel, ajoutez ou mettez à jour le fichier de configuration du réseau CDN au chemin de configuration approprié, tel que config/staging/cdn.yaml.
    2. Référencez la variable secrète dans le fichier YAML. Par exemple : edgeKey1: ${{CDN_EDGEKEY_<date>}}

  4. Déployez la configuration du réseau CDN via un pipeline de configuration : Remarque : un seul pipeline de configuration peut exister par environnement. Si l’option Config n’est pas visible, vérifiez si un pipeline Config cible déjà l’environnement. S’il n’existe aucun pipeline de configuration, contactez l’assistance Adobe pour activer l’option.

    1. Dans Cloud Manager, vérifiez qu’un pipeline Config cible l’environnement.

    2. Si un pipeline de configuration existe déjà, modifiez-le pour utiliser les paramètres suivants :

      • Référentiel : votre référentiel AEM
      • Branche : votre branche de développement, par exemple dev
      • Emplacement du code : config ou le sous-dossier approprié

    3. ​​​​​​exécutez le pipeline pour déployer la configuration cdn.yaml sur le réseau CDN Adobe

  5. Configurez le réseau CDN externe :

    • Définissez les en-têtes suivants lorsque vous transférez du trafic vers l’instance de publication :

      • Host : nom d’hôte de votre instance de publication
      • X-Forwarded-Host : votre domaine
      • X-AEM-Edge-Key : clé Edge générée

  6. Vérifiez la configuration :

    1. Après le déploiement, vérifiez que les requêtes transférées du réseau CDN externe à AEM incluent le X-AEM-Edge-Key correct.
    2. Vérifiez que le réseau CDN d’Adobe accepte les requêtes.
recommendation-more-help
experience-cloud-kcs-help-kbarticles