Skip to main content

Bulk Device Updates - Cisco WLC

PUT 
/pub/v4.0/device/bulkUpdate?updateSource=cisco_wlc

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

Request​

Query Parameters

    customerid stringrequired

    The customer ID to which the API call is directed

    updateSource stringrequired

    The source of the device information: Cisco WLAN controllers

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...