DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:authplaincas

authplaincas Plugin

Compatible with DokuWiki

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

plugin CAS authentication plugin without LDAP but with CAS attributes

Last updated on
2016-07-22
Provides
Auth
Repository
Source

Tagged with authentication, cas, plain

Installation

:!: External requirements: This plugin requires the following additional components that must be installed separately:

PHP needs to be configured with curl and xml support for phpCAS to work see phpCAS requirements

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.

:!: You have to download and the phpCAS library and place it in the folder of the plugin so that the file lib/plugins/authplaincas/phpCAS/CAS.php exists.

Configuration and Settings

settings file

To really use this authentication plugin some customization is necessary next to the settings available in the plugin settings interface.

You should copy the file plaincas.settings.php to your conf folder and do the modifications there. (alternatively you can move it wherever you want and specify the path in the conf/local.protected.php file (create when not existing) with $conf['plugin']['authplaincas']['settings_file'])

The four functions in plaincas.settings.php are slightly documented.

In general the procedure is as follows:

  1. The CAS attributes are fetched through the phpCAS library
  2. The CAS attributes are passed to the functions in the plaincas.settings.php file
  3. The mail and name are returned based on the attributes in plaincas_user_attributes
  4. The attributes for the groups are assembled and returned in plaincas_pattern_attributes
  5. All elements of the array returned in plaincas_pattern_attributes are checked against the regular expressions returned from plaincas_group_patterns
  6. The keys of the expressions which match will be assigned as groups of the user.

minimal users

Maybe you don't want everybody from the CAS server to log in on your dokuwiki?

No problem! specify a comma separated list of groups of which at least one has to be assigned in order for the user to be saved.

custom groups

You want to assign groups to certain usernames rather than the CAS attributes?

No problem! in the plaincas.settings.php file you can return an array with the function plaincas_custom_groups with the groups as keys and an array with the usernames as values.

ToDo/Wish List

In the future the plugin could also support the local users list that authplain uses.

Debugging

Make sure the newest version of the plugin is installed. If using the plugin manager make sure the current version is installed. If you continue to have problems put this in conf/local.php $conf['plugin']['authplaincas']['debug'] = TRUE;

FAQ

[discussions should ideally be deleted and turned into FAQ entries along the way]

Discussion

Could be placed on an external page (e.g. plugin:pluginname:discussion) to have a distinction between user comments and author docs

plugin/authplaincas.txt · Last modified: 2017-10-11 21:23 by 78.102.142.215