This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Customizing the Admin Portal Domain

Owned by Former user (Deleted)
Last updated: Jul 11, 2019
2 min read

The steps to customize the API Admin domain is similar to how you customize the API Store domain and API Publisher domain. 

Follow the steps below to customize the API Admin domain:

  1. Sign in to WSO2 API Cloud (https://api.cloud.wso2.com) as an admin user.

  2. On the API Publisher, click Configure and then select Custom URL from the drop-down menu. 


    This displays the Manage Custom Domains page.

  3. Under API Portal, click the pencil icon to edit the existing Custom Domain of the Admin portal. 

    This displays the Modify Admin Custom Domain dialog box where you can specify a custom Domain Name for the Admin portal. 

  4. Specify a valid Domain Name and click Verify. This checks whether the CNAME record exists for the specified URL.

    If the CNAME verification is successful, you will see the following dialog box:

  5.  For each field, upload a valid file that satisfies the specified requirements.

    FieldRequirements
    SSL CertificateThis certificate file must satisfy the following requirements:

    • Should be in X509 format.

    • Should not be expired.

    • Should be issued directly or by a wild card entry for a provided custom URL. For example,

      • In the direct method, if the CNAME is adminportal.wso2.com, the issued SSL file must contain adminportal.wso2.com.

      • In the wildcard method, if the CNAME is adminportal.wso2.com, the issued SSL file should be *.wso2.com.

    SSL Key File The private key of the certificate, which should be encrypted in the RSA format.
    Chain FileThe chain file to be used if the SSL connection to your custom URL fails with the SSL Certificate and SSL Key File.

  6. Click Proceed. If the certificate files upload successfully, you will see a notification similar to the following:

    This confirms that you have successfully changed the Admin portal domain name.

    It takes approximately 10 minutes for the changes to apply. Adding the configurations and restarting the load balancers can take some time.

  7. Access the Admin portal using the new domain. In this example, the new Admin portal domain is https://admin2.wso2stagingapps.com.