This documentation is for WSO2 Identity Server 5.4.0 . View documentation for the latest release.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The WSO2 Identity Server enables users to merge multiple accounts and switch between accounts after logging in to a merged account. It also enables you to connect your federated user credentials with your WSO2 Identity Server account. This topic provides instructions on how to achieve this.

Managing user account associations

You can merge multiple user accounts and switch between them by following one of the two approaches listed below.

Table of Contents
maxLevel43
minLevel43

Using the AdminService

The first approach is to use the AdminService. You can access this admin service using the following URL: 'https://<HOST_NAME>:9443/services/UserAccountAssociationService?wsdl'.

...

  • Create a new user account association
  • Delete an existing user account association
  • Get all associated user accounts of the logged in user
  • Switch between associated user accounts without re-authenticate with the system

Using the dashboard

The WSO2 Identity Server end user dashboard can be used to associate the accounts. The following steps provide information on how to set this up.You can associate a local user account or a federated user account:

Table of Contents
maxLevel4
minLevel4

Managing local user IDs

  1. Go to the dashboard URL: https://localhost:9443/dashboard/
  2. Log in using your username and password.
  3. Click the View details button that corresponds to the Associated User Accounts gadget. 
    Image Modified
  4. You can see all associated accounts of the user that you logged in as. This table includes the user domain, tenant domain and username ID and identity provider of all the associated user accounts of the user.
    Image RemovedImage Added
  5. You can initiate a new user account association by clicking the Add Association button under Associated User Accounts
  6. In Select Local as theAssociate User Account dialog-boxType, and enter the username and password of the user account that you want to connect to.
    Click Associate to associate this user account and the Identity Server authenticates the user account. If  If it is authentic, the WSO2 Identity Server authenticates the user account and saves that user account as an association to the user account of the logged in user.
    Image RemovedImage Added
  7. You can delete this user account association by clicking Remove in the Associated User Accounts list.
  8. You can also switch between associated user accounts without having to re-authenticate the user account with the Identity Server. In the user dashboard UI, the associated user accounts appear under the dropdown list at the top right corner of your screen. You can switch between accounts by selecting the required user account from the dropdown. Note that the session key does not change during this operation.
    Image RemovedImage Added

Managing federated user IDs

You can connect your federated user IDs with your WSO2 Identity Server account from the end user dashboard. To set this up, do the following.

...

  1. Go to the dashboard URL: https://localhost:9443/dashboard/
  2. Log in using your username and password.
  3. Click the View details button that corresponds to the Associated User Accounts gadget. 
    Image Modified
  4. You can see all associated accounts of the user that you logged in as. This table includes user domain, tenant domain and username ID and the identity provider of all associated user accounts of the user.
    Image RemovedImage Added
  5. You can initiate a new user account association by clicking the Add Association button under Federated User IDs Associated Accounts
  6. You must select the identity provider from Select the Federated as the Account Type from the dropdown provided, and enter the federated user ID. username and password.
    Click Associate to connect this federated ID user account to the WSO2 Identity Server account of the logged in user.
    Image RemovedImage Added
  7. You can delete this user account association by clicking Remove in the Federated User IDs list. on the Associated Accounts list.