Dokumentation

Geolocation-Antwort-Header spiegeln nicht den Client-IP-Speicherort in AEMaaCS wider

Last update: Mon Jul 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Geolocation-Kopfzeilen in HTTP-Antworten von Adobe Experience Manager as a Cloud Service (AEMaaCS) spiegeln den tatsächlichen Client-Speicherort nicht wider. Versuche, die Geolokalisierung mithilfe einer cdn.yaml-Datei zu konfigurieren, führen aufgrund einer falschen Struktur oder der Verwendung reservierter Kopfzeilennamen zu Bereitstellungsfehlern. Um das Problem zu beheben, aktualisieren Sie die CDN-Konfiguration und testen Sie sie von einer gültigen IP-Adresse.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites (Entwicklung)

Problem/Symptome

  • Geolocation-Kopfzeilen wie X-AEM-Client-Country geben Platzhalterwerte zurück.
  • Kopfzeilen werden nicht in HTTP-Antworten vom Veröffentlichungsendpunkt angezeigt.
  • Bereitstellungsfehler treten aufgrund falscher cdn.yaml oder reservierter Kopfzeilennamen auf.
  • Die Antworten entsprechen nicht dem erwarteten Land für spanische IP-Adressen.

Auflösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Stellen Sie sicher, dass sich die cdn.yaml-Datei unter /config/cdn.yaml in Ihrem Cloud Manager-Git-Repository befindet. Vermeiden Sie zusätzliche Unterordner oder Tippfehler im Pfad.

  2. Bearbeiten Sie die Datei cdn.yaml so, dass ein benutzerdefinierter Kopfzeilenname anstelle reservierter Präfixe wie x-aem- verwendet wird. Verwenden Sie beispielsweise Client-Country und definieren Sie die Umwandlungsregel wie folgt:

    code language-none 
    kind: "CDN"
   version: "1"
   metadata:
   envTypes: \[ "dev"]
   data:
   responseTransformations:
   rules:
   * name: add-country-header
     when: "\*"
     actions:
     * type: set
       respHeader: "Client-Country"
       value: "{reqHeader:x-aem-client-country}"
       \

  3. Übertragen Sie die Änderungen und stellen Sie die Konfiguration mithilfe von Cloud Manager bereit. Stellen Sie sicher, dass die Pipeline ohne YAML-Syntax- oder Header-Namensfehler abgeschlossen wird.

  4. Testen Sie das Setup mit einem VPN oder einem externen Netzwerk mit einer IP-Adresse aus dem Zielland (z. B. Spanien). Dadurch wird sichergestellt, dass das CDN präzise Geolocation-Header in HTTP-Antworten basierend auf IP einfügt.

  5. Führen Sie eine DNS-Suche auf Ihrem Veröffentlichungsendpunkt durch, um zu überprüfen, ob er über das CDN von Adobe weitergeleitet wird. Verwenden Sie dann einen ausführlichen curl -I -v <publish-url>-Befehl, um nach CDN-bezogenen Kopfzeilen wie x-cache oder via zu suchen.

  6. Stellen Sie sicher, dass keine Zwischensysteme (z. B. Dispatcher- oder Caching-Ebenen) die erforderlichen Header vor der Transformation entfernen.

Wenn das Problem weiterhin besteht, überprüfen Sie die Pipeline-Protokolle auf Fehler oder Warnungen und überprüfen Sie die IP-Adresse der Anfrage. Untersuchen Sie weiter, ob Zwischensysteme die Kopfzeileneinspritzung oder -umwandlung stören.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f