From 2fa50080a62a053affcfcd822a17ea5a5ddbe0a1 Mon Sep 17 00:00:00 2001 From: j-ed Date: Sat, 26 Jan 2013 12:31:54 +0100 Subject: [PATCH] Update admin_manual/configuration_mail.rst added description of SMTP authentication type (mail_smtpauthtype). --- admin_manual/configuration_mail.rst | 37 ++++++++++++++++++++++++++--- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/admin_manual/configuration_mail.rst b/admin_manual/configuration_mail.rst index 108cdd788..991c3bd7a 100644 --- a/admin_manual/configuration_mail.rst +++ b/admin_manual/configuration_mail.rst @@ -77,11 +77,13 @@ Parameters "mail_smtpname" => "", "mail_smtppassword" => "", - If SMTP authentication is required the configuration may be changed as - followed: + If SMTP authentication is required you have to set the required username + and password and can optionally choose between the authentication types + ``LOGIN`` (default) or ``PLAIN``. :: "mail_smtpauth" => true, + "mail_smtpauthtype" => "LOGIN", "mail_smtpname" => "username", "mail_smtppassword" => "password", @@ -100,6 +102,7 @@ Parameters "mail_smtptimeout" => 10, "mail_smtpsecure" => "", "mail_smtpauth" => false, + "mail_smtpauthtype" => "LOGIN", "mail_smtpname" => "", "mail_smtppassword" => "", @@ -117,6 +120,7 @@ Parameters "mail_smtptimeout" => 10, "mail_smtpsecure" => "", "mail_smtpauth" => false, + "mail_smtpauthtype" => "LOGIN", "mail_smtpname" => "", "mail_smtppassword" => "", @@ -134,6 +138,7 @@ Parameters "mail_smtptimeout" => 10, "mail_smtpsecure" => "", "mail_smtpauth" => false, + "mail_smtpauthtype" => "LOGIN", "mail_smtpname" => "", "mail_smtppassword" => "", @@ -211,7 +216,33 @@ Trouble shooting 221 smtp.domain.dom closing connection Connection closed by foreign host. -5. **Enable Debug Mode** +5. **How can I find out which authentication types/methods a SMTP server supports?** + + A SMTP server usually announces the available authentication types/methods + right after a connection has been established. This can easily been checked + with the telnet command. You need to enter the marked lines to get the + information displayed: + :: + + # telnet smtp.domain.dom 25 + Trying 192.168.1.10... + Connected to smtp.domain.dom. + Escape character is '^]'. + 220 smtp.domain.dom ESMTP Exim 4.80.1 Tue, 22 Jan 2013 22:39:55 +0100 + EHLO your-server.local.lan # <<< enter this command + 250-smtp.domain.dom Hello your-server.local.lan [ip-address] + 250-SIZE 52428800 + 250-8BITMIME + 250-PIPELINING + 250-AUTH PLAIN LOGIN CRAM-MD5 # <<< available Authentication types + 250-STARTTLS + 250 HELP + QUIT # <<< enter this command + 221 smtp.domain.dom closing connection + Connection closed by foreign host. + + +6. **Enable Debug Mode** If you are still not able to send email it might be useful to activate further debug messages by setting the following parameter. Right after