This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Realm Configuration

<CARBON_HOME>/repository/conf/user-mgt.xml file's main configuration section has the following information:

<Configuration>
   <AdminRole>admin</AdminRole>
   <AdminUser>
       <UserName>admin</UserName>
       <Password>admin</Password>
   </AdminUser>
   <EveryOneRoleName>everyone</EveryOneRoleName> <!-- By default users in this role sees the registry root -->
   <Property name="dataSource">jdbc/WSO2CarbonDB</Property>
   <Property name="MultiTenantRealmConfigBuilder">org.wso2.carbon.user.core.config.multitenancy.SimpleRealmConfigBuilder
   </Property>
</Configuration>

The main elements of the Realm Configuration are as follows.

Element Name

Description

<AdminRole>

Admin's role name.
This role has permission to carry out any action related to the Management Console. If the user store is read-only, then this role is added to the system as a special internal role where users are from an external user store.

<AdminUser>\<UserName>

Admin user's username. 
If the user store is read-only, the admin user must exist in the user store. Otherwise the system won't start.

<AdminUser>\<Password>

Admin user's password. 
If the user store is read-only, this element and its value are ignored.

<EveryOneRoleName>

Everyone role name.
All users in the system belong to this role.

The main properties of the user Realm Configuration can be explained as follows. It mainly contains details for the database connection.

Property Name

Description

dataSource
Data sources are configured in the <PRODUCT_HOME>/repository/conf/datasources/master-datasources.xml file. This property indicates the relevant data source configuration for the User Management Database.
MultiTenantRealmConfigBuilder
Tenant Manager specific realm config parameter. Can be used to build different types of realms for the tenant.