User's Manual

Parameter Description
script_name
The name of the script executable.
Options
l -i <ip_addr>—Specify the client’s IP address.
l -m <mac_addr>—Specify the client’s MAC address.
l -n <name>—Specify the client’s user name.
l -p <passwd>—Specify the client password.
l -r role—Specify the current user role of the client.
l -t timeout—User session timeout.
l -v version—API version number. Default is 1.0
l -a method—Specify the encryption method to send the secret key. You can specify
MD5 or SHA-1 or cleartext as the encryption method. By default, cleartext method is
used to send the key.
l -s sessid—Active session Id
controller-ip
The IP address of the controller that will receive the authentication requests.
command The authentication command sent to the controller. You can send one of the following
commands per request:
l add: Adds the client to your network.
l delete: Deletes the client from your network
l query: Fetches information about the client
l blacklist: Blacklists or block the client from connecting to your network
l authenticate: Authenticates the client and assigns the default authenticated role.
secret_key
The password used to validate the authentication request from your authentication
server. See Configuring the XML API Server on page 1024 for more information.
Table 227: XML API Request Parameters and Descriptions
Understanding XMl API Response
The response message from the controller is sent in an XML format. The default format of the response is:
[Message header]
Displays the request parameters and other standard header details.
..
...
..
<response>
<status>Status Message</status>
<code>Code in case of an error</code>
</response>
Adding a Client
This command will add a client on your network.
Figure 244 Adding a client—request and response
john@linux:/home/john/tools/xml-api# ./auth -i 10.10.10.249 -m 00:19:d2:01:0b:aa -r logon
10.11.12.13 add $abcd$1234$
The commands sends the following information in the authentication request to the controller:
l Client IP address: 10.10.10.249
l Client MAC address: 00:19:d2:01:0b:aa
l Authentication server IP address: 10.11.12.13
l Authentication command: add
Dell Networking W-Series ArubaOS 6.4.x | User Guide External User Management | 1033