Contents

WLAN probe· 1

About WLAN probe· 1

WLAN probe system·· 1

Working mechanism·· 1

WLAN probe tasks at a glance· 1

Enabling WLAN probe· 2

Specifying a server to receive wireless device information· 2

About specifying a server to receive wireless device information· 2

Specifying an HTTPS server 2

Specifying a UDP server 3

Enabling real-time reporting of wireless device information to the UDP server 4

Setting the coordinates and timezone offset for a sensor 4

Configuring advanced WLAN probe features· 4

Configuring the MAC address filtering list 4

Setting the RSSI threshold for clients or APs· 5

Reporting information about Apple terminals that use a random MAC address· 5

Setting the RSSI difference threshold for wireless device detection· 5

Setting device entry timers· 6

Reporting wireless device information to the cloud platform·· 6

Configuring a sensor to report the MAC address of the auditing device· 7

Verifying and maintaining WLAN probe· 7

Displaying sensor statistics· 7

Clearing sensor statistics· 7

WLAN probe configuration examples· 8

Example: Configuring WLAN probe· 8

 

WLAN probe

About WLAN probe

WLAN probe enables APs to monitor the WLAN and collect information about wireless devices in the WLAN. Then, the APs send the collected information to the specified server for further analysis.

WLAN probe system

As shown in Figure 1, a WLAN probe system contains the following devices:

·     Sensors—APs enabled with WLAN probe. They scan the channels, collect wireless device information, and report the information to the server.

·     AC—Manages sensors and reports information received from sensors to the server.

·     Server—Analyzes the information received from sensors and the AC.

Figure 1 WLAN probe system

‌

Working mechanism

A WLAN probe system operates as follows:

1.     Wireless devices send 802.11 packets.

2.     Sensors collect wireless device information, such as MAC address, device type, RSSI, and time stamp from the packets.

3.     Sensors send collected device information to the AC or server.

4.     The server analyzes the received information.

WLAN probe tasks at a glance

To configure WLAN probe, perform the following tasks:

1.     Enabling WLAN probe

2.     Specifying a server to receive wireless device information

¡     Specifying an HTTPS server

¡     Specifying a UDP server

3.     (Optional.) Enabling real-time reporting of wireless device information to the UDP server

4.     (Optional.) Setting the coordinates and timezone offset for a sensor

5.     (Optional.) Configuring advanced WLAN probe features

¡     Configuring the MAC address filtering list

¡     Setting the RSSI threshold for clients or APs

¡     Reporting information about Apple terminals that use a random MAC address

¡     Setting the RSSI difference threshold for wireless device detection

6.     (Optional.) Setting device entry timers

7.     (Optional.) Reporting wireless device information to the cloud platform

8.     (Optional.) Configuring a sensor to report the MAC address of the auditing device

Enabling WLAN probe

1.     Enter system view.

system-view

2.     Enter AP view or an AP group's AP model view.

¡     Enter AP view.

wlan ap ap-name

¡     Execute the following commands in sequence to enter an AP group's AP model view:

wlan ap-group group-name

ap-model ap-model

3.     Enter radio view.

radio radio-id

4.     Enable WLAN probe.

client-proximity-sensor enable

By default:

¡     In radio view, a radio uses the configuration in an AP group's radio view.

¡     In an AP group's radio view, WLAN probe is disabled.

Specifying a server to receive wireless device information

About specifying a server to receive wireless device information

Perform this task to specify a server for a sensor or the AC to report wireless device information.

Specifying an HTTPS server

1.     Enter system view.

system-view

2.     Specify an HTTPS server to receive wireless device information.

client-proximity-sensor server string [ window-time window-time-value | partner partner-value ] *

By default, no HTTPS server is specified.

3.     Enable sensors to report information about detected devices to the AC.

client-proximity-sensor report-ac enable

By default, sensors do not report information about detected devices to the AC.

4.     (Optional.) Set the interval at which sensors report information about detected devices to the AC.

client-proximity-sensor report-ac-interval interval

By default, sensors report information about detected devices to the AC every 10 seconds.

Specifying a UDP server

About this task

A sensor can report wireless device information to the UDP server directly or through the AC.

Specifying a UDP server for the AC

1.     Enter system view.

system-view

2.     Specify a UDP server to receive wireless device information from the AC.

client-proximity-sensor udp-server ip-address port port-number [ interval interval | preshared-key [ cipher | simple ] key-string ] *

