DocumentationExperience Cloud KCS

Résolution des problèmes de connectivité SMTP dans AEM as a Cloud Service

Dernière mise à jour : 20 octobre 2026

Adobe Experience Manager as a Cloud Service (AEMaaCS) peut rencontrer des délais d’expiration de connexion SMTP lors de la connexion à des serveurs de messagerie externes, car les connexions SMTP sortantes directes sur les ports non HTTP sont bloquées par défaut. Le trafic SMTP doit utiliser le proxy de sortie de réseau avancé avec un transfert de port configuré. Pour résoudre ce problème, configurez le transfert de port et mettez à jour le service de messagerie Day CQ afin d’utiliser l’hôte proxy et le port transféré.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Mise en réseau avancée activée

Problème/Symptômes

  • L’envoi d’e-mails depuis AEM as a Cloud Service vers des points d’entrée SMTP externes échoue avec les délais de connexion expirés.
  • Les journaux AEM affichent des erreurs telles que MailConnectException et SocketTimeoutException.
  • Le serveur de messagerie externe ne reçoit aucune tentative de connexion.

Cause première

Les connexions SMTP sortantes directes sur des ports non HTTP sont bloquées par défaut dans AEM as a Cloud Service. Le trafic SMTP doit être acheminé via le proxy de sortie de réseau avancé à l’aide d’un transfert de port configuré.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Dans Cloud Manager, configurez le transfert du port de réseau avancé pour chaque point d’entrée SMTP externe que vous devez atteindre. Par exemple :

    code language-none 
    {
  "nonProxyHosts": [ ] ,
  "portForwards": [
    {
      "name": "",
      "portDest": 587,
      "portOrig": 30587
    }
  ]
}
    • Remplacez les valeurs d’exemple par l’hôte SMTP réel et choisissez un port interne disponible pour portOrig.
    • Définissez portDest pour correspondre au port SMTP, généralement 587.
    • Utilisez portOrig comme port interne utilisé par AEM pour établir la connexion par le biais du proxy.

  2. Mettez à jour la configuration OSGi pour le service de messagerie 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
}
    • Remplacez les exemples de valeurs, tels que smtp.user et from.address, par vos informations d’identification et adresses.
    • Assurez-vous que smtp.port correspond à la valeur portOrig dans la configuration de transfert.

  3. Déployez les configurations Cloud Manager et OSGi mises à jour dans les environnements AEM, de création et/ou de publication, selon les besoins.

  4. Tester l’envoi d’un e-mail à partir d’AEM et confirmer la réussite de l’envoi via le serveur SMTP externe.

  5. Si la connexion expire toujours :

    • Demandez au fournisseur de messagerie externe de placer sur la liste autorisée l’adresse IP de sortie Adobe à partir de la configuration de mise en réseau avancée.
    • Vérifiez que le fournisseur de messagerie externe voit les tentatives de connexion entrantes sur le port SMTP.
recommendation-more-help
experience-cloud-kcs-help-kbarticles