Naar de hoofdinhoud
Gidsen Laatst bijgewerkt: oktober 2026 9 min leestijd

Een captive portal instellen op TP-Link Omada: de gids

C
Redactie van CaptiFi
CaptiFi · sep. 2024
Een captive portal instellen op TP-Link Omada: de gids
4 stappen
Gasten-SSID, extern portal, pre-auth-lijst, koppeling met de controller
4 vermeldingen
Domeinen en IP-adres in de pre-auth walled garden
8043
Poort van de softwarecontroller (443 op de OC200/OC300)
Geen RADIUS
Een Omada-operatoraccount autoriseert gasten

TP-Link Omada omvat access points, switches en gateways, beheerd vanuit een controller die je bezit of huurt. Het eigen portal van de controller kan gasten al een inlogpagina tonen, met opties als een eenvoudig wachtwoord, vouchers en een Form Auth-vragenlijst. Deze handleiding laat zien hoe je de External Portal Server van Omada in plaats daarvan naar CaptiFi laat verwijzen, zodat elke gastlogin een contact aan je gastenlijst toevoegt, met de marketingtoestemming erbij vastgelegd. De stappen zijn dezelfde als in de Omada-installatiehandleiding van CaptiFi in onze klantdocumentatie.

Eerst iets rechtzetten, want veel lezers van eerdere versies van deze handleiding zijn erover gestruikeld: je hoeft geen RADIUS-server in te stellen. Omada stuurt gasten door naar de inlogpagina van CaptiFi, en CaptiFi autoriseert ze daarna via een operatoraccount op je controller. Alles wat je in Omada invult is een URL, vier pre-auth-vermeldingen en één operatorlogin.

Wat een captive portal doet

Een captive portal is de pagina die gasten zien als ze verbinding maken met je wifi, voordat ze online gaan. In plaats van een open netwerk of een wachtwoord aan de muur kun je met het portal gegevens van gasten vastleggen, zoals een e-mailadres, naam of telefoonnummer, je eigen huisstijl tonen, de marketingtoestemming vastleggen die de UK GDPR en PECR vereisen, en de gast doorgeven aan je wifi-marketingsoftware zodra die verbinding maakt. Omada regelt het wifi-signaal en het netwerk; CaptiFi regelt de pagina, de gegevens en alles wat er na de login gebeurt.

CaptiFi is externe captive-portalsoftware. Het werkt met TP-Link Omada en ook met UniFi, Cisco Meraki, Aruba, MikroTik, Ruckus, Fortinet en DrayTek, en met het CaptiFi-apparaat (tegen een borg die je terugkrijgt) als je liever helemaal niet aan een controller komt.

Wat je nodig hebt

  • Een TP-Link Omada-controller die CaptiFi via internet kan bereiken: een OC200- of OC300-hardwarecontroller, de gratis zelf gehoste softwarecontroller of de betaalde Omada Cloud-Based Controller (CBC).
  • Niet de gratis Essentials-versie, die TP-Link nu Omada Central Essentials noemt (voorheen Omada Cloud Essentials). In de functietabel van TP-Link staat daar een optie External Portal Server, maar de Omada-koppeling van CaptiFi wordt alleen ondersteund op de controllers hierboven. Ziet het adres van je controller eruit als xxx-omada-essential-device.tplinkcloud.com, dan zit je op Essentials. Verplaats de access points naar een OC200, de softwarecontroller of de betaalde Cloud-Based Controller, of sla de controller helemaal over met het CaptiFi-apparaat, tegen een borg die je terugkrijgt.
  • Controllerfirmware 5.x of hoger wordt aanbevolen, en v5.15 of hoger is vereist voor WiFi 7-EAP's zoals de EAP772 en EAP773.
  • Een of meer Omada EAP-access points, geadopteerd en online.
  • Beheerderstoegang tot de controller.
  • Een CaptiFi-account op my.captifi.io, met je site-ID bij de hand. Die staat in je dashboard, of support kan hem naar je sturen. Start een gratis proefperiode van 30 dagen als je nog geen account hebt.
  • De controller moet bereikbaar zijn vanaf internet. De standaardpoort is 8043 op de softwarecontroller en 443 op de OC200 en OC300, dus een controller op locatie heeft meestal een port forward nodig.

