DocumentaciónKCS de Experience Cloud

El correo electrónico SMTP de AEM as a Cloud Service no funciona o no se puede configurar

Última actualización: 6 de julio de 2026

AEM as a Cloud Service no incluye un servidor SMTP y no puede conectarse a hosts SMTP internos o de AMS, por lo que el correo electrónico falla cuando los clientes esperan un servidor integrado o intentan utilizar un relé corporativo o heredado. Todo el correo electrónico saliente debe pasar por un proveedor SMTP público proporcionado por el cliente, autenticado y enrutado a través de redes avanzadas, y los entornos de zona protegida no admiten redes avanzadas, por lo que SMTP no puede funcionar allí. Al seleccionar un proveedor SMTP externo, configurar el reenvío de puertos de red avanzada y agregar la configuración OSGi del servicio de correo, se habilita la entrega de correo electrónico desde los entornos de Ensayo y Producción.

Descripción description

Entornos:

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Assets Essentials
  • Cloud Manager (redes avanzadas)
  • Entornos de fase y producción (espacio aislado y RDE no admiten redes avanzadas)

Problema/Síntomas:

  • El correo electrónico funciona en localhost, pero falla en AEM Cloud, con 500 errores cuando el código se implementa en Author o Publish.
  • No se puede completar la configuración de SMTP porque el cliente esperaba que Adobe proporcionara un servidor SMTP.
  • El correo electrónico no se puede enviar en entornos de espacio aislado porque la red avanzada no es compatible con ellos.
  • Los intentos de usar un servidor SMTP de solo uso interno fallan porque AEMaaCS requiere un extremo SMTP autenticado público.

Causa principal:

AEM as a Cloud Service no proporciona un servidor SMTP y no puede conectarse a hosts SMTP internos. Todo el correo electrónico saliente debe utilizar un proveedor SMTP externo público proporcionado por el cliente y enrutado a través de la red avanzada. Los entornos de zona protegida no admiten redes avanzadas, por lo que SMTP no es posible allí. Los intentos de usar servidores SMTP no SLA proporcionados por AMS fallan porque no se puede acceder a ellos desde el entorno AEMaaCS Kubernetes.

Cómo confirmar

  1. Determine si el entorno es compatible con SMTP. Identifique si el entorno es de espacio aislado, RDE, fase o producción. SMTP no es compatible con zonas protegidas o RDE, por lo que las pruebas deben realizarse en un entorno de nivel de fase o producción.
  2. Confirme que el extremo SMTP deseado es externo y público. AEMaaCS no puede alcanzar hosts SMTP internos o de AMS, por lo que un servidor solo interno no funcionará independientemente de la configuración.

Resolución resolution

Siga estos pasos para resolver el problema:

  1. Seleccione y prepare un proveedor SMTP externo. Elija un proveedor SMTP público y autenticado y obtenga su host, puerto, nombre de usuario y contraseña. Estas credenciales provienen del proveedor de correo electrónico; Adobe no proporciona credenciales SMTP.

  2. Configuración de redes avanzadas en Cloud Manager. Cree portForwards con portOrig establecido en el intervalo 30000-30999 y portDest establecido en 465 o 587 según su proveedor SMTP. Confirme que el JSON de la canalización de Cloud Manager incluye un bloque portForwards.

  3. Añada la configuración OSGi del servicio de correo al repositorio. Crear ui.config/src/jcr_root/apps/<project>/osgiconfig/config/com.day.cq.mailer.DefaultMailService.cfg.json con estos valores:

    • smtp.host = $[ env:AEM_PROXY_HOST;predeterminado=proxy.túnel]
    • smtp.port = el valor portOrig del paso anterior (por ejemplo: 30465 o 30587)
    • smtp.ssl = true al usar el puerto 465, o false al usar el puerto 587

  4. Volver a implementar mediante Cloud Manager. Ejecute una canalización de implementación completa, luego abra /system/console/configMgr (solo lectura pero visible en AEMaaCS) y confirme que com.day.cq.mailer.DefaultMailService refleja los valores configurados.

  5. Compruebe la conectividad SMTP. Almacene en déclencheur un correo electrónico de flujo de trabajo de AEM o envíe un correo electrónico a través de un servlet personalizado y, a continuación, compruebe los registros de su proveedor SMTP para ver si hay una conexión autenticada. Si la entrega está bloqueada, compruebe si el proveedor la está rechazando debido a DKIM/DMARC, que se gestiona en el nivel del proveedor SMTP en lugar de en AEM.

Validación

  1. Confirme que aparece un correo electrónico enviado desde AEM en los registros del panel del proveedor SMTP.
  2. Confirme que el servicio Day CQ Mail Service muestra smtp.host = proxy.túnel y un smtp.port en el intervalo 30000-30999 de la consola OSGi.
  3. Confirme que AEM error.log no muestra errores de conexión SMTP.

Lectura relacionada

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