DokumentationExperience Cloud KCS

Generieren und Bereitstellen eines X-AEM-Edge-Schlüssels in AEMaaCS

Letzte Aktualisierung: 3. September 2026

Dieser Artikel enthält Schritt-für-Schritt-Anweisungen zum Generieren, Konfigurieren und Bereitstellen des X-AEM-Edge-Schlüssels für eine Adobe Experience Manager as a Cloud Service-Umgebung. Außerdem wird erläutert, wie Sie den -Schlüssel in mehreren Domains verwenden und über Cloud Manager bereitstellen.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS) (alle Versionen)

Problem/Symptome

  • Sie müssen den X-AEM-Edge-Key für eine neue Staging- oder Nicht-Produktionsumgebung konfigurieren.
  • Unsicherheit über die Verwendung desselben Edge-Schlüssels für mehrere Domains in derselben Umgebung.
  • Die Bereitstellungsoption config wird beim Erstellen einer produktionsfremden Pipeline in Cloud Manager nicht angezeigt, was die Bereitstellung der erforderlichen CDN-Konfiguration verhindert.

Ursache

Der Kunde verwaltet den X-AEM-Edge-Key und muss ihn über eine Konfigurations-Pipeline in Cloud Manager konfigurieren und bereitstellen. Pro Umgebung ist nur eine Konfigurations-Pipeline zulässig. Der Schlüssel gilt für die Umgebung und nicht für einzelne Domains.

Lösung resolution

Führen Sie zur Behebung des Problems folgende Schritte aus:

  1. Generieren Sie den X-AEM-Edge-Key:

    1. Verwenden Sie einen sicheren Zufallsgenerator, um eine 32-Byte-Hexadezimal-Zeichenfolge zu erstellen. Beispiel: openssl rand -hex 32
    2. Verwenden Sie den generierten Wert als X-AEM-Edge-Key.

  2. Erstellen Sie eine geheime Umgebungsvariable in Cloud Manager:

    1. Fügen Sie in Cloud Manager eine geheime Umgebungsvariable, z. B. CDN_EDGEKEY_<date>, zur Zielumgebung hinzu.
    2. Legen Sie den Wert auf den generierten Edge-Schlüssel fest.

  3. Verweisen Sie auf die geheimen Daten in der CDN-Konfiguration:

    1. Fügen Sie im Repository die CDN-Konfigurationsdatei unter dem entsprechenden Konfigurationspfad hinzu oder aktualisieren Sie sie, z. B. config/staging/cdn.yaml.
    2. Verweisen Sie auf die geheime Variable in der YAML-Datei. Beispiel: edgeKey1: ${{CDN_EDGEKEY_<date>}}

  4. Stellen Sie die CDN-Konfiguration über eine Konfigurations-Pipeline bereit: Hinweis Pro Umgebung kann nur eine Konfigurations-Pipeline vorhanden sein. Wenn die Option config nicht sichtbar ist, überprüfen Sie, ob eine Konfigurations-Pipeline bereits auf die Umgebung abzielt. Wenn keine Konfigurations-Pipeline vorhanden ist, wenden Sie sich an den Adobe-Support, um die Option zu aktivieren.

    1. Bestätigen Sie in Cloud Manager, dass eine Konfigurations-Pipeline auf die Umgebung abzielt.

    2. Wenn bereits eine Konfigurations-Pipeline vorhanden ist, bearbeiten Sie sie, um die folgenden Einstellungen zu verwenden:

      • repository: Ihr AEM-Repository
      • Verzweigung: Ihre Entwicklungsverzweigung, z. B. dev
      • Code-Speicherort: config oder den entsprechenden Unterordner

    3. ​​​​​Ausführen​Führen Sie die Pipeline aus, um die cdn.yaml-Konfiguration im Adobe CDN bereitzustellen

  5. Konfigurieren des externen CDN:

    • Legen Sie die folgenden Kopfzeilen fest, wenn Sie Traffic an die Veröffentlichungsinstanz weiterleiten:

      • Host: Ihr Hostname für die Veröffentlichungsinstanz
      • X-Forwarded-Host: Ihre Domain
      • X-AEM-Edge-Key: Der generierte Edge-Schlüssel

  6. Überprüfen Sie die Konfiguration:

    1. Bestätigen Sie nach der Bereitstellung, dass vom externen CDN an AEM weitergeleitete Anfragen die richtige X-AEM-Edge-Key enthalten.
    2. Vergewissern Sie sich, dass das Adobe CDN die Anfragen akzeptiert.
recommendation-more-help
experience-cloud-kcs-help-kbarticles