====== OpenID Plugin ======

---- plugin ----
description: Allow users to authenticate with OpenID. (previous authors: Andreas Gohr, François Hodierne)
author     : usr-local
email      : 
type       : action
lastupdate : 2023-02-19
compatible : Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Greebo, Igor, Jack Jackrum
depends    : 
conflicts  : 
similar    : 
tags       : authentication, embed

sourcerepo : https://github.com/usr-local/dokuwiki-openid
downloadurl: https://github.com/usr-local/dokuwiki-openid/archive/refs/tags/2.2.0-ul-2.tar.gz
bugtracker : https://github.com/znarf/dokuwiki-openid/issues
----

{{ plugin:openid.png?300|The OpenID login form}}

This plugin allows users to log in through the [[http://openid.net|OpenID]] protocol.

===== Download and Install =====

Download and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

  * [[https://github.com/usr-local/dokuwiki-openid/releases|releases]]

===== Changes =====

==== Version 2  ====

Website: https://github.com/usr-local/dokuwiki-openid

  * [[https://github.com/znarf/dokuwiki-openid/tree/c494263ba48c68b55688ec6b775ff358e0499333|15 February 2011: 2.2.0]]
    * PHP5 only
    * update to latest php-openid library (thanks Adrian Lang)
    * integrate ru and pt-br lang files
  * [[https://github.com/znarf/dokuwiki-openid/tree/5bdaeeab8690217aff70d3c59057ec5dadbde371|01 April 2010: 2.1.0]]
    * new version scheme (precedent beta3 = 2.0.3)
    * fix issues with php-openid library and PHP 5.3
    * ensure plugin works with DokuWiki 2009-12-25
  * [[https://github.com/znarf/dokuwiki-openid/tree/03604432d23ffafa629eecfe7ad932af366ab61f|18 Mai 2009: beta3]]
    * change session/cookie handling
    * don't warn to register if registration is off
    * support for user openids from auth backend
    * better redirects, don't loose current page in the authentication process
    * add a php4 compatibility fix
  * [[https://github.com/znarf/dokuwiki-openid/tree/7174820fa3c91f72f6ad446824e28c2ceef55d87|23 Mar 2009: beta2]]
    * fix an issue preventing authenticating with clean URLs activated
  * [[https://github.com/znarf/dokuwiki-openid/tree/bf6ac4814b82d31e2f36fbb24d5002821b323de2|15 Mar 2009: beta1]]
    * now use JainRain PHP OpenID Library
    * now compatible with OpenID 2.0
    * new workflow, openID identities are now associated with traditional DokuWiki accounts

===== Notes =====

  * The plugin doesn't currently play well with DokuWiki 'auth_security_timeout' configuration. So, for now, you have to set this option to an high value, like '60*60*24', the user being disconnected one day after initial authentication.

===== Bugs =====
  * ...

===== Feature Requests =====

  * Allow an administrator to specify that **ONLY** a specific openID provider would be allowed.  This would allow a wiki to be restricted to an already defined body of users.
    * //This feature is being developed and will be completed soon. Watch the fork on   [[https://github.com/boukeversteegh/dokuwiki-openid|github.com/boukeversteegh/dokuwiki-openid]]//
  * Ability to assign OpenID users to additional groups.
  * Option to completely disable non-OpenID logins.
  * Attribute Exchange support (AX) to allow groups to be assigned
  * Be a OpenID **provider** for wiki users, so they can log in elsewhere with their wiki credentials.
===== Localization =====

Feel free to add any localization tips here.

===== Discussion =====

Just to let you know I got it working with DokuWiki Release 2018-04-22a "Greebo". It's a rough patch though, e.g. only fragments of [[https://github.com/openid/php-openid/issues/8#issuecomment-1346962|The patch in OpenID Issue #8]] triggering a fatal error are applied.
My version is available at https://github.com/usr-local/dokuwiki-openid
 --- [[user>usr-local|Peter]] //2018-06-12 16:31//

Just to let you know I got it working with DokuWiki Release 2022-07-31a "Igor" as well. It includes an update of [[https://github.com/openid/php-openid|PHP OpenID]] as well as the [[https://www.patreon.com/posts/better-forms-58551930|switch to the new dokuwiki form library]].
This version is available at https://github.com/usr-local/dokuwiki-openid/releases/tag/2.2.0-ul-2
 --- [[user>usr-local|Peter]] //2023-02-19 22:00//