User manual

Coova-chilli captive portal
_______________________________________________________________________________________________________
27 Coova-chilli captive portal
Coova-chilli is an access controller application typically used in Wireless LAN
HotSpot, but it can also be used to manage subscriber access via wired LAN.
The captive portal technique forces an HTTP client, such as a user’s web browser
on a network to see a special web page, for authentication purposes, before
using the internet normally.
This is done by intercepting all packets, regardless of address or port, until the
user opens a browser and tries to access the internet. At that point, the browser
is redirected to a web page which requires authentication, displays acceptable
use policy and requires the user to agree to terms and conditions.
Coova-chilli supports two different access methods for a Wireless LAN HotSpot:
• Universal Access Method (UAM)
• Wireless Protected Access (WPA)
Client’s authentication is performed by an external radius server or, in a simple
setup, by checking against the user’s file stored internally on the gateway.
27.1 Coova-chilli Command Line Interface
27.1.1 Main UCI configuration file
Configure Coova-chilli from the command line by editing file
/etc/config/coovachilli.
You must restart the Coova-chilli daemon after saving changes in this
configuration file or reboot the rooter for the changes to take effect.
The configuration options are explained below.
27.1.1.1 Section ‘main’
Name Type Range Default Description
enable decimal 0 or 1 0 Globally enables Coova-chilli on the
router.
log_severity decimal 0 to 7 4 Sets the severity level of messages
logged by the coova-chilli into the
router’s syslog.
The decimal values correspond to:
0=Emergency
1=Alert
2=Critical
3=Error
4=Warning
5=Notice
6=Info
_______________________________________________________________________________________________________
© Virtual Access 2015
GW1000 Series User Manual
Issue: 2.4 Page 196 of 255