Grandstream GWN
Grandstream GWN works with Tuvorlink in two ways:
- Codes (the simplest, and the default): you make vouchers in GWN.Cloud and add them to Tuvorlink. Each customer who pays is shown one of your codes, and types it on the Grandstream login page.
- Automatic (beta): the access point sends customers to your Tuvorlink page; once they pay, Tuvorlink tells your GWN.Cloud to let their device on. No codes, but more to set up.
You can switch a hotspot between the two any time under Hotspots › Change.
Codes
- Hotspots › Add hotspot, device Grandstream GWN, connection Codes (or Change an existing hotspot to Codes). You land on its setup page, which shows exactly how to set each package's vouchers.
- In GWN.Cloud: Captive Portal › Vouchers › Add, one batch per package: Quantity, Max Devices, Duration (up to 7 days, counted from the first login) and, if the package has one, the byte limit. Grandstream enforces these, so a 1-device voucher only works on one phone.
- Captive Portal › Splash Page: a page with only Voucher as the login method; Captive Portal › Policy: a policy using that splash page, chosen on the Wi-Fi customers pay on.
- In the policy's Pre-Authentication Rules, allow
tuvorlink.com, and add a Buy Wi-Fi link to your shop page on the splash page. - Export or copy the vouchers and add them under Codes, choosing the package. We email you when a package is running low.
- Optional: paste your Wi-Fi login page's address on the setup page (Your login page address), so customers get a button straight back to it after paying.
Customers buy on your shop page, see their code (with a Copy button and how many devices it works on), can have it sent by SMS (or to someone else's number), and can find it again under Already paid? Lost your code? with the number they paid with or the number it was sent to.
Automatic login (beta)
Beta. Automatic login on Grandstream is new: tell us if a menu on your controller looks different.
What you need
- GWN access points managed in GWN.Cloud (www.gwn.cloud or eu.gwn.cloud), or a GWN Manager reachable from the internet.
- Your controller login, to turn on API access and create a portal policy.
1. Add the hotspot
In your dashboard: Hotspots › Add hotspot, device Grandstream GWN (connection: Automatic: GWN.Cloud lets each paid device on), then Grandstream setup.
2. Give Tuvorlink your API keys
- In GWN.Cloud, open the API Developer page and turn on developer mode. It shows an App ID and a Secret Key.
- On the Grandstream setup page, choose where your access points are managed, paste both, and click Save and test. You should see Connected to GWN.Cloud.
The Secret Key is stored encrypted and never shown again.
3. Point the Wi-Fi's captive portal at Tuvorlink
In GWN.Cloud (Captive Portal › Policy List, or Profiles › Portal Policy), add a policy:
| Field | Value |
|---|---|
| Splash Page | External |
| Platform | Universal Platform |
| External Splash Server Address | your hotspot's address, shown on the setup page (https://tuvorlink.com/g/…) |
| RADIUS Authentication | required by the form: see below |
| Enable HTTPS Redirection | on |
| Enable Secure Portal | on |
| Pre Authentication Rule(s) | two rules, service Web: Hostname tuvorlink.com and the IP address shown on the setup page |
RADIUS: GWN.Cloud won't save an external policy without a RADIUS profile. Create one first under Settings › Profiles › RADIUS, with the server address shown on the setup page, ports 1812 and 1813, and any secret. Tuvorlink lets devices on through the GWN.Cloud API, not through RADIUS.
Then edit your guest Wi-Fi (SSIDs or Settings › Wi-Fi): Security Open, Enable Captive Portal on, Captive Portal Policy the one you made. Under Device Membership, make sure your access points are members.
4. Test
Wait a minute for GWN.Cloud to update the access points, join the Wi-Fi with a phone and open http://neverssl.com. Your Tuvorlink page should open. The Check box on the setup page turns green when it does. Buy the cheapest package: the phone should go online by itself.
Good to know
- Packages end by time. GWN.Cloud can't apply data limits this way, so a data package ends when its validity ends.
- Time starts at first connection, and a returning device gets its remaining time back, even on another access point of the same hotspot.
- If GWN.Cloud can't be reached at the moment of payment, Tuvorlink keeps trying every minute.
Troubleshooting
| Problem | What to do |
|---|---|
| Phone has internet without paying | The policy isn't on that Wi-Fi: check Enable Captive Portal, the policy, and Device Membership. |
| No internet and no page | Check the External Splash Server Address, the two Pre Authentication Rules and HTTPS Redirection. Test with an http:// site: https sites can't be redirected. |
| "GWN.Cloud didn't accept the keys" | Copy the App ID and Secret Key again from the API Developer page, and check the region (www or eu). |