Omada-MSP's: één gehoste captive portal voor alle klantlocaties
Een MSP met een tiental Omada-klantlocaties kan ze allemaal dezelfde gehoste inlogpagina en gastmarketing geven, en ze volgen vanuit één partnerlogin. Omada heeft daar een voorziening voor: het authenticatietype External Portal Server, dat het inloggen overdraagt aan een externe server, waar de gastenlijst en de marketing staan.
De feiten over TP-Link hieronder komen uit de supportdocumenten voor Omada, geraadpleegd op 22 oktober 2026. De instellingen staan klik voor klik op de installatiepagina voor Omada en in de handleiding voor het captive portal van TP-Link Omada.
Wat het ingebouwde portal van Omada biedt
Omada Controller heeft zeven typen portalauthenticatie, volgens de handleiding van TP-Link voor het configureren van portalauthenticatie op Omada Controller v6.2 en hoger: No Authentication, Simple Password, Hotspot, RADIUS Server, External LDAP Server, External Portal Server en Google. Je maakt per site een portal aan onder Network Config, Authentication, Portal, en het geldt voor SSID's en LAN-netwerken.
Het type Hotspot bundelt een aantal methoden die een zaak zelfstandig kan gebruiken:
- vouchers die de controller voor een vaste duur aanmaakt, en die je print en uitdeelt
- Local User, een gebruikersnaam en wachtwoord die je op de controller instelt
- SMS, een verificatiecode die naar de telefoon van de gast gaat
- RADIUS, waarbij de inloggegevens op een RADIUS-server worden gecontroleerd
- Form Auth, een vragenlijst die de beheerder opstelt en die volgens TP-Link "kan worden gebruikt om feedback van klanten te verzamelen"
Op de pagina Design pas je de achtergrond, het logo, de tekst, het formulier en de advertenties aan, en op het tabblad Access Control staat Pre-Authentication Access: de URL's of IP-bereiken die gasten kunnen bereiken voordat ze inloggen.
De instelling External Web Portal van Omada, onder Portal Customization, is makkelijk te verwarren met External Portal Server. TP-Link omschrijft die als een inlogpagina op een externe webportalserver, voor gebruik met de typen RADIUS Server en External LDAP Server. Een gehost platform zoals CaptiFi gebruikt External Portal Server, waarbij de portalserver zelf de controller opdraagt de gast online te laten gaan.
Wat in de handleiding van TP-Link het dichtst bij een gastenlijst komt is Form Auth, dat wordt aangeprezen voor het verzamelen van feedback; over marketingtoestemming, campagnes, reviewverzoeken of rapporten over terugkerende gasten staat er niets in.
De MSP-modus van Omada en de cloudabonnementen
MSP-modus is de beheerlaag van TP-Link voor een dienstverlener met veel klanten. In de handleiding voor het configureren van MSP-modus op Omada Controller v6 staat dat je er meerdere klanten mee kunt toevoegen, de realtime status van elke klant kunt volgen en accounts over al die klanten heen kunt beheren. Je zet de modus aan onder Global Settings, Controller Settings, en krijgt dan een MSP-weergave met een klantenlijst, MSP-rollen voor die weergave en Customer-rollen voor de Global- en Site-weergave van elke klant. TP-Link noemt een maximum van 100 klanten op Omada Controller v5 en 500 op v6.
Volgens dezelfde handleiding wordt MSP-modus ondersteund op de Omada Software Controller en de Cloud-Based Controller Network Only Standard Organization, en niet op Omada Central (netwerk- en bewakingssystemen) of de Cloud-Based Controller Essential. De pagina over de cloudcontroller van TP-Link zet een gratis Essentials-abonnement naast Cloud Standard, een betaalde licentie per apparaat die onder meer MSP-beheer voor meerdere klanten, geavanceerde portalauthenticatie en toegang tot de Open API toevoegt.
CaptiFi werkt met de hardwarecontrollers OC200 en OC300, de zelf gehoste softwarecontroller en de betaalde Cloud-Based Controller, en ondersteunt de gratis Central Essentials-versie van Omada niet (voorheen Cloud Essentials, hernoemd in mei 2025). In de functietabel van Essentials van TP-Link staat wel een optie External Portal Server, maar de Omada-koppeling van CaptiFi wordt op die versie niet ondersteund. De Omada-handleiding van CaptiFi is per site geschreven en behandelt MSP-modus niet apart, dus laat je eerste klantlocatie een volledige test doorlopen (doorverwijzing, inloggen, gast online, gast in het dashboard) voordat je de rest uitrolt.
Hoe CaptiFi verbinding maakt met elke Omada-site
CaptiFi maakt verbinding met elke Omada-site via een portal van het type External Portal Server, vier pre-authenticatie-items en een hotspot-operatoraccount, en elke site is een eigen CaptiFi-locatie op het account van de klant. Op de controller, per site:
- Maak een gasten-SSID aan met de beveiliging op None, de optie Guest Network van Omada uit (die voorkomt dat gasten het portaladres van de controller bereiken) en een eigen VLAN om gasten weg te houden van kassa's en kantoorcomputers.
- Maak op die SSID een portal aan met Authentication Type op External Portal Server en Custom Portal Server op URL. Kies https:// en vul app.captifi.io/guest/omada?site_id=YOUR_SITE_ID in; de installatiewizard toont dat adres met een kopieerknop. Landing Page blijft op Original URL staan.
- Zet Pre-Authentication Access aan en voeg app.captifi.io, fonts.googleapis.com en fonts.gstatic.com toe als URL-items en 46.62.168.7 als IP Range-item met masker 32. Omada accepteert geen wildcards, en de pagina heeft er ook geen nodig.
- Voeg onder Hotspot, Operators een operatoraccount voor CaptiFi toe op die site en vul daarna de Controller URL, de Controller ID van 32 tekens en de operatorlogin in bij de locatie in my.captifi.io.
Via het operatoraccount komen gasten online. Volgens de API-handleiding voor External Portal Server voor Omada Controller v6.2.10 van TP-Link logt het portal in met de inloggegevens van een hotspot-operator voordat het een client autoriseert, en die gegevens "moeten horen bij een Hotspot Operator-account dat in de Controller is aangemaakt, niet bij een beheerdersaccount van de Controller". De sessieduur stel je in op de CaptiFi-locatie, dus in Omada hoef je geen time-out in te stellen.
CaptiFi moet de controller rechtstreeks kunnen bereiken, dus een controller op locatie heeft een port forward nodig (8043 op de softwarecontroller, 443 op een OC200 of OC300), en de pagina voor externe toegang van TP-Link werkt niet als Controller URL. Bij de Starlink-abonnementen Residential en Roam blokkeert CGNAT inkomende verbindingen, dus gebruik de betaalde Cloud-Based Controller of een softwarecontroller in de cloud, of een Starlink Priority-abonnement met een openbaar IP-adres.
De Open API-route: laat CaptiFi het portal instellen
Met een Omada Open API-app met de rol Admin doet CaptiFi stap 2 en 3 voor je. De handleiding van TP-Link voor het aanmaken van een site via de Open API laat zien waar je apps aanmaakt: in de Global-weergave, Settings, Platform Integration, Open API, Add New App, waar je de app een naam geeft en de Role en Site Privilege kiest. De Client-modus wordt daar omschreven als de modus voor koppelingen tussen systemen.
Maak voor CaptiFi de app aan in Client-modus, beperk Site Privilege tot de site van de klant (de app mag maar één Omada-site zien) en plak de Client ID en het Client Secret in de Connection status van de locatie op my.captifi.io:
- Viewer toont de access points van de locatie in CaptiFi (naam, model, status, laatst gezien) en de gasten die nu verbonden zijn.
- Admin voegt de knop Set up the portal on my controller toe, die een portal met de naam CaptiFi aanmaakt of bijwerkt op de gekozen SSID en ontbrekende pre-authenticatie-items aanvult. CaptiFi kan daarmee ook de gasten-SSID hernoemen, de download- en uploadlimieten van de locatie toepassen als rate limit-profiel en de verbinding van een gast verbreken.
Open API is beschikbaar op de software- en hardwarecontrollers van Omada vanaf v5.12 en op Omada 6. Op de locatiekaart staan dan vier controles (Guest WiFi network chosen, Portal points at CaptiFi, Pre-authentication list en Guest Network setting), zodat je de portalinstellingen van elke site kunt nakijken zonder de controller te openen. Het operatoraccount aanmaken en de controller koppelen doe je nog wel zelf.
Wil een klant betaalde wifi, houd er dan rekening mee dat de snelheidsniveaus van CaptiFi alleen op UniFi worden afgedwongen. Op een Omada-locatie krijgt de gast het niveau van een pas wel te zien, maar wordt het niet toegepast, en databundels zijn best effort. Verkoop Omada-passen dus op duur.
Checklist per klantlocatie met Omada
Doorloop deze negen stappen, in deze volgorde, voor elke klantlocatie.
| Stap | Waar | Wat je instelt | Klaar als |
|---|---|---|---|
| 1. Klant en locatie | my.captifi.io, Partner, Clients | Voeg de klant toe, of een locatie bij een bestaande klant, met TP-Link Omada als wifi-hardware | De locatie heeft de status Setup Required |
| 2. Controller | Omada | OC200, OC300, softwarecontroller of betaalde Cloud-Based Controller, bereikbaar vanaf internet | De inlogpagina ervan laadt via mobiele data |
| 3. Gasten-SSID | Network Config, Network Settings, WLAN | Beveiliging None, Guest Network uit, eigen VLAN | Een testtelefoon krijgt een adres in het gasten-VLAN |
| 4. Portal | Network Config, Authentication, Portal | External Portal Server, URL, het CaptiFi-adres van de locatie | Het portal is opgeslagen op de gasten-SSID |
| 5. Pre-authenticatie | Portal, Access Control | Drie URL-items en 46.62.168.7, masker 32 | Alle vier de items zijn toegepast |
| 6. Operator | Hotspot, Operators | Een operatoraccount voor deze site | Het account is opgeslagen |
| 7. Koppelen | De locatie op my.captifi.io | Controller URL, Controller ID, operatorlogin | CaptiFi bevestigt de koppeling |
| 8. Open API (optioneel) | Global-weergave, Settings, Platform Integration, Open API | Viewer of Admin, alleen deze site | CaptiFi toont de gevonden access points en het toegangsniveau |
| 9. Testen | Een telefoon zonder portal in de cache | Verbinden, inloggen, surfen | De testgast staat in het dashboard en het setup-label is een stap verder |
Verschijnt de inlogpagina niet in stap 9, dan is een ontbrekend pre-authenticatie-item meestal de oorzaak. De handleiding over een captive portal dat niet verschijnt behandelt wat je op de telefoon controleert.
Omada-klantlocaties beheren vanuit het overzicht van alle locaties
Zodra locaties live zijn, volg je ze vanuit het CaptiFi-partnerdashboard op my.captifi.io. Een Omada-locatie staat in het overzicht van alle locaties met het controllerplatform erbij en geldt als online zodra de controller gekoppeld is. De tegel Devices online telt alleen CaptiFi-apparaten, dus beoordeel locaties met een controller op de status van hun inlogpagina, de gasten van vandaag en de laatste activiteit.
Een setup-label op elke klantregel volgt de vier stappen naar livegang (locatie aangemaakt, apparaat online, inlogpagina live, eerste gast verbonden). Daarmee is de pagina Clients je takenlijst voor installaties, en de statusmail in de ochtend meldt elke locatie die aandacht nodig heeft.
In de Omada-controller pas je voor elke klant radio's, VLAN's en firmware aan. Het overzicht van alle locaties in CaptiFi laat zien of gasten inloggen, en op de pagina Clients zie je per klant het abonnement, de groothandelsprijs, de verkoopprijs en de marge, met een groothandelsoverzicht dat op de 1e per e-mail komt. Klanten met UniFi staan in dezelfde tabel met locaties, en de handleiding voor UniFi-installateurs behandelt die kant.
Een partnermodel kiezen voor Omada-klanten
Beheer je de Omada-controller van een klant al, dan word jij als eerste gebeld als de wifi hapert. Reselling of white label past dan meestal; referral past bij een tussenpersoon die geen supportwerk wil. De MSP-handleiding over reselling en white label zet de voorwaarden van elk model uiteen, en op de pagina over het MSP-programma staat de tarievenlijst. Heeft een locatie hulp van CaptiFi nodig, dan staat in stap 10 van de MSP-checklist voor uitrol wat je naar partners@captifi.io stuurt.
Doorloop vóór de eerste klantlocatie stap 2 tot en met 9 van de checklist per locatie op een testcontroller, met de testlocatie met demolicentie van 6 maanden die je na goedkeuring krijgt, zodat de routine erin zit. Om te beginnen kun je je online aanmelden of mailen naar partners@captifi.io.
Bronnen: TP-Link Omada Support, How to Configure Portal Authentication on Omada Controller (v6.2 and Above), API and Code Samples for External Portal Server (Omada Controller v6.2.10 or Above), How to Configure MSP Mode on Omada Controller v6 en How to Create Site in Omada Controller via Open API; Omada Networks, de pagina over de cloud-based controller en het persbericht Omada Central Essentials (19 mei 2025); alles geraadpleegd op 22 oktober 2026. Omada Networks, functietabel Omada Central Essentials, geraadpleegd op 28 oktober 2026. De pagina's over het partnerprogramma en de klantdocumentatie van CaptiFi, oktober 2026. TP-Link, Omada, Starlink, UniFi en de andere productnamen hier zijn handelsmerken van hun eigenaren; CaptiFi is niet aan hen gelieerd en is niet door hen goedgekeurd.
Veelgestelde vragen
Korte antwoorden op de meest gestelde vragen over dit onderwerp.
Welke typen portalauthenticatie ondersteunt Omada Controller?
Wat is het verschil tussen External Web Portal en External Portal Server in Omada?
Welke Omada-controllers ondersteunen MSP-modus?
Waarom heeft een extern captive portal een hotspot-operatoraccount nodig op Omada?
Kan CaptiFi het Omada-portal op elke klantlocatie voor me instellen?
Welke Omada-controllers kan een CaptiFi-partner gebruiken voor klantlocaties?
Hoe houd ik veel Omada-klantlocaties in de gaten in CaptiFi?
Kan CaptiFi bandbreedtelimieten voor gasten instellen op een Omada-netwerk?
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.