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

hostUUID=<string> (valid uuid)

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

uuid=<string> (valid uuid)

Parameters "hostUUID" and "uuid" absent

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


Parameter "scanResultID" exists

scanResultID=<number>


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

sourceType=<string> "cumulative" | "patched"
Example Response
Expand
{
	"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
}