Grandstream Captive Portal User Manual

Grandstream Networks, Inc.

Captive Portal Authentication via Facebook

Table of Content
SUPPORTED DEVICES ................................................................................................	4
INTRODUCTION............................................................................................................	5
CAPTIVE PORTAL SETTINGS .....................................................................................	6
Policy Configuration Page................................................................................................................	7
Landing Page Redirection.......................................................................................................	10
Pre-Authentication Rules ........................................................................................................	10
Post-Authentication Rules.......................................................................................................	10
Guest Page ...................................................................................................................................	11
CONFIGURATION STEPS...........................................................................................	12
Create Facebook App ....................................................................................................................	12
Configure Captive Portal Policy with Facebook Authentication .......................................................	17
Using GWN Master GUI (Standalone mode) ...........................................................................	17
Using GWN Management Platform .........................................................................................	20
Wi-Fi Client..................................................................................................................	23
Facebook analytics ....................................................................................................	25

P a g e | 2

Captive Portal

Authentication via Facebook

Table of Figures
Figure 1: General Architecture ...............................................................................................................	5
Figure 2: Captive Portal GWN76XX web GUI menu ...............................................................................	6
Figure 3: GWN76XX Web GUI Policy Page Configuration ......................................................................	7
Figure 4: GWN76XX Guest Web Page..................................................................................................	11
Figure 5: Create new APP ...................................................................................................................	12
Figure 6: App options...........................................................................................................................	12
Figure 7: Create an App ID ..................................................................................................................	13
Figure 8: Security check ......................................................................................................................	13
Figure 10: Add “Facebook login” product to your App ...........................................................................	14
Figure 11: Facebook Login - Settings...................................................................................................	14
Figure 12: Facebook Login Settings - Valid OAuth redirect URIs ..........................................................	15
Figure 13: Facebook Developers Parameters - General.......................................................................	15
Figure 14: Make Facebook App Public.................................................................................................	16
Figure 15: Switch Mode to LIVE...........................................................................................................	16
Figure 16:Facebook Login App - Live...................................................................................................	16
Figure 17: GWN Master - Captive Portal Policy Sample Configuration .................................................	17
Figure 18: GWN Master – Pre Authentication Rules for Facebook Authentication .................................	18
Figure 19: GWN Master - Enable Captive Portal on Wi-Fi Settings.......................................................	19
Figure 20: GWN Platform - Splash Page Configuration ........................................................................	20
Figure 21: GWN Platform - Captive Portal Policy Sample Configuration ...............................................	21
Figure 22: GWN Platform - Enable Captive Portal on Wi-Fi Settings.....................................................	22
Figure 23: Connect to the SSID ...........................................................................................................	23
Figure 24: Login with Facebook ...........................................................................................................	23
Figure 25: Facebook Login page..........................................................................................................	24
Figure 26: Authentication succeed .......................................................................................................	24
Figure 27: Facebook Tools...................................................................................................................	25
Figure 28: Facebook Analytics .............................................................................................................	25
Table of Tables
Table 1: Supported Devices ...................................................................................................................	4
Table 2: GWN76XX Policy Configuration Page.......................................................................................	8

P a g e | 3

Captive Portal

Authentication via Facebook

SUPPORTED DEVICES

Following table shows Grandstream devices supporting Captive Portal with Facebook Authentication

feature:

Table 1: Supported Devices

	Model			Supported			Firmware
	GWN7610			Yes			1.0.5.14 or higher
	GWN7615			Yes			1.0.15.18 or higher
	GWN7605			Yes			1.0.15.18 or higher
	GWN7605LR			Yes			1.0.15.18 or higher
	GWN7600			Yes			1.0.3.19 or higher
	GWN7600LR			Yes			1.0.4.12 or higher
	GWN7630			Yes			1.0.9.12 or higher
	GWN7630LR			Yes			1.0.15.18 or higher
	GWN7000			Yes			1.0.4.23 or higher

P a g e | 4

Captive Portal

Authentication via Facebook

INTRODUCTION

Captive Portal feature on GWN76XX Access Points allows to define a Landing Page (Web page) that will be displayed on Wi-Fi clients’ browsers when attempting to access Internet.

Once connected to GWN76XX AP, Wi-Fi clients will be forced to view and interact with that landing page before Internet access is granted.

Captive portal can be used in different environments including airports, hotels, coffee shops, business centers and others offering free Wi-Fi hotspots for Internet users.

This guide describes how to setup the captive portal feature on the GWN76XX series using Facebook Authentication.

The following figure illustrates an example of the landing page feature using Facebook authentication.

Figure 1: General Architecture

P a g e | 5

Captive Portal

Authentication via Facebook

CAPTIVE PORTAL SETTINGS

The Captive Portal feature can be configured from the GWN76XX web page, by navigating to “Captive Portal” section.

This section contains four subsections: Guest, Policy List, Splash Page and Vouchers.

Guest: This section lists the authenticated clients MAC addresses.

Policy List : In this section, users can configure multiple portal policies which then can be

assigned to specifc SSIDs under the menu “SSIDs”. (For example having non-authentication

based portal for temporary guests and setting up an authentication based portal policy for the

internal staff).

Splash Page: Under this tab, users could download and upload customized portal landing page

to display to the users when they try to connect over the Wi-Fi.

Figure 2: Captive Portal GWN76XX web GUI menu

P a g e | 6

Captive Portal

Authentication via Facebook

Policy Configuration Page

The Policy configuration allows users to configure and customize different captive portal policies which then can be selected on SSID configuration page, giving the admin the ability to set different captive portals for each SSID, in this guide, we will be using Internal Splash Page for Facebook Authentication.

Figure 3: GWN76XX Web GUI Policy Page Configuration

P a g e | 7

Captive Portal

Authentication via Facebook

The following table describes all the settings on this page:

			Table 2: GWN76XX Policy Configuration Page
		Field				Description
		Name				Enter a name to identify the created policy (ex: Guest Portal).
		Splash Page				Select Splash Page type, Internal or External.
						Following types of authentication are available:
						Login for free: when choosing this option, the landing page
						feature will not provide any type of authentication, instead it
						will prompt users to accept the license agreement to gain
						access to internet.
						RADIUS Server: Choosing this option will allow users to set a
						RADIUS server to authenticate connecting clients.
		Authentication Type				Social Login Authentication: Choosing this option will allow
						users to enable authentication Facebook or Twitter or
						WeChat.
						Vouchers: Choose this page when using authentication via
						Vouchers.
						Login with Password: Choose this page when using
						authentication via a password.
		Expiration				Configures the period of validity, after the valid period, the client
						will be re-authenticated again.
		Facebook Authentication				Check this box to enable Facebook Authentication.
		Facebook App ID				Enter the app ID to use Facebook Login API.
		Facebook App Secret				Enter the app secret to use Facebook Login API.
		Use Default Portal Page				When enabled, the default portal page will be used, otherwise
						users can upload their custom page.
						Captive Portal	P a g e | 8
						Authentication via Facebook