Fastly (BIOCDN)
Questa configurazione indirizza il traffico agente (richieste da bot di IA e agenti utente LLM) al servizio back-end Edge Optimize (live.edgeoptimize.net). I visitatori umani e i bot SEO continuano a essere serviti dalla tua origine come al solito. Per verificare la configurazione, al termine dell’installazione, cercare l’intestazione x-edgeoptimize-request-id nella risposta.
Prerequisiti
Prima di impostare le regole VCL Fastly, assicurati di disporre di:
- Accesso a Fastly per il dominio.
- Chiave API di ottimizzazione Edge recuperata dall’interfaccia utente di LLM Optimizer. Per i passaggi, consulta Recuperare le chiavi API.
- (Facoltativo) Per verificare il routing dell’area di gestione temporanea, vedere Chiave API di gestione temporanea.
Configurazione
Aggiungi i tre snippet VCL seguenti al tuo servizio Fastly. Questi snippet gestiscono il routing delle richieste di agenti ad Edge Optimize, la separazione delle chiavi della cache e il failover all’origine predefinita.
snippet vcl_recv
unset req.http.x-edgeoptimize-url;
unset req.http.x-edgeoptimize-config;
unset req.http.x-edgeoptimize-api-key;
unset req.http.x-edgeoptimize-fetcher-key; # Optional (required only in case of WAF)
if (!req.http.x-edgeoptimize-request
&& req.http.user-agent ~ "(?i)(AdobeEdgeOptimize-AI|ChatGPT-User|GPTBot|OAI-SearchBot|PerplexityBot|Perplexity-User)") {
set req.http.x-forwarded-host = req.http.host; # required for identifying the original host
set req.http.x-edgeoptimize-url = req.url; # required for identifying the original url
set req.http.x-edgeoptimize-config = "LLMCLIENT=TRUE;"; # required for cache key
set req.http.x-edgeoptimize-api-key = "<YOUR API KEY>"; # required for identifying the client
set req.http.x-edgeoptimize-fetcher-key = "<YOUR FETCHER KEY>"; # Optional (required only in case of WAF)
set req.backend = F_EDGE_OPTIMIZE;
}
snippet vcl_hash
if (req.http.x-edgeoptimize-config) {
set req.hash += "edge-optimize";
set req.hash += req.http.x-edgeoptimize-config;
}
snippet vcl_deliver
if (req.http.x-edgeoptimize-config && resp.status >= 400) {
set req.http.x-edgeoptimize-request = "failover";
set req.backend = F_Default_Origin;
restart;
}
if (!req.http.x-edgeoptimize-config && req.http.x-edgeoptimize-request == "failover") {
set resp.http.x-edgeoptimize-fo = "1";
}
Failover
Lo snippet vcl_deliver gestisce automaticamente il failover. Se Edge Optimize restituisce un errore 4XX o 5XX, la richiesta viene riavviata e indirizzata all’origine predefinita in modo che l’utente finale riceva comunque una risposta. Le risposte di failover includono l’intestazione x-edgeoptimize-fo: 1.
2XX4XX o 5XXx-edgeoptimize-fo: 1.Consenti ottimizzazione in Edge tramite regole firewall (facoltativo)
Se la rete CDN utilizza un WAF o un Bot Manager:
-
Inserire nell’elenco Consentiti l’agente utente
*AdobeEdgeOptimize/1.0*nel WAF o nel gestore bot in modo che il servizio Optimize at Edge possa recuperare il contenuto di origine. -
Se il firewall richiede ulteriori verifiche oltre all’agente utente, generare un segreto (ad esempio,
openssl rand -hex 32) e:- Aggiungi
x-edgeoptimize-fetcher-keycon il segreto nelle regole di routing insieme alle altre intestazionix-edgeoptimize-*. - Aggiungi una regola di WAF o Bot Manager per consentire le richieste in cui
x-edgeoptimize-fetcher-keycorrisponde allo stesso segreto.
- Aggiungi
-
Ottimizza in Edge inoltra questa intestazione così com’è, sei il proprietario dell’intero ciclo di vita delle chiavi.
Verifica installazione
Dopo aver completato la configurazione, verifica che il traffico da bot venga indirizzato ad Edge Optimize e che non venga influenzato dal traffico umano.
1. Verifica traffico da bot (deve essere ottimizzato)
Simulare una richiesta bot di intelligenza artificiale utilizzando un agente utente:
curl -svo /dev/null https://www.example.com/page.html \
--header "user-agent: chatgpt-user"
Una risposta corretta include l’intestazione x-edgeoptimize-request-id, a conferma che la richiesta è stata instradata tramite Edge Optimize:
< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85
2. Test del traffico umano (non dovrebbe essere interessato)
Simula una richiesta browser umana regolare:
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 deve non contenere l’intestazione x-edgeoptimize-request-id. Il contenuto della pagina e il tempo di risposta devono rimanere identici a prima di abilitare l’opzione Ottimizza in Edge.
3. Come distinguere tra i due scenari
x-edgeoptimize-request-idx-edgeoptimize-fo1)Lo stato del routing del traffico può essere controllato anche nell’interfaccia utente di LLM Optimizer. Passa a Configurazione cliente e seleziona la scheda Configurazione CDN.
Per ulteriori informazioni su Ottimizza in Edge, tra cui le opportunità disponibili, i flussi di lavoro di ottimizzazione automatica e le domande frequenti, torna alla Panoramica sull’ottimizzazione in Edge.