This reference lists the attributes that Device Security collects from Cisco Spaces,
their names as stored in Device Security, and the Device Security fields they map to.
Device Security integrates with Cisco Spaces to import location intelligence data for
connected devices. The attributes in this reference cover device location records
and floor map data from the Cisco Spaces platform.
The third-party attribute name in Device Security refers to the attribute name
as it appears in the Assets Inventory table and in Query Engine. This follows the format
of third-party-name.attribute-name.
When viewing the attribute name in the Assets Inventory table column selector or on a
Device Details page, where the third-party name can be found as a header for the
attributes section, then the third-party name is removed from the attribute name.
For example, micrsoft_defender_xdr.macAddress would appear in the
Query Builder and in the Assets Inventory table, but under Device DetailsAttributesIntegration Specific AttributesMicrosoft Defender, the attribute would appear as macAddress.
Device Location Attributes
Device Security collects device location attributes from the Cisco Spaces Location API. Each record describes a wireless device and its real-time location within a managed space.
The following table lists each Cisco Spaces attribute, its name as stored in
Device Security, and the Device Security field it maps to (if applicable).
Cisco Spaces Attribute
Device Security Attribute Name
Device Security Common Attribute*
Description
controller
cisco_spaces.controller
—
Wireless controller associated with the device
lhFloorId
—
floor_id
Floor identifier
floor_plan_dimension
—
floor_plan_dimension
Dimensions of the floor plan
floor
—
floor_name
Name of the floor
building
—
building_name
Name of the building
campus
—
campus_name
Name of the campus
ap_location
—
AP Location
Location of the access point on the floor plan
floor_plan_coordinate
—
floor_plan_coordinate
Coordinates on the floor plan
associatedApName
—
Access Point Name
Name of the associated access point
locationHierarchy
—
Location
Location hierarchy of the device
lastLocatedAt
—
Last Activity
Date and time the device was last located
apMacAddress
—
ap_mac
MAC address of the associated access point
userName
—
Hostname
Hostname or username of the device
ipAddress
—
ipv4_address
IPv4 address of the device
ssid
—
SSID
SSID of the wireless network
macAddress
—
MAC Address
MAC address of the device
geoCoordinates
cisco_spaces.geoCoordinates
—
Geographic coordinates
coordinates
cisco_spaces.coordinates
—
Coordinates
source
cisco_spaces.source
—
Source
deviceId
cisco_spaces.deviceId
—
Device identifier in Cisco Spaces
isMacHashed
cisco_spaces.isMacHashed
—
Indicates whether the MAC address is hashed
band
cisco_spaces.band
—
Band
manufacturer
cisco_spaces.manufacturer
—
Manufacturer
associated
cisco_spaces.associated
—
Associated
lastLocatedAt
cisco_spaces.lastLocatedAt
—
Last located at
firstLocatedAt
cisco_spaces.firstLocatedAt
—
First located at
computeType
cisco_spaces.computeType
—
Compute type
hierarchyIds
cisco_spaces.hierarchyIds
—
Hierarchy IDs
locationHierarchy
cisco_spaces.locationHierarchy
—
Location hierarchy
hierarchy
cisco_spaces.hierarchy
—
Hierarchy
lhFloorId
cisco_spaces.lhFloorId
—
LH floor ID
floorId
cisco_spaces.floorId
—
Floor ID
buildingId
cisco_spaces.buildingId
—
Building ID
campusId
cisco_spaces.campusId
—
Campus ID
deviceType
cisco_spaces.deviceType
—
Device type
tenantId
cisco_spaces.tenantId
—
Tenant identifier in Cisco Spaces
ipAddress
cisco_spaces.ipAddress
—
IP address
ssid
cisco_spaces.ssid
—
SSID
associatedApName
cisco_spaces.associatedApName
—
Associated AP name
apMacAddress
cisco_spaces.apMacAddress
—
Access point MAC address
Floor Map Attributes
Device Security collects floor map attributes from the Cisco Spaces Location API. Each record describes a device's position on a floor map within a managed building.
The following table lists each Cisco Spaces attribute, its name as stored in
Device Security, and the Device Security field it maps to (if applicable).
Cisco Spaces Attribute
Device Security Attribute Name
Device Security Common Attribute*
Description
floor_plan_dimension
—
floor_plan_dimension
Dimensions of the floor plan
floorId
—
floor_id
Floor identifier
floor
—
floor_name
Name of the floor
building
—
building_name
Name of the building
campus
—
campus_name
Name of the campus
ap_location
—
AP Location
Location of the access point on the floor plan
floor_plan_coordinate
—
floor_plan_coordinate
Coordinates on the floor plan
name
—
Hostname
Hostname or username of the device
ipAddress
—
ipv4_address
IPv4 address of the device
macAddress
—
MAC Address
MAC address of the device
id
cisco_spaces.id
—
Device ID
unit
cisco_spaces.unit
—
Unit
xyCoordinates
cisco_spaces.xyCoordinates
—
XY coordinates
importType
cisco_spaces.importType
—
Import type
make
cisco_spaces.make
—
Device make
geoPosition
cisco_spaces.geoPosition
—
Geographic position
macAddress
cisco_spaces.macAddress
—
MAC address of the device
name
cisco_spaces.name
—
Device name
ipAddress
cisco_spaces.ipAddress
—
IP address
ethernetMacAddress
cisco_spaces.ethernetMacAddress
—
Ethernet MAC address
* Only some attributes map to a Device Security Common Attribute.