Definieren Sie beliebige der folgenden Abfrageparameter, um die zurückgegebenen Ergebnisse zu filtern. Wenn Sie keine Abfrageparameter festlegen, werden alle Geräteverbindungen zurückgegeben.
Name
Beschreibung des Dataflows
Beispiel
Erforderlich/optional
discoveredBefore
Numerisch. Dient zum Filtern der Ergebnisse, die vor einem bestimmten Zeitpunkt erkannt wurden. Der Zeitpunkt wird dabei in Millisekunden auf Basis der Epochenzeit sowie in der UTC-Zeitzone angegeben.
Numerisch. Dient zum Filtern der Ergebnisse, die nach einem bestimmten Zeitpunkt erkannt wurden. Der Zeitpunkt wird dabei in Millisekunden auf Basis der Epochenzeit sowie in der UTC-Zeitzone angegeben.
Numerisch. Dient zum Filtern der Ergebnisse nach einem bestimmten Zeitrahmen, in dem Verbindungen aktiv waren. Wird rückwärts in Minuten ab der aktuellen Zeit definiert.
Dient zum Abrufen der Verbindungen für das angegebene Gerät.
/api/v1/devices/<deviceId>/connections
Erforderlich
Abfrageparameter
Name
Beschreibung des Dataflows
Beispiel
Erforderlich/optional
discoveredBefore
Numerisch. Dient zum Filtern der Ergebnisse, die vor einem bestimmten Zeitpunkt erkannt wurden. Der Zeitpunkt wird dabei in Millisekunden auf Basis der Epochenzeit sowie in der UTC-Zeitzone angegeben.
Numerisch. Dient zum Filtern der Ergebnisse, die nach einem bestimmten Zeitpunkt erkannt wurden. Der Zeitpunkt wird dabei in Millisekunden auf Basis der Epochenzeit sowie in der UTC-Zeitzone angegeben.
Numerisch. Dient zum Filtern der Ergebnisse nach einem bestimmten Zeitrahmen, in dem Verbindungen aktiv waren. Wird rückwärts in Minuten ab der aktuellen Zeit definiert.
Mit dieser API können Sie eine absteigend nach CVE-Bewertung sortierte Liste aller bekannten CVEs anfordern, die auf Geräten im Netzwerk erkannt wurden.
Definieren Sie beliebige der folgenden Abfrageparameter, um die zurückgegebenen Ergebnisse zu filtern.
Name
Beschreibung des Dataflows
Beispiel
Erforderlich/optional
top
Numerisch. Bestimmt, wie viele CVEs mit den höchsten Bewertungen für jede Geräte-IP-Adresse abgerufen werden sollen.
/api/v1/devices/cves?top=50
/api/v1/devices/<ipAddress>/cves?top=50
Optional. Standardwert: 100
Typ: JSON
JSON-Array von Geräte-CVE-Objekten oder folgende Fehlermeldung:
`Message`
BESCHREIBUNG
Fehler: error
Fehler beim Vorgang
Antwortfelder bei Erfolg
Name
type
Nullwerte zulassend/Keine Nullwerte zulassend
Liste der Werte
cveId
String
Lässt keine NULL-Werte zu
Eine kanonische ID nach Branchenstandard für die CVE-Angabe.
ipAddress
String
Lässt keine NULL-Werte zu
IP-Adressen
score
String
Lässt keine NULL-Werte zu
Eine CVE-Bewertung zwischen 0,0 und 10,0.
attackVector
String
Lässt keine NULL-Werte zu
Network, Adjacent Network, Local oder Physical
description
String
Lässt keine NULL-Werte zu
-
Antwortbeispiel
[
{
"cveId": "CVE-2007-0099",
"score": "9.3",
"ipAddress": "10.35.1.51",
"attackVector": "NETWORK",
"description": "Race condition in the msxml3 module in Microsoft XML Core
Services 3.0, as used in Internet Explorer 6 and other
applications, allows remote attackers to execute arbitrary
code or cause a denial of service (application crash) via many
nested tags in an XML document in an IFRAME, when synchronous
document rendering is frequently disrupted with asynchronous
events, as demonstrated using a JavaScript timer, which can
trigger NULL pointer dereferences or memory corruption, aka
\"MSXML Memory Corruption Vulnerability.\""
},
{
"cveId": "CVE-2009-1547",
"score": "9.3",
"ipAddress": "10.35.1.51",
"attackVector": "NETWORK",
"description": "Unspecified vulnerability in Microsoft Internet Explorer 5.01
SP4, 6, 6 SP1, and 7 allows remote attackers to execute
arbitrary code via a crafted data stream header that triggers
memory corruption, aka \"Data Stream Header Corruption
Vulnerability.\""
}
]
Dient zum Abrufen von CVEs für die angegebene IP-Adresse.
/api/v1/devices/<ipAddress>/cves
Erforderlich
Definieren Sie den folgenden Abfrageparameter, um die zurückgegebenen Ergebnisse zu filtern:
Name
Beschreibung des Dataflows
Beispiel
Erforderlich/optional
top
Numerisch. Bestimmt, wie viele CVEs mit den höchsten Bewertungen für jede Geräte-IP-Adresse abgerufen werden sollen.
/api/v1/devices/cves?top=50
/api/v1/devices/<ipAddress>/cves?top=50
Optional. Standardwert: 100
Typ: JSON
JSON-Array von Geräte-CVE-Objekten oder folgende Fehlermeldung:
`Message`
BESCHREIBUNG
Fehler: error
Fehler beim Vorgang
Antwortfelder bei Erfolg
Name
type
Nullwerte zulassend/Keine Nullwerte zulassend
Liste der Werte
cveId
String
Lässt keine NULL-Werte zu
Eine kanonische ID nach Branchenstandard für die CVE-Angabe.
ipAddress
String
Lässt keine NULL-Werte zu
IP-Adressen
score
String
Lässt keine NULL-Werte zu
Eine CVE-Bewertung zwischen 0,0 und 10,0.
attackVector
String
Lässt keine NULL-Werte zu
Network, Adjacent Network, Local oder Physical
description
String
Lässt keine NULL-Werte zu
-
Antwortbeispiel
[
{
"cveId": "CVE-2007-0099",
"score": "9.3",
"ipAddress": "10.35.1.51",
"attackVector": "NETWORK",
"description": "Race condition in the msxml3 module in Microsoft XML Core
Services 3.0, as used in Internet Explorer 6 and other
applications, allows remote attackers to execute arbitrary
code or cause a denial of service (application crash) via many
nested tags in an XML document in an IFRAME, when synchronous
document rendering is frequently disrupted with asynchronous
events, as demonstrated using a JavaScript timer, which can
trigger NULL pointer dereferences or memory corruption, aka
\"MSXML Memory Corruption Vulnerability.\""
},
{
"cveId": "CVE-2009-1547",
"score": "9.3",
"ipAddress": "10.35.1.51",
"attackVector": "NETWORK",
"description": "Unspecified vulnerability in Microsoft Internet Explorer 5.01
SP4, 6, 6 SP1, and 7 allows remote attackers to execute
arbitrary code via a crafted data stream header that triggers
memory corruption, aka \"Data Stream Header Corruption
Vulnerability.\""
}
]
Definieren Sie den folgenden Abfrageparameter, um die zurückgegebenen Ergebnisse zu filtern: Wenn Sie keine Abfrageparameter festlegen, werden alle Geräteverbindungen zurückgegeben.
Name
Beschreibung des Dataflows
Beispiel
Erforderlich/optional
authorized
Boolesch:
- true: Filtert nur nach Daten auf autorisierten Geräten. - false: Filtert nur nach Daten auf nicht autorisierten Geräten.
/api/v1/devices/
Optional
Antworttyp: JSON
Array von JSON-Objekten, die Geräteobjekte darstellen, oder folgende Fehlermeldung:
`Message`
BESCHREIBUNG
Fehler: error
Fehler beim Vorgang
Antwortfelder bei Erfolg
Name
type
Nullwerte zulassend/Keine Nullwerte zulassend
Liste der Werte
id
Numerisch. Definiert die Geräte-ID.
Lässt keine NULL-Werte zu
-
ipAddresses
JSON-Array mit Zeichenfolgen.
Nullwerte zulässig
-
name
Eine Zeichenfolge. Definiert den Gerätenamen.
Lässt keine NULL-Werte zu
-
vendor
Eine Zeichenfolge. Definiert den Gerätehersteller.
Nullwerte zulässig
-
operatingSystem
Enumeration. Definiert das Betriebssystem des Geräts.