Naar de hoofdinhoud
Installatiehandleiding

Captive portal op Ruckus
Installatiehandleiding

Laat je Ruckus Unleashed-access points naar CaptiFi verwijzen met een Hotspot (WISPr)-service plus RADIUS: leg e-mailadressen van gasten vast, automatiseer Google-reviews en laat je marketing op de automatische piloot draaien. Gebruik je SmartZone, ZoneDirector of RUCKUS One? Die stellen we in overleg in, dus mail naar hello@captifi.io voordat je begint.

📋 Zorg voordat je begint dat je dit hebt:
• Ruckus-access points die op Unleashed draaien, met beheerderstoegang tot de webinterface van Unleashed
• Een computer op hetzelfde netwerk waarmee je een SSH-sessie naar je Unleashed master access point kunt openen (Terminal op een Mac, PowerShell of PuTTY op Windows)
• Een CaptiFi-account met een Ruckus-locatie: maak er hier een aan
• Je site-ID, RADIUS shared secret en NAS identifier van CaptiFi (te vinden in de installatiewizard, en onder Controllerinstellingen op de kaart van je locatie)

1 Overzicht van de installatie in 6 stappen

Sinds oktober 2026 werkt CaptiFi direct met Ruckus Unleashed, via een Hotspot (WISPr)-service plus RADIUS-authenticatie. Gasten die verbinding maken met je gastenwifi worden naar je CaptiFi-inlogpagina gestuurd. Zodra ze die hebben afgerond, logt de pagina ze in op je Unleashed-netwerk, en Unleashed controleert bij de RADIUS-server van CaptiFi voordat het apparaat online mag. Alles gebeurt in de webinterface van Unleashed, op één kort commando via SSH na.

💡 Deze handleiding gaat over Ruckus Unleashed. Worden je access points beheerd met SmartZone, ZoneDirector of RUCKUS One, dan stellen we die in overleg in: mail naar hello@captifi.io of gebruik de contactpagina voordat je begint.
Stap 1 Maak de Ruckus-locatie aan in CaptiFi om je portal-URL, RADIUS-waarden en NAS identifier te krijgen.
Stap 2 Voeg de RADIUS-servers van CaptiFi toe in Unleashed, één voor authenticatie en één voor accounting.
Stap 3 Maak de hotspotservice aan die gasten naar je CaptiFi-inlogpagina stuurt, met de bijbehorende walled garden.
Stap 4 Maak het gast-WLAN aan op die hotspotservice.
Stap 5 Stel het NAS-ID van het gast-WLAN in via SSH, zodat CaptiFi weet op welke locatie elke gast is.
Stap 6 Test het geheel met een telefoon.
⚠️ De portal-URL, de RADIUS-gegevens en het shared secret moeten exact zo worden ingevoerd als in je CaptiFi-dashboard staat. Met onjuiste waarden werkt het captive portal niet.

2 Maak de locatie aan in CaptiFi

Log in op my.captifi.io, ga naar Mijn locaties → Locatie toevoegen (of kies je hardware in de installatiewizard) en selecteer Ruckus. Geef de controller een naam en rond de wizard af. De stap Activeer je wifi toont wat Unleashed nodig heeft als een configuratiepakket dat je kunt kopiëren: je portal-URL, de RADIUS-server en de poorten, het shared secret, je NAS identifier, de Start Page-URL en de NAS-ID-commando's voor de SSH-stap, met de waarden van je locatie al ingevuld. Het secret blijft verborgen tot je op Tonen klikt. Later vind je dezelfde waarden op de kaart van de locatie onder Mijn locaties (open Meer en kies Controllerinstellingen).

De wifi-stap toont onder het portaladres de verbindingscontroles: of de controller RADIUS-verkeer stuurt, of een gastapparaat de inlogpagina heeft bereikt, en of gasten die afronden. Zijn de stappen hieronder klaar, maak dan met een telefoon verbinding met de gastenwifi en de controles worden groen.

Je portal-URL heeft deze vorm (vervang YOUR_SITE_ID door het site-ID uit je dashboard):

Portal URL https://app.captifi.io/guest/ruckus?site_id=YOUR_SITE_ID
⚠️ Je access point voegt het MAC-adres van de gast, het SSID en andere gegevens automatisch aan deze URL toe, dus zet niets achter site_id.

3 Voeg de RADIUS-servers van CaptiFi toe

Ruckus zet gasten online via RADIUS. Nadat een gast het formulier op de inlogpagina heeft verstuurd, vraagt Unleashed aan de RADIUS-server van CaptiFi of dat apparaat online mag. Zonder deze stap zien gasten de inlogpagina wel, maar krijgen ze nooit internet.

