DokumentationExperience Cloud KCS

Beheben von SMTP-Verbindungsfehlern in AEM as a Cloud Service

Letzte Aktualisierung: 20. Oktober 2026

Bei Adobe Experience Manager as a Cloud Service (AEMaaCS) kann es beim Herstellen einer Verbindung zu externen E-Mail-Servern zu SMTP-Verbindungstimeouts kommen, da ausgehende direkte SMTP-Verbindungen an Nicht-HTTP-Ports standardmäßig blockiert werden. Der SMTP-Traffic muss den erweiterten Netzwerk-Egress-Proxy mit einem konfigurierten Port für die Weiterleitung verwenden. Um das Problem zu beheben, konfigurieren Sie die Port-Weiterleitung und aktualisieren Sie den Day CQ-E-Mail-Service, um den Proxy-Host und den weitergeleiteten Port zu verwenden.

Beschreibung description

Umgebung

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Erweiterte Netzwerke aktiviert

Problem/Symptome

  • Das Senden von E-Mails von AEM as a Cloud Service an externe SMTP-Endpunkte schlägt mit Verbindungstimeouts fehl.
  • AEM-Protokolle enthalten Fehler wie MailConnectException und SocketTimeoutException.
  • Der externe Mailserver erhält keine Verbindungsversuche.

Grundursache

Direkte ausgehende SMTP-Verbindungen an Nicht-HTTP-Ports sind in AEM as a Cloud Service standardmäßig blockiert. SMTP-Traffic muss über den erweiterten Netzwerk-Egress-Proxy mit einem konfigurierten Port für die Weiterleitung geleitet werden.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Konfigurieren Sie in Cloud Manager die erweiterte Netzwerkport-Weiterleitung für jeden externen SMTP-Endpunkt, den Sie erreichen müssen. Beispiel:

    code language-none 
    {
  "nonProxyHosts": [ ] ,
  "portForwards": [
    {
      "name": "",
      "portDest": 587,
      "portOrig": 30587
    }
  ]
}
    • Ersetzen Sie die Beispielwerte durch den tatsächlichen SMTP-Host und wählen Sie einen verfügbaren internen Port für die portOrig aus.
    • Legen Sie portDest auf den SMTP-Port fest, normalerweise 587.
    • Verwenden Sie portOrig als internen Port, den AEM verwendet, um eine Verbindung über den Proxy herzustellen.

  2. Aktualisieren Sie die OSGi-Konfiguration für den Day CQ Mail Service (com.day.cq.mailer.DefaultMailService):

    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
}
    • Ersetzen Sie Beispielwerte wie smtp.user und from.address durch Ihre Anmeldeinformationen und Adressen.
    • Stellen Sie sicher, dass smtp.port mit dem portOrig in der Port-Forward-Konfiguration übereinstimmt.

  3. Stellen Sie die aktualisierten Cloud Manager- und OSGi-Konfigurationen nach Bedarf in den AEM-Umgebungen bereit - Authoring und/oder Publishing.

  4. Testen Sie das Senden einer E-Mail von AEM und bestätigen Sie den erfolgreichen Versand über den externen SMTP-Server.

  5. Wenn die Verbindung immer noch unterbrochen wird:

    • Bitten Sie den externen E-Mail-Anbieter, die Adobe-Ausgangs-IP aus der erweiterten Netzwerkkonfiguration zu ändern.
    • Vergewissern Sie sich, dass der externe E-Mail-Anbieter eingehende Verbindungsversuche auf dem SMTP-Port sieht.
recommendation-more-help
experience-cloud-kcs-help-kbarticles