Qpsmtpd:auth/auth imap

From SME Server
Jump to navigation Jump to search

Qpsmtpd#Plugins

NAME

auth_imap - Authenticate to an IMAP server

DESCRIPTION

This plugin authenticates against any IMAP server you wish (it also supports SSL). You need to specify the IMAP server and port number in the plugins configuration file like so:

auth/auth_imap 192.168.0.1 143

Without any options, it defaults to connecting to the IMAP server on localhost on port 143.

This plugin requires the Net::IMAP::Simple::SSL CPAN module. Options from that module can be added to the $server->() constructor below if your IMAP server requires older versions of SSL rather than TLS or for connection debugging ( debug => 1, ssl_version => "SSLv3", etc.). While you can adjust these settings, the plugin should work as is for a typical IMAP server.

See the Net::IMAP::Simple POD for details on how tune the constructor parameters.

Note that auth_imap requires that you use AUTH PLAIN or AUTH LOGIN mechanisms which means that communication between your e-mail client and Qpsmtpd - and between Qpsmtpd and your IMAP server - should be encrypted. There are several approaches to enabling encrypted password storage on the IMAP server. For dovecot2 see: http://wiki2.dovecot.org/HowTo/CRAM-MD5

This plugin is suited for authorizing user connections to a Qpsmtp SMTP server acting as a relay or a primary mail server. The principal benefit is ease of adminstration when an existing IMAP service is already established.

head1 AUTHOR Christopher Heschong

Edits to add SSL support and updated for latest qpsmtpd version - James Turnbull <james@lovedthanlost.net>

COPYRIGHT AND LICENSE

Copyright (c) 2004 Christopher Heschong This plugin is licensed under the same terms as the qpsmtpd package itself. Please see the LICENSE file included with qpsmtpd for details.