/deviceInfo
Methods
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
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
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
{
"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
}