doc/plugins/emailauth.mdwn

   1 [[!template id=plugin name=emailauth core=1 author="[[Joey]]"]]
   2 [[!tag type/auth]]
   3
   4 This plugin lets users log into ikiwiki using any email address. To complete
   5 the login, a one-time-use link is emailed to the user, and they can simply
   6 open that link in their browser.
   7
   8 It is (indirectly) enabled by default, but can be turned off if you want to
   9 only use some other form of authentication, such as [[passwordauth]] or
  10 [[openid]].
  11
  12 Users who have logged in using emailauth will have their email address used as
  13 their username. In places where the username is displayed, like the
  14 RecentChanges page, the domain will be omitted, to avoid exposing the
  15 user's email address. In places where the full username needs to be put,
  16 like commits of changes, the email address is cloaked using
  17 <a href="http://xmlns.com/foaf/spec/#term_mbox_sha1sum">the
  18 foaf:mbox_sha1sum spec</a>.
  19
  20 This plugin needs the [[!cpan Mail::Sendmail]] perl module installed,
  21 and able to send outgoing email.