Users Guide

1065| External User Management Dell Networking W-Series ArubaOS 6.5.x| User Guide
The XML API functions such as addition, deletion, authentication, blacklisting, querying, and logout have been
extended to support IPv6 users in addition to IPv4 users. However, the XML API server must be configured with an
IPv4 address for communication with the controller.
Adding a User
This XML request uses the user_add command to create a new user entry in the controllers user table. If the
user entry is already present in the user table, the command will modify the entry with the values defined in
the XML request, with an exception of IP and MAC address. Session time-out is only applicable to captive portal
users.
xml=<aruba command="user_add">
<ipaddr>IP-address_of_the_user</ipaddr>
<macaddr>MAC-address_of_the_user</macaddr>
<name>User_Name</name>
<role>Role_Name<role>
<session_timeout>Session_timeout</session_timeout>
<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_add command:
l IP Address
l MAC Address (a valid wireless or wired client on the controller)
l Key
l Authentication
l Version
Deleting a User
Do not use the user_delete command if the intention is to clear the association from the controller user table. If the
client is dual-stack, it re-inherits the authentication state from the IPv6 address. If not dual-stack, the client reverts to
the initial role.
This XML request uses the user_delete command to delete an existing user from the controllers user table.
xml=<aruba command="user_delete">
<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_delete 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.