By default, no UDP server is specified.

3.     Enable sensors to report information about detected devices to the AC.

client-proximity-sensor report-ac enable

By default, sensors do not report information about detected devices to the AC.

4.     (Optional.) Set the interval at which sensors report information about detected devices to the AC.

client-proximity-sensor report-ac-interval interval

By default, sensors report information about detected devices to the AC every 10 seconds.

5.     (Optional.) Enable reporting of AP information to the UDP server.

client-proximity-sensor report-ap enable

By default, AP information is not reported to the UDP server.

Specifying a UDP server for a sensor

1.     Enter system view.

system-view

2.     Enter AP view.

wlan ap ap-name

3.     Specify a UDP server to receive wireless device information from the sensor.

client-proximity-sensor ap-udp-server ip-address port port-number [ interval interval | preshared-key [ cipher | simple ] key-string ] *

By default, no UDP server is specified.

4.     (Optional.) Enable reporting of AP information to the UDP server.

quit

client-proximity-sensor report-ap enable

By default, AP information is not reported to the UDP server.

Enabling real-time reporting of wireless device information to the UDP server

About this task

After you enable this feature, the device information is reported to the UDP server in real time, rather than at the specified intervals.

Procedure

1.     Enter system view.

system-view

2.     Enable real-time reporting of wireless device information to the UDP server.

client-proximity-sensor rt-report enable

By default, real-time reporting of wireless device information to the UDP server is disabled.

Setting the coordinates and timezone offset for a sensor

About this task

Perform this task to enable a sensor to report the coordinate and timezone offset information together with the information about detected wireless devices.

Procedure

1.     Enter system view.

system-view

2.     Enter AP view.

wlan ap ap-name

3.     Set the longitude and latitude of the sensor.

client-proximity-sensor coordinates longitude longitude-value latitude latitude-value

By default, the longitude and latitude are not set.

4.     Set the timezone offset between the AC and the sensor.

client-proximity-sensor timezone-offset { add | minus } timevalue

By default, the timezone offset between the AC and the sensor is not set.

Configuring advanced WLAN probe features

Configuring the MAC address filtering list

About this task

Perform this task to configure the AC to not report information about devices in the MAC address filtering list to the server.

Procedure

1.     Enter system view.

system-view

2.     Configure the MAC address filtering list.

client-proximity-sensor filter-list list

By default, the MAC address filtering list is not configured.

Setting the RSSI threshold for clients or APs

About this task

Sensors do not ignore any wireless devices by default. Perform this task to configure sensors to ignore wireless devices with an RSSI lower than the specified RSSI threshold.

Procedure

1.     Enter system view.

system-view

2.     Set the RSSI threshold for APs or clients.

client-proximity-sensor rssi-threshold { ap ap-rssi-value | client client-rssi-value }

By default, the RSSI thresholds for clients and APs are not set.

Reporting information about Apple terminals that use a random MAC address

About this task

Apple terminals send probe requests by using a random MAC address whose second bit in the first byte is 1 and cause sensors to detect non-existent wireless devices. Enable or disable this feature as appropriate.

Procedure

1.     Enter system view.

system-view

2.     Enable reporting of information about Apple terminals that use a random MAC address

client-proximity-sensor random-mac-report enable

By default, information about Apple terminals that use a random MAC address is not reported.

Setting the RSSI difference threshold for wireless device detection

About this task

A sensor does not update information about a wireless device when the following conditions are met:

·     The wireless device has been detected before.

·     The RSSI difference of the wireless device between the most recent two detections has not reached the specified threshold.

Procedure

1.     Enter system view.

system-view

2.     Set the RSSI difference threshold for wireless device detection.

client-proximity-sensor rssi-change-threshold threshold-value

By default, the RSSI difference threshold for wireless device detection is 100.

Setting device entry timers

About this task

Perform this task to set the inactivity timer and aging timer for AP and client entries. After the inactivity timer of an entry expires, the entry enters inactive status. After the aging timer of an entry expires, the entry is deleted.

Restrictions and guidelines

The aging time must be at least twice the inactive time. As a best practice, use the default inactive time and aging time.

Errors might exist in the time changes of entries, and the error value depends on the interval at which sensors report information about detected devices.

Procedure

1.     Enter system view.

system-view

2.     Set the AP entry timers.

