oosVersion 2.1

Portal Mode with RADIUS

Portal mode with Radius

Captive Portal requires users to enter a username and password on a web page after joining Wi-Fi, before gaining network access. This page offers two authentication sources: a RADIUS server or OOS Controller. Follow the one used in your environment.

Before You Begin

  • Be able to manage the OOS Wi-Fi AP (access point) and target SSID. SSID is the network name users see when searching for Wi-Fi.
  • For RADIUS, set up the server first and prepare its Hostname, Port, Pre-Shared Key, and a test user account. RADIUS centrally checks user login details. The Pre-Shared Key here is shared between OOS and the server.
  • For OOS Controller, prepare the management login and confirm that the OOS device appears in the Controller Inventory.
  • Choose the Portal redirection URL to open after authentication and the Timeout after which users must authenticate again.

!NOTE When the timeout expires, Internet access is interrupted until the user authenticates again. Changing authentication on an active SSID may also affect connections. Check how you will retain management access to OOS first.

Option 1: Use a RADIUS Server

1. Register the Authentication Server

  1. Go to Security > Authentication > AAA Server, where OOS stores authentication service details.
  2. Click Add, enter a name, and select Radius as the type.
  3. Enter the server's actual Hostname, Port, and Pre-Shared Key, then click Apply.

RADIUS server configuration page

2. Create the Portal Authentication Profile

  1. Go to Networking > Wi-Fi and click Setting.
  2. Open Authentication, click Add, and enter a name.
  3. Following this example, select Portal mode and WPA-2 version, then choose the RADIUS AAA server you registered.
  4. Enter the Portal redirection URL and Timeout, then click Apply.

Portal mode authentication settings with RADIUS

3. Assign the Profile to an SSID and Test

  1. Open SSID and assign the new authentication profile to the target SSID. The example profile name is portal-radius.
  2. Click Apply.

SSID bound to Portal RADIUS authentication settings

  1. Connect a test device to that SSID. This example uses OOS-2.4G-1; use the name you configured. Check that the OOS Wi-Fi Captive Portal login page appears.

OOS Wi-Fi Captive Portal login page

  1. Enter the RADIUS user's username and password. After successful authentication, the browser opens the configured redirection URL. Confirm that the page opens, then test the network service you need.

Portal authentication success redirection page

Option 2: Use OOS Controller

1. Select Controller as the Authentication Source

  1. Go to Security > Authentication > AAA Server and click Add.
  2. Enter a name and select OOS Controller as the type.

Adding OOS Controller AAA server

  1. Go to Networking > Wi-Fi and click Setting.
  2. Open Authentication, click Add, and enter a name.
  3. Following this example, select Portal mode and WPA-2 version, then choose the Controller AAA server. If it is missing from the list, return to AAA Server and check its registration.
  4. Enter the Portal redirection URL and Timeout, then click Apply.

!NOTE After timeout, network access is interrupted until the user authenticates again.

Portal mode authentication settings with OOS Controller

2. Create a User Account in Controller

  1. Sign in to the OOS Controller management interface.

OOS Controller login screen

  1. Confirm that the OOS device is managed and listed in Inventory.

OOS Controller device inventory list

  1. Open Auth Connect and click Add.
  2. Enter the account name and password to give the Wi-Fi user.

Auth Connect APP account creation dialog

  1. Click Apply to create the account.

Auth Connect APP account applied

3. Return to OOS to Apply and Test

  1. Return to SSID in the OOS Wi-Fi settings and select the Controller Portal authentication profile. The example profile name is portal-Controller.

SSID configured with Controller Portal authentication

  1. Click Apply.
  2. Connect a test device to the target SSID. This example uses BehindNAT-2.4G-2; use the name you configured. Check that the login page appears.

OOS Controller Captive Portal login page

  1. Enter the credentials created through Auth Connect. After successful authentication, confirm that the browser opens the configured redirection URL, then test the network service you need.

OOS Controller authentication success redirection page

If login or redirection does not complete, check the connected SSID, its authentication profile, the authentication source, and the user account. Do not use the OOS management credentials or the RADIUS shared key as the Wi-Fi user's password.