What can we do when we cannot login to WSO2 APIM

Photo by James Sutton on Unsplash

If you have had the change to get your hands on WSO2 products, you may probably came across with concept of user store. User-stores basically stores the users of the systems.

Here I am talking about WSO2 APIM 2.0 and 2.1 in this article. But this could related to other WSO2 products as well.

WSO2 APIM comes with default JDBC user store. Apart from that we can change the user store to LDAP or Active Directory (AD).

You can find more details about configuring user stores for WSO2 APIM in this article.

Suppose you have configured LDAP or AD as a user store. You are adding users and assigning necessary roles for the users through carbon management console so that they can login to relevant web applications (admin, publisher ,store) and work on those web apps.

However, when you trying to login to web applications, you might not be able to login.

This can happen for several reasons.

1. Credentials are incorrect/invalid
2. Users do not have enough permissions to login and work
3. User-store has not configured properly
4. Case-sensitiveness of username

1.Credentials are incorrect/invalid

Well, if you are trying to login using incorrect credentials, then you will get an error in the UI. Obviously you have to overcome it by entering the correct credentials.

2. Users do not have enough permissions to login and work

Only the availability of users is not enough to work with WSO2 products. They need to have proper roles with necessary permissions to work with the products.

Following this document you can get a clearer idea about users and roles management.

If you do not have the necessary privileges, then you will be shown an error in the UI saying that you do not have necessary privileges.

3. User-store has not configured properly

Well..you can try this simply by login to management console using admin credentials. If you fails, then we an assume that there is something wrong with the user store.

4. Case-sensitiveness of username

Well..this is tricky. Suppose you have created a user with mix-case username of uppercase username. But you are trying to login with incorrect case username.

You can avoid this case sensitivity checking by adding the following property to the user-mgt.xml file in <carbon_home>/repository/conf/user-mgt.xml

<Property name="CaseInsensitiveUsername">true</Property>

You have to include this property inside the UserStoreManager you have defined.

Following is an example.

<UserStoreManager class={relevantClass}>
      .....{other properties}........
      <Property name="CaseInsensitiveUsername">true</Property>
</UserStoreManager>

You need to make restart the server after making this change in your server. Then you will be able to login without any issue. :)

******************************************************************

These are the basic cases where you face the issue related to login. Well..hope you got an idea on how to login without an issue now and how to overcome if any issue occurred while login… :)

Enjoy reading…!! Cheers…