Rol CaptiFi uit bij je klanten
Stapsgewijze checklists voor UniFi, Omada, Meraki en meer. Zet je eerste klantlocatie binnen een uur live.
Drie manieren om uit te rollen
Bestaande controller
Stel CaptiFi in als extern captive portal op je bestaande UniFi-, Omada-, Meraki- of Aruba-controller.
CaptiFi-hardware
Sluit ons vooraf ingestelde apparaat aan. Het werkt op elk bestaand netwerk. Geen controller nodig. Met het CaptiFi-apparaat ben je in ongeveer 5 minuten live.
Hardware van de partner
Gebruik je eigen compatibele router of access point. Stel de doorverwijzing naar een extern portal zo in dat die naar CaptiFi wijst.
Hoofdchecklist voor de uitrol
Rond elk punt af voordat je de locatie als live markeert. Deze checklist geldt voor elke manier van uitrollen.
Bedrijfsnaam, adres, contactpersoon, e-mail, telefoon
PNG, JPG of WebP, minimaal 200×200px; een PNG of WebP met transparante achtergrond werkt het best.
Huisstijl, kleuren, inlogmethode, links naar voorwaarden en privacybeleid
UniFi, Omada, Meraki, Aruba, MikroTik, DrayTek of CaptiFi-hardware
Alleen waar CaptiFi praat met een controller die je zelf host. UniFi via een API-sleutel of via gebruikersnaam en wachtwoord, en een Omada-controller op locatie, hebben een openbaar IP-adres of een hostnaam nodig, plus een firewallregel of port forward voor HTTPS vanaf CaptiFi. Bij een Cisco Catalyst 9800- of AireOS-controller moet UDP 1700 (9800) of 3799 (AireOS) inkomend openstaan voor CaptiFi. De UniFi Remote Tunnel, de betaalde Cloud-Based Controller van Omada en Meraki hebben geen inkomende toegang nodig, en voor het CaptiFi-apparaat is geen vast IP-adres of firewallwijziging nodig.
Aparte SSID voor gasten, via een VLAN gescheiden van het bedrijfsnetwerk
Doorverwijzing naar een extern portal die naar de inlogpagina-URL van CaptiFi wijst
Verbind een telefoon of tablet met de gasten-SSID en controleer of de inlogpagina laadt
Vul het inlogformulier in en controleer of het e-mailadres en de naam in het CaptiFi-dashboard verschijnen
Na het inloggen moet de gast op internet komen of op een eigen landingspagina
De klant weet hoe het dashboard werkt, hoe gegevens worden vastgelegd en hoe support verloopt
Handleidingen per platform
Vereisten
- UniFi Network Application draait (zelf gehost of op een Cloud Gateway)
- CaptiFi kan de controller bereiken: een openbaar IP-adres met een firewallregel of port forward, of de Remote Tunnel op een UniFi OS-console, waarvoor geen inkomende poorten nodig zijn
- Gastennetwerk/SSID is al aangemaakt
Configuratiestappen
- Open in Settings → WiFi het gastennetwerk en scrol naar Hotspot Portal (in oudere versies heet dit Settings → Guest Hotspot)
- Zet Hotspot Portal op Enabled en het portaltype op External Portal Server
- Vul het portal van CaptiFi in: IPv4-adres 46.62.168.7 en domein site.app.captifi.io. Bij een koppeling via een API-sleutel of de Remote Tunnel schrijft CaptiFi deze instellingen voor je weg
- Stel Pre-Authorization Access in: voeg de CaptiFi-domeinen toe aan de walled garden
- Vink in de instellingen van de landingspagina Show Landing Page, HTTPS Redirection Support, Encrypted URL en Secure Portal aan
- Zet op het hotspotportal de eigen methoden van UniFi uit (Password, Voucher, Facebook, Payment en RADIUS): CaptiFi autoriseert gasten via de UniFi Controller API, dus RADIUS is niet nodig
- Sla op en pas toe. Verbind een testapparaat om het te controleren.
Domeinen voor de walled garden
Voeg deze toe aan de pre-authorization access:
site.app.captifi.io
app.captifi.io
fonts.googleapis.com
fonts.gstatic.com
*.captifi.io
De eerste vier zijn verplicht; de wildcard dekt alles wat CaptiFi later toevoegt, als je firmware wildcards accepteert.
Problemen oplossen
- Inlogpagina laadt niet: controleer of de CaptiFi-domeinen in de walled garden staan
- Doorverwijzing blijft rondgaan: zorg dat er maar één portal actief is (zet het ingebouwde UniFi-portal uit)
- Gast komt na het inloggen niet op internet: controleer de VLAN-routering en de firewallregels
Configuratiestappen
- Maak een open gasten-SSID aan met de optie Guest Network van Omada uit, en gebruik een apart VLAN om gasten gescheiden te houden van je eigen apparaten
- Open Network Config → Authentication → Portal (Omada 5: Settings → Authentication → Portal), klik op Create New Portal, zet het aan voor de gasten-SSID en stel Landing Page in op Original URL
- Zet op het tabblad Authentication het Authentication Type op External Portal Server met een custom portal server op basis van een URL: kies
https://en vulapp.captifi.io/guest/omada?site_id=YOUR_SITE_IDin - Zet op het tabblad Access Control de optie Pre-Authentication Access aan en voeg
app.captifi.io,46.62.168.7(IP-bereik, masker 32),fonts.googleapis.comenfonts.gstatic.comtoe. Omada accepteert geen wildcards - Voeg onder Hotspot → Operators een operatoraccount voor CaptiFi toe en vul daarna de Controller URL, de Controller ID van 32 tekens en de operatorlogin in bij de locatie op my.captifi.io
- Sla op en test met een apparaat van een gast. Met een Open API-app met de rol Admin kan CaptiFi het portal en de pre-authenticationlijst op de controller voor je instellen
Configuratiestappen
- Open Meraki Dashboard → Wireless → Configure → Splash page, kies de gasten-SSID en vul de inlogpagina-URL van CaptiFi in onder Custom splash URL, met Include the client MAC address in the splash URL ingeschakeld
- Zet in Wireless → Configure → Access control de Splash page op Click-through en de Captive portal strength op Block all access until sign-on is complete
- Schakel onder Advanced splash settings de walled garden in en voeg
app.captifi.io,site.app.captifi.io,*.captifi.io,network-auth.com,*.network-auth.com,fonts.googleapis.comenfonts.gstatic.comtoe. Zonder de twee network-auth.com-vermeldingen geeft Meraki nooit toegang - Sla de wijzigingen op. Test met een apparaat van een gast op de ingestelde SSID.
Installatiestappen
- Sluit het CaptiFi-apparaat met een ethernetkabel aan op het bestaande netwerk van de zaak en zet het aan
- Het lampje knippert geel tijdens het opstarten (30 tot 60 seconden) en brandt daarna continu paars: het apparaat wacht op activatie
- Verbind een telefoon met het netwerk "CaptiFi Setup" en vul de 8-cijferige activatiepincode van de locatie in
- Het lampje pulseert blauw terwijl het apparaat zijn configuratie ophaalt uit de CaptiFi-cloud en brandt daarna continu groen
- Verbind een telefoon met de gasten-SSID en de inlogpagina laadt vanzelf
- De hele installatie duurt van begin tot eind ongeveer vijf minuten, zonder controller, vast IP-adres of firewallwijziging
Betekenis van het lampje: knipperend geel is opstarten, continu paars is wachten op de activatiepincode, pulserend blauw is configureren, continu groen is live. Rood betekent geen internet, dus controleer de kabel naar de router.
Hulp nodig?
Support voor partners
Jij verzorgt de eerstelijnssupport voor je klanten. Mail naar partners@captifi.io om een technisch probleem door te zetten naar CaptiFi als tweedelijnssupport, en vermeld het als een locatie platligt, zodat we weten dat het dringend is.
Voordat je een probleem doorzet
- Ga na of het geen probleem met het lokale netwerk is
- Controleer de verbinding met de controller
- Test met een schoon apparaat (zonder portal in de cache)
- Stuur screenshots en logs mee
Nog geen partner?
Meld je aan voor het MSP-partnerprogramma en krijg toegang tot groothandelsprijzen, installatietools en een interne demolicentie van 6 maanden voor één interne testlocatie (alleen voor tests en demo's).
Meld je aan als partner