Naar de hoofdinhoud
Installatiehandleiding

TP-Link Omada captive portal
Installatiehandleiding

Voeg met CaptiFi een captive portal in je eigen huisstijl toe aan je TP-Link Omada-gastenwifi: leg bij het inloggen e-mailadressen van gasten vast, automatiseer Google-reviews en laat je gastenwifimarketing vanzelf draaien. Werkt met elk EAP-access point.

📋 Zorg dat je dit hebt voordat je begint:
• Een TP-Link Omada Controller die CaptiFi via internet kan bereiken: een OC200/OC300-hardwarecontroller, de zelf gehoste softwarecontroller of de betaalde Cloud-Based Controller (de gratis Omada Cloud Essentials-versie wordt niet ondersteund, zie de FAQ hieronder)
• Een of meer EAP-access points die in de controller zijn opgenomen
• Beheerderstoegang tot de Omada Controller, met firmware 5.x of nieuwer (v5.15 of nieuwer voor wifi 7-access points zoals de EAP772 en EAP773)
• Een CaptiFi-account - maak er hier een aan
• Je CaptiFi-inlogadres, dat je met een kopieerknop vindt in de wifi-stap van de installatiewizard

Instellen in de wizard

Kies TP-Link Omada in de installatiewizard op je CaptiFi-dashboard op my.captifi.io. De wizard maakt de locatie aan en toont het portaladres, en de wifi-stap toont daaronder de verbindingscontroles: of een apparaat van een gast de inlogpagina heeft bereikt en of gasten die afronden. Zodra de controller naar CaptiFi verwijst, maak je met een telefoon verbinding met de gastenwifi en worden de controles groen.

1 Overzicht van de installatie in 4 stappen

CaptiFi instellen op TP-Link Omada kost op je eigen controller minder dan een uur. Het gaat om vier taken:

Stap 1 Maak een open gast-SSID aan in de Omada Controller.
Stap 2 Maak onder Network Config → Authentication → Portal een portal aan op de gast-SSID en stel op het tabblad Authentication External Portal Server in met je CaptiFi-adres.
Stap 3 Voeg de CaptiFi-domeinen toe aan de pre-authenticatielijst, zodat de inlogpagina laadt voordat een gast inlogt.
Stap 4 Maak in Omada onder Hotspot een operatoraccount aan en verbind de controller met CaptiFi met de Controller URL, de Controller ID en de inloggegevens van de operator.
💡 Omada blijft je wifi verzorgen. CaptiFi voegt alleen de inlogpagina in je eigen huisstijl toe, het vastleggen van e-mailadressen, de AVG-toestemming en de marketingautomatisering die daarop volgt.

2 Een gast-SSID aanmaken

