Skip to main content

CVEScanState

Object

The latest CVE scan of one scope of your org (the whole org, or one building), with what it covered.

type CVEScanState {
autoDispositions: Long
cvesIdentified: Long
devicesScanned: Long
devicesUnidentified: Long
id: String
lastScanCompleted: DateTime
lastScanStarted: DateTime
locationId: String
pointsScanned: Long
status: CVEScanStatus
subtendedByConnection: [CVESubtendedCoverageBucket]
subtendedDevices: [CVESubtendedDevice]
subtendedDevicesUnidentified: Long
}

Fields​

FieldTypeDescription
autoDispositionsLongFindings the scan closed or reopened automatically, e.g. after a firmware update.
cvesIdentifiedLongNew findings the scan recorded.
devicesScannedLongDevices whose make, model and firmware were compared with the CVE catalog.
devicesUnidentifiedLongThings in scope that could not be checked because the graph has no make and model for them.
idStringThe scan's id. Treat it as opaque.
lastScanCompletedDateTimeWhen the scan finished; empty while it is running.
lastScanStartedDateTimeWhen the scan started.
locationIdStringThe building scanned; empty when the scan covered the whole org.
pointsScannedLongPoints scanned on those devices.
statusCVEScanStatusWhether the scan is running, succeeded, failed or partly succeeded.
subtendedByConnection[CVESubtendedCoverageBucket]subtendedDevicesUnidentified grouped by gateway and protocol.
subtendedDevices[CVESubtendedDevice]The unidentified subtended devices, most points first, at most 500.
subtendedDevicesUnidentifiedLongDistinct devices seen behind scanned things (through their points, e.g. a controller behind a Niagara station) that are not things themselves, so were not scanned. They can be scanned once modeled as things.

Used by​