Naar de hoofdinhoud
Installatiehandleiding

Captive portal op Cisco WLC
Installatiehandleiding

Koppel je Cisco Catalyst 9800 of je wireless LAN controller met AireOS aan CaptiFi met Central Web Authentication (CWA): leg e-mailadressen van gasten vast, automatiseer Google-reviews en laat je marketing op de automatische piloot draaien. ISE is niet nodig.

📋 Zorg voordat je begint dat je dit hebt:
• Een Cisco Catalyst 9800 (IOS-XE 17.x) of een AireOS-WLC (8.x: 5500, 8500 of virtuele WLC) met aangemelde, werkende access points
• Beheerderstoegang tot de WLC (GUI of CLI)
• Een CaptiFi-account waarin een Cisco-locatie is aangemaakt - maak er hier een aan, kies daarna Cisco Catalyst 9800 / AireOS in de installatiewizard op my.captifi.io en kies bij de locatiestap het besturingssysteem van je WLC. De wizard maakt de locatie aan en toont je configuratiepakket
• Je configuratiepakket uit de wizard, met je RADIUS shared secret, je NAS identifier en elke waarde die hieronder wordt gebruikt (na de installatie staat het onder Controllerinstellingen in het menu Meer op de kaart van de locatie in Mijn locaties)

Instellen in de wizard

Kies Cisco Catalyst 9800 / AireOS in de installatiewizard op je CaptiFi-dashboard op my.captifi.io. De wizard maakt je locatie aan zodra je die een naam geeft en toont de waarden die de WLC nodig heeft als een configuratiepakket dat je kunt kopiëren: het adres van de inlogpagina, de toegestane domeinen en de RADIUS-server, de poorten, het shared secret en de NAS identifier. Een verbindingscontrole laat daarna zien wanneer het eerste gastapparaat de inlogpagina bereikt en wanneer de eerste gast die afrondt.

1 Hoe de CWA-flow werkt

Sinds augustus 2026 ondersteunt CaptiFi beide besturingssystemen voor de Cisco WLC via Central Web Authentication (CWA): dezelfde flow in ISE-stijl, waarbij CaptiFi als RADIUS-server werkt. Je hebt geen ISE nodig.

