Tenable Security Center API: Device Information

/deviceInfo

Methods
GET

Gets the device information for a given host.

NOTE: This will return device information for the first repository. To specify a particular repository, see /repository/{id}/deviceInfo::GET

Fields Parameter
Expand

The fields parameter should be specified along the query string, and it takes the syntax

    ?fields=<field>,...

Allowed Fields

*ip
*uuid
*repositoryID(This attribute is not supported as part of fields parameter use repository instead)
repositories
repository
score
total
severityInfo
severityLow
severityMedium
severityHigh
severityCritical
macAddress
policyName
pluginSet
netbiosName
dnsName
osCPE
biosGUID
tpmID
mcafeeGUID
lastAuthRun
lastUnauthRun
severityAll
os
hasPassive
hasCompliance
lastScan
links

Legend

* = always comes back

redFont =  field is a JSON object ( e.g. "repository" :{ "id" : <id>, "name" : <name> } )

Request Parameters
Expand

Parameters must be passed in as query string (as opposed to JSON) in the format of: /deviceInfo?uuid="123e4567-e89b-12d3-a456-426655440000" or /deviceInfo?ip="1.1.1.1"&dnsName="foo"

Parameter "hostUUID" exists

1
hostUUID=<string> (valid uuid)

Parameter "hostUUID" is absent and "uuid" is present

1
uuid=<string> (valid uuid)

Parameters "hostUUID" and "uuid" absent

1
2
ip=<string> (valid ip address)
&dnsName=<string> OPTIONAL


Parameter "scanResultID" exists

1
scanResultID=<number>


Parameter "sourceType" optimization when "scanResultID" is not supplied

1
sourceType=<string> "cumulative" | "patched"
Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
{
    "type" : "regular",
    "response" : {
        "repositories" : [
            {
                "id" : "2",
                "name" : "Rep2",
                "description" : "",
                "type": "Remote",
                "uuid": "998E121D-6259-436C-BA06-0289DF9617E9"          }
        ],
        "ip" : "192.168.0.1",
        "uuid" : "123e4567-e89b-12d3-a456-426655440000",
        "repositoryID" : "2",
        "score" : "2130",
        "total" : "322",
        "severityInfo" : "110",
        "severityLow" : "7",
        "severityMedium" : "41",
        "severityHigh" : "152",
        "severityCritical" : "12",
        "macAddress" : "00:00:00:00:00:00",
        "policyName" : "",
        "pluginSet" : "",
        "netbiosName" : "TARGET\\WIN7X64",
        "dnsName" : "win7x64.target.domain.com",
        "osCPE" : "cpe:\/o:microsoft:windows_7::gold:x64-ultimate",
        "biosGUID" : "",
        "tpmID" : "",
        "mcafeeGUID" : "",
        "lastAuthRun" : "",
        "lastUnauthRun" : "",
        "severityAll" : "12,152,41,7,110",
        "os" : "Microsoft Windows 7 Ultimate",
        "hasPassive" : "No",
        "hasCompliance" : "No",
        "lastScan" : "1408294249",
        "links" : [
            {
                "name" : "SANS",
                "link" : "https:\/\/isc.sans.edu\/ipinfo.html?ip=192.168.0.1"           },
            {
                "name" : "ARIN",
                "link" : "http:\/\/whois.arin.net\/rest\/ip\/192.168.0.1"           }
        ],
        "repository" : {
            "id" : "2",
            "name" : "Rep2",
            "description" : "",
            "type": "Remote",
            "uuid": "998E121D-6259-436C-BA06-0289DF9617E9"      }
    },
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1409848524
}