Akamai (BYOCDN)

Diese Konfiguration 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.

Voraussetzungen

Stellen Sie vor dem Einrichten der Akamai Property Manager-Regeln sicher, dass Sie über Folgendes verfügen:

  • Greifen Sie auf den Akamai Property Manager für Ihre Domain zu.
  • Einen API-Schlüssel für Edge Optimize, der von der Adobe Brand Visibility-Benutzeroberfläche abgerufen wurde. Die einzelnen Schritte finden Sie unter Abrufen Ihrer API-Schlüssel.
  • (Optional) Weitere Informationen zum Staging-Routing finden Sie unter Staging-API-Schlüssel.

Setup-Optionen

Es gibt zwei Möglichkeiten, Akamai für „Optimize at Edge“ zu konfigurieren:

Option 1: Geführtes Setup in Adobe Brand Visibility

Für das geführte Setup ist ein Akamai EdgeGrid-API-Client in Ihrem eigenen Akamai-Konto erforderlich, mit Zugriff des Typs Property Manager (PAPI) – READ-WRITE auf die Gruppe und den Vertrag der Zieleigenschaft sowie die Berechtigung zum Aktivieren von Eigenschaftsversionen in Akamai-Staging und -Produktion. Adobe Brand Visibility verwendet diese Anmeldedaten nur für das Setup und speichert sie nicht.

Vorbereiten des Akamai EdgeGrid-API-Clients

Wenn Sie noch keinen geeigneten API-Client haben, erstellen Sie einen im Akamai Control Center:

  1. Öffnen Sie Administration > Identität und Zugriff.
  2. Wählen Sie unter Users and API Clients (Benutzende und API-Clients) die Option Create API client (API-Client erstellen) aus.
  3. Wählen Sie Ich und dann Erweitert aus. Beschränken Sie den Client auf Property Manager (PAPI) – READ-WRITE, behalten Sie nur die Zielgruppe und den Vertrag bei und bestätigen Sie die Berechtigung zur Aktivierung in Staging und Produktion.
  4. Erstellen Sie den Client und laden Sie dann sofort die Datei mit den Anmeldedaten herunter oder kopieren Sie sie. Sie benötigen das Client-Geheimnis, den API-Host, das Zugriffs-Token und das Client-Token. Das Client-Geheimnis wird nur einmal angezeigt.

Erstellen eines API-Clients in der Akamai-Identitäts- und Zugriffsverwaltung

Beschränken des API-Clients auf Property Manager (PAPI) LESEN-SCHREIBEN

NOTE
Speichern Sie die Datei mit den Anmeldedaten im von Ihrer Organisation genehmigten Geheimnis-Manager. Adobe Brand Visibility speichert diese Anmeldedaten nicht. Sie verbleiben in Ihrer Browser-Sitzung und werden gelöscht, wenn Sie das Bereitstellungs-Dashboard schließen.

Bereitstellen der Routing-Konfiguration

  1. Öffnen Sie die CDN-Konfiguration für die URL, die Sie konfigurieren möchten.
  2. Wählen Sie unter Optimierungen für AI Agents bereitstellen bei Bedarf die Option Aktivieren aus.
  3. Wählen Sie Routing in Akamai bereitstellen (Beta) aus.
  4. Fügen Sie die Datei mit EdgeGrid-Anmeldedaten ein oder geben Sie das Client-Geheimnis, den API-Host, das Zugriffs-Token und das Client-Token einzeln ein und stellen Sie dann eine Verbindung her.
  5. Wählen Sie die Akamai-Eigenschaft aus, überprüfen Sie die vorgeschlagenen Änderungen und befolgen Sie die geführten Schritte zur Bereitstellung. Holen Sie vor der Aktivierung der neuen Eigenschaftsversion die Genehmigung ein.

Bereitstellen des Routings in Akamai über Adobe Brand Visibility

NOTE
Geführtes Setup ist als Funktion mit frühzeitigem Zugriff für geeignete Konten verfügbar. Unterstützung beim Onboarding erhalten Sie bei Ihrem Adobe-Account-Team oder per E-Mail an abv-at-edge@adobe.com.

Option 2: Manuelles Setup

Führen Sie die folgenden Schritte aus, um die Akamai Property Manager-Regeln manuell zu konfigurieren.

Konfiguration

