DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:authsmartcard

authsmartcard Plugin

Compatible with DokuWiki

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

plugin Use client certificates (or smartcards) for authentication to the wiki

Last updated on
2014-07-16
Provides
Auth
Repository
Source

This plugin authenticates users to dokuwiki by comparing the user's client certificate's CN attribute with the group field for a user in the dokuwiki user database.

This is a rewrite of an old plugin by Margus Pärt (mxrguspxrt). Much of the plugin structure and API changed with dokuwiki requiring a rewrite.

Installation

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.

Examples/Usage

For example, user John Doe needs access to the Wiki. John has a client certificate (or smartcard with a certificate on it) that as a CN attribute of 'DOE.JOHN.99999'. John Doe has is added to the dokuwiki user database by an administrator. His username is 'jdoe'. His groups are set to 'DOE.JOHN.99999, finance'.

When John Doe access the Wiki with his browser configured to use a client certificate (or smartcard), this plugin will authenticate user 'jdoe' by comparing the CN of his certificate with the groups he is a member of in the dokuwiki user database.

Configuration and Settings

You must set authtype to authsmartcard in conf/local.php or conf/local.protected.php:

$conf['authtype'] = 'authsmartcard';

Other configuration parameters specific to the authsmartcard plugin are available in lib/plugins/authsmartcard/conf/default.php:

// Enable logging?
$conf['log_to_file']        = true;
// If log_to_file is enabled, where to log?  Make sure apache/php can write to this file
$conf['logfile']        = "/full/path/to/logfile/writable/by/apache";

Change Log

  • 2014-12-10
    • Initial release

Known Bugs and Issues

None - use Issues from link above to open a new case if bugs are found.

FAQ

None yet.

plugin/authsmartcard.txt · Last modified: 2014-12-13 13:51 by ach