Servidor HTTP Apache

Essa configuração se aplica quando o Servidor HTTP Apache atua como proxy reverso na frente da sua origem (uma configuração auto-hospedada, sem o AEM Dispatcher). Ela roteia o tráfego agêntico (solicitações de bots de IA e agentes de usuário de LLM) para o serviço de back-end da Otimização na borda (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 nem worker para ser implantado. 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, certifique-se de ter:

Configuração

1. Baixar os arquivos de configuração

Baixe os três arquivos de inclusão da Otimização na borda do repositório de exemplos de código do Otimizar na borda e coloque-os em um diretório no seu servidor Apache (por exemplo, conf/oae/):

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 cada domínio que você está habilitando. Substitua o host pelo seu domínio e YOUR_API_KEY pela chave da interface do Adobe Brand Visibility. Os domínios não listados são roteados para a origem sem alterações, portanto, você só pode habilitar um domínio por 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 ao <VirtualHost *:443> existente. O arquivo de roteamento vem antes das suas regras de reescrita e 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 na borda — todo o restante (ServerName, ProxyPass e o restante) faz parte da sua configuração existente, sem alterações.

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.

Permitir Otimização na borda por meio de regras de firewall (opcional)

Se a CDN usar um WAF ou gerenciador de bot:

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

O status do roteamento de tráfego também pode ser verificado na interface do Adobe Brand Visibility. Acesse Configuração do cliente e selecione a guia Configuração da CDN.

Para saber mais sobre a Otimização na borda, incluindo oportunidades disponíveis, fluxos de trabalho de otimização automática e perguntas frequentes, volte para a Visão geral da Otimização na borda.