Bulk Device Updates - Aruba WLC
PUT/pub/v4.0/device/bulkUpdate?updateSource=aruba_wlc
Update devices in your IoT Security inventory with device information that Cortex XSOAR retrieves from integrated Aruba WLAN controllers.
Request
Query Parameters
The customer ID to which the API call is directed
The source of the device information: Aruba WLAN controllers
- application/json
Body
required
- Array [
- ]
devicelist object[]required
Array of device attributes from integrated Aruba WLAN controllers
The MAC address of a wireless client on the Aruba WLAN. IoT Security uses it to link device attributes from Aruba WLAN controllers to a device in its inventory.
The wireless client IP address
The radio band that the wireless client is using (2.4 GHz or 5 GHz)
Whether the wireless client is connected or not
An attribute that a WLAN controller sends an AP indicating the SSID an authenticated wireless client should join
The service set identifier (SSID) on which the wireless client associates with the access point
The duration of the wireless client’s current connection
Whether or not authentication is required to connect to the WLAN
The method the wireless client uses to authenticate: WPA2 PSK, WPA 802.1X, WPA, WEP, open
The type of cipher the wireless client uses to encrypt communications, such as CCMP-128 (AES) or TKIP
The received signal strength (RSSI) of the wireless client’s connection
The signal-to-noise ratio (SNR) of the wireless client’s connection
The name of the access point through which the device makes a wireless connection to the network
The IP address of the access point through which the device makes a wireless connection to the network
The MAC address of the access point through which the device makes a wireless connection to the network
The radio slot ID on the access point
The access point model
The location of the device as learned from the location setting on the switch or access point to which the device connects
The country for which the device is configured to operate its radio. This affects available radio channels and power levels.
Whether the wireless client is authenticated or not
The total number of wireless clients currently associated with the AP
(Bluetooth/BLE devices) Whether the wireless client uses Bluetooth or Bluetooth Low Energy (BLE)
(BLE devices) The type of function the device is performing; for example, BLE Beacon
Whether the wireless client uses Bluetooth/BLE or not
(BLE devices) The hardware type of the device
(BLE devices) The firmware version running on the device
Responses
- 200
- 4XX
- 5XX
Successful Response
- application/json
- Schema
- Example (from schema)
- resolveSecurityAlertResponseExample
Schema
The path used to call the IoT Security API: “device/bulkupdate”
The version of the IoT Security API: “v4.0”
The code number indicating success: 1
The message indicating success: “OK”
The number of devices that IoT Security successfully updated
{
"api": "string",
"ver": "string",
"code": "string",
"message": "string",
"updatedDeviceNum": 0
}
{
"api": "device/bulkUpdate",
"ver": "v4.0",
"code": 1,
"message": "OK",
"updatedDeviceNum": 5
}
Client Error Response
- application/json
- Schema
- Example (from schema)
- Bad Request
- Forbidden access
- Too many requests
Schema
STATUS_CODE
GENERAL_MESSAGE
{
"code": "string",
"msg": "string"
}
{
"code": 400,
"msg": "Bad Request. This occurs when an HTTP request contains an invalid query string."
}
{
"code": 403,
"msg": "Forbidden access. Either the provided API key is invalid or it does not have the required RBAC permissions to run this API."
}
{
"code": 429,
"msg": "Too many requests. The number of requests for device details for a single device exceeded the rate limit of 180 queries per minute per tenant."
}
Server Error Response
- application/json
- Schema
- Example (from schema)
- resolveSecurityAlertResponseExample
Schema
STATUS_CODE
GENERAL_MESSAGE
{
"code": "string",
"msg": "string"
}
{
"code": 500,
"msg": "Internal server error. A unified status for API communication type errors."
}