Versions Compared

Key

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

...

To configure multiple user stores via the UI:

  1. Log in to the WSO2 Identity Server.
  2. In the Configure menu, click User Store Management under Configure.
  3. The default view is as follows, when there are no multiple user stores defined. 

    Info

    You cannot update the 'PRIMARY' user store at run time, so it is not visible in this view.

     

  4. Click Add Secondary User Store. The following form appears, where you can define a secondary user store:.
  5. First select the required implementation of user store manager from the drop-down menu. By default, all the Carbon products come with four user store manager implementations.
    • ReadWriteLDAPUserStoreManager
    • ReadOnlyLDAPUserStoreManager
    • ActiveDirectoryUserStoreManager
    • JDBCUserStoreManager
    You can also add custom user store manager implementations to the server. A sample custom user store manager can be found in the repository. Once it is added to the server it also appears in this drop-down menu.
  6. Once you select the preferred user store manager implementation, look through and fill the list of properties that can be specified. As shown in the following image, it also provides a description of each property.
  7. Provide a unique domain name and fill all the mandatory fields with the values corresponding to the user store. 

    Info

    Domain name should not include the '_' (underscore) character.

  8. Click Add. A notification appears indicating that the user store is in the process of being added to the end of the chain of user stores.
  9. Refresh the page to see the new user store in the table, if it is successfully added.

Now we have a newly defined secondary user store in action. You can also edit the properties of the defined secondary user stores and enable/disable them in a dynamic manner.

When Configuring multiple user stores manually:

By default, the configuration of the primary user store is saved in the user-mgt.xml file. When you create a secondary user store, its configuration is saved to an XML file with the same name as the domain you specified. If desired, you can create this XML file manually and save it as follows:

  • If it is configuration of a super tenant, the secondary user store definitions should go to '<CARBON_HOME>/repository/deployment/server/userstores'.
  • If it is a general tenant, the configuration should go to '<CARBON_HOME>/repository/tenants/<tenantid>/userstores'.
  • The file should have the same name as the domain with an underscore (_) in place of the period. For example, if the domain is wso2.com, name the file as follows: wso2_com.xml
  • One file only contains the definition for one user store domain.

...