解决AEM as a Cloud Service中的SMTP连接故障

在连接到外部邮件服务器时,Adobe Experience Manager as a Cloud Service (AEMaaCS)可能会遇到SMTP连接超时,因为默认情况下会阻止非HTTP端口上的直接出站SMTP连接。 SMTP通信必须使用具有配置的端口转发的高级网络出口代理。 要解决此问题,请配置端口转发并更新Day CQ Mail Service以使用代理主机和转发的端口。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • 高级联网已启用

问题/症状

  • 从AEM as a Cloud Service向外部SMTP端点发送电子邮件的过程因连接超时而失败。
  • AEM日志显示错误,如​ MailConnectException ​和​SocketTimeoutException。
  • 外部邮件服务器未收到任何连接尝试。

根本原因

默认情况下,AEM as a Cloud Service中会阻止非HTTP端口上的直接出站SMTP连接。 SMTP流量必须使用配置的端口转发通过高级网络出口代理进行路由。

解决方法 resolution

请按照以下步骤解决问题:

  1. 在Cloud Manager中,为需要连接的每个外部SMTP端点配置高级联网端口转发。 例如:

    code language-none
    {
      "nonProxyHosts": [ ] ,
      "portForwards": [
        {
          "name": "",
          "portDest": 587,
          "portOrig": 30587
        }
      ]
    }
    
    • 将示例值替换为实际SMTP主机,并为portOrig选择一个可用的内部端口。
    • 设置portDest以匹配SMTP端口,通常为587。
    • 使用portOrig作为AEM用于通过代理连接的内部端口。
  2. 更新Day CQ邮件服务(com.day.cq.mailer.DefaultMailService)的OSGi配置:

    code language-none
    {
      "smtp.host": "$[ env:AEM_PROXY_HOST;default=proxy.tunnel] ",
      "smtp.port": "30587", // Use the portOrig value from your port forward
      "smtp.user": "",
      "smtp.password": "$[ secret:SMTP_PASSWORD] ",
      "from.address": "user@example.com",
      "smtp.ssl": false,
      "smtp.starttls": true,
      "smtp.requiretls": true
    }
    
    • 将示例值(如smtp.user和from.address)替换为您的凭据和地址。
    • 确保smtp.port与端口转发配置中的portOrig值匹配。
  3. 根据需要,将更新的Cloud Manager和OSGi配置部署到AEM环境“创作”和/或“发布”。

  4. 测试从AEM发送电子邮件,并确认通过外部SMTP服务器成功投放。

  5. 如果连接仍然超时:

    • 要求外部邮件提供商从高级联网配置Adobe出口IP。
    • 确认外部邮件提供商在SMTP端口上看到传入连接尝试。
recommendation-more-help
experience-cloud-kcs-help-kbarticles