It's better when it's simple

User Tools

Site Tools


authsmartcard Plugin

Compatible with DokuWiki

2017-02-19, 2016-06-26, 2015-08-10

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

Last updated on

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with authentication, cac, certificate, smartcard

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.


Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.


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.


None yet.

plugin/authsmartcard.txt · Last modified: 2018-07-26 21:10 by sbbowman

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki