Skip to content

Manage User stores

WSO2 Identity Server allows configuring multiple user stores to your system that are used to store users and their groups. Out of the box, WSO2 Identity Server supports JDBC, LDAP, and Active Directory user stores with the capability of configuring custom user stores. There are different user store adapters called User store managers, which are used to connect with these user store types.

There are two types of user stores - Primary User store (Mandatory) and Secondary user stores (Optional). All the supported user stores can be configured under these two types.


Primary user store (Mandatory)

This is the main user store that is shared in the system. Only one user store should be configured as the primary user store and it is configured in the <IS_HOME>/repository/conf/deployment.toml file. By default, WSO2 Identity Server uses the embedded H2 database as the primary user store. It is recommended to change this default configuration in the production system.

See, Configure the Primary User Store

Secondary user store(s) (Optional)

Any number of secondary user stores can be easily set up for your system. You can use the management console to create secondary user stores or you can create them manually. These will be stored in an xml file with the configurations corresponding to the secondary user store.

See, Configure a Secondary User Store

User store manager

Adapters used to connect with different user stores are called User store Managers. By default, there are user store managers for JDBC, LDAP and Active Directory user stores. If you need to add a new user store implementation, see Write a Custom User store Manager. When you configure the user store, you have to set the user store manager class name.


The permissions attached to roles are always stored in an RDBMS. With the default configurations, permissions are stored in the embedded H2 database. For information on how to set up a RDBMS repository for storing permission, see Configure the Authorization Manager.