How to configure the portal function on Omada Controller?

Released On: 2018-07-20 09:18:01Last update time: 2020-04-07 06:15:49

Suitable for: Omada Controller 2.5.1 or above and EAP products with corresponding firmware.

Portal authentication is a kind of access authentication method, which is also known as web authentication. With portal function configured on Omada Controller, when a wireless client connects to an EAP managed by Omada Controller and tries to access the internet, it will be directed to a pre-set web page which requires additional authentication information. Only the wireless client which has the right authentication information can pass the web authentication to access the internet.

Portal authentication is suitable for managing wireless access in public places such as hotels, malls, airports and so on. It provides a flexible method to control the connections to the network and vivid customized authentication portal page for business promotion.

This following gives some instructions on how to configure the portal function on Omada Controller.

Step 1 Run Omada Controller

Start Omada Controller software and login to the management page. For how to install and login to Omada Controller, please go to the Download page of Omada Software Controller and refer to Chapter 1 of the User Guide.

Step 2 Choose Appropriate Portal Authentication Type

  1. Go to Wireless Control > Portal and click to create a new portal. Specify a name and select the SSIDs for the Portal.

  1. Choose one of the eight authentication methods. These authentication methods are available: No Authentication, Simple Password, Local User, Voucher, SMS, Facebook, External RADIUS Server and External Portal Server.


  • With No Authentication configured, all wireless clients connected to EAP devices will have access to internet without any authentication. But clients will still see the pre-set login page.

  • With Simple Password configured, all wireless clients will use this single password for authentication.

  • With Local User configured, clients are required to enter the correct username and password of the login account to pass the authentication. You can create multiple accounts and assign different accounts for different users on User Management.


  • With Voucher configured, you can distribute the vouchers automatically generated by the Omada Controller to the clients. Clients can use the vouchers to access the network. Voucher is configured on Voucher Manager. Voucher authentication requires your controller to stay running. Refer to How to Configure Voucher Authentication on Omada Controller? for detailed configurations of Voucher.

  • With SMS configured, clients can get verification codes using their mobile phones via text message and enter the received codes to pass the authentication. For more details about how to configure SMS Portal, you can go to Download Center and download the configuration guide for SMS Portal.

  • With Facebook configured, when clients connect to your Wi-Fi, they will be redirected to your Facebook page. To access the internet, clients need to pass the authentication on the Facebook page. For more details about how to configure Facebook Portal, go to Configuration Guide and refer to the configuration guide for Facebook Portal.

  • If you have a RADIUS server, you can configure External RADIUS Server. With this type of portal, you can get two types of portal customization: Local Web Portal and External Web Portal. The authentication login page of Local Web Portal is provided by the built-in portal server of the EAP. The External Web Portal is provided by external portal server. As different username/password can be added on the radius server, users can use their unique username for authentication.


  1. You can set the time that the wireless clients can stay online after passing the authentication. For No Authentication, Simple Password, SMS and External RADIUS Server, you can configure the expiration time on Authentication Timeout in the Basic Info section. For Voucher and Local User, you can set the expiration time when creating the vouchers and users. For Facebook, you can set the expiration time on the Facebook page.
  2. If you want to redirect the wireless client’s page to a predefined web page after authentication (such as TL-Link’s official website), you can enable Redirect and specify Redirect URL as

Step 3 Customize the Portal Page

After completing the basic settings for the portal authentication in the Basic Info section, you can customize the login page in the Login Page section. You can set the background, logo, copyright and Terms of service for the login page depending on your needs.

And you can select whether display advertisement pictures for users and configure the related parameters in the Advertisement section.


  1. The maximum image size of the background and logo picture is 2MB. The supported formats are .jpg, .bmp, .gif, .png, .jpeg.
  2. Remember to click the after completing all the portal configurations.
  3. Please keep the controller running when you use portal authentication.