plugin:genericsso
Table of Contents
genericsso Plugin
Compatible with DokuWiki
- 2024-02-06 "Kaos" yes
- 2023-04-04 "Jack Jackrum" yes
- 2022-07-31 "Igor" unknown
- 2020-07-29 "Hogfather" unknown
Allows to authenticate against any SSO system that set environment variables
Similar to shibbolethauth
This plugin replaces shibbolethauth for DokuWiki > 2013-05-10 “Weatherwax”.
It allows to authenticate against any SSO system that sets environment variables or HTTP headers with the user attributes after authentication (such as Shibboleth).
Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Configuration and Settings
| Parameter name | Type | Signification | Default value |
|---|---|---|---|
| autologin | bool | Automatically logs user in if attributes are available | false |
| headers | bool | Get attributes from HTTP headers instead of ENV variables (used when behind a SAML proxy | false |
| login_url | string | Service provider login trigger URL, {target} will be replaced by the URL of the page to return to | /sso/login?target={target} |
| logout_url | string | Service provider logout trigger URL, {target} will be replaced by the URL of the page to return to | /sso/logout?target={target} |
| home_url | string | URL to return to after logout | / |
| idp_attribute | string | Attribute to use as identity provider identifier | REMOTE_USER |
| id_attribute | string | Attribute to use as user identifier | REMOTE_USER |
| email_attribute | string | Attribute to use as user email | REMOTE_USER |
| fullname_attribute | string | Attribute to use as user name | REMOTE_USER |
Sample php config using Shibboleth
$conf['plugin']['genericsso']['id_attribute'] = 'eppn'; $conf['plugin']['genericsso']['email_attribute'] = 'mail'; $conf['plugin']['genericsso']['fullname_attribute'] = 'dn'; $conf['plugin']['genericsso']['autologin'] = 1; $conf['plugin']['genericsso']['login_url'] = 'http://'.$_SERVER['SERVER_NAME'].'/Shibboleth.sso/Login?target={target}'; $conf['plugin']['genericsso']['logout_url'] = 'http://'.$_SERVER['SERVER_NAME'].'/Shibboleth.sso/Logout?return={target}';
plugin/genericsso.txt · Last modified: by yent