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