Open je Omada Controller via de webinterface: het eigen IP-adres of domein van je controller plus de beheerpoort (bijvoorbeeld https://203.0.113.10:8043), of de controller-URL uit je Omada-cloudaccount als je de betaalde Cloud-Based Controller gebruikt. Dit is hetzelfde adres dat je later aan CaptiFi geeft, dus het moet vanaf internet bereikbaar zijn. Ga daarna naar Network Config → Network Settings → WLAN (Settings → Wireless Networks in Omada 5) en maak een nieuwe gast-SSID aan:

Naam Iets wat gasten herkennen, bijvoorbeeld Free WiFi
Beveiliging None (het captive portal regelt het inloggen)
Guest Network Uit. Met de optie Guest Network van Omada kunnen gasten het portaladres van de controller niet bereiken, dus laat die uit of voeg een uitzondering toe voor het adres van de controller
VLAN Wijs eventueel een gast-VLAN toe om het verkeer te scheiden van je bedrijfsnetwerk. Zo houd je gasten weg van je eigen apparaten terwijl Guest Network uit staat

3 Het externe portal instellen

Ga naar Network Config → Authentication → Portal (Settings → Authentication → Portal in Omada 5) en klik op Create New Portal. Op het tabblad Basic:

Portal Aan
SSID & Network Je nieuwe gast-SSID
Landing Page Original URL
💡 Laat het veld Portal URL op het tabblad Basic zoals het is. Dat is het eigen adres van de controller, niet dat van CaptiFi.

Op het tabblad Authentication:

Authentication Type External Portal Server
Custom Portal Server URL
Address Kies https:// in de keuzelijst en plak daarna je CaptiFi-adres zonder het deel https://, bijvoorbeeld app.captifi.io/guest/omada?site_id=YOUR_SITE_ID
Klik op Save. De sessieduur stel je in CaptiFi in en die wordt bij elke login meegestuurd, dus in Omada hoef je geen time-out in te stellen.

4 De pre-authenticatiedomeinen toevoegen

Voeg CaptiFi toe aan de pre-authenticatielijst (de walled garden van Omada), zodat de inlogpagina kan laden voordat een gast inlogt:

  • app.captifi.io
  • 46.62.168.7
  • fonts.googleapis.com
  • fonts.gstatic.com
💡 Voeg de drie hosts toe als URL-items en 46.62.168.7 als IP Range-item met subnetmasker 32, en sla dan op. Omada accepteert geen wildcards zoals *.captifi.io, en de pagina heeft er ook geen nodig.

5 De controller met CaptiFi verbinden

CaptiFi autoriseert gasten via de hotspot-operator-API van Omada en heeft daarom een eigen operator-account nodig, los van je beheerderslogin. Open in de Omada Controller je site en klik in het linkermenu op Hotspot (Omada 6 opent Hotspot Management in een nieuw tabblad; in Omada 5 heet het Hotspot Manager). Ga naar Operators en voeg een operator toe, bijvoorbeeld met gebruikersnaam captifi en een sterk wachtwoord, en selecteer je site.

Log daarna in op je CaptiFi-dashboard, ga naar My Venues → Add venue (of kies je hardware tijdens de onboarding), selecteer TP-Link Omada en vul in:

Controller URL Het adres waarop CaptiFi je controller rechtstreeks kan bereiken, inclusief de poort, bijvoorbeeld https://YOUR-PUBLIC-IP:443 voor een OC200 of OC300, of https://YOUR-PUBLIC-IP:8043 voor een softwarecontroller. Het domein van je controller werkt ook. Gebruik bij de betaalde Cloud-Based Controller de controller-URL uit je Omada-cloudaccount
Controller ID Alleen de ID van 32 tekens. Open je controller op zijn eigen adres en log in: de 32 tekens direct na de host en de poort in de adresbalk zijn de ID. Plak je het hele adres, dan bewaart CaptiFi alleen de ID
Gebruikersnaam en wachtwoord van de operator Het operatoraccount dat je net hebt aangemaakt
Klik op Connect. CaptiFi test de login en bevestigt de koppeling.
💡 Een controller op locatie heeft port forwarding nodig zodat CaptiFi hem kan bereiken: poort 8043 bij een softwarecontroller, 443 bij een OC200 of OC300. Test het van buiten je netwerk, bijvoorbeeld op een telefoon met mobiele data. De pagina voor externe toegang van TP-Link, die je browser opent op een omada-cloud.tplinkcloud.com-adres als je een controller op locatie via Omada Cloud benadert, werkt niet als Controller URL, omdat CaptiFi er niet via kan inloggen. Links uit de Omada-app die beginnen met omada:// zijn ook geen controlleradressen.

6 De oplossing testen

Verbind een telefoon met je gast-SSID. Je hoort te worden doorgestuurd naar je CaptiFi-inlogpagina in je eigen huisstijl. Vul een test-e-mailadres in, rond het inloggen af en controleer of je op internet komt.

Controleer de registratie in je CaptiFi-dashboard onder Gastbezoeken.

✅ Je captive portal van CaptiFi staat nu live op je TP-Link Omada-netwerk. Elke gast die verbinding maakt, ziet je inlogpagina in je eigen huisstijl en het e-mailadres wordt automatisch vastgelegd.
🧭 Wil je de volledige uitleg? De bloggids hieronder behandelt dezelfde stappen met screenshots, de lijst met compatibele EAP-hardware en wat CaptiFi toevoegt aan het ingebouwde Omada-portal.

CaptiFi Open API-toegang geven

Staat het portal live, dan kan CaptiFi de controller van deze locatie ook uitlezen via de Open API van Omada. Hoeveel het mag doen, hangt af van de rol die je de app geeft. Met een Viewer-app staan de access points van de locatie op de pagina Access Points van je CaptiFi-dashboard (naam, model, online of offline, laatst gezien, elke 15 minuten vernieuwd) en zie je op de pagina Connected Guests welke gasten nu verbonden zijn, elke 3 minuten vernieuwd. Met een Admin-app kan CaptiFi daarnaast de naam van de gastenwifi wijzigen, de bandbreedtelimieten van de locatie toepassen, de verbinding van een gast verbreken en het portal en de pre-authenticatielijst op de controller voor je instellen, waarmee stap 3 en 4 hierboven zijn afgedekt. Zodra gasten gaan inloggen, kan Popular Access Points onder Analytics ze ook bij naam tonen. Dit onderdeel is optioneel. Het inloggen van gasten werkt ook zonder, en de portalinstellingen en de operatorlogin die je hierboven hebt ingesteld, blijven precies zoals ze zijn.

Een Omada-beheerder maakt de app aan. Schakel in de controller over naar Global View, ga naar Settings → Platform Integration → Open API en klik op Add New App:

Naam Iets wat je later herkent, bijvoorbeeld CaptiFi
Mode Client
Role Viewer om access points en verbonden gasten te tonen, of Admin om CaptiFi ook de gastenwifi voor je te laten beheren
Site Privilege Alleen de site van deze locatie

Omada toont dan een Client ID en een Client Secret. Kopieer ze allebei, open My Venues in CaptiFi, klik op More op de kaart van de locatie, dan op Connection status, en klik op Add Open API access in de rij Access points. Save controleert het paar bij je controller, vertelt hoeveel access points er zijn gevonden en toont het gevonden toegangsniveau, Viewer of Admin. Zit je nog in de installatiewizard? De stap Connect your Omada controller heeft dezelfde twee velden onder List your access points in CaptiFi (optional), dus je kunt het daar doen en de kaart overslaan. Later staat er Update op de knop en heeft het formulier een optie Remove.

💡 Begonnen met de rol Viewer en wil je de rest ook? Maak de app opnieuw aan met de rol Admin, of wijzig de rol in Omada, en plak de nieuwe Client ID en het nieuwe Client Secret in hetzelfde formulier. De app moet precies één Omada-site kunnen zien, die van deze locatie. Ziet de app er geen, of meerdere, dan meldt CaptiFi dat en vraagt het je om de Site Privilege te beperken tot de site van de locatie. Een verkeerde Client ID of een verkeerd Secret, of een controller die CaptiFi niet kan bereiken, wordt in gewone taal gemeld. Het secret wordt na het opslaan niet meer getoond. Open API zit op software- en hardwarecontrollers van Omada vanaf v5.12 en op Omada 6; de gratis Cloud Essentials-versie wordt door CaptiFi helemaal niet ondersteund (zie de FAQ hieronder).

Laat CaptiFi het portal instellen

Is de app opgeslagen, dan krijgt Connection status op de kaart van de locatie een rij WiFi network. Kies welke SSID van de controller het gastennetwerk is; de keuzelijst markeert elke SSID waarvan de instelling Guest Network aan staat. Onder de rijen met gastactiviteit staan dan vier controles van de controller: Guest WiFi network chosen, Portal points at CaptiFi, Pre-authentication list (die noemt welke van de vier items ontbreken) en Guest Network setting. De laatste waarschuwt als de optie Guest Network van Omada aan staat op de gekozen SSID, omdat gasten door die optie het portaladres van de controller niet kunnen bereiken. Vink de optie uit op de SSID of voeg een uitzondering toe voor het adres van de controller.

Met een Admin-app en een gekozen SSID maakt de knop Set up the portal on my controller op die SSID een portal met de naam CaptiFi aan of werkt hij dat bij, met Authentication Type External Portal Server dat naar het CaptiFi-adres van de locatie verwijst. De knop voegt ook ontbrekende pre-authenticatie-items toe, past de bandbreedtelimiet toe als die is ingesteld en meldt wat er is gedaan. In de installatiewizard biedt de wifi-stap hetzelfde aan als Set up the portal for me, met dezelfde controles eronder, en de handmatige instructies blijven op de pagina staan.

Werkt met je bestaande Omada-apparatuur, of gebruik ons apparaat, dat is inbegrepen

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 Omada-apparatuur Gebruik je al EAP-access points van TP-Link en een Omada Controller, volg dan de stappen hierboven. CaptiFi staat ervoor als extern portal. Geen extra hardware.
Gebruik ons inbegrepen plug-and-play-apparaat Geen Omada-controller, of kom je er liever niet aan? We sturen je een vooraf ingesteld CaptiFi-apparaat. Sluit het met een ethernetkabel aan op je bestaande netwerk, vul op je telefoon de activatiepincode van 8 cijfers in en het haalt zijn configuratie uit de cloud. De gastenwifi staat van begin tot eind in ongeveer vijf minuten live, zonder controller, vast IP-adres of wijziging in de firewall.
💡 Het plug-and-play-apparaat is het alternatief zonder configuratie. In beide gevallen hetzelfde marketingplatform.

Lite: £19.99 per maand op je eigen netwerk

Gebruik je al TP-Link Omada? Lite is gasten vastleggen en CSV-export op de access points die je hebt, 500 nieuwe gasten per maand, voor één locatie. Op de inlogpagina blijft de CaptiFi-branding staan.

Verwante handleidingen en pagina's

FAQ over het TP-Link Omada captive portal

Werkt CaptiFi met de gratis Omada Software Controller?

Ja. CaptiFi werkt met de hardwarecontrollers OC200 en OC300, de gratis zelf gehoste softwarecontroller en de betaalde Cloud-Based Controller: elke controller die CaptiFi rechtstreeks via HTTPS kan bereiken.

Werkt CaptiFi met Omada Cloud Essentials?

Nee, CaptiFi ondersteunt de gratis Essentials-versie niet (TP-Link noemt die nu Omada Central Essentials). In de functietabel van TP-Link voor Essentials staat wel 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 van TP-Link. Worden je access points beheerd door Essentials, zet ze dan over naar de gratis zelf gehoste softwarecontroller (of een OC200), stap over op de betaalde Cloud-Based Controller van TP-Link, of sla de controller helemaal over met een CaptiFi Plug & Play-apparaat, tegen een borg die je terugkrijgt. Mail naar hello@captifi.io en we helpen je kiezen.

Welke EAP-access points ondersteunt CaptiFi?

CaptiFi werkt met de hele EAP-serie, waaronder de EAP225, EAP245, EAP660 HD, EAP670 en de buitenmodellen EAP610 en EAP225. De portalinstellingen zijn voor de hele serie hetzelfde.

De wifi 7-plafondmodellen BE9300, de EAP772 en EAP773, werken op dezelfde manier, met twee beperkingen. Ze hebben Omada Controller v5.15 of nieuwer nodig en moeten door een controller worden beheerd, omdat CaptiFi via de controller verbinding maakt. (In de standalone-modus staat TP-Link een extern webportal alleen toe met External RADIUS Server-authenticatie.) Hun 6 GHz-band staat geen open netwerken toe, dus zet de gast-SSID op 2.4 GHz en 5 GHz en houd 6 GHz voor een privé-SSID voor personeel, tenzij je Enhanced Open (OWE) instelt. Bij een Starlink-verbinding blokkeert CGNAT inkomende verbindingen naar een controller op locatie, dus gebruik dan de Omada Cloud-Based Controller of een softwarecontroller die in de cloud wordt gehost.

Toont CaptiFi mijn Omada-access points?

Ja, zodra je het Open API-toegang geeft. Een Omada-beheerder opent Global View, dan Settings, Platform Integration, Open API, en klikt op Add New App: een naam zoals CaptiFi, de modus Client, de rol Viewer of Admin, en Site Privilege beperkt tot de site van de locatie. Open daarna My Venues, klik op More op de kaart van de locatie, dan op Connection status, klik op Add Open API access in de rij Access points en plak de Client ID en het Client Secret erin, of gebruik het optionele onderdeel over access points in de installatiewizard. CaptiFi controleert ze bij je controller, vertelt hoeveel access points het heeft gevonden en welk toegangsniveau de app heeft, en toont ze vanaf dan op de pagina Access Points met naam, model, status en laatst gezien, elke 15 minuten vernieuwd. Kan de app geen site zien, of meer dan één, dan vraagt CaptiFi je de Site Privilege te beperken tot de site van de locatie. Open API vraagt om een software- of hardwarecontroller op v5.12 of nieuwer, of Omada 6; de gratis Cloud Essentials-versie wordt niet ondersteund.

Kan CaptiFi het Omada-portal voor mij instellen?

Ja, als de Open API-app de rol Admin heeft. Sla de app op de kaart van de locatie op en kies dan het gastennetwerk in de rij WiFi network van de Connection status (de keuzelijst markeert een SSID waarvan de instelling Guest Network aan staat). Klik op Set up the portal on my controller en CaptiFi maakt op die SSID een portal met de naam CaptiFi aan of werkt het bij, zet het Authentication Type op External Portal Server dat naar het CaptiFi-adres van de locatie verwijst, voegt de items toe die van de vier pre-authenticatie-items ontbreken, past je bandbreedtelimiet toe als die is ingesteld en meldt wat er is gedaan. De vier controles onder de rijen met gastactiviteit (Guest WiFi network chosen, Portal points at CaptiFi, Pre-authentication list en Guest Network setting) laten bij beide rollen zien hoe het ervoor staat, en de laatste waarschuwt als de optie Guest Network van Omada aan staat op de gekozen SSID, omdat gasten door die optie het portaladres van de controller niet kunnen bereiken. Vink de optie uit op de SSID of voeg een uitzondering toe voor het adres van de controller. In de installatiewizard geeft een Admin-app de wifi-stap een knop Set up the portal for me met dezelfde controles, en de handmatige stappen blijven op de pagina staan.

Kan CaptiFi op Omada mijn wifi-naam wijzigen of bandbreedtelimieten instellen?

Ja, met een Open API-app met de rol Admin en een gekozen gastenwifinetwerk. Wijzig de wifi-naam bij de locatie, in Edit venue of als geplande wijziging van de wifi-naam in de Planner, en CaptiFi hernoemt de SSID op je controller. De download- en uploadlimieten van de locatie worden op de controller toegepast als een rate-limitprofiel met de naam CaptiFi guest limit, dat aan de gast-SSID wordt gekoppeld en er weer af gaat als je de limiet uitschakelt. Met een Viewer-app blijft de naam een label op je inlogpagina en QR-code, worden limieten op Omada niet afgedwongen en legt het dashboard uit waarom. De pagina Connected Guests toont de gasten op de controller, elke 3 minuten vernieuwd, en Disconnect is beschikbaar als de app Admin is. Block en Extend zijn op Omada nog niet beschikbaar.

Waarom laadt mijn Omada-inlogpagina niet?

Bijna altijd ontbreekt er een CaptiFi-domein in de pre-authenticatielijst. Controleer of alle vier de domeinen aan het portalbeleid zijn toegevoegd en of je hebt opgeslagen. Test op een apparaat dat geen eerder portal in de cache heeft.

Moet ik mijn bestaande Omada-installatie aanpassen?

Nee. Je voegt één open gast-SSID toe en stelt daarop het externe portal in. Je bestaande bedrijfs- en personeelsnetwerken blijven ongemoeid.

Maakt CaptiFi mijn Omada-wifi trager?

Nee. CaptiFi verzorgt alleen de inlogpagina. Is een gast eenmaal binnen, dan loopt het verkeer gewoon rechtstreeks over je Omada-netwerk.

Voldoet het vastleggen van e-mailadressen op Omada-gastenwifi met CaptiFi aan de AVG?

CaptiFi vraagt toestemming voor marketing los van de toegang tot internet en legt het antwoord van elke gast vast, en gasten die weigeren komen toch op je Omada-wifi. Elke marketingmail bevat een afmeldlink, met Verwijderen (AVG) en Anonimiseren (AVG) op de pagina Guest Visits handel je verwijderverzoeken af, en de verwerkersovereenkomst van CaptiFi is gepubliceerd. Jouw zaak is de verwerkingsverantwoordelijke, dus de naleving zelf blijft bij jou.

De gegevens over TP-Link komen uit Omada Central Essentials en de FAQ van TP-Link over externe portals voor EAP's, beide geraadpleegd op 28 oktober 2026. Omada en TP-Link zijn handelsmerken van TP-Link; CaptiFi is niet aan TP-Link verbonden en niet door TP-Link goedgekeurd.

Maak van je Omada-gastenwifi een marketingmachine

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

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