De vier stappen in één oogopslag

  1. Gasten-SSID: maak een apart, open draadloos netwerk voor gasten aan.
  2. Extern portal: laat het portal van die SSID naar CaptiFi verwijzen.
  3. Walled garden: laat de CaptiFi-domeinen toe vóór de authenticatie, zodat de inlogpagina kan laden.
  4. Controllerkoppeling: maak een operatoraccount aan en koppel de controller in CaptiFi.

Test daarna met een telefoon. Wie zijn weg kent in de Omada-controller, doet het hele traject in één keer.

Stap 1: maak een gasten-SSID aan

Open je Omada-controller, lokaal of in de cloud, open je site en ga naar Network Config, dan Network Settings, dan WLAN (op Omada 5 is dat Settings, dan Wireless Networks). Voeg een nieuw draadloos netwerk toe en geef de SSID de naam die gasten moeten zien, bijvoorbeeld "Free WiFi". Zet Security op None, want het captive portal bepaalt wie er online komt, en laat SSID Broadcast aan staan. Kies onder Band 2.4 GHz, 5 GHz of beide, en klik op Save.

Zet het gastenverkeer op een eigen VLAN om het netwerk te scheiden. Ga naar Network Config, Network Settings, LAN (Settings, Wired Networks, LAN op Omada 5), maak een nieuw netwerk voor gasten aan, ga terug naar het draadloze netwerk en wijs de gasten-SSID eraan toe. Zo blijven gasten uit de buurt van je kassa's, printers en kantoorcomputers.

Stap 2: stel het externe portal in

Dit is de belangrijkste stap. Ga naar Network Config, Authentication, Portal (Settings, Authentication, Portal op Omada 5), klik op Create New Portal en vul het tabblad Basic in.

InstellingWaarde
Portal NameCaptiFi, of een naam naar keuze
PortalAan
SSID & NetworkJe gasten-SSID uit stap 1
Landing PageOriginal URL

Laat het veld Portal URL op het tabblad Basic staan zoals het is: dat is het eigen adres van de controller, niet dat van CaptiFi. Open daarna het tabblad Authentication, zet Authentication Type op External Portal Server en Custom Portal Server op URL. Kies https:// in de keuzelijst en typ de rest van je adres in het vak ernaast: app.captifi.io/guest/omada?site_id=YOUR_SITE_ID. Het vak weigert een adres dat begint met https://, dus plak alles wat daarna komt. Sla het portal op.

Vervang YOUR_SITE_ID door je CaptiFi-site-ID; de installatiewizard toont je volledige adres met een kopieerknop. Het adres moet exact worden ingevoerd, en een typefout hier is de meest voorkomende reden dat de inlogpagina nooit verschijnt. Het accepteert automatisch de redirectparameters van de Omada-controllerversies 4, 5 en 6. Voor een extern portal hoef je in Omada geen time-out in te stellen: hoe lang gasten online blijven is de sessieduur (Session length) van je locatie in CaptiFi, die CaptiFi bij elke login meestuurt.

Stap 3: voeg de pre-auth-vermeldingen toe

Dankzij de walled garden, die in Omada 6 Pre-Authentication Access heet, kunnen gasten de servers van CaptiFi bereiken voordat ze zijn ingelogd. Zonder deze vermeldingen kan de inlogpagina niet laden. Open op de pagina Portal het tabblad Access Control, zet Pre-Authentication Access aan en klik voor elke vermelding hieronder op Add (zoek op Omada 5 in de portalinstellingen naar het onderdeel Pre-Auth Policy of Walled Garden).

Domein of IP-adresWaarom het nodig is
app.captifi.ioLevert de inlogpagina
46.62.168.7Het IP-adres van CaptiFi, voor controllers die alleen IP-vermeldingen accepteren
fonts.googleapis.comLettertypen van de pagina
fonts.gstatic.comLettertypen van de pagina

Voeg de drie hosts toe als URL-vermelding en het IP-adres als IP Range-vermelding met subnetmasker 32. Omada accepteert geen wildcards zoals *.captifi.io, en de pagina heeft er ook geen nodig. Sommige versies van de Omada-controller accepteren in de walled garden alleen vermeldingen op basis van een IP-adres. Weigert die van jou een domein, dan houdt de IP-vermelding 46.62.168.7 het portal bereikbaar. Klik op Save of Apply als de lijst compleet is.

