This document will explain how to use ezMaster external captive portal API to configure an
external hosted splash page. This includes an overview of the two captive portal sign-on
methods: “Splash & Go”, where the user is redirected to the splash page and needs to click
on a link to be granted access to the Internet, and “ezMaster Authentication/RADIUS
Server”, where the user is redirected to a splash page and must either enter a username
and password before being granted access to the Internet.

A. Splash and go with external web page

Architecture

Parameter

When a guest connects to a Captive Portal enabled SSID and browses a http/https web page
(ie. http://www.google.com), the AP will intercept this request and redirect the user to the
custom URL you specified. The External Captive Portal Web Server will redirect the user to a
URL similar to the following string:

​
http://xxxxx/splash.php specifies the external web page setting in ezMaster’s Captive Portal
profiles. Users will be directed to this URL with extra parameters appended to the URL.

Sample code of external web page sample

During the process of redirecting, the system combines the query and assembles a new URL.
Make sure to obtain the “actionurl” value, and fill in href for the URL.

e.g.
When user clicks on the “Click to Proceed” button, the system will proceed with the related
authentication procedures.

B. RADIUS Server with external web page

Architecture

Parameter

When a guest connects to a Captive Portal enabled SSID and browses a http/https web page
(ie. http://www.google.com), the AP will intercept this request and redirect the user to the
custom URL you specified. The External Captive Portal Web Server will redirect the user to a
URL similar to the following string:

http://xxxxx/login.php specifies the external web page setting in ezMaster’s Captive Portal
profiles. Users will be directed to this URL with extra parameters appended to the URL.

Sample code of external web page

If the splash page uses a form to grant access, the “username”, “password”, “userurl” and
correct action URL is requited. In the event of redirecting, the system assembles a new URL
with extra parameters. Use “actionurl” value (e.g($_GET[‘actionurl’]), and fill in the action
URL. Besides “username” and “password”, the form also need to consist of “userurl”, of
which value sets are fetched from the value “userurl” e.g($_GET[‘userurl’])