Owners manual
Integration with Instant
The XML API interface allows users to send specific XML commands to an IAP from an external server. These
XMLcommands can be used to customize IAP client entries. You can use the XML API interface to add, delete,
authenticate, query, or blacklist a user or a client.
The user authentication is supported only for users authenticated by Captive Portal authentication and not for the
dot1x-authentication users.
The user add operation performed by the XMLAPIinterface is only used to modify the role of an existing user and
not to create a new user.
Users can now use HTTP or HTTPS to post commands to IAP. The communication process using the
XMLAPIInterface is as follows:
l An API command is issued in XML format from the Server to the Virtual Controller.
l The Virtual Controller processes the XML request and identifies where the client is and sends the command to
the correct slave IAP.
l Once the operation is completed, Virtual Controller sends the XML response to the XML server.
l Users can use the response and take appropriate action that suit their requirements. The response from the
controller is returned using predefined formats.
Configuring an IAP for XMLAPI integration
You can configure an IAP for XMLAPI integration using the Instant UI or CLI.
In the Instant UI
1. Click More > Services. The Services window is displayed.
2. Click Network Integration. The XMLAPIServer configuration options are displayed.
Figure 93 XML API Server Configuration
3. Enter the IPaddress of the XMLAPIServer.
4. Enter the Passphrase required to authenticate and access the XMLAPIServer.
5. Re-enter the Passphrase in the Retype box.
6. Click OK.
In the CLI
To enable XMLAPI integration with the IAP:
(Instant AP)(config)# xml-api-server
(Instant AP)(xml-api-server)# ip <ip-address>
(Instant AP)(xml-api-server)# key <shared-key>
(Instant AP)(xml-api-server)# no <delete-command>
(Instant AP)(xml-api-server)# end
(Instant AP)# commit apply
Aruba Instant 6.4.0.2-4.1 | User Guide Services | 270