Table of Contents

genericsso Plugin

Compatible with DokuWiki

  • 2025-05-14 "Librarian" unknown
  • 2024-02-06 "Kaos" yes
  • 2023-04-04 "Jack Jackrum" yes
  • 2022-07-31 "Igor" unknown

plugin Allows to authenticate against any SSO system that set environment variables

Last updated on
2024-07-23
Provides
Auth
Repository
Source

Similar to shibbolethauth

Tagged with auth, shibboleth, sso

By Etienne Méléard

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}';