DocumentazioneExperience Cloud KCS

Risoluzione degli errori di connettività SMTP in AEM as a Cloud Service

Ultimo aggiornamento: 20 ottobre 2026

Adobe Experience Manager as a Cloud Service (AEMaaCS) può riscontrare timeout di connessione SMTP durante la connessione a server di posta esterni perché le connessioni SMTP dirette in uscita su porte non HTTP sono bloccate per impostazione predefinita. Il traffico SMTP deve utilizzare il proxy di uscita di rete avanzata con una porta di inoltro configurata. Per risolvere il problema, configura l’inoltro delle porte e aggiorna Day CQ Mail Service in modo che utilizzi l’host proxy e la porta inoltrata.

Descrizione description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Funzionalità di rete avanzate abilitate

Problema/Sintomi

  • L’invio di e-mail da AEM as a Cloud Service a endpoint SMTP esterni non riesce e si verificano timeout di connessione.
  • I registri di AEM mostrano errori quali MailConnectException e SocketTimeoutException.
  • Il server di posta esterno non riceve alcun tentativo di connessione.

Causa principale

Le connessioni SMTP dirette in uscita su porte non HTTP sono bloccate per impostazione predefinita in AEM as a Cloud Service. Il traffico SMTP deve essere instradato attraverso il proxy di uscita di rete avanzata utilizzando una porta di inoltro configurata.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. In Cloud Manager, configurare l’inoltro delle porte di rete avanzate per ogni endpoint SMTP esterno che è necessario raggiungere. Ad esempio:

    code language-none 
    {
  "nonProxyHosts": [ ] ,
  "portForwards": [
    {
      "name": "",
      "portDest": 587,
      "portOrig": 30587
    }
  ]
}
    • Sostituire i valori di esempio con l’host SMTP effettivo e scegliere una porta interna disponibile per portOrig.
    • Impostare portDest in modo che corrisponda alla porta SMTP, in genere 587.
    • Utilizza portOrig come porta interna utilizzata da AEM per connettersi tramite il proxy.

  2. Aggiorna la configurazione OSGi per il servizio di posta Day CQ (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
}
    • Sostituire i valori di esempio, ad esempio smtp.user e from.address, con le credenziali e gli indirizzi.
    • Verificare che smtp.port corrisponda al valore portOrig nella configurazione port-forward.

  3. Se necessario, distribuisci le configurazioni Cloud Manager e OSGi aggiornate negli ambienti AEM, Author e/o Publish.

  4. Prova a inviare un’e-mail da AEM e conferma del completamento della consegna tramite il server SMTP esterno.

  5. Se la connessione si interrompe:

    • Chiedere al provider di posta elettronica esterno di inserire nell’elenco Consentiti l’IP in uscita di Adobe dalla configurazione di rete avanzata.
    • Verificare che il provider di posta esterna veda i tentativi di connessione in ingresso sulla porta SMTP.
recommendation-more-help
experience-cloud-kcs-help-kbarticles