Stap 4: verbind de controller met CaptiFi

Maak een operatoraccount aan in Omada

CaptiFi autoriseert gasten via de hotspot-operator-API van Omada en heeft daarom een apart operatoraccount nodig in plaats van je hoofdlogin als beheerder. Open in de controller je site en klik in het linkermenu op Hotspot (Omada 6 opent Hotspot Management in een nieuw tabblad; op Omada 5 heet het Hotspot Manager) en ga naar Operators. Voeg een nieuwe operator voor je site toe, bijvoorbeeld met de gebruikersnaam captifi, en geef die een sterk wachtwoord.

Voeg de locatie toe in CaptiFi

  1. Zorg dat de controller bereikbaar is vanaf internet. Een controller op locatie heeft meestal een port forward nodig voor 8043 (softwarecontroller) of 443 (OC200/OC300).
  2. Log in op my.captifi.io en ga naar My Venues, dan Add venue, of kies je hardware tijdens de onboarding, en kies TP-Link Omada.
  3. Vul de Controller URL in: het eigen adres van de controller inclusief de poort, bijvoorbeeld https://YOUR-CONTROLLER-IP:8043, of het domein ervan. Gebruik je de betaalde Cloud-Based Controller, neem dan de controller-URL uit je Omada-cloudaccount. Plak geen omada://-links uit de Omada-app; dat zijn geen controlleradressen.
  4. Vul de Controller ID in: dat is het lange ID-gedeelte in de URL van je Omada-controller.
  5. Vul de gebruikersnaam en het wachtwoord in van de operator die je net hebt aangemaakt.
  6. Klik op Connect. CaptiFi test de login en bevestigt de koppeling.

Controleer de port forward

Staat de controller op locatie, controleer dan de toegang op afstand voordat je met gasten test. Zoek je openbare IP-adres op via whatismyip.com en ga daarna van buiten je netwerk naar https://YOUR_PUBLIC_IP:8043. Je hoort de inlogpagina van Omada te zien, mogelijk achter een certificaatwaarschuwing die je kunt accepteren.

Stap 5: test met een telefoon

  1. Verbind een telefoon of laptop met de gastenwifi.
  2. De inlogpagina van CaptiFi hoort automatisch te verschijnen. Opent een telefoon de pagina niet vanzelf, open dan een browser en ga naar een willekeurige HTTP-site, zoals http://example.com.
  3. Vul het inlogformulier op de inlogpagina in.
  4. Controleer of je na het inloggen internettoegang hebt.
  5. Open je CaptiFi-dashboard: de testgast hoort in je gastenlogboek te staan.

Problemen oplossen

SymptoomWat je moet controleren
Inlogpagina verschijnt nietHet portal staat aan, de juiste SSID is geselecteerd en Authentication Type staat op External Portal Server
Foutmelding "Portal unreachable"In de walled garden staan app.captifi.io en 46.62.168.7
Lege of kapotte inlogpaginafonts.googleapis.com en fonts.gstatic.com staan in de walled garden, zodat de onderdelen van de pagina kunnen laden
Gast komt na het inloggen niet onlineHet CaptiFi-adres staat in Custom Portal Server op het tabblad Authentication van het portal, het operatoraccount hoort bij deze site, en VLAN- of firewallregels blokkeren het verkeer na de authenticatie niet
Controller maakt geen verbinding met CaptiFiPort forwarding werkt voor controllers op locatie; test van buiten het netwerk op poort 8043
"Invalid credentials" in CaptiFiDe gebruikersnaam en het wachtwoord van de operator, en de Controller ID die je uit de Omada-URL hebt gekopieerd
Portal werkt maar op een deel van de AP'sElke EAP is geadopteerd, online en zendt de gasten-SSID uit; provisioneer opnieuw als dat nodig is
HTTPS-sites starten de redirect nietGa eerst naar een HTTP-site, zoals http://example.com
Walled garden accepteert geen domeinenDie firmware ondersteunt alleen IP-vermeldingen; voeg 46.62.168.7 toe als IP-vermelding

Compatibele Omada-hardware

