Fortinet black logo

Administration Guide

Device identities

Copy Link
Copy Doc ID 868f1267-7299-11e9-81a4-00505692583a:601395
Download PDF

Device identities

Retrieve device identities.

https://<servername>:8443/api/deviceprofiler/identity

https://<servername>:8443/api/deviceprofiler/identity?macAddress={mac}

Return value

Type

Description

id

Integer

Device Identity record ID

createTime

Integer

Time fingerprint was created

lastHeardTime

Integer

Time fingerprint was last heard

messageType

String

Message Type

parameterList

String

List of DHCP Parameters

optionList

String

DHCP Option List

physAddress

String

MAC Address

operatingSystem

String

Operating System

timeToLive

String

Time To Live

deviceIdentity

String

Device Identity

Example request

curl -k -u 'username:password' -H "accept: application/xml" -X GET https://localhost:8443/api/deviceprofiler/identity?macAddress=00:0B:86:C0:1A:76

Example XML format

<fingerprintSearchResult>

<status>success</status>

<limit>1</limit>

<nextOffset>1</nextOffset>

<offset>0</offset>

<total>917</total>

<fingerprints>

<fingerprint>

<createTime><nanos>0</nanos></createTime>

<deviceIdentity>

<name>Wireless Access Point</name>

<tag>WAP</tag>

</deviceIdentity>

<ID>1</ID>

<lastHeardTime><nanos>0</nanos></lastHeardTime>

<messageType>

<id>1</id>

<name>DHCP Fingerprinting</name>

<shortName>DISCOVER</shortName>

</messageType>

<operatingSystem>Aruba</operatingSystem>

<optionList>53,57,55</optionList>

<parameterList>1,3,6,15</parameterList>

<physAddress>00:0B:86:C0:1A:76</physAddress>

<timeToLive>255</timeToLive>

</fingerprint>

</fingerprints>

</fingerprintSearchResult>

Device identities

Retrieve device identities.

https://<servername>:8443/api/deviceprofiler/identity

https://<servername>:8443/api/deviceprofiler/identity?macAddress={mac}

Return value

Type

Description

id

Integer

Device Identity record ID

createTime

Integer

Time fingerprint was created

lastHeardTime

Integer

Time fingerprint was last heard

messageType

String

Message Type

parameterList

String

List of DHCP Parameters

optionList

String

DHCP Option List

physAddress

String

MAC Address

operatingSystem

String

Operating System

timeToLive

String

Time To Live

deviceIdentity

String

Device Identity

Example request

curl -k -u 'username:password' -H "accept: application/xml" -X GET https://localhost:8443/api/deviceprofiler/identity?macAddress=00:0B:86:C0:1A:76

Example XML format

<fingerprintSearchResult>

<status>success</status>

<limit>1</limit>

<nextOffset>1</nextOffset>

<offset>0</offset>

<total>917</total>

<fingerprints>

<fingerprint>

<createTime><nanos>0</nanos></createTime>

<deviceIdentity>

<name>Wireless Access Point</name>

<tag>WAP</tag>

</deviceIdentity>

<ID>1</ID>

<lastHeardTime><nanos>0</nanos></lastHeardTime>

<messageType>

<id>1</id>

<name>DHCP Fingerprinting</name>

<shortName>DISCOVER</shortName>

</messageType>

<operatingSystem>Aruba</operatingSystem>

<optionList>53,57,55</optionList>

<parameterList>1,3,6,15</parameterList>

<physAddress>00:0B:86:C0:1A:76</physAddress>

<timeToLive>255</timeToLive>

</fingerprint>

</fingerprints>

</fingerprintSearchResult>