Captive portal

From Wikipedia, the free encyclopedia
Jump to: navigation, search

A captive portal is a special web page that is shown before using the Internet normally. The portal is often used to present a login page.[1] This is done by intercepting most packets, regardless of address or port, until the user opens a browser and tries to access the web. At that time the browser is redirected to a web page which may require authentication and/or payment, or simply display an acceptable use policy and require the user to agree. Captive portals are used at many Wi-Fi hotspots, and can be used to control wired access (e.g. apartment houses, hotel rooms, business centers, "open" Ethernet jacks) as well.

Since the login page itself must be presented to the client, either that login page is locally stored in the gateway, or the web server hosting that page must be "whitelisted" via a walled garden to bypass the authentication process. Depending on the feature set of the gateway, multiple web servers can be whitelisted (say for iframes or links within the login page). In addition to whitelisting the URLs of web hosts, some gateways can whitelist TCP ports. The MAC address of attached clients can also be set to bypass the login process.

This technique has occasionally been referred to as UAM (Universal Access Method) in implementations and standards forums


There is more than one way to implement a captive portal.

Redirection by HTTP[edit]

If an unauthenticated client requests a website, DNS is queried by the browser and the appropriate IP resolved as usual. The browser then sends an HTTP request to that IP address. This request, however, is intercepted by a firewall and forwarded to a redirect server. This redirect server responds with a regular HTTP response which contains HTTP status code 302 to redirect the client to the Captive Portal. To the client, this process is totally transparent. The client assumes that the website actually responded to the initial request and sent the redirect. A transparent proxy is often integrated to add flexibility such as exempting certain website domains from redirection.

This technique can also be implemented without cooperation from a firewall or proxy. A server given access to a network sniff of packet headers and allowed to spoof may send an HTTP redirect quickly enough to reach the client before the actual response.

ICMP redirect[edit]

Client traffic can also be redirected using ICMP redirect on the layer 3 level.

Redirection by DNS[edit]

When a client requests a website, DNS is queried by the browser. The firewall will make sure that only the DNS server(s) provided by DHCP can be used by unauthenticated clients (or, alternatively, it will forward all DNS requests by unauthenticated clients to that DNS server). This DNS server will return the IP address of the Captive Portal page as a result of all DNS lookups.

In order to perform redirection by DNS the captive portal is using DNS poisoning to perform a man-in-the-middle attack. To limit the impact of DNS poisoning typically a TTL of 0 is used.

Circumvention of captive portals[edit]

Captive portals have been known to have incomplete firewall rule sets. In some deployments the rule set will route DNS requests from clients to the Internet, or the provided DNS server will fulfill arbitrary DNS requests from the client. This allows a client to bypass the captive portal and access the open Internet by tunneling arbitrary traffic within DNS packets. One tool for DNS tunneling is iodine.[2]

Some captive portals may be configured to allow appropriately equipped user agents to detect the captive portal and automatically authenticate. User agents and supplemental applications such as Apple's Captive Portal Assistant can sometimes transparently bypass the display of captive portal content against the wishes of the service operator as long as they have access to correct credentials, or they may attempt to authenticate with incorrect or obsolete credentials, resulting in unintentional consequences such as accidental account locking.