CaptiFi werkt met Omada EAP-access points die door een ondersteunde controller zijn geadopteerd, waaronder de EAP225 en EAP245 voor binnen, de WiFi 6-modellen EAP660 HD en EAP670, de EAP225-Outdoor en EAP610-Outdoor, en de WiFi 7-plafondmodellen EAP772 en EAP773 op controller v5.15 of hoger. Ondersteunde controllers zijn de OC200, de OC300, de zelf gehoste softwarecontroller en de betaalde Cloud-Based Controller. De gratis Cloud Essentials-versie wordt niet ondersteund. Gebruik je WiFi 7-access points of zit je zaak op Starlink, dan vind je in de klantdocumentatie een aparte handleiding voor Omada met WiFi 7 en Starlink, met de vereiste controllerversies, de beperking van de gasten-SSID op 6 GHz en de CGNAT van Starlink.

Wat er na het instellen gebeurt

Zodra het portal live is, ziet elke gast die verbinding maakt je pagina in je eigen huisstijl en neemt CaptiFi het daarna over. Het bewaart de gegevens en de toestemming van elke gast uit de login en houdt terugkerende bezoeken bij, zodat je ziet wie je vaste gasten zijn. Vanaf Essentials kan het ook een welkomstmail sturen na een eerste bezoek, een Google-reviewverzoek zodra de gast weg is, en een win-backaanbieding aan gasten die al een tijd niet zijn geweest. Je stelt het één keer in en het blijft draaien.

Het ingebouwde portal van Omada vergeleken met Omada met CaptiFi

Dit verandert er als je het eigen portal van de controller vervangt door CaptiFi als extern portal. In de kolom Omada staat wat de documentatie van TP-Link beschrijft; waar die iets niet noemt, staat dat in de cel.

MogelijkheidHet eigen portal van OmadaOmada met CaptiFi
Hoe gasten inloggenZeven authenticatietypen, waaronder een eenvoudig wachtwoord, Hotspot (vouchers en meer), RADIUS, Google en een External Portal ServerEen pagina met je logo en kleuren, die om naam en e-mailadres vraagt
Verzamelde gastgegevensEen Form Auth-vragenlijst, die TP-Link omschrijft als een manier om feedback van klanten te verzamelenE-mailadres, naam en telefoonnummer, met vastgelegde marketingtoestemming
Geautomatiseerde e-mailmarketingNiet vermeld door TP-LinkVanaf Essentials: welkomstmail, reviewverzoek en win-back
Google-reviewverzoekenNiet vermeld door TP-LinkVanaf Essentials, verstuurd na het bezoek
Terugkerende bezoeken bijhoudenNiet vermeld door TP-LinkBezoekgeschiedenis per gast
Meerdere sitesBeheer van meerdere sites op de Omada-controllerElke locatie in één CaptiFi-account
ToestemmingsregistratieNiet vermeld door TP-LinkBewaard per gast, met de marketing-opt-in los van het online gaan

Meerdere Omada-sites beheren

Beheer je meer dan één Omada-site of locatie, dan kan elke locatie in CaptiFi een eigen ontwerp voor de inlogpagina krijgen. De instellingen per locatie staan onder My Venues in je 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. Dat staat op de abonnementenpagina in de klantdocumentatie.

Wil je alleen gasten vastleggen en naar CSV exporteren op de apparatuur die je al hebt, dan kost Lite £19.99/mnd voor één locatie. Begin met Lite.

Een captive portal op TP-Link Omada instellen met CaptiFi is één sessie in de controller en één formulier in je dashboard. Start je gratis proefperiode van 30 dagen, verbind je Omada-controller, en je gastenwifi bouwt vanaf de eerste login aan een lijst. Kom je er niet uit, mail dan naar hello@captifi.io met je type controller en de firmwareversie.

Bronnen: TP-Link, authenticatietypen voor het portal, Omada Central Essentials en Omada Software Controller; alle geraadpleegd op 28 oktober 2026. De Omada-stappen van CaptiFi volgen onze klantdocumentatie. TP-Link en Omada zijn handelsmerken van TP-Link; CaptiFi is niet verbonden aan of goedgekeurd door TP-Link.

Veelgestelde vragen

Korte antwoorden op de meest gestelde vragen over dit onderwerp.

