Les courriers électroniques sont envoyés par l'application esup-helpdesk lors des remontées d'alertes et pour l'envoi des rapports d'exception.
Propriétés de /properties/config.properties
Serveur SMTP (requis)
Le nom ou l'adresse IP du serveur d'envoi des courriers électroniques :
#smtp.host=smtp.domain.edu
Port SMTP
Le port sur lequel tourne le serveur SMTP :
#smtp.port=25
Authentification SMTP
Par défaut une connexion anonyme est utilisée :
#smtp.user= #smtp.password=
Jeu de caractères
Le jeu de caractères utilisé lors de l'envoi de courriers :
#smtp.charset=utf-8
Expéditeur
Les valeurs utilisées pour l'entête From: des courriers envoyés :
#smtp.fromEmail=esup-helpdesk@domain.edu #smtp.fromName=ESUP-Portail Helpdesk
Interception
Le nom du bean utilisé pour intercepter tous les courriers électronique :
#smtp.interceptBean=smtpIntercept
Lors de la mise au point de l'application, il est bon d'intercepter tous les courriers électroniques émis pour ne pas polluer les boites à lettres des utilisateurs. Lors du passage en production, on positionne cette propriété à null.
L'adresse vers laquelle seront redirigés tous les courriers électroniques émis par l'application (utilisée seulement si smtp.interceptBean est positionnée à smtpIntercept) :
#smtp.interceptEmail=maintainer@domain.edu #smtp.interceptName=Maintainer
Les adresses pour les quelles les courriers ne sont jamais interceptés (séparées par des virgules) :
#smtp.notInterceptedAddresses=
Valeurs de test
Les propriétés suivantes sont utilisées lors de l'appel de la tâche ant test-smtp :
#smtp.testEmail=maintainer@domain.edu #smtp.testName=Maintainer
Personnalisations
Remplacement du service SMTP par défaut
Le bean utilisé pour l'envoi de courriers électroniques est nommé smtpService, et est par défaut de la classe org.esupportail.commons.services.smtp.AsynchronousSmtpServiceImpl. Il est possible de développer sa propre implémentation de l'interface SmtpService et déclarer le bean smtpService de cette classe dans le fichier /properties/smtp/smtp.xml.
Dans ce cas, permettre la récupération de la nouvelle classe et du fichier /properties/smtp/smtp.xml lors de la prochaine mise à jour (cf Mises à jour et conservation des personnalisations).
Utilisation de plusieurs serveurs SMTP
Il est possible de s'appuyer sur plusieurs serveurs SMTP pour plus de redondance. Pour cela :
- déclarer plusieurs beans de la classe org.esupportail.commons.services.smtp.SmtpServer (nommés par exemple smtpServer1 et smtpServer2)
- déclarer ces beans dans l'attribut servers du bean smtpService
- permettre la récupération de la nouvelle classe et du fichier /properties/smtp/smtp.xml lors de la prochaine mise à jour (cf Mises à jour et conservation des personnalisations).