Akamai (BYOCDN)

Cette configuration achemine le trafic généré par l’IA agentique (demandes provenant de robots d’IA et d’agents utilisateurs LLM) vers le service principal Edge Optimize (live.edgeoptimize.net). Les personnes humaines 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 celle-ci 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.
  • La clé API Edge Optimize récupérée à partir de l’interface d’utilisation d’Adobe Brand Visibility. Pour connaître les étapes, voir Récupération de vos clés API.
  • (Facultatif) Pour tester le routage de préproduction, consultez Clé API de préproduction.

Options de configuration

Il existe deux façons de configurer Akamai pour Optimize at Edge :

Option 1 : configuration guidée dans Adobe Brand Visibility

La configuration guidée nécessite un client d’API Akamai EdgeGrid dans votre propre compte Akamai, avec un accès Property Manager (PAPI) — READ-WRITE au groupe et au contrat de la propriété cible et l’autorisation d’activer les versions de propriété sur les environnements d’évaluation et de production Akamai. Adobe Brand Visibility utilise ces informations d’identification uniquement pour la configuration et ne les stocke pas.

Préparer le client d’API Akamai EdgeGrid

Si vous ne disposez pas déjà d’un client d’API approprié, créez-en un dans Akamai Control Center :

  1. Ouvrez Administration > Identité et accès.
  2. Sur Utilisateurs et clients d’API, sélectionnez Créer un client d’API.
  3. Sélectionnez Moi-même, puis Avancé. Limitez le client à Property Manager (PAPI) — READ-WRITE, conservez uniquement le groupe cible et le contrat, et confirmez l’autorisation d’activer sur les environnements d’évaluation et de production.
  4. Créez le client, puis téléchargez ou copiez immédiatement le fichier d’informations d’identification. Vous avez besoin du secret client, de l’hôte API, du jeton d’accès et du jeton client. Le secret client s’affiche une seule fois.

Création d’un client d’API dans la gestion des identités et des accès Akamai

Restriction du client d’API à Property Manager (PAPI) READ-WRITE

NOTE
Stockez le fichier d’informations d’identification dans le gestionnaire de secrets approuvé par votre organisation. Adobe Brand Visibility ne stocke pas ces informations d’identification. Elles restent dans la session de votre navigateur et sont effacées lorsque vous fermez le tableau de bord de déploiement.

Déploiement de la configuration de routage

  1. Ouvrez Configuration du CDN pour l’URL que vous souhaitez configurer.
  2. Dans Déployer les optimisations pour les agents IA, sélectionnez Activer si nécessaire.
  3. Sélectionnez Déployer le routage dans Akamai (version bêta).
  4. Collez le fichier d’informations d’identification EdgeGrid ou saisissez séparément le secret client, l’hôte API, le jeton d’accès et le jeton client, puis connectez-vous.
  5. Sélectionnez la propriété Akamai, passez en revue les modifications proposées et suivez les étapes guidées de déploiement. Obtenez une approbation avant d’activer la nouvelle version de la propriété.

Déployer le routage dans Akamai à partir d’Adobe Brand Visibility

NOTE
La configuration guidée est disponible en tant que fonctionnalité d’accès anticipé pour les comptes éligibles. Pour obtenir de l’aide sur l’intégration, contactez votre équipe de compte Adobe ou envoyez un e-mail à abv-at-edge@adobe.com.

Option 2 : configuration manuelle

Suivez les étapes ci-après pour configurer manuellement les règles d’Akamai Property Manager.

Configuration

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

​1. Définir les critères de routage (correspondance de l’agent utilisateur et du trafic HTML)

Définir le routage pour les agents utilisateurs suivants :

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
Appliquez la règle de routage Optimize at Edge uniquement au trafic des pages HTML agentiques. Une configuration courante consiste à utiliser des critères côté requête tels que Extension de fichier pour faire correspondre html et 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éfinir l’origine comme live.edgeoptimize.net et faire correspondre le SAN à *.edgeoptimize.net

NOTE
Si l’activation de la propriété échoue après l’ajout de la règle Optimize at 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 Optimize at 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éfinir la variable de clé 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 récupérée depuis Adobe Brand Visibility
x-edgeoptimize-config vers LLMCLIENT=TRUE;
x-edgeoptimize-url à {{builtin.AK_URL}}

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

Autoriser Optimize at Edge via des règles de pare-feu (facultatif)

Si votre CDN utilise un WAF ou un Bot Manager :

  • Placez sur la liste autorisée l’agent utilisateur ou utilisatrice *AdobeEdgeOptimize/1.0* dans votre WAF ou Bot Manager 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 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 Bot Manager pour autoriser les demandes où x-edgeoptimize-fetcher-key correspond au même secret.
  • Optimize at Edge transmet cet en-tête en l’état : vous êtes propriétaire de l’ensemble du cycle de la clé.

Définir l’en-tête x-edgeoptimize-fetcher-key dans le Gestionnaire des propriétés

NOTE
Placez également sur la liste autorisée 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 des réponses entrantes

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

​7. Modification de l’ID de cache

Modification de l’ID de cache

​8. Modifier les en-têtes des requêtes sortantes

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

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

​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.

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

Dans la règle de routage Optimize at Edge principale, créez une règle enfant nommée Comportement de basculement de site. Définissez-la sur Ne correspond à aucun et ajoutez les critères suivants :

  • Le code d’état de réponse est compris entre 400 et 599.
  • Le délai d’expiration d’origine est Yes.

Ajoutez le comportement Basculement de site et le fragment de code XML avancé à cette règle enfant.

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 l’en-tête de requête x-edgeoptimize-request 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

9b. 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 — non 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
▼ 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
Cela permet de s’assurer que la règle d’en-tête du test de basculement évalue toutes les règles de routage, et pas seulement une.
Assurez-vous également que la règle de routage Optimize at 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 x-edgeoptimize-request d’en-tête de requête est fo, définissez l’en-tête de réponse sortante x-edgeoptimize-fo 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 à la clientèle.
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 utilisateur-agent :

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 Optimize at 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 : true)
Absent

Le statut du routage du trafic peut également être vérifié dans l’interface d’utilisation d’Adobe Brand Visibility. Accédez à Configuration cliente et sélectionnez l’onglet Configuration du CDN.

Déployer des optimisations vers les agents IA — Terminé

Pour en savoir plus sur Optimize at Edge, y compris sur les opportunités disponibles, les workflows d’optimisation automatique et les questions fréquentes, revenez à la Vue d’ensemble d’Optimize at Edge.

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