Devices

Always point UniFi’s captive portal at this client’s host — https://{slug}.wifi.sostech.app (no trailing slash). Never put the guest’s final website in UniFi.

In UniFi, set the success / landing / post-auth redirect field to this URL only. It never changes per client destination. Where guests go afterward is controlled in this app under Branding → After approval — redirect URL (HTTP 302).

UniFi rejects hostnames in the External Portal Server field. Enter the public A record IPv4 for this client’s host (DNS-only / grey-cloud so UniFi gets a real address). Portal and success paths still use the hostnames from steps 1–2.

• Or resolve yourself: dig +short A {slug}.wifi.sostech.app
• In UniFi: Settings → Hotspot → External portal server — enter one IPv4 from above

In UniFi Network: Settings → WiFi / Hotspot → Hotspot Portal (wording varies by version).

• Enable the captive / Hotspot portal for the guest WLAN
• Choose External portal server (not the built-in landing page)
• Server = IPv4 from step 3
• Captive / portal URL = exact FQDN from step 1 (no trailing slash)
• Success / landing / redirect URL (if UniFi shows a separate field) = fixed URL from step 2 (https://{slug}.wifi.sostech.app/redirect) — never the hotel site or Google

Guests must reach the portal before they’re authorized.

• Allow this client’s hostname {slug}.wifi.sostech.app (HTTPS) — prefer hostname allowlist, not only the IP
• Allow DNS resolution for that host if your policy blocks DNS until authorize
• Confirm the guest SSID uses this Hotspot profile

• Use a dedicated guest WLAN (isolation / guest policy on)
• Site name is usually default unless you renamed the UniFi site
• Integration site id (UUID) is preferred for authorize; find it via Integrations API or Site Manager

Site Manager / api.ui.com connector: unifi.ui.com → Settings → API Keys — key must include this console (Network / full scopes). Direct console URL: Network → Settings → Control Plane → Integrations. A local UDM Integration key will not work on api.ui.com. Then paste host + key below and Test connection. Site id is optional.