Akamai (BYOCDN)

Dernière mise à jour : 15 avril 2026

Rubriques :
Opportunities

Cette configuration achemine le trafic dynamique (requêtes provenant de robots d’IA et d’agents utilisateurs LLM) vers le service principal Edge Optimize (live.edgeoptimize.net). Les visiteurs humains et les robots d’optimisation du moteur de recherche continuent d’être servis depuis votre origine comme d’habitude. Pour tester la configuration, une fois la configuration terminée, recherchez l’en-tête x-edgeoptimize-request-id dans la réponse.

Conditions préalables

Avant de configurer les règles du gestionnaire de propriétés Akamai, vérifiez que vous disposez des éléments suivants :

Accès au gestionnaire de propriétés Akamai pour votre domaine.
Clé d’API Edge Optimize récupérée à partir de l’interface utilisateur de LLM Optimizer. Pour connaître les étapes, voir Récupération de vos clés API.
(Facultatif) Pour tester le routage d’évaluation, consultez Clé API d’évaluation.

Configuration

La règle Akamai Property Manager suivante achemine le trafic des pages HTML authentiques vers Edge Optimize. La configuration contient les étapes suivantes :

1. Définissez des critères de routage (correspondance de trafic Agent-utilisateur et HTML)

Définissez le routage pour les agents utilisateurs suivants :

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*

NOTE

Appliquez la règle de routage Optimiser au niveau d’Edge uniquement au trafic de pages d’HTML authentiques. Une configuration courante consiste à utiliser des critères côté requête tels que Extension de fichier pour faire correspondre les html et les EMPTY_STRING pour les URL de page sans extension. Si votre site diffuse HTML à partir d’autres modèles d’URL ou inclut des itinéraires sans extension hors page, tels que des points d’entrée d’API, affinez la règle avec des critères supplémentaires basés sur un chemin d’accès.

Définir les critères de routage

2. Définir l’origine et le comportement SSL

Définissez l’origine comme live.edgeoptimize.net et faites correspondre le SAN à *.edgeoptimize.net

NOTE

Si l’activation de la propriété échoue après l’ajout de la règle Optimiser sur Edge , vérifiez si la règle utilise un mode de vérification SSL du serveur d’origine différent de celui de la règle par défaut. Si tel est le cas, mettez à jour la règle Optimiser sous Edge pour qu’elle corresponde à la règle par défaut. Par exemple, si la règle par défaut utilise Paramètres de la plateforme, utilisez Paramètres de la plateforme ici également. Si vous ne pouvez pas utiliser le paramètre requis, contactez l’assistance Akamai.

Définir l’origine et le comportement SSL

3. Définir la variable de clé de cache

Définissez la variable de cache PMUSER_EDGE_OPTIMIZE_CACHE_KEY sur LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}

Définir la variable de clé de cache

4. Règles de mise en cache

Règles de mise en cache

5. Modifier les en-têtes des requêtes entrantes

Définissez les en-têtes de requête entrante suivants :
x-edgeoptimize-api-key à la clé API extraite de LLMO
x-edgeoptimize-config vers LLMCLIENT=TRUE;
x-edgeoptimize-url à {{builtin.AK_URL}}

Modifier les en-têtes des requêtes entrantes

Autoriser l’optimisation sur Edge via des règles de pare-feu (facultatif)

Si votre réseau CDN utilise un WAF ou un gestionnaire de robots :

Placez sur la liste autorisée l’agent utilisateur *AdobeEdgeOptimize/1.0* dans votre WAF ou Gestionnaire de robots afin que le service Optimize at Edge puisse récupérer votre contenu d’origine.
Si votre pare-feu nécessite une vérification supplémentaire au-delà de l’agent utilisateur, générez un secret (par exemple, openssl rand -hex 32) et :
- Ajoutez des x-edgeoptimize-fetcher-key avec le secret dans vos règles de routage à côté des autres en-têtes x-edgeoptimize-*.
- Ajoutez une règle WAF ou Gestionnaire de robots pour autoriser les requêtes où x-edgeoptimize-fetcher-key correspond au même secret.
Optimiser dans Edge transmet cet en-tête en l’état : vous êtes propriétaire du cycle de vie complet des clés.

Définissez l’en-tête x-edgeoptimizer-fetcher-key dans le Gestionnaire de propriétés

NOTE

Placez sur la liste autorisée également l’agent utilisateur *AdobeEdgeOptimize/1.0* et l’en-tête x-edgeoptimize-fetcher-key dans Akamai Bot Manager.

