DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:authimap

authimap Plugin

Compatible with DokuWiki

  • 2017-02-19 "Frusterick Manners" unknown
  • 2016-06-26 "Elenor Of Tsort" unknown
  • 2015-08-10 "Detritus" unknown
  • 2014-09-29 "Hrun" yes

plugin Authenticate users against an IMAP server

Last updated on
2015-02-26
Provides
Auth
Repository
Source

Tagged with auth, imap, pop3

This plugin allows you to configure your DokuWiki to use a mailserver as authentication backend (IMAP and POP3 should work). It only works for a single server and single E-Mail domain only. Logins are the local part of the email-Address and Full-Names are derived from the local part as well. All users are member of the default group only.

Installation

A CosmoCode Plugin

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

Configuration and Settings

The plugin has three config options that you probably want to manually configure in your conf/local.protected.php. Here's an example:

$conf['authtype'] = 'authimap';
$conf['plugin']['authimap']['server'] = '{mail.example.com:993/imap/ssl}INBOX';                                   
$conf['plugin']['authimap']['domain'] = 'example.com';                                                                 
$conf['plugin']['authimap']['usedomain'] = 1;

The server setting requires a imap_open mailbox string. Here are a couple of examples:

  • connect to an IMAP server running on port 143 on mail.example.com:
    {mail.example.com:143}INBOX
  • connect to a POP3 server on port 110 on mail.example.com:
    {mail.example.com:110/pop3}INBOX
  • connect to an SSL IMAP server:
    {mail.example.com:993/imap/ssl}INBOX
  • connect to an SSL POP3 server with a self-signed certificate:
    {mail.example.com:995/pop3/ssl/novalidate-cert}

The domain setting is the E-Mail domain all your users use (the part after the @-character).

Enable the usedomain setting if users log in with their full email address instead of the local part only at your mailserver. Logins at DokuWiki always use the local part only.

plugin/authimap.txt · Last modified: 2015-02-26 11:32 by grosse