IoTDeviceEntity interface

Represents an IoT device entity.

Extends

Properties

additionalData

A bag of custom fields that should be part of the entity and will be presented to the user.

deviceId

The ID of the IoT Device in the IoT Hub

deviceName

The friendly name of the device

deviceSubType

The subType of the device ('PLC', 'HMI', 'EWS', etc.)

deviceType

The type of the device

edgeId

The ID of the edge device

firmwareVersion

The firmware version of the device

friendlyName

The graph item display name which is a short humanly readable description of the graph item instance. This property is optional and might be system generated.

hostEntityId

The Host entity id of this device

importance

Device importance, determines if the device classified as 'crown jewel'

iotHubEntityId

The AzureResource entity id of the IoT Hub

iotSecurityAgentId

The ID of the security agent running on the device

ipAddressEntityId

The IP entity if of this device

isAuthorized

Determines whether the device classified as authorized device

isProgramming

Determines whether the device classified as programming device

isScanner

Is the device classified as a scanner device

kind

The kind of the entity.

macAddress

The MAC address of the device

model

The model of the device

nicEntityIds

A list of Nic entity ids of the IoTDevice entity.

operatingSystem

The operating system of the device

owners

A list of owners of the IoTDevice entity.

protocols

A list of protocols of the IoTDevice entity.

purdueLayer

The Purdue Layer of the device

sensor

The sensor the device is monitored by

serialNumber

The serial number of the device

site

The site of the device

source

The source of the device

threatIntelligence

A list of TI contexts attached to the IoTDevice entity.

vendor

The vendor of the device

zone

The zone location of the device within a site

Inherited Properties

id

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

The name of the resource

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information.

type

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Property Details

additionalData

A bag of custom fields that should be part of the entity and will be presented to the user.

additionalData?: Record<string, any>

Property Value

Record<string, any>

deviceId

The ID of the IoT Device in the IoT Hub

deviceId?: string

Property Value

string

deviceName

The friendly name of the device

deviceName?: string

Property Value

string

deviceSubType

The subType of the device ('PLC', 'HMI', 'EWS', etc.)

deviceSubType?: string

Property Value

string

deviceType

The type of the device

deviceType?: string

Property Value

string

edgeId

The ID of the edge device

edgeId?: string

Property Value

string

firmwareVersion

The firmware version of the device

firmwareVersion?: string

Property Value

string

friendlyName

The graph item display name which is a short humanly readable description of the graph item instance. This property is optional and might be system generated.

friendlyName?: string

Property Value

string

hostEntityId

The Host entity id of this device

hostEntityId?: string

Property Value

string

importance

Device importance, determines if the device classified as 'crown jewel'

importance?: string

Property Value

string

iotHubEntityId

The AzureResource entity id of the IoT Hub

iotHubEntityId?: string

Property Value

string

iotSecurityAgentId

The ID of the security agent running on the device

iotSecurityAgentId?: string

Property Value

string

ipAddressEntityId

The IP entity if of this device

ipAddressEntityId?: string

Property Value

string

isAuthorized

Determines whether the device classified as authorized device

isAuthorized?: boolean

Property Value

boolean

isProgramming

Determines whether the device classified as programming device

isProgramming?: boolean

Property Value

boolean

isScanner

Is the device classified as a scanner device

isScanner?: boolean

Property Value

boolean

kind

The kind of the entity.

kind: "IoTDevice"

Property Value

"IoTDevice"

macAddress

The MAC address of the device

macAddress?: string

Property Value

string

model

The model of the device

model?: string

Property Value

string

nicEntityIds

A list of Nic entity ids of the IoTDevice entity.

nicEntityIds?: string[]

Property Value

string[]

operatingSystem

The operating system of the device

operatingSystem?: string

Property Value

string

owners

A list of owners of the IoTDevice entity.

owners?: string[]

Property Value

string[]

protocols

A list of protocols of the IoTDevice entity.

protocols?: string[]

Property Value

string[]

purdueLayer

The Purdue Layer of the device

purdueLayer?: string

Property Value

string

sensor

The sensor the device is monitored by

sensor?: string

Property Value

string

serialNumber

The serial number of the device

serialNumber?: string

Property Value

string

site

The site of the device

site?: string

Property Value

string

source

The source of the device

source?: string

Property Value

string

threatIntelligence

A list of TI contexts attached to the IoTDevice entity.

threatIntelligence?: ThreatIntelligence[]

Property Value

vendor

The vendor of the device

vendor?: string

Property Value

string

zone

The zone location of the device within a site

zone?: string

Property Value

string

Inherited Property Details

id

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

id?: string

Property Value

string

Inherited From Entity.id

name

The name of the resource

name?: string

Property Value

string

Inherited From Entity.name

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information.

systemData?: SystemData

Property Value

Inherited From Entity.systemData

type

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

type?: string

Property Value

string

Inherited From Entity.type