DocumentaçãoLLM Optimizer

Apache HTTP Server

Última atualização: 23 de julho de 2026

Essa configuração se aplica quando o Apache HTTP Server atua como proxy reverso na frente da sua origem (uma configuração auto-hospedada, sem AEM Dispatcher). Ele roteia o tráfego de agente (solicitações de bots de IA e agentes de usuário LLM) para o serviço de back-end de Otimização da Edge (live.edgeoptimize.net). Visitantes humanos e bots de SEO continuam sendo atendidos a partir da sua origem normalmente. Para testar a configuração, após sua conclusão, procure o cabeçalho x-edgeoptimize-request-id na resposta.

A integração é um conjunto de arquivos nativos do Apache Include — não há código ou funcionário para implantar. Você baixa três arquivos, define sua chave de API e adiciona duas linhas Include ao host virtual.

Pré-requisitos

Antes de configurar as regras de roteamento do Apache, verifique se você tem:

  • Apache HTTP Server 2.4 ou posterior com estes módulos habilitados: proxy, proxy_http, ssl, rewrite, headers, env e setenvif.
  • Acesso à configuração do Apache (o <VirtualHost> do site) e a capacidade de recarregar o Apache.
  • Uma chave da API do Edge Optimize obtida na interface do usuário do LLM Optimizer. Para obter as etapas, consulte Recuperar suas chaves de API.
  • (Opcional) Para testar o roteamento de preparo, consulte Chave de API de preparo.

Configuração

1. Baixar os arquivos de configuração

Baixe os três arquivos de inclusão do Edge Otimize do Otimize at Edge code samples repository e coloque-os em um diretório em seu servidor Apache (por exemplo, conf/oae/):

Arquivo
Propósito
oae-routing.conf
Detecta bots de IA, injeta os cabeçalhos de Otimização do Edge, roteia solicitações de página do HTML para o back-end e configura o isolamento de cache e o failover.
oae-failover.conf
Repete a solicitação original de acordo com sua origem se o Edge Otimize retornar um erro.
domains.conf
Ativa Otimizar no Edge por domínio e mantém sua chave de API.

Você não precisa modificar oae-routing.conf ou oae-failover.conf — use-os como estão.

2. Habilite seu domínio e defina a chave de API (domains.conf)

Edite domains.conf e adicione uma linha por domínio que você está habilitando. Substitua o host pelo seu domínio e YOUR_API_KEY pela chave da interface do usuário do LLM Optimizer. Domínios não listados rota para origem inalterada, portanto, você pode habilitar um domínio de cada vez.

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

3. Incluir os arquivos no host virtual

Adicione as duas linhas Include à <VirtualHost *:443> existente. O arquivo de roteamento vai antes da sua regravação e das ProxyPass regras; o arquivo de failover vai depois delas. No exemplo abaixo, as linhas marcadas com #NEWLINE são as únicas linhas que você adiciona para Otimizar no Edge — todo o resto (ServerName, ProxyPass e o resto) é sua configuração existente e inalterada.

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. Recarregar Apache

Valide a configuração e recarregue o Apache para aplicar as alterações.

NOTE
As respostas otimizadas por bot e humanas são mantidas automaticamente em entradas de cache separadas (o arquivo de roteamento define Vary: x-edgeoptimize-config). Se o Apache já usa o mod_cache, verifique se ele tem CacheQuickHandler Off para que a pesquisa de cache seja executada após a definição dos cabeçalhos de Otimização do Edge.

Permitir otimização no Edge por meio de regras de firewall (opcional)

Se o CDN usar um WAF ou Gerenciador de bot:

  • Inclua na lista de permissões o agente de usuário *AdobeEdgeOptimize/1.0* no WAF ou no Gerenciador de bot para que o serviço Otimizar na Edge possa buscar o conteúdo de origem.

  • Se o firewall exigir verificação adicional além do agente do usuário, gere um segredo (por exemplo, openssl rand -hex 32) e:

    • Adicione x-edgeoptimize-fetcher-key com o segredo em suas regras de roteamento junto com os outros cabeçalhos x-edgeoptimize-*.
    • Adicione uma regra do WAF ou do Gerenciador de bot para permitir solicitações em que x-edgeoptimize-fetcher-key corresponde ao mesmo segredo.

  • Otimizar no Edge encaminha esse cabeçalho como está — você é o proprietário do ciclo de vida completo da chave.

Verificar a configuração

Após concluir a configuração, verifique se o tráfego de bots está sendo roteado para o Edge Optimize e se o tráfego humano permanece inalterado.

1. Tráfego de bots de teste (deve ser otimizado)

Simular uma solicitação de bot de IA usando um agente de usuário agêntico:

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

Uma resposta bem-sucedida inclui o cabeçalho x-edgeoptimize-request-id, confirmando que a solicitação foi roteada pelo Edge Otimize:

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

2. Teste o tráfego humano (NÃO deve ser afetado)

Simule uma solicitação regular de navegador humano:

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"

A resposta não deve conter o cabeçalho x-edgeoptimize-request-id. O conteúdo da página e o tempo de resposta devem permanecer idênticos aos de antes da habilitação da otimização na borda.

3. Como diferenciar entre os dois cenários

Cabeçalho
Tráfego de bots (otimizado)
Tráfego humano (não afetado)
x-edgeoptimize-request-id
Presente — contém uma ID de solicitação exclusiva
Ausente
x-edgeoptimize-fo
Presente somente se houver um failover (valor: 1)
Ausente

O status do roteamento de tráfego também pode ser verificado na interface do usuário do LLM Optimizer. Navegue até Configuração do cliente e selecione a guia Configuração de CDN.

Implantação de otimizações em agentes de IA — concluída

Para saber mais sobre como Otimizar na Edge, incluindo oportunidades disponíveis, fluxos de trabalho de otimização automática e perguntas frequentes, volte para a visão geral de Otimizar na Edge.

recommendation-more-help
llm-optimizer-help-main-toc