This documentation is for WSO2 API Manager 2.1.0. View documentation for the latest release.

All docs This doc
Skip to end of metadata
Go to start of metadata

This section covers the following topics: 

Changing the super admin credentials

Follow the instructions below to change the super admin credentials: 

  1. Change the user credentials in the following files.

    • The <UserName> and <Password> values in the <APIM_HOME>/repository/conf/user-mgt.xml file.


      Note that the password in the user-mgt.xml file is written to the primary user store when the server starts for the first time. Thereafter, the password will be validated from the primary user store and not from the user-mgt.xml file. If you have started the server already, to change the admin password in the userstore do the following:

      1. Modify admin password in the user-mgt.xml file

      2. Configure the password through the management console.

      3. Edit the files following all the steps given below.

      To change the password from Management Console (https://localhost:9443/carbon), follow the steps in Changing a Password.

    • The  <APIM_HOME>/repository/conf/ file.

      connectionfactory.TopicConnectionFactory = amqp://admin:[email protected]/carbon?brokerlist='tcp://localhost:5672'
      connectionfactory.QueueConnectionFactory = amqp://admin:[email protected]/test?brokerlist='tcp://localhost:5672'

      If you have configured API Manager Analytics,
       change the credentials in the following files when changing the super admin credentials as shown below.

      • <APIM_HOME>/repository/conf/api-manager.xml 

                <!-- Enable Analytics for API Manager -->
                <!-- Administrator username to login to the remote DAS server. -->
                <!-- Administrator password to login to the remote DAS server. -->
      • <APIM_HOME>/repository/conf/ 


Do you have any special characters in passwords?

  • If you specify passwords inside XML files, take care when giving special characters in the user names and passwords. According to XML specification (, some special characters can disrupt the configuration. For example, the ampersand character (&) must not appear in the literal form in XML files. It can cause a Java Null Pointer exception. You must wrap it with CDATA ( as shown below or remove the character:

        <![CDATA[[email protected]?qZ%Jv855&A4a,%M8B]]>
  • Note the following if you have special characters in the passwords on your file:

    • It is not possible to use the @ symbol in the username or password.
    • It is also not possible to use the percentage (%) sign in the password. When building the connection URL, the URL is parsed. This parsing exception happens because the percentage (%) sign acts as the escape character in URL parsing. If using the percentage (%) sign in the connection string is required, use the respective encoding character for the percentage (%) sign in the connection string. For example, if you need to pass adm%in as the password, then the % symbol should be encoded with its respective URL encoding character. Therefore, you have to send it as adm%25in.

      For a list of possible URL parsing patterns, see URL encoding reference.

Recovering a password

See How can I recover the admin password used to log in to the management console?

Login in via multiple user attributes in API Store

See Authentication using multiple Attributes in the WSO2 IS documentation.

Setting up an e-mail login

See Email Authentication in the WSO2 IS documentation.

  • When setting up email login, specify the complete username with tenant domain. If you are in the super tenant mode the username should be as follows. <username>@<email>@carbon.super
    Example:[email protected]@carbon.super.
  • When configuring the <DataPublisher> section under <ThrottlingConfiguration> in the <PRODUCT_HOME>/repository/conf/api-manager.xml file, specify the fully qualified username with tenant domain.
    Example : <Username>[email protected]</Username>
  • The "@" character is a reserved character in the WSO2 messaging component. Therefore, when specifing username in JMS Connection URL, under <JMSConnectionParameters> section in the <PRODUCT_HOME>/repository/conf/api-manager.xml file, "@" characters should be replaced by "!" character. An example is shown below.

    <connectionfactory.TopicConnectionFactory><![CDATA[amqp://admin!!carbon.super:[email protected]/carbon?failover='roundrobin'&cyclecount='2'&brokerlist='tcp://'5'&connectdelay='50';tcp://'5'&connectdelay='50'']]></connectionfactory.TopicConnectionFactory>

Setting up a social media login

You can auto-provision users based on a social network login by integrating the API Manager with WSO2 Identity Server. Refer Log in to the API Store using Social Media for more information.

Note that auto-provision users based on a social network login is not supported in a multi-tenant environment

In a multi-tenant environment, the system cannot identify the tenant domain in the login request that comes to the API Manager's Publisher/Store. Therefore, the service provider is registered as a SaaS application within the super tenant's space. Configuring user provisioning is part of creating the service provider. In order to authenticate the user through a third party identity provider such as a social network login, you must enable identity federation. As the service provider is created in the super tenant's space, the provisioned user is also created within the super tenant's space. As a result, it is not possible to provision the user in the tenant's space. 

To overcome this limitation, you can write a custom authenticator to retrieve the tenant domain of the user and write a custom login page where the user can enter the tenant domain, which is then added to the authenticator context. Then, write a custom provisioning handler to provision the user in the tenant domain that is maintained in the context. 

  • No labels