aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/emailauth.mdwn
blob: db22e29319423cf03b2eb73afcea89db23c53e60 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
[[!template id=plugin name=emailauth core=1 author="[[Joey]]"]]
[[!tag type/auth]]

This plugin lets users log into ikiwiki using any email address. To complete
the login, a one-time-use link is emailed to the user, and they can simply
open that link in their browser.

It is enabled by default, but can be turned off if you want to only use
some other form of authentication, such as [[passwordauth]] or [[openid]].

Users who have logged in using emailauth will have their email address used as
their username. In places where the username is displayed, like the
RecentChanges page, the domain will be omitted, to avoid exposing the
user's email address. Note though that the email address will be visible
when looking at eg, commits in the git repository.

This plugin needs the [[!cpan Mail::SendMail]] perl module installed,
and able to send outgoing email.