Apache HTTP Server

Diese Konfiguration gilt, wenn Apache HTTP Server als Reverse-Proxy vor Ihrem Ursprung fungiert (ein selbst gehostetes Setup, ohne AEM Dispatcher). Sie leitet den Agent-basierten Traffic (Anfragen von KI-Bots und LLM-Benutzer-Agents) an den Backend-Service von Edge Optimize (live.edgeoptimize.net) weiter.Menschliche Besuchende und SEO-Bots werden weiterhin wie gewohnt von Ihrem Ursprung aus unterstützt. Um die Konfiguration zu testen, suchen Sie nach Abschluss der Einrichtung in der Antwort nach dem x-edgeoptimize-request-id-Header.

Bei der Integration handelt es sich um einen Satz nativer Apache-Include-Dateien, für die kein Code oder Worker bereitgestellt werden muss. Sie laden drei Dateien herunter, legen Ihren API-Schlüssel fest und fügen Ihrem virtuellen Host zwei Include-Zeilen hinzu.

Voraussetzungen

Stellen Sie vor dem Einrichten der Apache-Routing-Regeln sicher, dass Sie über Folgendes verfügen:

Konfiguration

1. Herunterladen der Konfigurationsdateien

Laden Sie die drei enthaltenen Edge Optimize-Dateien aus dem Respository mit Optimize at Edge-Code-Beispielen herunter und legen Sie sie in einem Verzeichnis auf Ihrem Apache-Server ab (z. B. conf/oae/):

Sie müssen oae-routing.conf oder oae-failover.conf nicht ändern – verwenden Sie sie unverändert.

2. Aktivieren Ihrer Domain und Festlegen des API-Schlüssels (domains.conf)

Bearbeiten Sie domains.conf und fügen Sie pro zu aktivierender Domain eine Zeile hinzu. Ersetzen Sie den Host durch Ihre Domain und YOUR_API_KEY durch den Schlüssel von der Adobe Brand Visibility-Benutzeroberfläche. Nicht aufgeführte Domains werden unverändert an den Ursprung weitergeleitet, sodass Sie jeweils nur eine Domain aktivieren können.

SetEnvIfExpr "%{HTTP_HOST} =~ m#(?i)^(www\.)?example\.com(:\d+)?$#" OAE_DOMAIN_ENABLED=1 OAE_API_KEY=YOUR_API_KEY

3. Einfügen der Dateien in Ihren virtuellen Host

Fügen Sie die beiden Include-Zeilen zu Ihrem vorhandenen <VirtualHost *:443> hinzu. Die Routing-Datei wird vor Ihren Rewrite- und ProxyPass-Regeln eingefügt, die Failover-Datei danach. Im folgenden Beispiel sind die mit #NEWLINE gekennzeichneten Zeilen die einzigen Zeilen, die Sie für „Optimize at Edge“ hinzufügen – alles andere (ServerName, ProxyPass und der Rest) ist Ihre bestehende, unveränderte Konfiguration.

Define OAE_CONF_DIR conf/oae                       #NEWLINE  directory holding the OAE include files

<VirtualHost *:443>
    ServerName www.example.com

    Include "${OAE_CONF_DIR}/oae-routing.conf"     #NEWLINE  OAE routing — BEFORE your Rewrite & ProxyPass rules

    # --- your existing rewrite rules and ProxyPass to origin ---
    ProxyPass        "/" "https://www.example.com/"
    ProxyPassReverse "/" "https://www.example.com/"

    Include "${OAE_CONF_DIR}/oae-failover.conf"    #NEWLINE  OAE failover — AFTER your ProxyPass rules
</VirtualHost>

4. Erneutes Laden von Apache

Überprüfen Sie die Konfiguration und laden Sie Apache neu, um die Änderungen anzuwenden.

Zulassen von „Optimize at Edge“ durch Firewall-Regeln (optional)

Wenn Ihr CDN eine WAF oder einen Bot Manager verwendet:

Überprüfen des Setups

Stellen Sie nach Abschluss des Setups sicher, dass Bot-Traffic an Edge Optimize weitergeleitet wird und dass der menschliche Traffic nicht betroffen ist.

1. Testen des Bot-Traffics (sollte optimiert werden)

Simulieren Sie eine KI-Bot-Anfrage mithilfe eines Agent-basierten Benutzer-Agents:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

Eine erfolgreiche Antwort enthält den x-edgeoptimize-request-id-Header, der bestätigt, dass die Anfrage über Edge Optimize weitergeleitet wurde:

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. Testen des menschlichen Traffics (sollte NICHT betroffen sein)

Simulieren Sie eine normale menschliche Browser-Anfrage:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

Die Antwort sollte nicht den x-edgeoptimize-request-id-Header enthalten. Der Seiteninhalt und die Antwortzeit sollten nach der Aktivierung von „Optimize at Edge“ unverändert bleiben.

3. So lassen sich die beiden Szenarien voneinander unterscheiden

Der Status des Traffic-Routing kann auch auf der Benutzeroberfläche von Adobe Brand Visibility überprüft werden. Navigieren Sie zu Kundenkonfiguration und wählen Sie die Registerkarte CDN-Konfiguration aus.

Weitere Informationen zu Optimize at Edge, einschließlich verfügbarer Möglichkeiten, Workflows für die automatische Optimierung und häufig gestellte Fragen, finden Sie unter Optimize at Edge – Überblick.