summaryrefslogtreecommitdiff
path: root/doc/plugins/openid.mdwn
blob: a6e01ccc5bde91e9bcc1d1c4935f48d92d3c69c9 (plain)

[[template id=plugin name=openid included=1 author="[[Joey]]"]] [[tag type/auth]]

This plugin allows users to use their OpenID to log into the wiki.

The plugin needs the [[cpan Net::OpenID::Consumer]] perl module. The [[cpan LWPx::ParanoidAgent]] perl module is used if available, for added security. Finally, the [[cpan Crypt::SSLeay]] perl module is needed to support users entering "https" OpenID urls.

This plugin has a configuration option. You can set --openidsignup to the url of a third-party site where users can sign up for an OpenID. If it's set, the signin page will link to that site.

This plugin supports the myopenid.com affiliate program, which can be used to help users sign up for an OpenID and log into your site in a single, unified process. When you create the affiliate, specify a login url like http://example.com/ikiwiki.cgi?do=postsignin. Once the affiliate is created, set openidsignup to point to the affiliate's signup url.

This plugin is included in ikiwiki, but is not enabled by default.