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.
  • Sonde di integrità: Abilitate

    • Percorso: /health/<your-domain> (ad esempio, /health/www.example.com)
    • Protocollo: HTTPS
    • Intervallo: 225 secondi
  • Affinità sessione: Disabilitata

  • Convalida del nome soggetto certificato: Abilitato

Gruppo di origine Edge Optimize con due origini basate su priorità e sonde di integrità

NOTE
Il gruppo di origine 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.

Set di regole EORouting che mostra le regole per l’eliminazione delle intestazioni e l’indirizzamento dei bot

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-url
  • x-edgeoptimize-config
  • x-edgeoptimize-api-key
  • x-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 contiene 1
  • x-edgeoptimize-request: Non contiene nessuno di failover, 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.

Regola di riscrittura della sonda integrità

Condizioni (tutte devono corrispondere):

  • Percorso URL della richiesta: Inizia con /health/
  • x-fd-healthprobe: Contiene 1

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-key con il segreto nelle regole di indirizzamento insieme alle altre intestazioni x-edgeoptimize-*.
    • Aggiungi una regola WAF o Bot Manager per consentire le richieste in cui x-edgeoptimize-fetcher-key corrisponde allo stesso segreto.
  • 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

Intestazione
Traffico da bot (ottimizzato)
Traffico da persone (non interessato da modifiche)
x-edgeoptimize-request-id
Presente: contiene un ID di richiesta univoco
Assente

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

Implementare le ottimizzazioni negli agenti IA - Completate

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.

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