This documentation is for WSO2 API Manager 2.0.0. View documentation for the latest release.

Versions Compared


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


  1. Log in to the management console and click User Store Managementclick list in  User Stores sub menu under Configure menu.
  2. The User Store Management page opens. Initially, there are no secondary user stores.


    Note: You cannot update the PRIMARY user store at run time, so it is not visible on this page.

  3. Click Add Secondary under User Stores to add a  Secondary User Store.

  4. In the User Store Manager Class list, select the type of user store you are creating:

    User store managerDescription

    Use ReadOnlyLDAPUserStoreManager to do read-only operations for LDAP user stores.


    Use ReadWriteLDAPUserStoreManager for LDAP user stores to do both read and write operations.


    Use ActiveDirectoryUserStoreManager to configure an Active Directory Domain Service (AD DS) or Active Directory Lightweight Directory Service (AD LDS). This can be used only for read/write operations. If you need to use AD as read-only, you must use org.wso2.carbon.user.core.ldap.ReadOnlyLDAPUserStoreManager.


    Use JDBCUserStoreManager for JDBC user stores. The JDBC user store can be configured for read-only mode or read/write mode using the following property: <Property name="ReadOnly">false/true</Property>. 

    You can also populate this drop-down list with custom user store manager implementations by adding them to the server. A sample custom user store manager can be found in the repository.

  5. Enter a unique domain name with no underscore (_) characters, and optionally enter a description for this user store.

  6. Enter values for the properties, using the descriptions in the Descriptions column for guidance. The properties that appear vary based on the user store manager class you selected, and there may be additional properties in an Optional or Advanced section at the bottom of the screen. See the related topics for descriptions of user store properties.

  7. Ensure that all the mandatory fields are filled and a valid domain name is given and click Add

  8. A message appears saying that the user stores are being added. 


    Note: The above message does not imply that the user store is added successfully. It simply means that the server is attempting to add the new user store to the end of the available chain of stores.

  9. Refresh the page after a few seconds to check the status. 

  10. If the new user store is successfully added, it will appear in the User Store Management page.

  11. After adding to the server, you can edit the properties of the new secondary user store and enable/disable it in a dynamic manner.