Table of Contents

APdesk - A Practical Example

Some info about our server

Item Detail
Server IP Address 198.27.111.78
Server FQDN rd01.wificity.asia
RADIUS Shared Secret testing123
SSID for Guests Bean There
SSID for Staff Bean There Staff
WPA2 Passphrase for staff stayoutbuddy

With these information handy we can now start with Bean There using APdesk


Steps involved

We will take the following steps to accomplish our goal


Create an Access Point Profile


Edit Access Point Profile

When we open an Access Point Profile to edit there are several sub-tabs where we define how our profile will behave.

Add the SSIDs

With this overview behind us we can start with our requirements. We will add the two SSIDs.

Add the Exit points

  • We assume that you created a Realm called Bean There as well as a Dynamic Login Page called Bean There initially.
  • These will be used here.

What If I don't select Auto-Add?

  • If you choose not to select the Auto-add function, you will have to add a Dynamic RADIUS client for each captive portal running on a device when you attach a device to an Access Point Profile
  • You will also have to link each captive portal running on a devices with a Dynamic Login Page.

The NAS-Id (a unique Identifier per Captive Portal exit point) is generated using the following convention.

  • Bean_There_ZA-Sandton-1_cp_27
    • The first bit is the Access Point Profile name underscored. (Bean_There)
    • The second bit is the Device name (ZA-Sandton-1)
    • The last bit is cp for Captive Portal.
    • Finally a number. This number is the Exit Point ID in the database.
    • Remember we can potentially run up to 16 Captive Portals on a single device! That's why we stick to numbers here.

Common Settings and Devices


Flash, set and point devices to our server

For the technical minded wanting to know how things work

config settings 'settings'
	option lan_up_file '/tmp/lan_up'
	option lan_down_file '/tmp/lan_down'
	option wifi_up_file '/tmp/wifi_up'
	option wifi_down_file '/tmp/wifi_down'
	option wifi_timeout '100'
	option config_file '/etc/MESHdesk/configs/current.json'
	option previous_config_file '/etc/MESHdesk/configs/previous.json'
	option heartbeat_interval '60'
	option config_server '192.168.255.20'
	option config_port '3000'
	option shared_secret 'verysecure'
	option heartbeat_dead_after '300'
	option gw_use_previous '1'
	option gw_auto_reboot '1'
	option first_run '1'
	option hardware 'dragino'
	option gw_dhcp_timeout '120'
	option gw_auto_reboot_time '600'
	option mode 'mesh'

Attach devices to the Access Point Profile


View Attached Devices