Skip to main content

Bulk Device Updates - Cisco WLC​

Update devices in your IoT Security inventory with device information that Cortex XSOAR retrieves from integrated Cisco WLAN controllers.

Query Parameters
  • customerid string required

    The customer ID to which the API call is directed

  • updateSource string required

    The source of the device information: Cisco WLAN controllers

Request Body required
  • devicelist object[] required

    Array of device attributes from integrated Cisco WLAN controllers

  • Array [
  • macAddress string

    The MAC address of a wireless client on the Cisco WLAN. IoT Security uses it to link device attributes from Cisco WLAN controllers to a device in its inventory.

  • ipAddress string

    The wireless client IP address

  • radio string

    The radio band that the wireless client is using (2.4 GHz or 5 GHz)

  • connectionState string

    Whether the wireless client is connected or not

  • wlanId string

    An attribute that a WLAN controller sends an AP indicating the SSID an authenticated wireless client should join

  • SSID string

    The service set identifier (SSID) on which the wireless client associates with the access point

  • connectedDuration string

    The duration of the wireless client’s current connection

  • authentication string

    Whether or not authentication is required to connect to the WLAN

  • status string

    Whether the wireless client is authenticated or not

  • authMethod string

    The method the wireless client uses to authenticate: WPA2 PSK, WPA 802.1X, WPA, WEP, open

  • encryptionCipher string

    The type of cipher the wireless client uses to encrypt communications, such as CCMP-128 (AES) or TKIP

  • rssi string

    The received signal strength (RSSI) of the wireless client’s connection

  • snr string

    The signal-to-noise ratio (SNR) of the wireless client’s connection

  • apName string

    The name of the access point through which the device makes a wireless connection to the network

  • apIPAddress string

    The IP address of the access point through which the device makes a wireless connection to the network

  • apMacAddress string

    The MAC address of the access point through which the device makes a wireless connection to the network

  • apRadioSlotId string

    The radio slot ID on the access point

  • apModel string

    The access point model

  • location string

    The location of the device as learned from the location setting on the Cisco switch or access point to which the device connects

  • country string

    The country for which the device is configured to operate its radio. This affects available radio channels and power levels.

  • BSSID string

    The MAC address of the wireless interface on which the AP hosts the SSID

  • apencryptionCipher string

    The set of encryption ciphers for which the AP broadcasts support in its beacons

  • bluetoothType string

    (Bluetooth/BLE devices) Whether the wireless client uses Bluetooth or Bluetooth Low Energy (BLE)

  • bluetoothDeviceType string

    (Bluetooth/BLE devices) The type of function the device is performing; for example, BLE Beacon

  • frequency string

    (Bluetooth/BLE devices) The radio frequency on which the Bluetooth or BLE client is communicating with the AP: 2.4 GHz

  • channel string

    (Bluetooth/BLE devices) The radio channel on which the Bluetooth or BLE client is communicating with the AP

  • isBluetooth boolean

    Whether the wireless client uses Bluetooth/BLE or not

  • ]
Responses

Successful Response

Schema
  • api string

    The path used to call the IoT Security API: “device/bulkupdate”

  • ver string

    The version of the IoT Security API: “v4.0”

  • code string

    The code number indicating success: 1

  • message string

    The message indicating success: “OK”

  • updatedDeviceNum integer

    The number of devices that IoT Security successfully updated

Loading...