Die folgende Regel von Akamai Property Manager leitet Agent-basierten HTML-Seiten-Traffic an Edge Optimize weiter. Die Konfiguration umfasst die folgenden Schritte:

​1. Festlegen von Routing-Kriterien (Zuordnung von Benutzer-Agent und HTML-Traffic)

Festlegen von Routing für die folgenden Benutzer-Agents:

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
Wenden Sie die Routing-Regel „Optimize at Edge“ nur auf Agent-basierten HTML-Seiten-Traffic an. Eine gängige Vorgehensweise ist die Verwendung von anfrageseitigen Kriterien wie Dateierweiterung, um html und EMPTY_STRING für Seiten-URLs ohne Erweiterung abzugleichen. Wenn Ihre Site HTML von anderen URL-Mustern bereitstellt oder nicht seitenbezogene Routen ohne Erweiterung wie API-Endpunkte enthält, verfeinern Sie die Regel mit zusätzlichen pfadbasierten Kriterien.

Festlegen von Routing-Kriterien

​2. Festlegen der Herkunft und des SSL-Verhaltens

Festlegen der Herkunft als live.edgeoptimize.net und Zuordnen von SAN zu *.edgeoptimize.net

NOTE
Falls die Eigenschaftenaktivierung nach dem Hinzufügen der Regel „Optimize at Edge“ fehlschlägt, überprüfen Sie, ob die Regel einen anderen SSL-Verifizierungsmodus für den Ursprungsserver verwendet als die Standardregel. Falls dies der Fall ist, aktualisieren Sie die Regel „Optimize at Edge“, sodass sie der Standardregel entspricht. Wenn die Standardregel beispielsweise Plattformeinstellungen verwendet, verwenden Sie hier auch Plattformeinstellungen. Falls Sie die erforderliche Einstellung nicht verwenden können, wenden Sie sich bitte an den Akamai-Support.

Festlegen der Herkunft und des SSL-Verhaltens

​3. Festlegen der Cache-Schlüsselvariablen

Festlegen der Cache-Schlüsselvariablen PMUSER_EDGE_OPTIMIZE_CACHE_KEY auf LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}

Festlegen der Cache-Schlüsselvariablen

​4. Caching-Regeln

Caching-Regeln

​5. Ändern der eingehenden Anfrage-Header

Legen Sie folgende eingehende Anfrage-Header fest:
x-edgeoptimize-api-key auf den von Adobe Brand Visibility abgerufenen API-Schlüssel
x-edgeoptimize-config in LLMCLIENT=TRUE;
x-edgeoptimize-url auf {{builtin.AK_URL}}

Ändern der eingehenden Anfrage-Header

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

Wenn Ihr CDN eine WAF oder einen Bot Manager verwendet:

  • Setzen Sie den *AdobeEdgeOptimize/1.0*-Benutzer-Agent in Ihrer WAF oder Ihrem Bot-Manager auf die Zulassungsliste, damit der Service „Optimize at Edge“ Ihre Ursprungsinhalte abrufen kann.

  • Wenn Ihre Firewall eine zusätzliche Überprüfung über den Benutzer-Agent hinaus erfordert, generieren Sie ein Geheimnis (z. B. openssl rand -hex 32) und:

    • Fügen Sie x-edgeoptimize-fetcher-key mit dem Geheimnis in Ihren Routing-Regeln zusammen mit den anderen x-edgeoptimize-*-Headern hinzu.
    • Fügen Sie eine WAF- oder Bot-Manager-Regel hinzu, um Anfragen zuzulassen, bei denen x-edgeoptimize-fetcher-key mit demselben Geheimnis übereinstimmt.
  • „Optimize at Edige“ leitet diesen Header unverändert weiter – Sie haben die volle Kontrolle über den gesamten Schlüssellebenszyklus.

Festlegen des Headers „x-edgeoptimize-fetcher-key“ im Property Manager

NOTE
Setzen Sie außerdem den Benutzer-Agent *AdobeEdgeOptimize/1.0* und den Header x-edgeoptimize-fetcher-key im Akamai Bot Manager auf die Zulassungsliste.

​6. Ändern der eingehenden Antwort-Header

Ändern der eingehenden Antwort-Header

​7. Cache-ID-Änderung

Cache-ID-Änderung

​8. Ändern der ausgehenden Anfrage-Header

