Azure Front Door (BYOCDN)
Questa configurazione indirizza il traffico da IA agentica (richieste da bot IA e da agenti utente LLM) al servizio back-end Edge Optimize (live.edgeoptimize.net). Le persone e i bot SEO continuano a ricevere come al solito i contenuti trasmessi dalla tua origine. Per testare la configurazione, al termine cerca nella risposta l’intestazione x-edgeoptimize-request-id.
Azure Front Door non esegue codice personalizzato sulla rete edge. L’indirizzamento è configurato utilizzando un set di regole insieme a un gruppo di origine dedicato per il servizio Edge Optimize. Il failover viene gestito dalle sonde di integrità del gruppo di origine basate sulla priorità di Azure Front Door.
Prerequisiti
Prima di impostare le regole di indirizzamento di Azure Front Door, assicurati di:
- Accesso al profilo Azure Front Door.
- Aver recuperato una chiave API per il servizio Edge Optimize dall’interfaccia di Adobe Brand Visibility. Per la procedura, consulta Recuperare le chiavi API.
- (Facoltativo) Per verificare l’indirizzamento in fase di staging, consulta Chiave API di staging.
Passaggio 1: creare un gruppo di origine per il servizio Edge Optimize
Il tuo profilo Azure Front Door dispone già di un gruppo di origine predefinito che punta all’origine. Crea un gruppo di origine nuovo per Edge Optimize:
-
Nome:
edge-optimize-origin-group -
Origini (failover basato su priorità):
- Priorità 1:
live.edgeoptimize.net(intestazione host di origine:live.edgeoptimize.net) - Priorità 2: endpoint di dominio (ad esempio,
www.example.com). Questo è per il failover: se Edge Optimize non è integro, le richieste vengono indirizzate al dominio, che entra nuovamente in Azure Front Door e viene fornito dall’origine predefinita.
- Priorità 1:
-
Sonde di integrità: Abilitate
- Percorso:
/health/<your-domain>(ad esempio,/health/www.example.com) - Protocollo: HTTPS
- Intervallo: 225 secondi
- Percorso:
-
Affinità sessione: Disabilitata
-
Convalida del nome soggetto certificato: Abilitato
edge-optimize-origin-group visualizza un avviso “Non associato” nel portale. Ciò è previsto, poiché vi si fa riferimento tramite una sostituzione del percorso nel set di regole, non direttamente tramite un percorso.Passaggio 2: configurare il percorso
Un percorso predefinito viene in genere creato con il profilo Azure Front Door. Il set di regole (passaggio 3) sostituisce il gruppo di origine per il traffico da IA agentica, pertanto non è necessario alcun percorso separato per Edge Optimize.
Passaggio 3: creare il set di regole
Passa a Set di regole > Aggiungi un set di regole e denominalo EORouting. Aggiungi tre regole in questo ordine.
Regola 1: StripIncomingEOHeaders01
Elimina le intestazioni Edge Optimize in arrivo per impedire lo spoofing. Nessuna condizione: si applica a tutte le richieste. Interrompi valutazione: Disattivato.
Azioni - Elimina intestazione richiesta per ciascuno di:
x-edgeoptimize-urlx-edgeoptimize-configx-edgeoptimize-api-keyx-edgeoptimize-fetcher-key
Regola 2: EOGPTBotRootGET03
Indirizza le richieste bot sui percorsi delle pagine HTML a Edge Optimize. Interrompi valutazione: Attivato.
Condizioni (tutte devono corrispondere):
- Metodo richiesta: Uguale
GET - Percorso richiesta: RegEx
(^$|^.*/$|(^|.*/)[^./]+$|^.*\.html$)(corrisponde alla directory principale del sito, ai percorsi che terminano in/, ai percorsi di pagina senza estensione e ai percorsi.html) - Agente utente: contiene uno qualsiasi di
chatgpt-user,gptbot,oai-searchbot,adobeedgeoptimize-ai,perplexitybot,perplexity-user,claudebot,claude-user,claude-searchbot. Imposta Trasformazione stringa su In minuscolo. x-edgeoptimize-monitor: Non contiene1x-edgeoptimize-request: Non contiene nessuno difailover,1
Azioni:
- Sovrascrittura intestazione della richiesta
x-edgeoptimize-url=/{url_path}?{query_string} - Sovrascrittura intestazione della richiesta
x-edgeoptimize-config=LLMCLIENT=TRUE; - Sovrascrittura intestazione della richiesta
x-edgeoptimize-api-key=YOUR_API_KEY - Sovrascrittura intestazione della richiesta
x-edgeoptimize-monitor=1 - Sostituzione configurazione del percorso: gruppo di origine →
edge-optimize-origin-group, Protocollo di inoltro → Corrispondenza richiesta in ingresso, Memorizzazione nella cache → Disabilitato
Regola 3: HealthProbeRewrite03
Riscrive le richieste delle sonde di integrità di Azure Front Door in modo che raggiungano l’origine come / anziché come /health/<domain>. Questo consente ad Azure Front Door di monitorare la disponibilità di Edge Optimize senza richiedere un endpoint di integrità dedicato sull’origine. Interrompi valutazione: Attivato.
Condizioni (tutte devono corrispondere):
- Percorso URL della richiesta: Inizia con
/health/ x-fd-healthprobe: Contiene1
Azioni:
- Riscrittura URL - Pattern di origine:
/health/, Destinazione:/ - Sovrascrittura intestazione della risposta
custom-origin-health=routed(diagnostica: può essere rimossa dopo la verifica) - Aggiunta all’intestazione della richiesta
user-agent=AdobeEdgeOptimize/1.0(aggiungi uno spazio iniziale: Azure Front Door aggiunge il valore così com’è) - Sostituzione configurazione del percorso: Gruppo di origine →
default-origin-group, Protocollo di inoltro → Corrispondenza richiesta in ingresso, Memorizzazione nella cache → Disabilitato
Passaggio 4: associare il set di regole al percorso
Apri il percorso, scorri fino alla sezione Regole in basso e seleziona il set di regole EORouting dal menu a discesa. Se sono presenti set di regole esistenti, utilizza la funzione Sposta in alto per posizionare EORouting su #1. Le regole di ottimizzazione nella rete edge intercettano solo il traffico da IA agentica e le richieste di loop-back di Edge Optimize: tutto il resto del traffico non viene influenzato da queste regole e passa direttamente alle altre regole. Salva e attendi la propagazione (circa 20 minuti).
Consentire l’ottimizzazione nella rete edge tramite le regole del firewall (facoltativo)
Se la rete CDN utilizza un WAF o un Bot Manager:
-
Inserisci l’agente utente
*AdobeEdgeOptimize/1.0*nell’elenco Consentiti nel WAF o in Bot Manager in modo che il servizio di ottimizzazione nella rete edge possa recuperare il contenuto di origine. -
Se il firewall richiede ulteriori verifiche oltre all’agente utente, genera un segreto (ad esempio,
openssl rand -hex 32) e:- Aggiungi
x-edgeoptimize-fetcher-keycon il segreto nelle regole di indirizzamento insieme alle altre intestazionix-edgeoptimize-*. - Aggiungi una regola WAF o Bot Manager per consentire le richieste in cui
x-edgeoptimize-fetcher-keycorrisponde allo stesso segreto.
- Aggiungi
-
L’ottimizzazione nella rete edge inoltra questa intestazione così com’è: sei tu a gestire l’intero ciclo di vita della chiave.
Verificare la configurazione
Dopo aver completato la configurazione, verifica che il traffico proveniente da bot venga indirizzato al servizio Edge Optimize e che il traffico da persone non sia interessato da alcuna modifica.
1. Test del traffico da bot (deve risultare ottimizzato)
Simula una richiesta da un bot IA utilizzando un agente utente da IA agentica:
curl -svo /dev/null https://www.example.com/page.html \
--header "user-agent: chatgpt-user"
Se il test ha esito positivo, la risposta contiene l’intestazione x-edgeoptimize-request-id, a conferma che la richiesta è stata indirizzata tramite il servizio Edge Optimize:
< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85
2. Test del traffico da persone (deve risultare NON interessato da modifiche)
Simula una normale richiesta inserita da una persona nel browser:
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 risposta non deve contenere l’intestazione x-edgeoptimize-request-id. Il contenuto della pagina e il tempo di risposta devono risultare identici rispetto a prima che sia stata abilitata la funzione di ottimizzazione nella rete edge.
3. Differenze tra i due scenari
x-edgeoptimize-request-idPuoi anche verificare lo stato dell’indirizzamento del traffico nell’interfaccia utente di Adobe Brand Visibility.Passa a Configurazione cliente e seleziona la scheda Configurazione CDN.
Per ulteriori informazioni sull’ottimizzazione nella rete edge, tra cui le opportunità disponibili, i flussi di lavoro di ottimizzazione automatica e le domande frequenti, torna alla Panoramica dell’ottimizzazione nella rete Edge.