Devices

From Airangel Wiki
Jump to: navigation, search

Registered Devices

Figure 1 Registered Devices Dashboard

The devices tab is used to manage all user devices that are known to the system or currently have a user account in the system. Information that can be accessed within this view includes; device MAC address, Operating System, whether the device is browser-less, any description or label currently associated with the device, the device user agent and any accounts or service tiers associated with the device (fig 4). It is also possible to manually add a device or import a .CSV list of devices.

Blocklist

Figure 2 Device Blocklist

The device blocklist is a list of all devices that have been placed onto the blocklist and are unable to authenticate onto the network. From this table you can drill down and see device information, the same as on the Registered Devices page (fig 4). Devices can be individually add to the Blocklist or bulk imported using a .CSV file.

Whitelist

Figure 3 Device Whitelist

The device whitelist is a list of all devices that have been placed onto the whitelist and are able to authenticate onto the network without viewing the Captive Portal. From this table you can drill down and see device information, the same as on the Registered Devices page (fig 4). Devices can be individually add to the Whitelist or bulk imported using a .CSV file.

Device Rules

Figure 4 Device Information
Figure 5 Device Rules & Labels Dashboard

The Device rules sub-tab is where rules and labels appended to whitelists, blocklists and devices are configured. Labels can be added to devices within the blacklist that can inform the user why they are unable to login and what the next steps are. These labels will appear in place of the portal page. Whitelisted devices can be configured to authenticate onto a service tier upon reaching the internet, labels can also display a message to whitelisted devices. Rules can be created that allow triggered actions to occur. For example, if a device is taking up to much data, it can be placed on the blocklist.

FAQs

What is a label?

Figure 6 Blocklist message setup

A label is essentially the action that will take place when a device is on the whitelist or blacklist.

How do I setup a label?

Navigate to the ‘Device Rules’ tab and click ‘Add Label’ which is located at the top left of the page. Click add label -> Create a discernible name (i.e blocklist/whitelist) -> ensure it is tagged to the brand/site that you wish the rule to take effect.

How do i send a message to Blocklisted users?

You can display a simple text message to users who have been placed on the blocklist and are unable to log on. This is achieved by navigating to the ‘Device Rules’ tab and clicking on a created blocklist label (see: How do I setup a label?). Ensure the action associated with the label is set to ‘Blocklist’ and click within the ‘Portal Message’ content box. Here you may enter the text that will appear when a device associated with the blocklist tried to login through the portal.

How do i associate a whitelist with a service tier?

Devices that are on a whitelist can bypass the usual service tiers tied to the guest WiFi and be placed on one exclusive to devices on the whitelist. Navigate to the ‘Device Rules’ tab and select your previously setup whitelist label (see: How do I setup a label?). Ensure the ‘Action’ is set to ‘Bypass Service Tier’ and then select the service tier you wish Whitelisted devices to be placed on.

How do i bulk import devices to a Blocklist/Whitelist?

You can import .CSV lists into the system to quickly add devices to a blacklist/whitelist. To do this, navigate to either the ‘Blocklist’ or ‘Whitelist’ tab and click ‘Import’. You will be presented with a modal with three boxes. These three boxes represent the columns on your .CSV, and so your .CSV should reflect these columns.

The columns are: MAC, DESCRIPTION, BROWSERLESS DEVICE (0/1).

Mac: The Mac address of the device you wish to add to the list

Description: A simple description that will be associated with the device (i.e Problem device/VIP user)

Browserless Device (0/1): Whether the device is browser-less or now. (1 = Yes | 0 = No)