Festlegen des x-forwarded-host-Headers auf {{builtin.AK_HOST}}

Ändern der ausgehenden Anfrage-Header

​9. Site-Failover

Die Site-Failover-Konfiguration besteht aus zwei Teilen: dem Failover-Verhalten (konfiguriert innerhalb der Haupt-Routing-Regel von „optimize-at-edge“) und einer separaten Header-Regel für den Failover-Test.

9 a. Verhalten bei Site-Failover (innerhalb der Haupt-Routing-Regel von „optimize-at-edge“)

Erstellen Sie innerhalb der Haupt-Routing-Regel von „Optimize at Edge“ eine untergeordnete Regel mit dem Namen Failover-Verhalten der Site. Setzen Sie diese Regel auf Beliebige Übereinstimmung und fügen Sie die folgenden Kriterien hinzu:

  • Antwort-Status-Code liegt im Bereich von 400 bis 599.
  • Ursprungs-Timeout ist Yes.

Fügen Sie dieser untergeordneten Regel das Site-Failover-Verhalten und das erweiterte XML-Snippet hinzu.

IMPORTANT
Der XML-Ausschnitt in diesem Schritt erfordert das erweiterte Verhalten. In einigen Akamai-Umgebungen ist dieses Verhalten bei der Selbstbearbeitung nicht verfügbar. Falls die Option Erweitert nicht angezeigt wird, wenden Sie sich bitte an Ihr Akamai-Konto-Team oder den Akamai-Support, um die erforderliche Konfiguration zu aktivieren.

Site-Failover

Fügen Sie den Anfrage-Header x-edgeoptimize-request mit dem Wert fo über Advanced XML hinzu:

<forward:availability.fail-action2>
<add-header>
<status>on</status>
<name>x-edgeoptimize-request</name>
<value>fo</value>
</add-header>
</forward:availability.fail-action2>

Failover-Verhalten

9 b. Regel für Failover-Test-Header (gleichrangige Regel)

IMPORTANT
Erstellen Sie die Regel EdgeOptimize Failover – Test-Header als gleichrangige Regel (auf derselben Ebene) der Routing-Regeln – nicht in diese verschachtelt. In der Regelstruktur des Akamai Property Manager sollte die Hierarchie wie folgt aussehen:
code language-none
▼ Optimize at Edge                          ← parent rule
      ▼ Optimize at Edge Routing                ← routing rule
              Site Failover Behavior                ← child of the routing rule
      EdgeOptimize Failover - Test Header       ← sibling of the routing rule
Dadurch wird sichergestellt, dass die Header-Regel des Failover-Tests für alle Routing-Regeln und nicht nur für eine bewertet wird.
Stellen Sie außerdem sicher, dass die Regel Optimize at Edge Routing nicht durch eine spätere übereinstimmende Regel überschrieben wird, die den Ursprung, das Caching-Verhalten oder die Cache-ID für dieselben Anfragen ändert. Wenn eine andere übereinstimmende Regel diese Verhaltensweisen zurücksetzt, funktionieren Routing oder Caching der Art „Optimize at Edge“ möglicherweise nicht wie erwartet.

Wenn der Wert des Anfrage-Headers x-edgeoptimize-request gleich fo ist, legen Sie den ausgehenden Antwort-Header x-edgeoptimize-fo auf true fest.

Failover-Regeln

Site-Failover stellt sicher, dass die Anfrage automatisch an Ihren Standardursprung zurückgeleitet wird, wenn Edge Optimize einen 4XX- oder 5XX-Fehler zurückgibt, sodass der bzw. die Endbenutzende weiterhin eine Antwort erhält.

Szenario
Verhalten
Edge Optimize gibt 2XX zurück
Der Client erhält eine optimierte Antwort.
Edge Optimize gibt 4XX oder 5XX zurück
Die Anfrage wird an den Standardursprung zurückgeleitet.

Ü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

Kopfzeile
Bot-Traffic (optimiert)
Menschlicher Traffic (nicht betroffen)
x-edgeoptimize-request-id
Vorhanden – enthält eine eindeutige Anfrage-ID
Abwesend
x-edgeoptimize-fo
Nur vorhanden, wenn Failover stattgefunden hat (Wert: true)
Abwesend

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.

Bereitstellen von Optimierungen für AI Agents – abgeschlossen

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.

recommendation-more-help
brand-visibility-help-main-toc