1# dokuwiki-plugin-authdrupal8
2Authentication plugin for dokuwiki, authenticate with Drupal8 accounts to **Drupal10 with changed password hash**
3
4This plugin might be useful if you are running a drupal website and want to give your drupal users access to a dokuwiki using the same login credentials.
5
6If you install this plugin manually, make sure it is installed in
7lib/plugins/authdrupal8/ - if the folder is called different it
8will not work!
9
10Please refer to http://www.dokuwiki.org/plugins for additional info
11on how to install plugins in DokuWiki.
12
13----
14
15This plugin is widely based on
16
17Dokuwiki MySQL authentication backend by
18* Matthias Jung <matzekuh@web.de>
19
20and
21* Andreas Gohr <andi@splitbrain.org>
22* Chris Smith <chris@jalakai.co.uk>
23* Matthias Grimm <matthias.grimmm@sourceforge.net>
24* Jan Schumann <js@schumann-it.com>
25
26and
27DokuDrupal Drupal 7.x/MySQL authentication backend by
28* Alex Shepherd <n00bATNOSPAMn00bsys0p.co.uk>
29
30mysqli fix by
31* Miro Janosik <miro.janosik.geo+ad7@gmail.com>
32
33----
34## Configuration
35The plugin will only work if you have a drupal installation accessible.
36
37In configuration backend you have to edit at least the following entries:
38* MySQL server
39* MySQL user and password
40* MySQL database holding your drupal tables
41* The database prefix used for your drupal tables (including the underscore e.g. ```myprefix_```)
42
43**Before** setting your authentication mode to ```authdrupal8``` you should think about the following:
44Dokuwiki might only grant access to users that are member of a defined user group. This plugin is reading the user groups from your database.
45Make sure, that you use the exact same user group names in the ACL controls. Otherwise you might not be able to get access to your wiki or your adminstration panel although you are able to log in using correct credentials.
46
47Easiest way is to go to Admin panel/Config/authentication section Security settings and here select :
48* authtype authdrupal8
49* passcrypt sha512
50* administrator: add a administrator group (with @) or username that matches one of your drupal8 administrator roles
51* manager: add a manager group (with @) or username that matches one of your drupal roles or users
52
53----
54
55This program is free software; you can redistribute it and/or modify
56it under the terms of the GNU General Public License as published by
57the Free Software Foundation; version 2 of the License
58