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, env e setenvif.
  • 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/):

File
Scopo
oae-routing.conf
Rileva i bot IA, inserisce le intestazioni del servizio Edge Optimize, indirizza le richieste di pagine HTML al back-end e configura il failover e l’isolamento della cache.
oae-failover.conf
Riproduce la richiesta originale rispetto all’origine se il servizio Edge Optimize restituisce un errore.
domains.conf
Abilita l’ottimizzazione nella rete edge per dominio e contiene la tua chiave API.

Non è 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.

NOTE
Le risposte di utenti reali e quelle ottimizzate per bot vengono mantenute automaticamente in voci di cache separate (set di file di indirizzamento 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-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
x-edgeoptimize-fo
Presente solo in caso di failover (valore: 1)
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