Custom Field Authenticator
 | XWiki authenticator based on a configurable field instead of the user identifier |
| Type | JAR |
| Category | |
| Developed by | |
| Active Installs | 3 |
| Rating | |
| License | GNU Lesser General Public License 2.1 |
| Compatibility | Require XWiki 8.4+ |
Table of contents
Description
This authenticator allow to use a custom field ("email" by default) in the login form instead of the user identifier.
Enable the authenticator
Configure the authenticator
In xwiki.properties file:
#-#
#-# The default is:
# authentication.customfield.field=email
#-# Indicate the field on which to validate the user identifier.
#-#
#-# The default is true except for the following fields:
#-#
# authentication.customfield.caseSensitive=true
#-# Indicate if the authenticator should fallback on standard XWiki authenticator if login fail with the custom field.
#-#
#-# The default is:
# authentication.customfield.falllback=true
Troubleshooting
What happen when several users have the same uid ?
If you have several user who already have the same uid before the authenticator is installed then the login with this id might be a bit random depending on the order in the database (which can change for various reasons) and you will get a warning in the application server log explaining it.
Once the authenticator is installed and configured this situation is prevented by a listener which cancel any user profile save with a duplicate uid.
Prerequisites & Installation Instructions
We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).
You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.
Release Notes
v1.2.4
The following translations have been updated with this release:
v1.2.3
The following translations have been updated with this release:
v1.2.2
The following translations have been updated with this release:
v1.2.1
v1.2.0
v1.1.1
v1.1
v1.0.5
v1.0.3
v1.0.1
Dependencies
Dependencies for this extension (org.xwiki.contrib.authentication:authenticator-customfield 1.2.4):
- org.xwiki.platform:xwiki-platform-oldcore 8.4
- org.xwiki.contrib:authservice-backport-api 1.1.1