Ga in Unleashed naar Admin & Services → Services → AAA Servers en klik twee keer op Create, één keer voor elke server hieronder. Unleashed wil hier een IP-adres, en 46.62.168.7 is de RADIUS-server van CaptiFi (radius.captifi.io).

Authenticatieserver

Naam Naar keuze, bijvoorbeeld CaptiFi-Auth
Type RADIUS
Auth Method PAP
IP Address 46.62.168.7
Port 1812
Shared Secret Te vinden in je CaptiFi-dashboard

Accountingserver

Naam Naar keuze, bijvoorbeeld CaptiFi-Acct
Type RADIUS Accounting
IP Address 46.62.168.7
Port 1813
Shared Secret Hetzelfde shared secret

4 Maak de hotspotservice aan

Ga naar Admin & Services → Services → Hotspot Services en klik op Create. Je kunt de service ook aanmaken vanuit het gast-WLAN in de volgende stap, met de + naast Hotspot Services.

Tabblad General

Naam CaptiFi
WISPr Smart Client Support Geen
Login Page Je CaptiFi-portal-URL uit stap 2
Start Page Redirect to the following URL: https://app.captifi.io/site/YOUR_SITE_ID/connected

Gebruik hetzelfde site-ID als in je portal-URL. Gasten komen op deze verbonden-pagina uit zodra ze online zijn, en die stuurt ze door naar de redirect-URL die bij je locatie is ingesteld. We hebben de andere Start Page-optie geprobeerd (de URL die de gebruiker wil bezoeken): iPhones kwamen wel online, maar bleven op een leeg scherm hangen, dus kies de redirect.

Tabblad Authentication

Kies de CaptiFi-authenticatieserver uit stap 3 bij Authentication, en de CaptiFi-accountingserver bij Accounting.

Tabblad Walled Garden

Dankzij de walled garden kunnen gasten de servers van CaptiFi bereiken voordat ze inloggen. Zonder deze regels kan de inlogpagina niet laden. Voeg ze alle drie toe:

  • app.captifi.io
  • captifi.io
  • 46.62.168.7
Klik op OK om de hotspotservice op te slaan.
💡 Je hoeft geen aparte URL voor het terugsturen in te stellen. De inlogpagina logt de gast zelf in op Unleashed, en Unleashed vraagt het daarna na bij de RADIUS-server van CaptiFi.

5 Maak het gast-WLAN aan

Ga naar Wi-Fi Networks en klik op Create, of bewerk je bestaande gastnetwerk:

Naam De naam van je gastnetwerk, bijvoorbeeld The Anchor Guest WiFi
Usage Type Hotspot Service
Authentication Method Open
Encryption Method Geen
Hotspot Services CaptiFi (de service uit stap 4)
Klik op OK om op te slaan.
💡 De netwerknaam staat op je Ruckus-controller. Als je de naam van het wifi-netwerk in CaptiFi wijzigt, krijgt het netwerk in Unleashed geen andere naam, dus pas de naam hier aan.

6 Stel het NAS-ID in via SSH

Unleashed stuurt bij elk RADIUS-verzoek een NAS-ID mee, en CaptiFi herkent daaraan je locatie. Doe je niets, dan stuurt het WLAN zijn eigen BSSID mee, dat CaptiFi niet aan een locatie kan koppelen, waardoor gasten de inlogpagina zien maar nooit online komen. De webinterface van Unleashed heeft er geen veld voor, en daarom regel je deze ene instelling via SSH.

Open een SSH-sessie naar je master access point, met het IP-adres waarop je de webinterface van Unleashed opent. Op een Mac of Linux:

ssh -o HostKeyAlgorithms=+ssh-rsa admin@UNLEASHED_IP

Unleashed biedt een ouder sleuteltype aan dat huidige SSH-clients alleen op verzoek accepteren, vandaar de extra optie. PuTTY op Windows maakt zonder die optie verbinding. Vul bij Please login: de gebruikersnaam en het wachtwoord van je Unleashed-beheerder in en open daarna het gast-WLAN met deze regels, één voor één, met de exacte naam van je gast-WLAN uit stap 5:

enable config wlan "YOUR GUEST WLAN NAME"

Unleashed hoort te antwoorden dat de WLAN-service has been loaded. Staat er in plaats daarvan has been created, dan komt de naam met geen van je WLAN's overeen en is Unleashed aan een nieuw WLAN begonnen. Typ abort, waarmee niets wordt opgeslagen, en open het WLAN opnieuw met de exacte naam, inclusief hoofdletters en spaties. Is het geladen, stel dan het NAS-ID in met de NAS identifier uit je CaptiFi-dashboard en sla op:

nasid-type user-define YOUR_NAS_IDENTIFIER end exit exit

Je CaptiFi-dashboard toont beide sets regels met de waarden van je eigen locatie al ingevuld, klaar om te kopiëren. Na end antwoordt Unleashed dat de WLAN-service is bijgewerkt en opgeslagen.

