Users Guide

1067| External User Management Dell Networking W-Series ArubaOS 6.5.x| User Guide
Querying for User Status
This XML request uses the user_query command to get the status and details of a user connected to your
network. A dual-stack client can be queried by any of its IPv4 or IPv6 addresses, but only the queried IP
address is displayed in the output.
xml=<aruba command="user_query">
<ipaddr>IP-address_of_the_user</ipaddr>
<macaddr>MAC-address_of_the_user</macaddr>
<name>User_Name</name>
<key>Shared_Key</key>
<authentication>MD5|SHA-1|cleartext</authentication>
<version>1.0</version>
</aruba>
The following options are mandatory when you execute the user_query command:
l IP Address
l Key
l Authentication
l Version
Passing the MAC address or username serves only to perform additional validation against the mandatory IP
address. For example, if the IP address is 1.2.3.4 and the MAC address passed is 00:11:22:33:44:55 but the real MAC
address is 66:77:88:99:aa:bb then the XML request will fail with response code 1, "unknown user" message.
Logging Out a User
This XML request uses the user_logout command to revert the user to the initial role. This is only applicable to
captive portal users. For dual-stack clients, all user-table entries will be reverted to the initial role.
xml=<aruba command="user_logout">
<ipaddr>IP-address_of_the_user</ipaddr>
<macaddr>MAC-address_of_the_user</macaddr>
<name>User_Name</name>
<key>Shared_Key</key>
<authentication>MD5|SHA-1|cleartext</authentication>
<version>1.0</version>
</aruba>
The following options are mandatory when you execute the user_logout command:
l IP Address
l Key
l Authentication
l Version
XML Response
For every successful XML request the controller will return the processed information as an XML response.
There are two types of responses: Default response and Query response.
Default Response Format
The format of a default XML response from the controller is:
<aruba>
<status>Ok | Error</status>
<code>response_code</code>
<reason>response_message</reason>