Catalyst 9800 Appliance, cloud of embedded, met IOS-XE 17.x. Volg stap 2 tot en met 4 hieronder.
AireOS WLC 5500, 8500 of virtuele WLC met AireOS 8.x (bijvoorbeeld voor Aironet 2700-AP's). Volg stap 2 en 3 voor het principe, en daarna het gedeelte over AireOS.

De volgorde in de praktijk: een gast maakt verbinding met je open gast-SSID, de WLC stuurt MAC-authenticatie (MAB) naar de RADIUS-server van CaptiFi, onbekende gasten worden in een quarantainestatus toegelaten met een redirect naar je CaptiFi-inlogpagina, de gast vult het formulier op de inlogpagina in, CaptiFi autoriseert het MAC-adres en laat je WLC de sessie opnieuw controleren (CoA op de 9800, Disconnect-Request/PoD op AireOS), en de WLC authenticeert de sessie opnieuw en geeft volledige internettoegang.

💡 Op een Cisco WLC leg je nooit een vaste inlogpagina-URL vast. CaptiFi geeft de redirect-URL dynamisch terug in het RADIUS-antwoord (het attribuut url-redirect) en stuurt de gast zo naar je inlogpagina in je eigen huisstijl, die je ontwerpt in de Splash Page Builder op my.captifi.io. De exacte URL voor je locatie staat in je configuratiepakket.
⚠️ De naam van de redirect-ACL en de RADIUS-instellingen moeten exact zo worden ingevoerd als getoond. De configuratie van de Cisco 9800 verschilt per IOS-XE-versie: kom je er niet uit, mail dan naar support@captifi.io en we lopen het samen met je door.

2 Voeg de RADIUS-server van CaptiFi toe

Ga in de GUI van de 9800 naar Configuration → Security → AAA → Servers/Groups → RADIUS → Servers → Add en vul in:

Server Address radius.captifi.io
Auth Port 1812
Accounting Port 1813
Shared Secret Te vinden in de wizardstap Configureer je controller, en daarna onder Controllerinstellingen in het menu Meer op de kaart van de locatie in Mijn locaties
Support for CoA Ingeschakeld

Hetzelfde via de CLI, inclusief dynamic authorization voor CoA:

radius server CAPTIFI address ipv4 <resolved-ip-of-radius.captifi.io> auth-port 1812 acct-port 1813 key <YOUR_SHARED_SECRET> aaa server radius dynamic-author client <radius-server-ip> server-key <YOUR_SHARED_SECRET>

Maak daarna een servergroep aan en de method lists waarnaar het WLAN verwijst:

aaa group server radius CAPTIFI_GROUP server name CAPTIFI aaa authorization network CAPTIFI_AUTHZ group CAPTIFI_GROUP aaa accounting identity CAPTIFI_ACCT start-stop group CAPTIFI_GROUP

3 Maak de redirect-ACL aan

De ACL met de naam CAPTIFI_REDIRECT bepaalt welk verkeer wordt onderschept (doorgestuurd naar de inlogpagina) en welk verkeer vóór authenticatie wordt doorgelaten:

ip access-list extended CAPTIFI_REDIRECT 10 deny udp any any eq domain 20 deny udp any eq domain any 30 deny tcp any host <app.captifi.io IP> eq 443 40 deny tcp any host <captifi.io IP> eq 443 100 permit tcp any any eq www 110 permit tcp any any eq 443
💡 Zo werken redirect-ACL's van Cisco op de 9800: in een redirect-ACL voor CWA geldt: deny = NIET doorsturen (doorlaten) en permit = onderscheppen en doorsturen. DNS en de CaptiFi-hosts moeten op deny staan (bereikbaar vóór authenticatie), al het andere webverkeer op permit (doorgestuurd).

Dit zijn de CaptiFi-hosts die vóór het inloggen bereikbaar moeten zijn:

  • app.captifi.io
  • captifi.io
⚠️ De naam van de ACL moet exact CAPTIFI_REDIRECT zijn (hoofdlettergevoelig). CaptiFi geeft deze naam terug in het av-pair url-redirect-acl, dus een andere naam wordt nooit herkend.

4 Stel het gast-WLAN in voor MAB

Ga naar Configuration → Tags & Profiles → WLANs → Add en stel in:

Beveiliging van het gast-SSID Layer 2 → None (open, de inlogpagina regelt het inloggen)
MAC Filtering Enabled, selecteer de authorization list CAPTIFI_AUTHZ

In het Policy Profile voor dit WLAN:

AAA Override Ingeschakeld
NAC State Enabled, NAC Type RADIUS
Accounting list CAPTIFI_ACCT
Pas het policy profile via de policy tag toe op je gast-WLAN.

Hetzelfde via de CLI (belangrijkste regels):

wlan GUEST_WIFI 10 "Free WiFi" mac-filtering CAPTIFI_AUTHZ no security wpa no shutdown wireless profile policy GUEST_POLICY aaa-override nac accounting-list CAPTIFI_ACCT no shutdown

5 Verschillen bij AireOS (oudere WLC's)

AireOS (5500, 8500 of virtuele WLC met 8.x) gebruikt dezelfde RADIUS-instellingen van CaptiFi, maar een andere GUI en, belangrijk, een omgekeerde ACL-logica.

Voeg de RADIUS-server toe

Ga naar Security → AAA → RADIUS → Authentication → New: het server-IP is het IP-adres waarnaar radius.captifi.io verwijst, het shared secret komt uit je configuratiepakket, poort 1812, Support for CoA ingeschakeld. Herhaal dit onder Accounting met poort 1813.

Maak de redirect-ACL aan

Ook hier moet de ACL exact CAPTIFI_REDIRECT heten, maar redirect-ACL's op AireOS gebruiken de gewone permit-logica, het omgekeerde van de Catalyst 9800: je geeft een permit aan het verkeer dat vóór authenticatie het netwerk moet kunnen bereiken, en de impliciete deny-all onderaan zorgt voor de redirect. Geef onder Security → Access Control Lists een permit aan DNS (UDP 53, beide richtingen), DHCP (UDP 67 en 68, beide richtingen) en TCP 80 en 443 naar app.captifi.io en captifi.io. Voeg geen algemene permit voor al het webverkeer toe: dan komt HTTP/HTTPS erdoor en blijft de redirect uit.

⚠️ FlexConnect local switching: gebruikt je gast-WLAN FlexConnect local switching, dan moet CAPTIFI_REDIRECT bestaan als FlexConnect-ACL die aan je FlexConnect-groep is gekoppeld (Wireless → FlexConnect Groups → je groep → ACL Mapping → Policies) EN OOK als gewone ACL met exact dezelfde naam onder Security → Access Control Lists. Ontbreekt een van de twee, dan is dat de meest voorkomende reden dat een client wel een IP-adres krijgt maar daarna wordt geweigerd in plaats van doorgestuurd.

Stel het gast-WLAN in

Security → Layer 2 None, met MAC Filtering ingeschakeld
Security → Layer 3 Geen
Security → AAA Servers Selecteer de RADIUS-server van CaptiFi voor Authentication en Accounting
Gevorderd Allow AAA Override ingeschakeld, NAC State = RADIUS NAC (in de GUI van AireOS 8.x heet dit ISE NAC, het is dezelfde instelling), en FlexConnect Local Switching ingeschakeld als je AP's op FlexConnect draaien
💡 Sessie vernieuwen op AireOS: nadat een gast de inlogpagina heeft afgerond, stuurt CaptiFi een RADIUS Disconnect-Request (Packet of Disconnect) naar je WLC op UDP 3799. De client maakt ongemerkt opnieuw verbinding, doorloopt de MAC-authenticatie opnieuw en krijgt volledige toegang. Zorg dat UDP 3799 inkomend openstaat van CaptiFi naar het management-IP van de WLC. Op de Catalyst 9800 is de vergelijkbare CoA-poort UDP 1700.

6 De oplossing testen

Verbind een telefoon met het gast-SSID. De CaptiFi-inlogpagina hoort automatisch te verschijnen (of open in een browser een willekeurige HTTP-site). Vul het formulier op de inlogpagina in: binnen een paar seconden hoort er volledige internettoegang te zijn, zo lang duurt de CoA plus de nieuwe authenticatie.

Controleer in je CaptiFi-dashboard onder Gastbezoeken of de gast is vastgelegd. Staat de gast erbij, dan ben je live.

✅ Je captive portal van CaptiFi draait nu op je draadloze Cisco-netwerk. Elke gast die verbinding maakt, ziet je inlogpagina in je eigen huisstijl en het e-mailadres wordt automatisch vastgelegd.

Problemen oplossen

Er verschijnt geen inlogpagina Controleer of MAC-filtering naar de authorization list van CaptiFi verwijst en of de WLC radius.captifi.io:1812 kan bereiken (UDP).
Inlogpagina laadt niet Controleer de regels in de redirect-ACL voor DNS en de CaptiFi-hosts: gasten moeten app.captifi.io vóór authenticatie kunnen bereiken.
Gast zit vast na het versturen van het formulier Mogelijk wordt CoA/PoD geblokkeerd. Controleer of dynamic authorization is ingeschakeld en of de juiste UDP-poort inkomend openstaat van CaptiFi naar de WLC: 1700 op de 9800, 3799 op AireOS.
"RADIUS server not responding" Controleer of het shared secret exact overeenkomt; controleer of geen firewall UDP 1812/1813 uitgaand blokkeert.
Werkt één keer, daarna moeten gasten opnieuw inloggen Sessietime-out: CaptiFi geeft de sessieduur uit je locatie-instellingen terug. Controleer geautoriseerde minuten in je dashboard.
ACL-fouten in de logs De naam van de ACL moet exact CAPTIFI_REDIRECT zijn (hoofdlettergevoelig).
AireOS FlexConnect: client krijgt een IP-adres en daarna "network access denied", zonder ooit te worden doorgestuurd Bij FlexConnect local switching werkt de redirect alleen als CAPTIFI_REDIRECT bestaat als FlexConnect-ACL die aan de groep is gekoppeld en ook als gewone ACL met exact dezelfde naam. Zie het gedeelte over AireOS hierboven.

Handige debugcommando's op de 9800:

show wireless client mac-address <mac> detail debug aaa authorization show access-lists CAPTIFI_REDIRECT

Werkt met je bestaande Cisco-apparatuur, of gebruik ons meegeleverde apparaat

CaptiFi is hier eerlijk over: je hoeft niets nieuws te kopen. Er zijn twee routes: je bestaande apparatuur werkt met elk abonnement, en het plug-and-play-apparaat is bij elk abonnement inbegrepen.

Gebruik je bestaande Cisco-apparatuur Heb je al een Catalyst 9800 of een AireOS-WLC draaien met aangemelde access points, volg dan de stappen hierboven. CaptiFi werkt als RADIUS-server en toont de inlogpagina in je eigen huisstijl. Geen ISE, geen extra hardware.
Gebruik ons inbegrepen plug-and-play-apparaat Geen Cisco-controller, of kom je liever niet aan de WLC? We sturen je per post een vooraf geconfigureerd CaptiFi-apparaat. Sluit het met een ethernetkabel aan op je bestaande netwerk, voer op je telefoon de activatiepincode van 8 cijfers in, en het haalt zijn configuratie uit de cloud. De gastenwifi is in ongeveer vijf minuten live, van begin tot eind, zonder controller, vast IP-adres of firewallwijziging.
💡 Het plug-and-play-apparaat is het alternatief zonder configuratie. Het marketingplatform is in beide gevallen hetzelfde, dus je kunt met ons apparaat beginnen en later overstappen op je Cisco-apparatuur, of dat gewoon laten.

Lite: £19.99 per maand op je eigen netwerk

Draai je al op Cisco Catalyst? Lite is gasten vastleggen en CSV-export op de access points die je hebt, 500 nieuwe gasten per maand, voor één locatie. De inlogpagina houdt de CaptiFi-branding.

Verwante handleidingen en pagina's

Veelgestelde vragen over een captive portal op Cisco WLC

Welke Cisco-controllers ondersteunt CaptiFi?

Sinds augustus 2026 ondersteunt CaptiFi de Catalyst 9800-familie (appliance, cloud en embedded, met IOS-XE 17.x) en AireOS-WLC's (5500, 8500 en virtuele WLC met 8.x). Beide gebruiken dezelfde CWA-flow met CaptiFi als RADIUS-server.

Heb ik Cisco ISE nodig om CaptiFi te gebruiken?

Nee. CaptiFi gebruikt dezelfde Central Web Authentication-flow in ISE-stijl, maar CaptiFi werkt zelf als RADIUS-server. Je hoeft verder niets te licentiëren of uit te rollen.

Waar vul ik de URL van de inlogpagina in?

Nergens. Op een Cisco WLC geeft CaptiFi de redirect-URL dynamisch terug in het RADIUS-antwoord (het attribuut url-redirect), dus er is geen veld voor een inlogpagina-URL om in te vullen. De inlogpagina zelf ontwerp je in de Splash Page Builder op my.captifi.io.

Waarom blijft mijn gast op de inlogpagina hangen na het versturen van het formulier?

Waarschijnlijk wordt het bericht voor de nieuwe autorisatie geblokkeerd. Controleer of dynamic authorization op de WLC is ingeschakeld en of de juiste UDP-poort inkomend openstaat vanaf CaptiFi: 1700 voor CoA op de Catalyst 9800, 3799 voor Disconnect-Request op AireOS.

Maakt CaptiFi mijn Cisco-wifi trager?

Nee. CaptiFi verzorgt alleen de inlogpagina en de RADIUS-autorisatie. Zodra een gast binnen is, loopt het verkeer zoals gewoonlijk rechtstreeks over je Cisco-netwerk.

Voldoet het captive portal op Cisco met CaptiFi aan de AVG?

CaptiFi vraagt marketingtoestemming los van het online gaan en legt het antwoord van elke gast vast, en gasten die weigeren komen gewoon op je Cisco-wifi. Elke marketing-e-mail bevat een afmeldlink, met Verwijderen (AVG) en Anonimiseren (AVG) op de pagina Gastbezoeken handel je verwijderverzoeken af, en de verwerkersovereenkomst van CaptiFi is gepubliceerd. Je zaak is de verwerkingsverantwoordelijke, dus de naleving zelf blijft bij jou.

Voor MSP's en installateurs

Stel je dit in voor een klant?

Partners van CaptiFi kopen bij elk abonnement in tegen een groothandelstarief onder de verkoopprijs, en white label is er tegen dezelfde tarieven. Je bepaalt je eigen prijs en factureert je klanten rechtstreeks. De volledige tarievenlijst in je eigen valuta staat in het partnerdashboard zodra je account is goedgekeurd, en je kunt ernaar vragen bij je aanmelding.

  • ✓ Tarievenlijsten in GBP, USD, EUR, CAD, AUD en NZD
  • ✓ Gratis interne demolicentie van 6 maanden voor één interne testlocatie (alleen voor tests en demo's)
  • ✓ Partnerdashboard vanaf je eerste login na goedkeuring, plus stapsgewijze checklists voor de installatie

Maak van je Cisco-gastenwifi een marketingmachine

Start een gratis proefperiode van 30 dagen, of bekijk eerst een live demo.