BlueCat Attribute Reference
Focus
Focus
Device Security

BlueCat Attribute Reference

Table of Contents

BlueCat Attribute Reference

This reference lists the attributes that Device Security collects from BlueCat, their names as stored in Device Security, and the Device Security fields they map to.
When Device Security integrates with BlueCat IPAM, it imports IP address management data to enrich the device inventory with network topology information. The attributes in this reference cover IPv4 address records, IPv4 networks, and IPv4 network blocks.
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.

IPv4 Address Attributes

Device Security collects ipv4 address attributes from BlueCat. The following table lists each BlueCat attribute, its name as stored in Device Security, and the Device Security field it maps to (if applicable).
BlueCat Attribute
Device Security Attribute Name
Device Security Common Attribute*
Description
address
ipam_bluecat.address
IP Address
Address
macAddress.address
ipam_bluecat.macAddress.address
MAC Address; id
Address
id
ipam_bluecat.id
—
Unique identifier
state
ipam_bluecat.state
—
State
type
ipam_bluecat.type
—
Type

IPv4 Network Attributes

Device Security collects ipv4 network attributes from BlueCat. The following table lists each BlueCat attribute, its name as stored in Device Security, and the Device Security field it maps to (if applicable).
BlueCat Attribute
Device Security Attribute Name
Device Security Common Attribute*
Description
name
ipam_bluecat.name
name
Name of the device
range
ipam_bluecat.range
prefix; id
Range
location.name
ipam_bluecat.location.name
Site
Name of the device
subnet_type
ipam_bluecat.subnet_type
Type
Subnet type
gateway
ipam_bluecat.gateway
—
Gateway
location.id
ipam_bluecat.location.id
—
Unique identifier
type
ipam_bluecat.type
—
Type
usage.assigned
ipam_bluecat.usage.assigned
—
Assigned
usage.dhcpAbandoned
ipam_bluecat.usage.dhcpAbandoned
—
DHCP abandoned
usage.dhcpAllocated
ipam_bluecat.usage.dhcpAllocated
—
DHCP allocated
usage.dhcpReserved
ipam_bluecat.usage.dhcpReserved
—
DHCP reserved
usage.reserved
ipam_bluecat.usage.reserved
—
Reserved
usage.static
ipam_bluecat.usage.static
—
Static
usage.total
ipam_bluecat.usage.total
—
Total
usage.unassigned
ipam_bluecat.usage.unassigned
—
Unassigned

IPv4 Block Attributes

Device Security collects ipv4 block attributes from BlueCat. The following table lists each BlueCat attribute, its name as stored in Device Security, and the Device Security field it maps to (if applicable).
BlueCat Attribute
Device Security Attribute Name
Device Security Common Attribute*
Description
name
ipam_bluecat.name
name
Name of the device
range
ipam_bluecat.range
prefix; id
Range
location.name
ipam_bluecat.location.name
Site
Name of the device
subnet_type
ipam_bluecat.subnet_type
Type
Subnet type
location.id
ipam_bluecat.location.id
—
Unique identifier
type
ipam_bluecat.type
—
Type
usagePercentage.addressAllocation.assigned
ipam_bluecat.usagePercentage.addressAllocation.assigned
—
Assigned
usagePercentage.addressAllocation.unassigned
ipam_bluecat.usagePercentage.addressAllocation.unassigned
—
Unassigned
usagePercentage.networkAllocation.assigned
ipam_bluecat.usagePercentage.networkAllocation.assigned
—
Assigned
usagePercentage.networkAllocation.unassigned
ipam_bluecat.usagePercentage.networkAllocation.unassigned
—
Unassigned
* Only some attributes map to a Device Security Common Attribute.