✎ ssmtp [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{tag>Jaunty serveur smtp mail BROUILLON}}
----

====== ssmtp ======

ssmtp permet à des applications d'envoyer des courriels via la commande /usr/sbin/sendmail. Contrairement à [[postfix]], il ne fait que rediriger les courriers vers un serveur SMTP externe. C'est donc un outil très léger et rapide, et qui ne demande que très peu de paramétrage.

A quoi cela peut servir ?

ssmtp peut permettre facilement :

* à CRON, ou encore à la commande at, de publier leurs résultats ;
  * d'envoyer des mails via le terminal ;
  * aux CMS et LMS d'un environnement de développement lampp d'envoyer des courriels via sendmail (ex : tester les messages envoyés par Drupal ou Spip).

Si vous voulez savoir si vous pouvez utiliser sendmail avant cette installation, entrez :
''whereis sendmail''
Si vous n'avez rien, l'installation et la configuration de ssmtp vous permettra d'utiliser sendmail.

===== Alternatives =====

* Pour envoyer un mail en ligne de commande : [[tutoriel/comment_envoyer_un_mail_par_smtp_en_ligne_de_commande]]

===== Pré-requis =====

* Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
  * Disposer d'un email, connaître son mot de passe et le serveur smtp du mail.

<note help>Comment connaître le serveur smtp du mail ? Vous pouvez consulter cette page [[http://www.arobase.org/adresses/serveurs.htm]] et renseigner le nom de votre fournisseur de service. Notez alors le serveur smtp et le port utilisé. Si vous ne le trouvez pas dans cette liste, vous pouvez essayer de rajouter mail au nom de domaine de votre courriel, par exemple : mail.votredomaine.com ou mail.libertysurf.fr.
</note>

===== Installation =====

[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt://ssmtp|ssmtp]]**.

Maintenant si vous entrez :
<code>whereis sendmail</code>
Vous devrez obtenir une réponse (ex : sendmail: /usr/sbin/sendmail )

Et qui se cache derrière sendmail ?

<code>ls -la /usr/sbin/sendmail</code>

ssmtp devrait apparaître une fois celui-ci installé :-)

===== Configuration =====

Il y a 2 fichiers à configurer.

==== Configuration de ssmtp.conf ====

[[:tutoriel:comment_modifier_un_fichier|Ouvrez le fichier]] **le fichier /etc/ssmtp/ssmtp.conf** en root comme par exemple avec :

<code>gksudo gedit /etc/ssmtp/ssmtp.conf</code>

Abordons le paramétrage lié à ce fichier.

=== Configuration de root ===

<code># Config file for sSMTP sendmail
#
# Tous les utilisateurs avec un uid < 1000 enverront un mail avec ce nom
# Laissez vide ou commentez la ligne pour déactiver la réécriture
root=votre_identifiant@fournisseur.com</code>

Vous pouvez mettre ici votre adresse mail.

=== Configuration d'AuthUser ===

<note important>Ce paramètre, tout comme le suivant (AuthPass=) n'est pas présent par défaut dans le fichier de configuration, rajoutez-le après root=identifiant@fournisseur.com par exemple, mais ne le mettez pas à la fin du fichier sinon dans les logs (var/log/mail.log) ou dans le terminal vous pourrez avoir le message d'erreur suivant 
<code>send-mail: Authorization failed (535 5.7.0 authentication failed)

Can't send mail: sendmail process failed with error code 1</code></note>

<code># Nom d'utilisateur du compte email avec lequel vous envoyer les mails
AuthUser=votre_identifiant@fournisseur.com</code>

Mettez donc l'identifiant qui vous permet d'accéder à la boîte de messagerie. Cela peut être du type votre_identifiant@fournisseur.com OU votre_identifiant OU votre_identifiant+fournisseur.com (remplacez @ par +). Pour info, le choix entre les 3 possibilités dépend de la configuration du serveur smtp. Par exemple, pour moi, ça a fonctionné avec votre_identifiant@fournisseur.com.

=== Configuration d'AuthPass ===

<code># Mot de passe de ce même compte
AuthPass=le_mot_de_passe_utilisé_pour_votre_identifiant@fournisseur.com</code>

Mettez ici votre mot de passe.

<note important>Attention, par défaut les droits de /etc/ssmtp/ssmtp.conf sont rw-r-r soit 644, ce qui signifie que des autres utilisateurs de votre OS pourront lire votre mot de passe s'ils visitent ce fichier. Pour pallier cela vous pouvez créer une adresse de messagerie uniquement utilisé pour ssmtp ou vous pouvez régler les permissions de /etc/ssmtp/ssmtp.conf sur 640. Cela permettra à ssmtp et au compte de l'administrateur système d'y accéder, sans permettre aux autres utilisateurs de pouvoir lire le contenu de ce fichier. Si vous réglez les permissions de /etc/ssmtp/ssmtp.conf sur 640, il faudra alors créer un utilisateur ssmtp pour que ce dernier puisse accéder à ce fichier de configuration. Vous pouvez par exemple vous inspirer de la commande suivante : pw useradd ssmtp -g nogroup -h - -s /sbin/nologin -d /nonexistent -c "sSMTP pseudo-user" décrite ici : http://blogs.techrepublic.com.com/security/?p=440 mais sous ubuntu pw ne semble pas pouvoir fonctionner. <del>Si vous savez comment adapter cette commande pour ubuntu, merci de l'ajouter ici.</del> Une fois l'utilisateur ssmtp créer, rendez le propriétaire de /etc/ssmtp/ssmtp.conf .<code>sudo chmod 600 /etc/ssmtp/ssmtp.conf
sudo useradd ssmtp -g nogroup -s /sbin/nologin -c "sSMTP pseudo-user"
sudo chown ssmtp /etc/ssmtp/ssmtp.conf</code></note>

=== Configuration de mailhub===

<code># The place where the mail goes. The actual machine name is required no 
# MX records are consulted. Commonly mailhosts are named mail.domain.com
mailhub=mail.fournisseur.com:587</code>

Mettez ici le serveur SMTP que vous allez utiliser, de cette manière ssmtp saura où faire parvenir vos courriels (cf. Prérequis si vous ne savez pas quel est le votre). Les chiffres après les deux points indiquent le port qui va être utilisé lors du contact du serveur smtp. 465 serait le port standard pour les connections SMPTP protégées par TLS et SSL (cf. plus bas). Pour utiliser des connections non cryptées vous pouvez mettre 25 (le port par defaut) ou 587 si par exemple votre FAI bloque le port 25 (mais selon votre fournisseur de service de messagerie, les ports 25 ou 587 peuvent aussi utiliser TLS).

=== Configuration de rewriteDomain ===

<code># Where will the mail seem to come from?
rewriteDomain=fournisseur.com</code>

Ceci indique à ssmtp que l'entête de votre mail doit être modifiée afin que le nom de domaine (texte après @, par exemple fournisseur.com pour votre_identifiant@fournisseur.com ) soit listé comme source de votre adresse email. Attention, si vous mettez autre un "fournisseur.com" différent de votre réel votre_identifiant@fournisseur.com, le message pourra ne pas être reçu par votre destinataire. Si vous commentez cette partie (avec #) le message peut être reçu et votre propre "fournisseur.com" sera utilisé.

=== Configuration de hostname ===

<code># The full hostname
hostname=nom_de_votre_ordinateur.domain</code>

Hostname indique ici le nom de votre ordinateur utilisé pour écrire et envoyer les mails. La partie .domain peut ou ne pas être mentionné. Vous pouvez entrez dans un terminal <code>hostname</code> pour connaître votre nom d'ordinateur.

Note : On dirait que ça n'a pas d'incidence sur la possibilité ou non d'envoyer des mails.

=== Configuration de FromLineOverride ===

<code># Are users allowed to set their own From: address?
# YES - Allow the user to specify their own From: address
# NO - Use the system generated From: address
FromLineOverride=YES</code>

Mettre YES permet au programme qui envoie un mail de modifier l'entête du message concernant l'émetteur.

<code>
# Utilisation d'une connexion sécurisée SSL/TLS (décommenter pour activer)
#UseTLS=YES</code>

Décommenter UseTLS=YES permet d'encrypter la connexion au serveur SMTP et de protéger votre login et mot de passe.

<note important>Si lors d'un envoi de mail avec le terminal ou dans les logs (var/log/mail.log) vous voyez <code>send-mail: Connection lost in middle of processing
Can't send mail: sendmail process failed with error code 1</code>, c'est peut être lié à un problème d'utilisation de TLS. Commenter UseTLS=YES peut permettre de résoudre le problème. 
</note>
<note important>UseTLS ne fonctionnerait pas avec authsmtp, seulement UseSTARTTLS fonctionnerait. Vous pouvez donc essayer UseSTARTTLS=YES au lieu de UseTLS=YES cf. https://cloud-support.engineyard.com/faqs/questions/ssmtp </note>

==== Configuration de revaliases ====

Passons maintenant au deuxième et dernier fichier à éditer. [[:tutoriel:comment_modifier_un_fichier|Ouvrez le fichier]] **le fichier /etc/ssmtp/revaliases** en root comme par exemple avec :

<code>gksudo gedit /etc/ssmtp/revaliases</code>

Et appliquez les modifications suivantes :

<code># sSMTP aliases
# 
# Format:	local_account:outgoing_address:mailhub
#
# Example: root:your_login@your.domain:mailhub.your.domain[:port]
# where [:port] is an optional port number that defaults to 25.
root:votre_identifiant@fournisseur.com:mail.fournisseur.com:587
# Other System user: (for Apache)
# www-data:votre_identifiant@fournisseur.com:mail.fournisseur.com:587
</code>

Où mail.fournisseur.com le serveur smtp de votre fournisseur de service de messagerie et 587 le port utilisé.

<note tip>Très pratique, il n'est pas nécessaire de redémarrer quoi que ce soit pour que les modifications de ssmtp.conf soient prises en compte, elles le sont tout de suite.</note>

===== Utilisation=====

==== En Ligne de commande ====

Une fois ssmtp configuré, vous pouvez [[:tutoriel:comment_installer_un_paquet|installez le paquet]] [[apt://xmail|xmail]] et envoyer un mail avec la commande suivante :

<note important>Dans Ubuntu Karmic (9.10) l'installation de xmail requiert la désinstallation de ssmtp.\\ Si vous voulez simplement tester ssmtp utilisez la commande ''ssmtp dest@domaine.com'' pour envoyer un message de test.\\ Sinon installez [[apt://mailutils|mailutils]] (//Attention la commande ci dessous est à rectifier//</note>

<code>echo Contenu du message | mail -v -s "sujet du mail" lemailpourlequelvoussouhaitezrecevoirlemessage@blabla.com</code>

si vous avez installé **//mailutils//** (Karmic) :

<code>echo Contenu du message | mail -s "TEST" -t email@destinataire.com -a From:email@expediteur.com</code>

Vous pourrez ainsi vérifier la configuration de ssmtp.conf et essayer de modifier certains paramètres sur ce dernier.

==== Paramétrer pour LAMP (fonction mail() de PHP) ====

Ouvrez le fichier ''/etc/php5/apache2/php.ini'' et éditez la ligne suivante((l'option **-l** n'est pas utilisée par ''ssmtp'')) :

<code>sendmail_path = /usr/sbin/ssmtp -t</code>

et ne pas oublier de redémarrer le serveur PHP avec la commande:

<code>sudo service apache2 restart</code>

===== Accéder aux logs ======

<code>gedit /var/log/mail.log</code>

===== Pour aller plus loin =====

* Consulter les man de ssmtp :

<code>man ssmtp</code>

<code>man ssmtp.conf</code>

===== Désinstallation =====

Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. La configuration de l'application sera conservée ou supprimée selon la méthode de désinstallation que vous choisirez.

===== Liens =====

//Basé sur ://

* **(en)** [[http://blogs.techrepublic.com.com/security/?p=440|"Use sSMTP to send e-mail simply and securely" par Chad Perrin, article détaillé sur la configuration de ssmtp ayant servi à la réalisation de cette page]]
  * **(fr)** [[http://artisan.karma-lab.net/node/1171|"Utiliser ssmtp comme remplacement de sendmail" par Ulhume, article de blog sur ssmtp, ayant servi à la réalisation de cette page]]

Autres liens :

* **(fr)** [[http://www.d-sites.com/2009/06/19/utiliser-un-serveur-smtp-distant-pour-envoyer-des-mails-depuis-son-serveur/]] ;
  * **(fr)** [[http://forum.ubuntu-fr.org/viewtopic.php?id=137722]] Régler ssmtp pour fonctionner avec Gmail + résolutions d'autres problèmes ;
  * **(fr)** [[http://forum.ubuntu-fr.org/viewtopic.php?id=217202]] Exemple de configuration.
  * **(en)** [[https://cloud-support.engineyard.com/faqs/questions/ssmtp]] Conseils sur la configuration de ssmtp.

----

//Contributeurs principaux : [[utilisateurs:elpepe|elpepe]]

Merci de recopier le code ci-contre pour prouver que vous êtes humain : J N E E J Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported