Allowing RSpace user to login with specific username alias, rather than username

Username Alias feature was added in RSpace 1.99 (June 2024). The feature is not supported in LDAP login flow.

When logging into RSpace account the user needs to provide username and password, or in case of SSO integration RSpace picks up SSO username provided by the Identity Provider.

Occasionally it is needed to allow login with a specific username that doesn't match RSpace username. This can happen e.g. after migration to a different SSO setup, when SSO usernames are changed, but the users expect to continue working with their existing RSpace accounts.

For such scenario RSpace Sysadmin can assign each individual user a special 'Username Alias'. Username Aliases are considered an alternative to username during login process, i.e. if during login process the incoming username is not matched with RSpace username, but it is matched with RSpace Username Alias, the user is logged into account of the user with given alias.

Assigning Username Alias to the user

On System->Users page, select the user, and click on 'Actions' -> 'Set Username Alias'. Put the alias, and confirm.

To see the assigned aliases in the System->Users listing, click on 'Columns' and enable 'Username Alias' column.

RSpace enforces Username Aliases to be unique and to not conflict with existing usernames.

Removing username alias for the user

To remove, just set the Username Alias to an empty value.

How did we do?

Powered by HelpDocs (opens in a new tab)