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’])