Filter
Top Products
Parameter Description
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 779 for more information.
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 359: 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
l Key to validate authentication request: $abcd$1234$
l Verification key is sent in cleartext format
Response from the controller
server=10.11.12.13, command=add, version=1.0, secret=$abcd$1234$sessid=
Message authentication is cleartext ($abcd$1234$)
DellPowerConnectW-SeriesArubaOS6.2 | User Guide ExternalUser Management | 788