Problemas de redirecionamento e roteamento de domínio da CDN em ambientes da AEM Cloud e AMS

O Adobe Experience Manager (AEM) encontra problemas de redirecionamento e roteamento de domínio quando os domínios não são mapeados corretamente ou os redirecionamentos falham devido a configurações não compatíveis ou pré-requisitos ausentes. Isso ocorre porque o comportamento de redirecionamento depende da camada de execução, como CDN, Dispatcher ou AEM, e devido a limitações, como a falta de suporte a domínio curinga e a configuração SSL necessária. Para resolver o problema, identifique o mecanismo de redirecionamento correto e configure o registro de domínio, o SSL e as regras de redirecionamento com base no tempo de execução do AEM.

Descrição description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Managed Services (AMS)
  • Adobe Experience Manager (AEM) no local

Problema/Sintomas

  • O domínio sempre é resolvido para a raiz do site em vez da página desejada.
  • Os redirecionamentos resultam em loops infinitos devido ao comportamento incorreto do cabeçalho do host.
  • Os redirecionamentos não são acionados porque o domínio não está registrado no Cloud Manager.
  • Subdomínios curingas (*.example.com) não podem ser adicionados e o tráfego falha.
  • Falha na implantação do pipeline de CDN devido à sintaxe de configuração inválida.

Causa raiz

O comportamento de redirecionamento depende do local em que o redirecionamento é executado, como CDN, Dispatcher ou AEM. O AEM as a Cloud Service exige registro de domínio explícito e certificados SSL válidos para processamento CDN. Não há suporte para mapeamentos de domínio curinga, e a configuração incorreta de regras de redirecionamento ou cabeçalhos de host causa falhas ou loops.

Resolução resolution

Siga estas etapas para configurar redirecionamentos corretos baseados em domínio e comportamento de roteamento:

  1. Identifique se o redirecionamento deve ocorrer antes que o AEM processe a solicitação ou depois que ela chegue ao AEM para determinar a camada de execução correta.
  2. Use redirecionamentos de CDN para roteamento de domínio para caminho no AEM as a Cloud Service.
  3. Use as regras de regravação do Dispatcher ou Apache para Adobe Managed Services ou ambientes locais.
  4. Use um serviço de redirecionamento externo se o requisito envolver subdomínios curingas dinâmicos não suportados pela AEM.
  5. Use redirecionamentos baseados em CDN para roteamento em nível de host ao usar o Edge Delivery Services, pois somente correspondências de caminho exatas são suportadas na camada de aplicativo.

Para AEM as a Cloud Service (AEMaaCS)

  1. Abra o Cloud Manager, navegue até Ambientes e acesse o Gerenciamento de Domínio para adicionar todos os domínios necessários para o redirecionamento.
  2. Carregue e configure certificados SSL válidos para cada domínio, incluindo domínios que não sejam da www.
  3. Verifique se cada domínio mostra um status ativo com um certificado válido.
  4. Crie ou atualize o arquivo cdn.yaml na raiz do repositório para definir regras de redirecionamento.
  5. Defina regras de redirecionamento usando condições baseadas em host com o código de status e o caminho de destino ou URL necessários.
  6. Execute o pipeline de configuração do Cloud Manager para implantar regras de CDN e validar se a implantação é concluída com êxito.
  7. Corrija quaisquer erros de sintaxe no arquivo de configuração revisando logs de pipeline e corrigindo a estrutura da regra.
  8. Configure redirecionamentos baseados em padrão usando condições de correspondência compatíveis, quando aplicável.
  9. Evite usar nomes de host curingas nas regras CDN porque eles não são compatíveis.

Para Adobe Managed Services (AMS) ou no local

  1. Adicione regras de regravação em arquivos de configuração do Dispatcher ou Apache para implementar redirecionamentos no nível de domínio.
  2. Configure as entradas de host virtual para cada domínio ou subdomínio para habilitar o roteamento adequado.
  3. Mapeie cada domínio ou subdomínio para a raiz apropriada do site do AEM.
  4. Verifique se a configuração do host virtual permite a resolução e a priorização corretas do domínio.

Para Edge Delivery Services (EDS)

Configure redirecionamentos somente para correspondências de caminho exatas no nível do aplicativo e lide com redirecionamentos baseados em host na camada CDN.

Validação:

  1. Execute solicitações HTTP usando ferramentas como curl e verifique se a resposta contém o status de redirecionamento correto e o cabeçalho do local.
  2. Verifique os logs CDN ou os resultados da implantação para confirmar se as regras de redirecionamento estão sendo executadas corretamente.
  3. Verifique se não ocorrem loops de redirecionamento, garantindo um comportamento consistente do host e do host encaminhado nas solicitações.

Quando escalonar:

  • O comportamento de redirecionamento não corresponde à lógica esperada após a implementação do mecanismo de redirecionamento correto.
  • A implantação da configuração do CDN falha devido a erros de validação ou sintaxe não resolvidos.
  • Os domínios não conseguem rotear apesar do registro adequado e dos certificados SSL válidos.
  • Os loops de redirecionamento persistem devido a inconsistências no cabeçalho do host.
  • Os requisitos de roteamento de domínio dinâmico ou curinga não podem ser implementados usando recursos AEM compatíveis.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles