Question : Comment configurer le serveur SMTP nécessaire pour l’envoi des fiches ?

Lorsqu’une tentative d’envoi par courriel retourne ce message : Erreur de commande interne~: Smtp parameters are not initialized (InitError: -1), cela signifie que les paramètres d’envoi SMTP ne sont pas renseignés.

Niveau : Administration système

Réponse :

Le logiciel BDF n’inclut pas lui-même de serveur d’envoi de courriels, il faut donc lui indiquer un serveur SMTP à utiliser avec les paramètres de connexion nécessaire.

Cette configuration n’est pas accessible via l’interface d’administration. Elle se fait via un fichier texte qui doit contenir les différents paramètres.

Par défaut, BDF regarde la présence un fichier appelé bdf-smtp.properties directement dans le répertoire WEB-INF où il est installé. Il est cependant possible d’indiquer un autre chemin (voire un autre nom) en définissant un paramètre nommé bdfSmtpFile dans le fichier de déclaration du contexte (au sens de Tomcat) de l’application BDF.

<Context docBase="/home/tomcat/webapps/bdf">
<Parameter name="bdfSmtpFile" value="/home/vic/java/bdf/bdf-smtp.properties"/>
</Context>

Exemple de définition du paramètre bdfSmtpFile dans le fichier de déclaration du contexte

Le fichier de configuration doit contenir les informations organisées sous la forme de couple clé=valeur, avec un couple par ligne.

Les clés sont les suivantes :

  • authentification : cette clé est obligatoire, elle indique le mécanisme utilisé pour l’identification au serveur, elle a trois valeurs possibles :

    • none : pas d’identification (cas d’un serveur en local)

    • basic : identification via un nom d’utilisateur et un mot de passe normale

    • pop : identification en se connectant préalablement avec le protocle Pop au serveur

    • ssl : connexion au serveur via ssl avec nom d’utilisateur et mot de passe

  • host : obligatoire, c’est le nom du serveur SMTP

  • port : facultatif, c’est le port du serveur SMTP (25 par défaut ou 465 en cas de connexion ssh)

  • username : obligatoire, sauf en l’absence d’identification, c’est le nom de l’utilisateur

  • password : obligatoire, sauf en l’absence d’identification, c’est le mot de passe

Pour que les modifications soient prises en compte, il est nécessaire de relancer l’application.

Voici quelques exemples de fichier de configuration :

authentification=none
host=localhost

accès au serveur local sans identification

authentification=basic
host=smtp.mon-hebergeur.com
username=mon_compte
password=mon_mot_de_passe

accès classique

authentification=ssl
host=smtp.googlemail.com
username=mon_compte@gmail.com
password=mon_mot_de_passe_gmail

accès SSL en utilisant un compte GMail

Point important : l’accès ssl peut se faire avec un serveur possédant un certificat auto-signé, BDF ne demandant pas de confirmation.