Configure the System Administrator¶
This documentation explains the main settings relevant to the system administrator.
The admin user is the super tenant that will be able to manage all other users, roles, and permissions in the system by using the management console of the product. Therefore, the user that should have admin permissions is required to be stored in the primary userstore when you start the system for the first time. The documentation on setting up primary userstores will explain how to configure the administrator while configuring the userstore. The information under this topic will explain the main configurations that are relevant to setting up the system administrator.
If the primary userstore is read-only, you will be using a user ID and role that already exists in the userstore, for the administrator. If the userstore is read/write, you have the option of creating the administrator user in the userstore as explained below. By default, the embedded H2 database (with read/write enabled) is used for both these purposes in WSO2 products.
Note the following key facts about the system administrator in your system.
- The admin user and role are always stored in the primary userstore in your system.
- An administrator is configured for your system by default. This admin user is assigned to the admin role, which has all permissions enabled.
- The permissions assigned to the default admin role cannot be modified.
Before you begin¶
Ensure that you have a primary userstore (for storing users and roles) and an RDBMS (for storing information related to permissions). See the related documentation for instructions on how to set up these repositories.
Update the administrator¶
<IS_HOME>/repository/conf/deployment.toml file allows you to configure the administrator user in your system as well as
the RDBMS that will be used for storing information related to user
authentication (i.e. role-based permissions).
[super_admin] create_admin_account= true admin_role = "admin" username = "admin" password = "admin" create_admin_account= true
Note the following regarding the configuration above.
||This is the role that has all administrative privileges of the WSO2 product, so all users having this role are admins of the product. You can provide any meaningful name for this role. This role is created in the internal H2 database when the product starts. This role has permission to carry out any actions related to the Management Console. If the userstore is read-only, this role is added to the system as a special internal role where users are from an external userstore.|
||This is the username of the default administrator or super tenant of the userstore. If the userstore is read-only, the admin user MUST exist in the userstore for the process to work.|
Do NOT put the password here but leave the default value. If the userstore is read-only, this element and its value are ignored. This password is used only if the userstore is read-write and the
Note that the password in the