Table of Contents
Note: Wrong use of some settings can make your wiki unreachable. Be sure to read the full documentation before installing/activating the plugin.
External requirements: This plugin requires the following additional components that must be installed separately:
When using the plugin Dokuwiki will get the user and login information from a Drupal 8 or 9 database.
Users can login using their Drupal 8 and 9 login credentials. Registering and modifying users is not possible (and most likely will not be) as this functionality is provided by Drupal.
Dokuwiki will read user groups and memberships from the Drupal 8 or 9 database as well. Make sure you read the configuration instructions further below on this page.
Configuration and Settings
After installation and activation the plugin can be configured using the dokuwiki configuration page. Make sure you stick to the suggested order unless you know exactly what you do.
1. Plugin configuration
You will find an authdrupal8-section on your config page. Edit the following values:
- database: name of the drupal database on your mysql-server
- username: mysql-username with at least reading access to the Drupal database
- prefix: Prefix of your Drupal tables, e.g.
mypre_, make sure it ends with an underscore
- host: this will most likely be
2. ACL settings
Dokuwiki will use the Drupal roles as usergroups. To get the correct permissions for your users you have to edit the ACL settings.
When granting permissions the user group names are replaced with Drupal role names. If you want to grant access to all Drupal users that are members of the role
wiki use the user group name
Go to the authentication section of the configuration page.
- Add a Drupal role or a valid Drupal username to the list of super-users
@administrator. I highly recommend you to be part of this group as it will be necessary to access the administration section afterwards. I highly recommend keeping “@admin” too, so that you can easily go back to “authplain”.
- You can add valid Drupal roles / usernames to the manager list.
About Drupal roles
I highly recommend that you create new Drupal roles for use in your Dokuwiki permissions. Doing this you will be able to grant or deny wiki permissions without affecting your drupal permission. Not neccessarily should every Drupal admin have superuser rights in Dokuwiki. Create and assign this roles using Drupal administration tools.
authdrupal8 plugin widely bases on the authdrupal7 plugin by Matthias Jung.
Some changes were neccessary as Drupal 8 uses some algorithms for hashing passwords that were not realizable using the authdrupal7 plugin.