Wiki source code of Authentication
Last modified by Thomas Mortagne on 2023/10/10
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | = Logging in = | ||
| 6 | |||
| 7 | When you need to log in to access a wiki page, you'll see the following form: | ||
| 8 | |||
| 9 | {{image reference="login.png"/}} | ||
| 10 | |||
| 11 | == Forgot Username == | ||
| 12 | |||
| 13 | If you forgot your username, you can retrieve it by clicking on the "Forgot your username?" link: | ||
| 14 | |||
| 15 | {{image reference="login-forgot-username-1"/}} | ||
| 16 | |||
| 17 | Then, you'll need to indicate the email address for your user and you'll be emailed your username (the mail template can be [[customized>>Documentation.AdminGuide.Authentication.WebHome#HMailTemplates]]). | ||
| 18 | |||
| 19 | {{image reference="login-forgot-username-2"/}} | ||
| 20 | |||
| 21 | == Forgot Password == | ||
| 22 | |||
| 23 | If you forgot your password, you can reset it by clicking on the "Forgot your password?" link: | ||
| 24 | |||
| 25 | {{image reference="login-forgot-password-1"/}} | ||
| 26 | |||
| 27 | Then, you'll need to indicate your username and if you had an email address set for your user, you'll receive a email with a link to set a new password (the mail template can be [[customized>>Documentation.AdminGuide.Authentication.WebHome#HMailTemplates]]). | ||
| 28 | |||
| 29 | {{image reference="login-forgot-password-2"/}} | ||
| 30 | |||
| 31 | = Authentication Mechanisms = | ||
| 32 | |||
| 33 | XWiki Standard embeds several authentication mechanisms by default: | ||
| 34 | |||
| 35 | * Form authentication | ||
| 36 | * Basic authentication | ||
| 37 | |||
| 38 | In addition XWiki allows you to create your own authentication extension in order to integrate with any custom mechanism you might be using already (SSO, etc). | ||
| 39 | |||
| 40 | Additional authenticators are available as extensions on [[extensions.xwiki.org>>extensions:Main.WebHome]]: | ||
| 41 | |||
| 42 | {{velocity}} | ||
| 43 | #set ($xwql = "from doc.object(ExtensionCode.ExtensionClass) as extension, doc.object(EXOExtensionCode.ExtensionClass) as exoextension where extension.category = 'authenticator'") | ||
| 44 | #set ($extensions = $services.query.xwql($xwql).setWiki('extensions').execute()) | ||
| 45 | #foreach ($extension in $extensions) | ||
| 46 | * [[extensions:$extension]] | ||
| 47 | #end | ||
| 48 | {{/velocity}} | ||
| 49 | |||
| 50 | {{info}} | ||
| 51 | Note that several extensions are not yet categorized in the ##authenticator## category on [[extensions.xwiki.org>>extensions:Main.WebHome]] and this is why they don't appear in the list above. For the moment, here's list of all extensions having "Authenticator" in the name: | ||
| 52 | |||
| 53 | {{velocity}} | ||
| 54 | #set ($xwql = "from doc.object(ExtensionCode.ExtensionClass) as extension, doc.object(EXOExtensionCode.ExtensionClass) as exoextension where extension.name like '%Authenticator%'") | ||
| 55 | #set ($extensions = $services.query.xwql($xwql).setWiki('extensions').execute()) | ||
| 56 | #foreach ($extension in $extensions) | ||
| 57 | * [[extensions:$extension]] | ||
| 58 | #end | ||
| 59 | {{/velocity}} | ||
| 60 | {{/info}} | ||
| 61 | |||
| 62 | For more details on how to configure authentication check the [[Authentication page of the Administration Guide>>Documentation.AdminGuide.Authentication]]. |
