Configuring Secondary User Stores

WSO2 Storage Server's default configuration has a single user store. If required, it can be configured to connect to multiple user stores as well, so that users in any of the configured user stores are able to login and perform operations depending on their roles/permissions. This section explains how to set up multiple user stores in WSO2 Storage Server.

To configure multiple user stores via the UI:

1. Log in to the WSO2 Storage 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. 

   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. 

   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.

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.