urosm
/
ikiwiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ikiwiki/doc/plugins/httpauth.mdwn

36 lines
1.5 KiB
Plaintext
Raw Normal View History

Migrate doc/plugins via prefix_directives This is a partial commit of: egrep -rl '\[\[[a-z]+ ' doc | xargs --max-args 1 ./ikiwiki-transition prefix_directives
2008-07-21 13:31:57 +02:00
[[!template id=plugin name=httpauth author="Alec Berryman"]]
[[!tag type/auth]]
* Make auth methods pluggable. * Move httpauth support to a plugin. * Add an openid plugin to support logging in using OpenID.
2006-11-20 02:52:18 +01:00
This plugin allows HTTP basic authentication to be used to log into the
httpauth: Add cgiauthurl setting that can be used to do http basic auth only when ikiwiki needs authentication, rather than for any access to the cgi/wiki.
2009-11-10 06:50:59 +01:00
wiki.
* Make auth methods pluggable. * Move httpauth support to a plugin. * Add an openid plugin to support logging in using OpenID.
2006-11-20 02:52:18 +01:00
httpauth: Add cgiauthurl setting that can be used to do http basic auth only when ikiwiki needs authentication, rather than for any access to the cgi/wiki.
2009-11-10 06:50:59 +01:00
## fully authenticated wiki
One way to use the plugin is to configure your web server to require
HTTP basic authentication for any access to the directory containing the
wiki (and `ikiwiki.cgi`). The authenticated user will be automatically
signed into the wiki. This method is suitable only for private wikis.
## separate cgiauthurl
To use httpauth for a wiki where the content is public, and where
httpauth: When cgiauthurl is configured, httpauth can now be used alongside other authentication methods (like openid or anonok). Rather than always redirect to the cgiauthurl for authentication, there is now a button on the login form to use it.
2010-02-11 23:26:09 +01:00
the `ikiwiki.cgi` needs to be usable without authentication (for searching,
or logging in using other methods, and so on), you can configure a separate
url that is used for authentication, via the `cgiauthurl` option in the setup
file. This url will then be redirected to when a user chooses to log in using
httpauth.
httpauth: Add cgiauthurl setting that can be used to do http basic auth only when ikiwiki needs authentication, rather than for any access to the cgi/wiki.
2009-11-10 06:50:59 +01:00
A typical setup is to make an `auth` subdirectory, and symlink `ikiwiki.cgi`
into it. Then configure the web server to require authentication only for
access to the `auth` subdirectory. Then `cgiauthurl` is pointed at this
symlink.
httpauth: Add httpauth_pagespec setting that can be used to limit pages to only being edited via users authed with httpauth.
2010-02-12 00:25:10 +01:00
## using only httpauth for some pages
If you want to only use httpauth for editing some pages, while allowing
other authentication methods to be used for other pages, you can
configure `httpauth_pagespec` in the setup file. This makes Edit
links on pages that match the [[ikiwiki/PageSpec]] automatically use
the `cgiauthurl`, and prevents matching pages from being edited by
users authentication via other methods.