7 De oplossing testen

Maak met een telefoon verbinding met de gastenwifi. De CaptiFi-inlogpagina hoort vanzelf te openen; gebeurt dat niet, open dan een browser en ga naar een willekeurige HTTP-site (bijvoorbeeld http://example.com). Vul het inlogformulier in. Binnen een paar seconden is de telefoon online en toont die je verbonden-pagina, en daarna de redirect-URL van je locatie.

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

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

Werkt met je bestaande Ruckus-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 Ruckus-apparatuur Draai je al Ruckus-access points op Unleashed, volg dan de stappen hierboven. CaptiFi staat ervoor als WISPr-portal en RADIUS-server, zonder extra hardware. Gebruik je SmartZone, ZoneDirector of RUCKUS One, mail dan naar hello@captifi.io voordat je gaat instellen.
Gebruik ons inbegrepen plug-and-play-apparaat Geen Ruckus-controller, of kom je er liever niet aan? 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 Ruckus-apparatuur, of dat gewoon laten.

Lite: £19.99 per maand op je eigen netwerk

Gebruik je al Ruckus? 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 Ruckus

Welke Ruckus-platforms ondersteunt CaptiFi?

Sinds oktober 2026 werkt CaptiFi direct met Ruckus Unleashed, ingesteld zoals deze handleiding beschrijft. SmartZone, ZoneDirector en RUCKUS One gaan in overleg: mail naar hello@captifi.io of gebruik de contactpagina voordat je op een van die platforms gaat instellen.

Waarom verschijnt mijn Ruckus-inlogpagina niet?

Controleer of het Usage Type van het gast-WLAN op Hotspot Service staat met de CaptiFi-hotspotservice geselecteerd, en of de Login Page van de service exact overeenkomt met je portal-URL. Laadt de pagina zonder opmaak, of helemaal niet, controleer dan of de walled garden alle drie de regels bevat: app.captifi.io, captifi.io en 46.62.168.7.

Gasten zien de inlogpagina maar komen nooit online. Waarom?

Controleer eerst het NAS-ID. Zonder de SSH-stap stuurt het WLAN zijn BSSID als NAS-ID mee, kan CaptiFi dat niet aan je locatie koppelen en komen gasten nooit online. Controleer daarna de authenticatieserver in Unleashed: IP 46.62.168.7, poort 1812, auth method PAP, en gekozen op het tabblad Authentication van de hotspotservice. Worden gasten na de inlogpagina geweigerd, dan komt het shared secret niet overeen, dus kopieer het opnieuw uit je CaptiFi-dashboard naar beide AAA-servers.

Waarom verschijnen er geen gasten in mijn CaptiFi-dashboard?

Kies op het tabblad Authentication van de hotspotservice de CaptiFi-accountingserver bij Accounting, naast de authenticatieserver bij Authentication; zonder die server krijgt CaptiFi geen sessiegegevens. Ontbreken gasten helemaal, loop dan het antwoord over NAS-ID en RADIUS hierboven door. Reken na elke wijziging op 1-2 minuten voordat de instellingen zijn doorgevoerd.

Waarom wordt het portal niet geactiveerd op HTTPS-sites?

Gasten moeten soms eerst een HTTP-site bezoeken (bijvoorbeeld http://example.com) om de redirect naar het portal te activeren. Dit is standaardgedrag van een captive portal en geen fout van Ruckus of CaptiFi: HTTPS-verkeer kan niet transparant worden doorgestuurd.

Kan ik CaptiFi op meerdere Ruckus-locaties gebruiken?

Ja. Elke locatie kan een eigen ontwerp voor de inlogpagina hebben, en elke locatie heeft een eigen portal-URL en NAS identifier, dus elk Unleashed-netwerk heeft een eigen hotspotservice en een eigen NAS-ID nodig. Je beheert ze onder Mijn locaties in je CaptiFi-dashboard. Voor elke extra CaptiFi-locatie boven de ene die in je abonnement zit, betaal je het tarief voor een extra locatie in je valuta.

Werken snelheidslimieten en sessieduur op Ruckus Unleashed?

Ja. De snelheidslimieten die je instelt in Locatie bewerken en de sessieduur gelden allebei voor gasten op Unleashed.

Kan ik wifi-vouchers of Betaalde wifi verkopen op Ruckus?

Nee. Wifi-vouchers en Betaalde wifi zijn niet beschikbaar op Ruckus-netwerken. Probeer je een van beide in te schakelen voor een Ruckus-locatie, dan meldt my.captifi.io dat het niet beschikbaar is, en gasten gebruiken altijd de standaard inlogpagina.

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 Ruckus-gastenwifi een marketingmachine

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