Creating a new Tenant via WSO2 Identity Server

Creating a new Tenant via WSO2 Identity Server

I will discuss the scenario of how a tenant can be created within the WSO2 Identity Server and how that tenant can then login and create a secondary user store. The first part of the blog will be related to the creation of the tenant.

The  WSO2 Identity Server enables creation and maintenance of user stores for tenants. The User Manager authenticates users from different types of user stores such as LDAP, Active Directory and JDBC to perform authentication. With the Identity Server version 4.5.0 the system enables these user-stores to be maintained within tenants. In this blog post I will show in step by step how a tenant can be created.

This blog post assumes that the pack is configured with a primary user store for which the administrator can login. First, access the login screen by typing the URL as ex: https://localhost:9443/carbon.

 Diagram1.0

At the above screen enter your super administrators user name and password. For this post I will assume that the administrator login is admin/admin. Once logged in, under the configuration menu, click on the option "Add New Tenant" this will direct you to a screen as shown below.

 Diagram2.0

Diagram3.0

To create a new tenant first, we need to specify a unique value for the domain. for this post assume that the domain name is domain1.com. Next, select the useage plan, for this demo let the "demo" plan be selected. Now we need to give the details of the administrator of the tenant. Enter the first and last names of the administrator who will be created for this tenant. For this post I will use shavantha as the first name and Weerasinghe as the last name. Next, we need to specify the user name and passwords, for the user name, I will use admin and for the password I will specify a value that conforms to the password format. As a final step, I will specify an email address that will be used for the tenant. Once these details are entered, click on the "Save" option to create the tenants profile.

Once, a tenant is created, the system will direct the user to a screen that shows the created tenant details. As shown below on Diagram4.0, to edit the tenant details click on the edit screen which will direct the user to a screen as shown on Diagram3.0 above.

Diagram4.0

once the tenant is created, logout as the super admin and login with the tenants credentials .In my next blog, I will show how this created tenant can login and create a user store.