Realm Configuration

The main configuration section of the <CARBON_HOME>/repository/conf/user-mgt.xml file 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>

If you change the super admin username/password in the user-mgt.xml file, you should change it in the <MB_HOME>/repository/conf/advanced/qpid-virtualhosts.xml file as well. The user you define in the qpid-virtualhosts.xml file does not have to match the user defined in the user-mgt.xml file, and does not need any special permissions.

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.