Please login to access that KB Article

How does Cloudpath learn Client Mac address to store in Mac Registration List during Hotspot Redirection to Workflow URL ?

Summary

The AP/SZ redirects unauthenticated clients to Cloudpath with the client MAC appended to the portal URL, allowing Cloudpath to learn and register the device's MAC address during enrollment.

Question

How does Cloudpath learn Client Mac address to store in Mac Registration List during Hotspot Redirection to Workflow URL ?

Customer Environment

Cloudpath with SmartZone Hotspot URL

Troubleshooting Steps

N/A

Workaround

N/A

Resolution

When the client associates to the Hotspot WLAN and is unauthorized, the AP's CPD process (or the SZ Captive Portal module) intercepts the client's HTTP/HTTPS traffic and responds with a 302 redirect to the configured external portal URL (Cloudpath Workflow URL). During this redirect, the AP/SZ appends the client MAC address as a query parameter (client_mac=XX:XX:XX:XX:XX:XX) to the redirect URL, along with other attributes (UE IP, SSID, AP MAC, NBI IP, etc.). Cloudpath parses the client_mac parameter from the incoming URL to learn the client's MAC address and stores it in the MAC registration list upon successful enrollment.

Important: MAC encryption must be disabled on the SZ/WLAN (no encrypt-mac-ip) for this to work, as Cloudpath expects the MAC in clear-text format.

Following PCAP screenshot is an example of this - 

Related Articles

000010361

Article Number:
000015435

Updated:
August 04, 2026 08:07 AM (about 1 month ago)

Tags:
Troubleshooting, Cloudpath

Votes:
0

This article is:
helpful
not helpful

Working...Please wait

This is here to prevent you from accidentally submitting twice.

The page will automatically refresh.

Alert!!

Close