LogoLogo
  • EnGenius Cloud Technology
  • EnGenius Cloud Services DataCenters
  • LLDP-MED
  • Presence Service
  • Captive Portal
    • Integrate with External Splash Page
      • Click-through
      • Sign-on Splash
      • Error Message
  • Zero-wait DFS
  • Security Access Points
    • Wireless Network Security Issues
    • Denial of Service and EnGenius Solution
    • Data Breach, Passcode Cracking, and the EnGenius Solution
    • EnGenius Solution and Benefits
  • AirGuard
    • Rogue AP
    • Rules and Classifications
    • Evil Twin
    • Malicious Attacks
    • RF Jamming
  • Fast Handover RSSI Thresholds
  • Authentication with Google Secure LDAP Server
    • Configure Google LDAP Authentication for Wireless Networks Access
    • Appendix
    • Troubleshooting
  • Authentication with Microsoft Active Directory (AD) Server for Wireless Users
    • Configure Active Directory Authentication for Wireless Network Access (SSID)
    • Behavior to Authenticate Users with Microsoft AD Server
    • Appendix
    • Troubleshooting
  • Configure SAML SSO with ADFS
  • Authentication with Microsoft Entra ID LDAP Server
Powered by GitBook
On this page
  • Overview
  • Communication Flow
  • Parameters
  • Enabling an External Splash Page on EnGeniusCloud
  • Configure the External Splash Page Server

Was this helpful?

Export as PDF
  1. Captive Portal
  2. Integrate with External Splash Page

Click-through

Last updated 4 years ago

Was this helpful?

When captive portal is enabled and authentication type is set to "Click-through", the user is redirected to a splash page and clicks on a link to be granted access to the Internet.

Overview

Communication Flow

Following figure shows the communication flows and steps for a Click-through captive portal with external splash page server.

  1. A new wireless client tries to connect to a Captive Portal enabled SSID served by an Access Point.

  2. The AP intercepts the request and redirect the user to the external splash page which is served by a external web server configured in SSID's splash page setting. In addition, an actionurl parameter is passed to the splash page such that browser can be redirected back to the cloud after submission in splash page.

  3. Splash page content with actionurl parameter are delivered to browser.

  4. User clicks on the confirmation link or submit button in the splash page and then be redirected to actionurl to complete the authentication.

Parameters

In previous Section Step 2, the actionurl parameter is composed of a cloud URL with extra parameters. A https request sample to the splash page could be like this:

https://yourwebsite.com/splash.html?actionurl=https://falcon.service.engenius.ai/captive-portal/auth%3Fuserurl=https://www.google.com/%26loginurl=http://192.168.200.1:4990/www/login.chi%26mac=0C:D2:92:42:0C:57%26called=8A:DC:96:21:FF:E5

The https://yourwebsite.com/splash.html here is the splash page setting customized for corresponding SSID. The details of the actionurl parameters are listed as follows:

Parameter Name

Description

vendor

Should be "EnGenius"

ap_ip

IP address of associated AP

ap_mac

MAC address of associated AP

ap_port

AP service port

client_ip

IP address of the wireless client

client_mac

MAC address of the wireless client

userurl

The URL that user tried to visit before authenticated

mac

Client's MAC address (will be obsolete after 2021)

please use client_mac

called

AP's MAC address (will be obsolete after 2021)

please use ap_mac

nas_id

Network access server identifier is used to notify the source of a RADIUS access request.

Enabling an External Splash Page on EnGeniusCloud

  1. Select a network in Org-tree.

  2. Select SSID in the configuring tool menu.

  3. Choose the SSID you want to configure.

  4. switch to Captive Portal Tab and make sure your Captive Portal is enabled and Authentication Type is set to "Click-through".

  5. switch to Splash Page Tab. Select "External Splash Page URL".

  6. Enter the URL of your custom splash page (eg, https://yourwebsite.com/splash.html).

  7. Click on "Apply" button.

Configure the External Splash Page Server

The external splash page must be hosted on a web server that will be accessible from the Access Points on your network. The following must be accomplished, but the particular details will depend very much on your web hosting environment.

  1. Setup the Web Server.

  2. Modify the splash page to set form action as the value of actionurl passed by cloud. In this way, after the user submit the form, he will be redirected to specific URL and complete the authentication.

  3. Another way to implement the splash page is to have a hyperlink redirect the browser to actionurl. For Example:

    <a href="<?php print $_GET['actionurl'] ?>">For all in one url</a>