Presence Service

For applications like CRM tools, presence analytics, or location-aware services which need to continuously gather presence data of wireless clients, EnGenius Cloud Acess Points are capable of delivering realtime presence data to fulfill the requirement.

EnGenius Presence Service can have cloud managed APs continuously gathering 802.11 probe request frames sent by wireless clients and then sending the data to 3rd party servers configured in EnGenius Cloud.

Configuration

In EnGeniusCloud, the configuration of presence service is at

General Settings > AP > Advanced Settings

Following parameters can be configured in the page:

Parameters	Description
Server Location	3rd party server address
Key	Secret used to generate a SHA256 HMAC signature, over the payload (the JSON message). The signature is then added to a custom HTTP header (“Signature”) in the POST message.
Interval	Interval between two consecutive message been sent.

Data Format

The data sent by EnGenius Presence Services is basically in JSON format with following objects:

Object	Description
mac	MAC address of the end client device for which presence data is being reported.
node_mac	MAC address of the Access Point reporting the presence data.
min_signal	Lowest RSSI reading on the access point for the specific client within the time period specified by the First seen and Last seen timestamps.
max_signal	Highest RSSI reading on the AP for the specific client within the time period specified by the First seen and Last seen timestamps.
count	Number of times the specific end client device connected to the access point within the time period specified by the First seen and Last seen timestamps.
avg_signal	Average RSSI reading on the AP for the specific client within the time period specified by the First seen and Last seen timestamps.
first_seen	Timestamp of when the client was first seen, during the reporting period; timezone is UTC.
last_seen	Timestamp of when the client was last seen, during the reporting period; timezone is UTC.
last_seen_signal	Reported RSSI reading on the access point for when this client was last seen.
associated	Displays the association status between the client and the access point.

The server receives the data via an HTTP POST message. Access points and EnGenius Cloud services DO NOT keep any of presence data. Accordingly, if the server specified in the configuration is down or otherwise unreachable, the HTTP POST will fail, making the data inaccessible. EnGenius Cloud will not provide any notification of such failure.