Gateway & AP – Set-Up Guide
Configuring CradlePoint Version 7

This chapter describes how to configure CradlePoint.
Before proceeding further with the configuration, you need to configure HSNM with a domain and a gateway as described in Adding a New Gateway.

Prerequisites

The prerequisites required for configuration are:

  • HSNM gateway configured with CradlePoint as hardware type
  • If you require a dynamic IP address as mentioned in the Dynamic IP Address chapter, make sure your Cradlepoint firmware is updated to version 7.24.10
  1. Now inside HSNM, select your Gateway, click the dropdown menu, choose Edit.
  2. Expand the General Data session.
  3. In the Hardware Type field, choose CradlePoint.

To get started, you will need to:
a) Make sure to have a proper SSL certificate available.
b) Setup Hotspot Services in NetCloud Manager.

Setting Up an SSL Certificate

Ericsson Cradlepoint has developed a secure method for facilitating transactions between their routers and captive portals using HTTPS. By encrypting these transactions, the submitted information remains secure, enhancing user trust and delivering a positive experience.

An SSL certificate and key must be uploaded to the Ericsson Cradlepoint router, and assigned to be used with HTTPS transactions to encrypt the HTTP transactions passed between a client browser (not the administrator level browser being used to make these changes), the Ericsson Cradlepoint router, and the captive portal. The SSL certificate:

  • Must be signed by a Certificate Authority (CA) that is trusted by the web browser.
  • Must be associated with a domain and a host name. Make a note of these, since these parameters are needed to setup the captive portal.
  • Bundled together with the key into a single file in PKCS #12 format. The filename extension will be either .p12 or .pfx.

IMPORTANT
A valid SSL certificate is required. If you have not set one up yet, see How to Use Custom Certificates with HTTPS.

Setting Up Hotspot Services

Hotspot Services enables businesses to provide their customers a public Wi-Fi hotspot with access controls. On networks that allow open public access, for example in hotel or on a bus, a captive portal page can be displayed with terms and limitations of the Wi-Fi service. Cradlepoint Hotspot Services provide an easy way to set up a captive portal, where clients attempting to access the internet are initially redirected to a different webpage, or are placed in a limited-service “walled garden”. Importantly, Cradlepoint also offers RADIUS/UAM hotspot mode, the mode in which it must be for Secure Captive Portal setup. This mode permits additional enterprise-level configuration via custom or third-party authentication servers.

IMPORTANT
Hotspot Services must be enabled. See Configuring Hotspot Services in RADIUS/UAM Mode.

Setting Up the Secure Captive Portal for Universal Access Method (UAM)

Complete the following steps to set up a secure captive portal for UAM.

Step 1

Log into NetCloud Manager.

Step 2

Select Devices in the left-side navigation panel.

Step 3

Select a router from the Routers page. Alternatively, to make configuration changes to a group navigate to the Groups page and select a group.

Step 4

Select Configuration and then Edit.

Step 5

Navigate to SYSTEM > Administration > Local Management.
a) Enter the domain associated with the SSL certificate in the Local Domain field, and select the matching SSL Certificate from the available list.
b) A best practice is to include the domain in the title of SSL certificate. This makes finding the correct certificate, and entering the correct domain where needed, much easier.

Step 6

Click Save.

Step 7

Navigate to NETWORKING > Local Networks > Local IP Networks.

Step 8

Select the LAN you configured earlier for Hotspot routing.

Step 9

Click Edit.

Step 10

Navigate to the General Settings tab.

Step 11

In the Hostname field, enter the host name associated with the SSL certificate.

This is “cp” by default (as below) and this is what is used in the existing routers used for testing.

Step 12

Click Save.

Step 13

Navigate to NETWORKING > Local Networks > Hotspot Services.

Note: You must have set up Hotspot Services in RADIUS/UAM mode already.

Step 14

Find the Login URL field in the UAM Settings section of the page. The URL should have the form,
https://<captive.portal.url>/start?<parameters>
where:
<captive.portal.url> Is the URL of the captive portal to which users will be
<parameters> Is a list of parameters that are appended to the end of

Step 15

Add the following new parameter string to the end of the <parameters> list:
&proto=https
For example, a complete Login URL statement could be:

Step 16

Click Save.

Step 17

Click Commit Changes. The router is now ready to serve secure captive portal transactions.

Testing to Verify Proper Configuration

When accessing

Complete the following steps to verify the configuration.

Step 1

Connect a client device (for example, a laptop or cellular phone) to the Cradlepoint router using either ethernet or Wi-Fi.

Verify that the client device’s only access to the internet is through its connection to the Ericsson Cradlepoint router.

Step 2

Open a web browser in private viewing mode on the client device. For example, in Chrome open a new Incognito window, or in Edge open a new InPrivate window. Using this type of browser window ensures that the browser answers HTTPS requests by sending them over the web instead of retrieving pages from its cache.

Step 3

Navigate to any web page that is external to the client’s local domain. Verify that:

  • The browser redirects to the captive portal landing page using HTTPS.
  • The captive portal addresses the Ericsson Cradlepoint router using the host name and domain name that were associated with the SSL certificate uploaded.

Step 4

Verify you can authenticate through the captive portal without triggering a pop- up from the browser warning of an insecure connection.

Additional Information

The protocol used for a browser-based login at a captive portal is called the Universal Access Method (UAM). There is currently no specification for the UAM protocol. Because there is no specification, there are slight differences in how UAM is implemented between vendors of captive portal solutions. It may be necessary for Ericsson Enterprise Wireless to work with your captive portal vendor to fully implement their side of the Secure UAM feature.

Upload SSL here: