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:
- Zugriff auf den Akamai Property Manager für Ihre Domain.
- Einen Edge Optimize-API-Schlüssel, 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.
Einrichtungsoptionen
Es gibt zwei Möglichkeiten, Akamai für „Optimieren“ bei Edge zu konfigurieren:
- Option 1: Geführte Einrichtung in Adobe Brand Visibility (empfohlen) - Verwenden Sie Adobe Brand Visibility, um die Routing-Konfiguration bereitzustellen.
- Option 2: Manuelles Setup - Konfigurieren des Routings in Akamai Property Manager.
Option 1: Geführte Einrichtung in Adobe Brand Visibility
Für die geführte Einrichtung ist ein Akamai EdgeGrid-API-Client in Ihrem eigenen Akamai-Konto erforderlich, mit Property Manager (PAPI) — LESE-/SCHREIB-Zugriff 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 Anmeldeinformationen 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:
- Öffnen Sie Administration > Identität und Zugriff.
- Wählen Sie unter Benutzer und API die Option API-Client erstellen aus.
- Wählen Sie Ich und dann Erweitert. Beschränken Sie den Client auf Property Manager (PAPI) - LESEN-SCHREIBEN, behalten Sie nur die Zielgruppe und den Vertrag bei und bestätigen Sie die Berechtigung zur Aktivierung in Staging und Produktion.
- Erstellen Sie den Client und laden Sie dann sofort die Datei mit den Anmeldeinformationen herunter oder kopieren Sie sie. Sie benötigen das Client-Geheimnis, den API-Host, das Zugriffstoken und das Client-Token. Das Client-Geheimnis wird nur einmal angezeigt.
Bereitstellen der Routing-Konfiguration
- Öffnen Sie CDN-) für die URL, die Sie konfigurieren möchten.
- Wählen unter „Optimierungen für KI Agenten bereitstellen bei die Option Aktivieren“ aus.
- Wählen Sie Routing bereitstellen in Akamai (Beta).
- Fügen Sie die EdgeGrid-Berechtigungsdatei ein oder geben Sie das Client-Geheimnis, den API-Host, das Zugriffstoken und das Client-Token einzeln ein und stellen Sie dann eine Verbindung her.
- Wählen Sie die Akamai-Eigenschaft aus, überprüfen Sie die vorgeschlagenen Änderungen und befolgen Sie die geführten Schritte zur Bereitstellung. Einholen der Genehmigung vor der Aktivierung der neuen Eigenschaftsversion.
Option 2: Manuelle Einrichtung
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. Routing-Kriterien festlegen (Traffic-Übereinstimmung zwischen Benutzeragent und HTML)
Festlegen von Routing für die folgenden Benutzer-Agents:
*AdobeEdgeOptimize-AI*
*ChatGPT-User*
*GPTBot*
*OAI-SearchBot*
*PerplexityBot*
*Perplexity-User*
*ClaudeBot*
*Claude-User*
*Claude-SearchBot*
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.
2. Festlegen des Ursprungs- und SSL-Verhaltens
Festlegen der Herkunft als live.edgeoptimize.net und von „SAN zuordnen“ auf *.edgeoptimize.net
3. Cache-Schlüsselvariable festlegen
Festlegen der Cache-Schlüsselvariablen PMUSER_EDGE_OPTIMIZE_CACHE_KEY auf LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}
4. Zwischenspeicherungsregeln
5. Header eingehender Anfragen ändern
Legen Sie folgende eingehende Anfrage-Header fest:x-edgeoptimize-api-key zum von Adobe Brand Visibility abgerufenen API-Schlüsselx-edgeoptimize-config in LLMCLIENT=TRUE;x-edgeoptimize-url auf {{builtin.AK_URL}}
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-keymit dem Geheimnis in Ihren Routing-Regeln zusammen mit den anderenx-edgeoptimize-*-Headern hinzu. - Fügen Sie eine WAF- oder Bot-Manager-Regel hinzu, um Anfragen zuzulassen, bei denen
x-edgeoptimize-fetcher-keymit demselben Geheimnis übereinstimmt.
- Fügen Sie
-
„Optimize at Edige“ leitet diesen Header unverändert weiter – Sie haben die volle Kontrolle über den gesamten Schlüssellebenszyklus.
*AdobeEdgeOptimize/1.0* und den Header x-edgeoptimize-fetcher-key im Akamai Bot Manager auf die Zulassungsliste.6. Eingehende Antwortkopfzeilen ändern
7. Cache-ID-Änderung
8. Ausgehende Anfragekopfzeilen ändern
Festlegen des x-forwarded-host-Headers auf {{builtin.AK_HOST}}
9. Standort-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.
9a. Site-Failover-Verhalten (innerhalb der Haupt-Routingregel „optimieren an 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
400bis599. - Ursprungs-Timeout ist
Yes.
Fügen Sie dieser untergeordneten Regel das Site-Failover-Verhalten und das erweiterte XML-Snippet hinzu.
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>
9b. Failovertest-Header-Regel (gleichrangige Regel)
| code language-none |
|---|
|
Wenn der Wert des Anfrage-Headers x-edgeoptimize-request gleich fo ist, legen Sie den ausgehenden Antwort-Header x-edgeoptimize-fo auf true fest.
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.
2XX zurück4XX oder 5XX zurückÜ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
x-edgeoptimize-request-idx-edgeoptimize-fotrue)Der Status des Traffic-Routings kann auch in der Adobe Brand Visibility-Benutzeroberfläche ü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.