DocumentaciónAdobe Brand Visibility

Servidor HTTP Apache

Última actualización: 18 de septiembre de 2026

Esta configuración se aplica cuando el servidor HTTP Apache actúa como proxy inverso delante de su origen (una configuración autoalojada, sin AEM Dispatcher). Enruta el tráfico agéntico (solicitudes de bots de IA y agentes de usuario LLM) al servicio de back-end de Edge Optimize (live.edgeoptimize.net). Los visitantes humanos y los bots de SEO se siguen sirviendo desde su origen como de costumbre. Para probar la configuración, una vez completados los ajustes, busque el encabezado x-edgeoptimize-request-id en la respuesta.

La integración es un conjunto de archivos Apache Include nativos; no hay código ni trabajador que implementar. Descarga tres archivos, establece su clave de API y añade dos líneas de Include a su host virtual.

Requisitos previos

Antes de configurar las reglas de enrutamiento de Apache, asegúrese de lo siguiente:

  • Servidor HTTP Apache 2.4 o posterior con estos módulos habilitados: proxy, proxy_http, ssl, rewrite, headers, env y setenvif.
  • Acceda a la configuración de Apache (el <VirtualHost> para su sitio) y la capacidad de volver a cargar Apache.
  • Haber recuperado una clave de API de Edge Optimize de la IU de Adobe Brand Visibility. Para ver los pasos, consulte Recuperar las claves de API.
  • (Opcional) Para probar el enrutamiento de ensayo, consulte Clave de API de ensayo.

Configuración

1. Descargue los archivos de configuración

Descargue los tres archivos de inclusión de Edge Optimize del repositorio de muestras de código de Optimizar en Edge y colóquelos en un directorio de su servidor Apache (por ejemplo, conf/oae/):

Archivo
Función
oae-routing.conf
Detecta bots de IA, inserta encabezados de Edge Optimize, enruta las solicitudes de página de HTML al backend y configura el aislamiento de caché y la conmutación por error.
oae-failover.conf
Reproduce la solicitud original con el origen si Edge Optimize devuelve un error.
domains.conf
Habilita Optimizar en Edge por dominio y contiene su clave de API.

No necesita modificar oae-routing.conf o oae-failover.conf; utilícelos tal cual.

2. Habilite su dominio y establezca la clave de API (domains.conf)

Edite domains.conf y añada una línea por cada dominio que habilite. Reemplace el host por su dominio y YOUR_API_KEY por la clave de la IU de Adobe Brand Visibility. Los dominios no enumerados se dirigen al origen sin cambios, por lo que puede habilitar un dominio a la vez.

SetEnvIfExpr "%{HTTP_HOST} =~ m#(?i)^(www\.)?example\.com(:\d+)?$#" OAE_DOMAIN_ENABLED=1 OAE_API_KEY=YOUR_API_KEY

3. Incluya los archivos en el host virtual

Incluya las dos líneas de Include a su <VirtualHost *:443> existente. El archivo de enrutamiento va antes de la reescritura y las reglas de ProxyPass; el archivo de conmutación por error va después de ellas. En el ejemplo siguiente, las líneas marcadas como #NEWLINE son las únicas que incluye para Optimizar en Edge; todo lo demás (ServerName, ProxyPass y el resto) es la configuración existente sin modificar.

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. Vuelva a cargar Apache

Valide la configuración y vuelva a cargar Apache para aplicar los cambios.

NOTE
Las respuestas humanas y optimizadas para bots se guardan automáticamente en entradas de caché independientes (el archivo de enrutamiento establece Vary: x-edgeoptimize-config). Si su Apache ya utiliza mod_cache, asegúrese de que tenga CacheQuickHandler Off para que la búsqueda en la caché se ejecute después de establecer los encabezados de Edge Optimize.

Permitir Optimizar en Edge mediante reglas de cortafuegos (opcional)

Si su CDN utiliza un WAF o un administrador de bots:

  • Incluya el agente de usuario de *AdobeEdgeOptimize/1.0* en la lista de permitidos de su WAF o administrador de bots para que el servicio Optimizar en Edge pueda recuperar el contenido de origen.

  • Si el cortafuegos requiere una verificación adicional más allá del agente de usuario, genere un secreto (por ejemplo, openssl rand -hex 32) y:

    • Añada x-edgeoptimize-fetcher-key con el secreto en sus reglas de enrutamiento junto con los otros encabezados de x-edgeoptimize-*.
    • Añada una regla de WAF o administrador de bots para permitir solicitudes en las que x-edgeoptimize-fetcher-key coincida con el mismo secreto.

  • Optimizar en Edge reenvía este encabezado tal cual: usted es el propietario del ciclo de vida completo de la clave.

Verificación de la configuración

Una vez completada la configuración, compruebe que el tráfico de bots se enrute a Edge Optimize y que el tráfico humano no se vea afectado.

1. Probar el tráfico de bots (debe optimizarse)

Simule una solicitud de bot de IA con un agente de usuario agéntico:

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

Una respuesta correcta incluye el encabezado x-edgeoptimize-request-id, que confirma que la solicitud se enrutó mediante Edge Optimize:

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. Probar el tráfico humano (NO debería verse afectado)

Simule una solicitud normal de un explorador:

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 respuesta no debe contener el encabezado x-edgeoptimize-request-id. El contenido de la página y el tiempo de respuesta deben ser idénticos al de antes de habilitar Optimizar en Edge.

3. Cómo diferenciar entre dos escenarios

Encabezado
Tráfico de bots (optimizado)
Tráfico humano (no afectado)
x-edgeoptimize-request-id
Presente: contiene un ID de solicitud único
Ausente
x-edgeoptimize-fo
Solo está presente si se produjo la conmutación por error (valor: 1)
Ausente

El estado del enrutamiento de tráfico también se puede comprobar en la IU de Adobe Brand Visibility.Vaya a Configuración del cliente y seleccione la pestaña Configuración de la CDN.

Implementar optimizaciones en agentes de IA: completado

Para obtener más información sobre Optimizar en Edge, incluidas las oportunidades disponibles, los flujos de trabajo de optimización automática y las preguntas frecuentes, vuelva a Información general sobre Optimizar en Edge.

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