Lire en anglais

Partager via


Informations de référence sur l’API de gestion des stocks pour les capteurs de monitoring OT

Cet article liste les API de gestion des stocks d’appareils prises en charge pour les capteurs OT Defender pour IoT.

connexions (Récupérer les informations de connexion de l’appareil)

Utilisez cette API pour demander la liste de toutes les connexions d’appareil.

URI : /api/v1/devices/connections

GET

Paramètres de requête

Définissez l’un des paramètres de requête suivants pour filtrer les résultats retournés. Si vous ne définissez pas les paramètres de requête, toutes les connexions d’appareil sont retournées.

Nom Description Exemple Obligatoire/facultatif
discoveredBefore Numérique. Filtrez les résultats détectés avant une heure donnée, avec l’heure donnée définie en millisecondes à partir de l’heure Époque et dans le fuseau horaire UTC. /api/v1/devices/2/connections?discoveredBefore=<epoch> Facultatif
discoveredAfter Numérique. Filtrez les résultats détectés après une heure donnée, avec l’heure donnée définie en millisecondes à partir de l’heure Époque et dans le fuseau horaire UTC. /api/v1/devices/2/connections?discoveredAfter=<epoch> Facultatif
lastActiveInMinutes Numérique. Filtrez les résultats selon une période donnée pendant laquelle les connexions étaient actives. Cette valeur est définie à rebours, en minutes, à partir de l’heure actuelle. /api/v1/devices/2/connections?lastActiveInMinutes=20 Facultatif

connexions par appareil (Récupérer des informations de connexion d’appareil spécifiques)

Utilisez cette API pour demander une liste de toutes les connexions par appareil.

URI : /api/v1/devices/<deviceID>/connections

GET

Paramètre de chemin

Nom Description Exemple Obligatoire/facultatif
deviceId Obtenez les connexions de l’appareil donné. /api/v1/devices/<deviceId>/connections Obligatoire

Paramètres de requête

Nom Description Exemple Obligatoire/facultatif
discoveredBefore Numérique. Filtrez les résultats détectés avant une heure donnée, avec l’heure donnée définie en millisecondes à partir de l’heure Époque et dans le fuseau horaire UTC. /api/v1/devices/2/connections?discoveredBefore=<epoch> Facultatif
discoveredAfter Numérique. Filtrez les résultats détectés après une heure donnée, avec l’heure donnée définie en millisecondes à partir de l’heure Époque et dans le fuseau horaire UTC. /api/v1/devices/2/connections?discoveredAfter=<epoch> Facultatif
lastActiveInMinutes Numérique. Filtrez les résultats selon une période donnée pendant laquelle les connexions étaient actives. Cette valeur est définie à rebours, en minutes, à partir de l’heure actuelle. /api/v1/devices/2/connections?lastActiveInMinutes=20 Facultatif

cves (Récupérer des informations sur les CVE)

Utilisez cette API pour demander la liste de tous les CVE connus découverts sur les appareils du réseau, triés par score CVE dans l’ordre décroissant.

URI : /api/v1/devices/cves

GET

Exemple : /api/v1/devices/cves

Définissez l’un des paramètres de requête suivants pour filtrer les résultats retournés.

Nom Description Exemple Obligatoire/facultatif
top Numérique. Déterminez le nombre de CVE de score élevé à obtenir pour chaque adresse IP d’appareil. /api/v1/devices/cves?top=50

/api/v1/devices/<ipAddress>/cves?top=50
facultatif. Valeur par défaut = 100

CVE par adresse IP (Récupérer des informations spécifiques sur les CVE)

Utilisez cette API pour demander la liste de tous les CVE connus découverts sur les appareils du réseau pour une adresse IP spécifique.

URI : /api/v1/devices/cves

GET

Exemple : /api/v1/devices/cves

Paramètre de chemin

Nom Description Exemple Obligatoire/facultatif
ipAddress Obtenez les CVE pour l’adresse IP donnée. /api/v1/devices/<ipAddress>/cves Obligatoire

Définissez l’un des paramètres de requête suivants pour filtrer les résultats retournés.

Nom Description Exemple Obligatoire/facultatif
top Numérique. Déterminez le nombre de CVE de score élevé à obtenir pour chaque adresse IP d’appareil. /api/v1/devices/cves?top=50

/api/v1/devices/<ipAddress>/cves?top=50
facultatif. Valeur par défaut = 100

appareils (Récupérer les informations des appareils)

Utilisez cette API pour demander la liste de tous les appareils détectés par ce capteur.

URI : api/v1/devices/

GET

Paramètre de requête.

Définissez l’un des paramètres de requête suivants pour filtrer les résultats retournés. Si vous ne définissez pas les paramètres de requête, toutes les connexions d’appareil sont retournées.

Nom Description Exemple Obligatoire/facultatif
autorisé Booléen :

- true : Filtrez les données sur les appareils autorisés uniquement.
- false : Filtrez les données sur les appareils non autorisés uniquement.
/api/v1/devices/ Facultatif

Étapes suivantes

Pour plus d’informations, consultez Vue d’ensemble de référence de l’API Defender pour IoT.