Versions Compared

Key

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

WSO2 Storage  Server now supports dynamic configuration of multiple user stores. This also allows users to configure their own user stores, out-of-the-box. WSO2 Storage ServerServer'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 setup set up multiple user stores in WSO2 Storage Server Server.

To configure multiple user stores via the UI:

  1. Login 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. 

    Info

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

     

  4. When you click the 'Click Add Secondary User Store' link, a form is provided to define the user stores. 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
    Additionally, if you want other You can also add custom user store manager implementations to be available, it is also possiblethe 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. After selecting Once you select the preferred user store manager implementation, it displays a look through and fill the list of properties to that can be filled. It specified. As shown in the following image, it also provides a description of what each property stands for.Image Removed
  7. Give 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.
  9. If all the mandatory parameters are filled and a valid domain name is provided, the following notification displays. At this moment, WSO2 Storage Server is attempting to add the new user store to the available chain of user stores.
    Image Removed
  10. This is added to the very A notification appears indicating that the user store is in the process of being added to the end of the chain of user stores.  InfoAlso note that this message does not imply that user store is added successfully. This can be checked in the following step.
    Image Added
  11. Refresh the page to see the new user store in the table, if it is successfully added.
    Image Modified

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.It is also

possible to just create Configuring multiple user stores manually:

By default, the configuration of the primary user store is saved in the user-mgt.xml manually and just drop it to the relevant configuration folder. 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
  • HOME>/repository/deployment/server/userstores'.
  • If it is a general tenant, the configuration should go to '<CARBON_
  • HOME
  • HOME>/repository/tenants/<tenantid>/userstores'.
  • Also the file name needs to be in accordance with the domain name to avoid conflicts (e.g.: if domain name
  • 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,
  • the file
  • name
  • of
  • the
  • configuration file should be 
  • file as follows: wso2_com.xml
  • ).
  • One file only contains the definition for one user store domain.