DocumentaçãoKCS da Experience Cloud

O email SMTP do AEM as a Cloud Service não está funcionando ou não pode ser configurado

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

O AEM as a Cloud Service não inclui um servidor SMTP e não pode se conectar a hosts SMTP internos ou do AMS, portanto, o email falha quando os clientes esperam um servidor integrado ou tentam usar uma retransmissão corporativa ou herdada. Todo e-mail de saída deve passar por um provedor SMTP autenticado e público fornecido pelo cliente roteado pela rede avançada, e os ambientes de sandbox não são compatíveis com a rede avançada; portanto, o SMTP não pode funcionar lá. Selecionar um provedor SMTP externo, configurar o encaminhamento de porta de rede avançada e adicionar a configuração OSGi do serviço de email permite a entrega de emails de ambientes de Preparo e Produção.

Descrição description

Ambientes:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Fundamentos do AEM Assets
  • Cloud Manager (rede avançada)
  • Ambientes de preparo e produção (sandbox e RDE não são compatíveis com rede avançada)

Problema/sintomas:

  • O email funciona no localhost, mas falha na AEM Cloud, com 500 erros quando o código é implantado para Autor ou Publicação.
  • A configuração do SMTP não pode ser concluída porque o cliente esperava que a Adobe fornecesse um servidor SMTP.
  • O email não pode ser enviado em ambientes de sandbox porque não há suporte para redes avançadas.
  • As tentativas de usar um servidor SMTP somente interno falham porque o AEMaaCS requer um ponto de extremidade SMTP público autenticado.

Causa raiz:

A AEM as a Cloud Service não fornece um servidor SMTP e não pode se conectar a hosts SMTP internos. Todo email de saída deve usar um provedor SMTP externo público fornecido pelo cliente roteado pelo Advanced Networking. Os ambientes de sandbox não são compatíveis com a rede avançada, portanto, o SMTP não é possível. As tentativas de usar servidores SMTP sem SLA fornecidos pelo AMS falham porque eles não são acessíveis pelo ambiente Kubernetes do AEMaaCS.

Como confirmar

  1. Determine se o ambiente é compatível com SMTP. Identifique se o ambiente é Sandbox, RDE, Preparo ou Produção. O SMTP não é compatível com sandbox ou RDE, portanto, o teste deve ocorrer em um ambiente de preparo ou de produção.
  2. Confirme se o terminal SMTP pretendido é externo e público. O AEMaaCS não pode acessar hosts SMTP internos ou do AMS, portanto, um servidor somente interno não funcionará independentemente da configuração.

Resolução resolution

Siga estas etapas para resolver o problema:

  1. Selecione e prepare um provedor SMTP externo. Escolha um provedor SMTP público e autenticado e obtenha seu host, porta, nome de usuário e senha. Essas credenciais vêm do seu provedor de email — a Adobe não fornece credenciais SMTP.

  2. Configurar redes avançadas no Cloud Manager. Crie portForwards com portOrig definido no intervalo 30000-30999 e portDest definido como 465 ou 587, dependendo do seu provedor de SMTP. Confirme se o pipeline JSON do Cloud Manager inclui um bloco portForwards.

  3. Adicione a configuração OSGi do serviço de e-mail ao seu repositório. Criar ui.config/src/jcr_root/apps/<project>/osgiconfig/config/com.day.cq.mailer.DefaultMailService.cfg.json com estes valores:

    • smtp.host = $[ env:AEM_PROXY_HOST;default=proxy.tunnel]
    • smtp.port = o valor portOrig da etapa anterior (por exemplo: 30465 ou 30587)
    • smtp.ssl = true ao usar a porta 465, ou false ao usar a porta 587

  4. Reimplante via Cloud Manager. Execute um pipeline de implantação completa, abra /system/console/configMgr (somente leitura, mas visível no AEMaaCS) e confirme se com.day.cq.mailer.DefaultMailService reflete os valores configurados.

  5. Verifique a conectividade SMTP. Acione um email de fluxo de trabalho do AEM ou envie um email por meio de um servlet personalizado e, em seguida, verifique se há uma conexão autenticada nos logs do provedor SMTP. Se o delivery estiver bloqueado, verifique se o provedor está rejeitando-o devido ao DKIM/DMARC, que é manipulado no nível do provedor SMTP, em vez do AEM.

Validação

  1. Confirme se um email enviado do AEM aparece nos logs do painel do provedor SMTP.
  2. Confirme se o Day CQ Mail Service mostra smtp.host = proxy.tunnel e um smtp.port no intervalo 30000-30999 do console OSGi.
  3. Confirme se o AEM error.log não mostra erros de conexão SMTP.

Leitura relacionada

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