Apache HTTP Server
Questa configurazione viene applicata quando Apache HTTP Server funge da proxy inverso davanti all’origine (configurazione self-hosted, senza AEM Dispatcher). Indirizza il traffico da IA agentica (richieste da bot IA e da agenti utente LLM) al servizio back-end di 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.
L’integrazione è un set di file Apache Include nativi. Nessun codice o processo di lavoro da implementare. Scarica tre file, imposta la chiave API e aggiungi due righe Include all’host virtuale.
Prerequisiti
Prima di configurare le regole di indirizzamento di Apache, assicurati di:
- aver abilitato Apache HTTP Server 2.4 o versione successiva con questi moduli:
proxy,proxy_http,ssl,rewrite,headers,envesetenvif. - Avere accesso alla configurazione di Apache (il
<VirtualHost>per il sito) e la possibilità di ricaricare Apache. - 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.
Configurazione
1. Scarica i file di configurazione
Scarica i tre file di inclusione del servizio Edge Optimize dall’archivio degli esempi di codice per l’ottimizzazione nella rete edge e inseriscili in una directory sul server Apache (ad esempio, conf/oae/):
oae-routing.confoae-failover.confdomains.confNon è necessario modificare oae-routing.conf o oae-failover.conf. Utilizzali così come sono.
2. Abilita il dominio e imposta la chiave API (domains.conf)
Modifica domains.conf e aggiungi una riga per ogni dominio che stai abilitando. Sostituisci l’host con il tuo dominio e la YOUR_API_KEY con la chiave che trovi nell’interfaccia di Adobe Brand Visibility. I domini non elencati vengono indirizzati all’origine senza modifiche, pertanto puoi abilitare un dominio alla volta.
SetEnvIfExpr "%{HTTP_HOST} =~ m#(?i)^(www\.)?example\.com(:\d+)?$#" OAE_DOMAIN_ENABLED=1 OAE_API_KEY=YOUR_API_KEY
3. Includi i file nell’host virtuale
Aggiungi le due righe Include al tuo <VirtualHost *:443> esistente. Il file di indirizzamento passa prima della riscrittura e delle regole di ProxyPass; il file di failover passa dopo. Nell’esempio di seguito, le righe contrassegnate con #NEWLINE sono le uniche righe aggiunte per l’ottimizzazione nella rete edge. Tutto il resto (ServerName, ProxyPass ecc.) è la configurazione esistente non modificata.
Define OAE_CONF_DIR conf/oae #NEWLINE directory holding the OAE include files
<VirtualHost *:443>
ServerName www.example.com
Include "${OAE_CONF_DIR}/oae-routing.conf" #NEWLINE OAE routing — BEFORE your Rewrite & ProxyPass rules
# --- your existing rewrite rules and ProxyPass to origin ---
ProxyPass "/" "https://www.example.com/"
ProxyPassReverse "/" "https://www.example.com/"
Include "${OAE_CONF_DIR}/oae-failover.conf" #NEWLINE OAE failover — AFTER your ProxyPass rules
</VirtualHost>
4. Ricarica Apache
Convalida la configurazione e ricarica Apache per applicare le modifiche.
Vary: x-edgeoptimize-config). Se il tuo Apache utilizza già mod_cache, assicurati che sia CacheQuickHandler Off in modo che la ricerca nella cache venga eseguita dopo l’impostazione delle intestazioni di Edge Optimize.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-idx-edgeoptimize-fo1)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.
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.