client-proximity-sensor ap-timer inactive inactive-value aging aging-value

By default, the inactive time and aging time for AP entries are 300 seconds and 600 seconds, respectively.

3.     Set the client entry timers.

client-proximity-sensor client-timer inactive inactive-value aging aging-value

By default, the inactive time and aging time for client entries are 300 seconds and 600 seconds, respectively.

Reporting wireless device information to the cloud platform

About this task

Perform this task to enable reporting of wireless device information to the cloud platform.

Procedure

1.     Enter system view.

system-view

2.     Enable reporting of wireless device information to the cloud platform.

undo client-proximity-sensor report-oasis disable

By default, wireless device information is not reported to the cloud platform.

3.     (Optional.) Set the report interval and the number of client entries sent to the cloud platform in each report

client-proximity-sensor report-oasis client interval interval number number

By default, 10 client entries are reported to the cloud platform every 1000 milliseconds.

4.     (Optional.) Set the RSSI difference threshold for reporting client information to the cloud platform.

client-proximity-sensor report-oasis rssi-change-threshold threshold-value

By default, the RSSI difference threshold is 50.

Configuring a sensor to report the MAC address of the auditing device

About this task

After you specify an auditing device for a sensor, the sensor will report the collected wireless device information and the MAC address of the auditing device to a server.

Restrictions and guidelines

If a server requires the MAC addresses of auditing devices, you must specify an auditing device for each sensor. Thus, the server can distinguish the received wireless device information by the auditing device.

Procedure

1.     Enter system view.

system-view

2.     Enter AP view.

wlan ap ap-name

3.     Configure the AP to report the auditing device MAC address to a server.

client-proximity-sensor audit-mac-address mac-address

By default, a sensor does not report the auditing device MAC address to a server.

Verifying and maintaining WLAN probe

Displaying sensor statistics

Perform display tasks in any view.

·     Display information about wireless devices detected by sensors.

display client-proximity-sensor device [ ap | client | mac-address mac-address ] [ verbose ]

·     Display information about sensors.

display client-proximity-sensor sensor

·     Display information received from sensors.

display client-proximity-sensor statistics receive

Clearing sensor statistics

Perform clear tasks in user view.

·     Clear wireless device information.

reset client-proximity-sensor device { ap | client | mac-address mac-address | all }

·     Clear information received from sensors.

reset client-proximity-sensor statistics receive

WLAN probe configuration examples

Example: Configuring WLAN probe

Network configuration

As shown in Figure 2, AP 1 and AP 2 provide wireless services for clients through SSID abc.

Enable WLAN probe on the sensor, and configure the AC to report the received wireless device information to the server.

Figure 2 Network diagram

‌

Procedure

# Configure wireless service settings on the AC. (Details not shown.)

For more information, see "Configuring WLAN access."

# Create AP Sensor, and enable WLAN probe for the AP.

<AC> system-view

[AC] wlan ap Sensor model WA6320

[AC-wlan-ap-Sensor] serial-id 219801A28N819CE0002T

[AC-wlan-ap-Sensor] radio 1

[AC-wlan-ap-Sensor-radio-1] radio enable

[AC-wlan-ap-Sensor-radio-1] client-proximity-sensor enable

[AC-wlan-ap-Sensor-radio-1] quit

[AC-wlan-ap-Sensor] radio 2

[AC-wlan-ap-Sensor-radio-2] radio enable

[AC-wlan-ap-Sensor-radio-2] client-proximity-sensor enable

[AC-wlan-ap-Sensor-radio-1] quit

[AC-wlan-ap-Sensor] quit

# Configure the sensor to report wireless device information to the AC.

[AC] client-proximity-sensor report-ac enable

# Configure the AC to report wireless device information to the UDP server with IP address 192.168.1.123 and port number 1234, and set the report interval to 20 seconds.

[AC] client-proximity-sensor udp-server 192.168.1.123 port 1234 interval 20

Verifying the configuration

# Display wireless device information detected by the sensor.

[AC] display client-proximity-sensor device

Total 3 detected devices

 

MAC address    Type      Duration    Sensors Channel Status

0021-632F-E9E5 Client    00h 10m 46s 1       11      Active

0021-6330-148B Client    00h 10m 46s 1       6       Active

0212-34B8-A8E0 Client    00h 10m 46s 1       1       Active

# On the management console of the server, view the wireless device information received from the AC. (Details not shown.)