To create new wiki account, please join us on #znc at Libera.Chat and ask admins to create a wiki account for you. You can say thanks to spambots for this inconvenience.

imapauth

From ZNC
Revision as of 16:37, 7 November 2012 by >Un1matr1x
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This module is intended for admins who run a shell/web/email/etc server and want to provide ZNC access to their existing users. By using this module, when your users login to ZNC - either with their IRC client or via the webadmin module - their password will be checked against your IMAP server instead of the ZNC config file.

Usage

Arguments

This user module takes up to three arguments. The arguments can be [server] [[+]port] [UserFormatString].

Read loading modules to learn more about loading modules.

If you want to set the arguments manually use this as reference:

  • Server: should be self explanatory. It is the IMAP server to connect to when trying to authenticate an incoming user.
  • Port: is the port that your IMAP server listens on. Use a + before the port to connect using SSL.
  • UserFormatString: will format the incoming username.
    • You use a % to represent the username like so.. %@foo.com - This will send fred@foo.com to your imap server when a user tries to authenticate as the user fred.
    • You can force the user to supply the full email address leaving this string blank or supplying just % by itself.

If any arguments are left blank the following defaults will be used:

  • Server: localhost
  • Port: 143 (non-SSL)
  • UserFormatString: Empty

Note: SSL must be enabled when you want the module to connect to the IMAP server using SSL.