This short tutorial covers how to set Galaxy as authentication system for DokuWiki, to read more about DokuWiki follow the article on ESN Wiki.
Note there is currently no possibility* to use multiple auth plugins together with Galaxy. This means you have to use only Galaxy accounts (or public access) to login into your wiki. On the other hand you'll be able to set permissions based on sections and roles so you can share parts of your local wiki with your friend section or create national wiki for everyone without any need to take care about user accounts.
*Please let us know if you find the way ;)
1) Install plaincas plugin
After you set up your DokuWiki it's time to get ESN Galaxy authentication plugin which has been developped by Fabian Bircher, member of IT Committee.
- You can get plaincas plugin for DokuWiki from official plugin page or better from ESN Wiki, which already includes all the settings and dependences (link above)
- Upload the authplaincas folder from archive to lib/plugins/ and enable the plugin in Admin > Extension manager if needed
2) Set your username as superuser and switch to authplaincas
You need to set yourself as superuser first otherway you'll loose admin access as soon as you switch to authplaincas.
- Go to: Admin > Configuration Manager > Authentication
- Add your Galaxy username to Superuser value (case sensitive)
- Later you should set this value to your group eg. @national.webmaster rather than username, but you need to configure groups in plaincas setting file first
- And finally set authplaincas as Authtype value and hit save
- If you can't access Administration now then you're probably not Superuser
If something goes wrong, you can allways set both those values directly in conf/local.php file:
- Superuser account: $conf['superuser'] = 'YourUsername, @local.webmaster';
- Authentication method (authplain as default): $conf['authtype'] = 'authplain';
If you're not sure what your username is, just login here into this helpcenter site and copy it from green message box right after login: "Logged in via ESN Galaxy as YourUserName."
Superuser should be actually @group and not your username as new webmaster should inherit this role according to Galaxy. Sometimes usernames includes various characters including space as username field is currently not trimmed in Galaxy, therefore group instead of username might also help you to avoid trouble.
4) Adjust plaincas.settings.php as desired for your country
What DokuWiki user groups are created based on Galaxy roles is set in plaincas.setting.php file using regular expressions. This can be found in /lib/plugins/authplaincas/ folder or copied right into /conf/ where it gets higher priority. You can find some examples here or directly in ESN plugin package. To see in which groups you currently are just check out Admin > User Manager.
- Swiss National or Local wiki - basic usage - asigns groups to listed sections and roles
- Czech National or Local wiki - advanced usage - gets list of sections from galaxy, caches it for a week and sets groups based on section and role (no need to manually add new sections)
5) Set ACL based on groups from plaincas plugin
- Last step is to set permissions to DokuWiki pages and namespaces based on newly defined groups in Admin > Access Control List Management
- Your groups are not present in ACL unless you define them manually, to do it just type @YourGalaxyGroup, press select, click on desired namespace or page and hit save. ACL lists only groups currently in use by list of rules below, not groups your users are actually in
- Again, to find out in which groups user is just check out Admin > User Manager
- See images below for further help