6. Modifier les en-têtes de réponse entrante

Modifier les en-têtes de réponse entrante

7. Modification de l’ID de cache

Modification de l’ID de cache

8. Modifiez Les En-Têtes Des Requêtes Sortantes

Définir x-forwarded-host’en-tête sur {{builtin.AK_HOST}}

Modifier les en-têtes de requête sortante

9. Basculement du site

La configuration de basculement de site comporte deux parties : le comportement de basculement (configuré dans la règle principale de routage Optimisation à la périphérie) et une règle d’en-tête de test de basculement distincte.

9 bis. Comportement de basculement de site (dans la règle principale de routage d’optimisation à la périphérie)

Dans la règle de routage principale, configurez le comportement de basculement de site et le fragment de code XML avancé comme suit :

IMPORTANT

Le fragment de code XML de cette étape nécessite le comportement Avancé. Dans certains environnements Akamai, ce comportement n’est pas disponible pour la modification en libre-service. Si vous ne voyez pas l’option Avancé, contactez votre équipe de compte Akamai ou l’assistance Akamai pour activer la configuration requise.

Basculement du site

Ajoutez le x-edgeoptimize-request d’en-tête de requête avec la valeur fo via le code XML avancé :

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

Comportements de basculement

9 ter . Règle d’en-tête du test de basculement (règle sœur)

IMPORTANT

Créez la règle Basculement EdgeOptimize - En-tête de test en tant que règle sœur (au même niveau) des règles de routage — pas imbriquée dans celles-ci. Dans l’arborescence des règles du Gestionnaire de propriétés Akamai, la hiérarchie doit se présenter comme suit :

code language-none
`▼ Parent Rule ▶ Optimize at Edge Routing ← routing rule EdgeOptimize Failover - Test Header ← sibling, same level`

Cela permet de s’assurer que la règle d’en-tête du test de basculement évalue toutes les règles de routage, pas seulement une.

Assurez-vous également que la règle Optimiser au routage Edge n’est pas remplacée par une règle de correspondance ultérieure qui modifie l’origine, le comportement de mise en cache ou l’identifiant de cache pour les mêmes requêtes. Si une autre règle correspondante réinitialise ces comportements, le routage ou la mise en cache de l’option Optimiser à Edge risque de ne pas fonctionner comme prévu.

Si la valeur du x-edgeoptimize-request d’en-tête de requête est fo, définissez le x-edgeoptimize-fo d’en-tête de réponse sortante sur true.

Règles de basculement

Le basculement de site garantit que si Edge Optimize renvoie une erreur 4XX ou 5XX, la requête est automatiquement renvoyée à votre origine par défaut, de sorte que l’utilisateur final reçoive toujours une réponse.

Scénario

Comportement

Edge Optimize renvoie 2XX

La réponse optimisée est transmise au client.

Edge Optimize renvoie 4XX ou 5XX

La demande est routée vers l’origine par défaut.

Vérifier la configuration

Une fois la configuration terminée, vérifiez que le trafic des robots est acheminé vers Edge Optimize et que le trafic humain n’est pas affecté.

1. Tester le trafic de robots (doit être optimisé)

Simulez une requête de robot d’IA à l’aide d’une chaîne agent-utilisateur :

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

Une réponse réussie inclut l’en-tête x-edgeoptimize-request-id, confirmant que la requête a été acheminée via Edge Optimize :

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

2. Tester le trafic humain (ne devrait PAS être affecté)

Simulez une requête régulière de navigateur humain :

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"

La réponse ne doit pas contenir l’en-tête x-edgeoptimize-request-id. Le contenu de la page et le temps de réponse doivent rester identiques à avant l’activation de l’option Optimiser dans Edge.

3. Comment différencier les deux scénarios

En-tête

Trafic de robots (optimisé)

Trafic humain (non affecté)

x-edgeoptimize-request-id

Présent : contient un ID de requête unique

Absent

x-edgeoptimize-fo

Présent uniquement en cas de basculement (valeur : 1)

Absent

Le statut du routage du trafic peut également être vérifié dans l’interface utilisateur de LLM Optimizer. Accédez à Configuration du client et sélectionnez l’onglet Configuration du réseau CDN.

Déploiement des optimisations sur les agents d’IA - terminé

Pour en savoir plus sur l’optimisation sur Edge, y compris sur les opportunités disponibles, les workflows d’optimisation automatique et les questions fréquentes, revenez à la Présentation de l’optimisation sur Edge .

recommendation-more-help

llm-optimizer-help-main-toc