Select the Authenticator

Last modified by Eleni Cojocariu on 2026/08/12 16:42

Steps

To choose the authenticator a wiki uses:

  1. Comment out xwiki.authentication.authclass in the xwiki.cfg file and restart the wiki, because a class named there takes precedence over the choice made in the administration.
  2. Go to "Administration" then "Users & Rights" then "Authentication".

    authentication-admin-menu.png

  3. Pick an authenticator in the "Authentication service" list.

    authentication-service-select.png

  4. Click "Save".
  5. Check that "Current Authentication service" now names the authenticator you picked, as follows:

    authentication-service-section.png

FAQ

Why is there only one authenticator to choose from?

The list holds the authenticators implemented as Components, and reports "No alternative authentication service can be found." while the standard one is alone. An authenticator set through xwiki.authentication.authclass never appears there.

Can each subwiki use a different authenticator?

Yes, the setting belongs to the wiki, so a subwiki keeps its own choice as long as no authenticator is forced globally in xwiki.cfg. This is validated on domain-based subwikis; on path-based subwikis it is not fully verified.

Related

Get Connected