Heb ik een RADIUS-server nodig om CaptiFi met TP-Link Omada te gebruiken?
Nee. De Omada-integratie gebruikt de instelling External Portal Server van de controller om gasten door te sturen naar de inlogpagina van CaptiFi, een pre-auth walled garden zodat die pagina kan laden, en een Omada-operatoraccount waarmee CaptiFi gasten autoriseert via de hotspot-operator-API. Onder RADIUS hoef je niets in te vullen, en er is geen shared secret om te beheren.
Werkt CaptiFi met Omada Cloud Essentials?
Nee. CaptiFi ondersteunt de gratis Essentials-versie niet, die TP-Link nu Omada Central Essentials noemt. In de functietabel van TP-Link staat bij Essentials een optie External Portal Server, maar de Omada-koppeling van CaptiFi wordt alleen ondersteund op de OC200, de OC300, de zelf gehoste softwarecontroller en de betaalde Cloud-Based Controller. Controlleradressen als xxx-omada-essential-device.tplinkcloud.com zijn Essentials. Verplaats je access points naar een OC200 of OC300, de gratis zelf gehoste softwarecontroller of de betaalde Cloud-Based Controller, of gebruik het CaptiFi-apparaat, tegen een borg die je terugkrijgt, helemaal zonder controller. Mail naar support@captifi.io als je niet zeker weet welke je hebt.
Welke Omada-controllers ondersteunt CaptiFi?
De hardwarecontrollers OC200 en OC300, de zelf gehoste softwarecontroller en de betaalde Omada Cloud-Based Controller, op firmware 5.x of hoger; WiFi 7-EAP's zoals de EAP772 en EAP773 hebben v5.15 of hoger nodig. De controller moet bereikbaar zijn vanaf internet, op poort 8043 voor de softwarecontroller of 443 voor de OC200 en OC300, dus een controller op locatie heeft meestal een port forward nodig.
Welke portal-URL vul ik in Omada in?
Zet Authentication Type op External Portal Server en vul https://app.captifi.io/guest/omada?site_id=YOUR_SITE_ID in, waarbij je YOUR_SITE_ID vervangt door de site-ID uit je CaptiFi-dashboard. Portal Customisation moet ook op External Portal Server staan en niet op het lokale webportal. De URL moet exact kloppen, en dit adres accepteert automatisch de redirectparameters van elke versie van de Omada-controller.
Wat zet ik in de walled garden van Omada?
Vier vermeldingen: app.captifi.io, het IP-adres 46.62.168.7, fonts.googleapis.com en fonts.gstatic.com. Zonder de eerste twee kan de inlogpagina niet laden; zonder de twee fonthosts laadt de pagina leeg of kapot. Omada accepteert geen wildcards zoals *.captifi.io, en de pagina heeft er ook geen nodig. Sommige Omada-firmware accepteert alleen vermeldingen op basis van een IP-adres; in dat geval houdt de vermelding 46.62.168.7 het portal bereikbaar.
Wat heeft CaptiFi nodig om verbinding te maken met mijn Omada-controller?
Een hotspot-operatoraccount, niet je beheerderslogin. Maak het aan in de controller onder Hotspot, Operators (Hotspot Manager, Operators op Omada 5). Ga daarna in je CaptiFi-dashboard naar My Venues, Add venue, kies TP-Link Omada en vul de controller-URL inclusief de poort in, de controller-ID uit de eigen URL van de controller, en de gebruikersnaam en het wachtwoord van de operator. Plak geen omada://-links uit de Omada-app; dat zijn geen controlleradressen.
Kan ik meerdere Omada-sites op één CaptiFi-account beheren?
Ja. Elke locatie kan een eigen ontwerp voor de inlogpagina krijgen, en de instellingen per locatie staan onder My Venues in je 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.
C
Geschreven door
Redactie van CaptiFi

De redactie van CaptiFi schrijft over gastenwifimarketing, captive portals, het vastleggen van gegevens volgens de AVG en lokale SEO voor ondernemers met een zaak. Als we CaptiFi met een ander platform vergelijken, gebruiken we de eigen website van dat bedrijf, met de datum waarop we die hebben geraadpleegd.

Klaar om van je gastenwifi een marketingmachine te maken?

CaptiFi legt bij elke wifi-login klantgegevens vast, automatiseert Google-reviews en opvolgmails, en sluit aan op de tools die je al gebruikt. Het CaptiFi-apparaat zit bij elk abonnement, tegen een borg die je terugkrijgt, de prijzen staan op de prijzenpagina en elk abonnement heeft een gratis proefperiode van 30 dagen.

Verder lezen