Software captive portals[edit]

  • Air Marshal, software based for Linux platform (commercial)
  • Net4Guest, WiFi billing and bandwidth management software (commercial)
  • ALCASAR, open source captive portal based on Linux Mageia and few open sources software (CoovaChilli, FreeRADIUS, MariaDB, Dnsmasq, Apache, etc.) - License GPLv3
  • Amazingports, Linux-based software with integrated billing and payment implementing service-oriented provisioning, free and commercial
  • Aradial, including RADIUS & Billing and Network Access Control (commercial)
  • Cloudessa, including Billing, SAML, Google Apps, Facebook and other social networks support (commercial)
  • Cloud4Wi, including custom splash portal, social login, web apps and analytics (commercial)
  • ChilliSpot, open source Linux daemon [abandoned], e.g. in the OpenWrt software package repositories
  • CoovaChilli, open source Linux daemon based on ChilliSpot, e.g. in the OpenWrt software package repositories
  • DNS Redirector, Windows based hotspot software with Internet filtering (commercial)
  • Ecnex, HCCRS is a linux-based proprietary SaaS which provides authentication, billing and bandwidth management.
  • FirstSpot, Windows based hotspot management software (commercial)
  • Global Reach Technology Limited, including Billing, SAML, Google Apps, Facebook, Twitter, Linkedin, including retail & location analytics - Draft Hotspot 2.0 r2 (commercial)
  • Kerio Control, Linux-based firewall with Network Access Control, QoS, etc. (commercial, available since 8.4)
  • LogiSense, Billing and OSS, and Network Access Control (commercial)
  • NONIUS.HSIA, High Speed Internet Access (HSIA),enterprise solution, authentication, billing and bandwidth management (commercial)
  • m0n0wall, FreeBSD-based firewall distribution
  • PacketFence, Linux-based Network Access Control software featuring a captive portal (open source)
  • Purple WiFi, Cloud service for social authentication, analytics, vouchering and location analytics (commercial)
  • pfSense, FreeBSD-based firewall software derived from m0n0wall
  • SOCIFI, Advertising and monetization platform for WiFi providers, MNO and advertisers. Including campaign management, targeting rules, payments system, analytics, social login.
  • Untangle Captive Portal, Firewall featuring Captive Portal (Linux-based, free basic functionality, commercial directory integration)
  • WiFiDog Captive Portal Suite, small C based kernel solution (embeddable), e.g. in the OpenWrt software package repositories
  • Wilmagate, C++ based and is executable both in Linux and Windows/Cygwin environments
  • Zentyal, Linux-based firewall distribution
  • Zeroshell, Linux-based network services distribution
  • WSPOT, Linux-based network services distribution (commercial)

Use cases[edit]

The prevalent use of captive portals is for user authentication, however captive portals are gaining increasing use on free open wireless networks where instead of authenticating users, they often display a message from the provider along with the terms of use. Although the legal standing is unclear, a click through a page may display terms of use and release the provider from any liability.[citation needed] Institutions will often require acknowledgement of an Acceptable use policy in addition to authentication.

Captive portals are sometimes used to enforce payment or negotiate the level and duration of authorization with a prospective user. Emergency notification systems may use captive portals to interrupt users' browsing experience until they have acknowledged receipt of an emergency bulletin.

Institutions implementing NAC often use captive portals to collect machine information, to supply software assessment agents which the supplicant user must run before gaining admission to the network, to provide online assistance for self-remediation of security problems, and to inform quarantined users when their network access has been revoked.

Delivery of advertising content via captive portals is not uncommon.


Some of these implementations merely require users to pass an SSL encrypted login page, after which their IP and MAC address are allowed to pass through the gateway. This has been shown to be exploitable with a simple packet sniffer. Once the IP and MAC addresses of other connecting computers are found to be authenticated, any machine can spoof the MAC address and IP of the authenticated target, and be allowed a route through the gateway. For this reason some captive portal solutions created extended authentication mechanisms to limit the risk for usurpation.

Captive portals require the use of a browser; this is usually the first application that users start, but users who first use an email client or other will find the connection not working without explanation, and will need to open a browser to validate. A similar problem can occur if the client joins the network with pages already loaded into its browser, causing undefined behavior when such a page tries HTTP requests to its origin server.

Platforms that have Wi-Fi and a TCP/IP stack but do not have a web browser that supports HTTPS cannot use many captive portals. Such platforms include the Nintendo DS running a game that uses Nintendo Wi-Fi Connection. Non-browser authentication is possible using WISPr, an XML-based authentication protocol for this purpose, or MAC-based authentication or authentications based on other protocols.

There also exists the option of the platform vendor entering into a service contract with the operator of a large number of captive portal hotspots to allow free or discounted access to the platform vendor's servers via the hotspot's walled garden, such as the deal between Nintendo and Wayport.[citation needed] For example, VoIP SIP ports could be allowed to bypass the gateway to allow phones to work.

See also[edit]


  1. ^ CaptivePortal
  2. ^