API Console de découverte pour OT

  • Rversion finale: Australia
  • Mis à jour 16 juin 2026
  • 3 minutes de lecture

    • Vous pouvez accéder aux données de découverte de la console via l’API. Sur la page Paramètres, sélectionnez l’onglet API pour afficher et utiliser les jetons actifs, les jetons refusés et les points de terminaison nécessaires pour communiquer avec Connecteur du graphe de services (SGC).

    Remarque :
    Pour en savoir plus sur Connecteur du graphe de services, consultez Connecteur du graphe de services pour ServiceNow Operational Technology Découverte

    Paramètres d’API

    Les paramètres d’API sont utilisés pour configurer les jetons actifs, les jetons refusés et les points de terminaison nécessaires pour communiquer avec le SGC pour ServiceNow Découverte pour les technologies opérationnelles (OT).

    Les jetons peuvent être importés ou exportés, et les points de terminaison peuvent être téléchargés.

    Le SGC permet à l’API de communiquer les Console de découverte pour OT données du composant et d’autres composants de découverte à l’instance ServiceNow . Les données peuvent également être communiquées à des API externes.

    Fonction

    SGC a été amélioré pour une meilleure connexion vers et depuis les composants Découverte, l’API Console de découverte pour OT et votre ServiceNow instance.

    Le SGC fournit des Console de découverte pour OT fonctions d’API telles que :
    • Envoie l’état de la licence utilisateur.
    • Importe tous les programmes logiciels qui sont identifiés sur les appareils et renvoie une liste paginée à partir de la vue SoftwaresAPI.
      L’API ingère le logiciel et fournit les attributs de programme suivants :
      • inputProduct : nom du logiciel
      • Version : la version du logiciel installé
      • inputVendor : fabricant du logiciel
      • lastSeenOn : champ LastSeenOn des actifs ajouté à l’objet
      • assetId : dérivé du _id du document d’actif contenant le tableau logiciel.
      • _id : pour le document ; doit être le _id de l’objet dans le tableau logiciel
    • Transfère les images et captures d’écran de la console vers l’instance ServiceNow . Cela renvoie les images dans une liste paginée avec les filtres suivants :
      • UpdateOn (mise à jour)
      • CreatedOn
      • Capture d’écran
      • Taille
      • Mots OCR
      • Titres
    • Transmet les Capteur de découverte pour OT informations à l’instance ServiceNow .
      • L’API peut être utilisée pour renvoyer le sensorId.
      • Vous pouvez recueillir des informations sur le capteur et les utiliser pour détecter des actifs.
      • Les informations du capteur peuvent être transmises via l’API au ServiceNow.
    • Envoyer à la console les mesures d’intégrité de la machine virtuelle (VM) et les mesures de l’hôte du capteur et du Scout. Cela améliore la visibilité de la version, des processus installés et de l’intégrité de l’ordinateur hôte de Console de découverte pour OT, Capteur de découverte pour OT et Scout de découverte pour OT.

    Connexion réseau indirecte (air-gapped)

    Pour des raisons de sécurité, un ordinateur ou un système peut ne pas être directement connecté à Internet ou se trouver sur un réseau local non sécurisé. Dans une telle situation, Discovery for Operational Technology components ne peut pas transmettre de fichiers ou de données au serveur MID, puis via Service Graph Connector (Connecteur du graphe de services) jusqu’à l’instance ServiceNow .

    Pour résoudre le problème d’air-gap, le Console de découverte pour OT peut générer des fichiers JSON. Ces fichiers JSON sont des fichiers physiques qui peuvent être copiés manuellement, puis déplacés vers le serveur MID via un disque externe. Ils peuvent ensuite être copiés manuellement dans un répertoire spécifique sur le serveur MID, puis consommés via le SGC dans l’instance ServiceNow .

    Par exemple, si vous accédez à Paramètres > exportations sur le Console de découverte pour OT, vous pouvez télécharger les données générées par les composants de découverte sous forme de fichier d’exportation JSON. Vous pouvez programmer la fréquence de ces téléchargements en définissant le nombre de jours et l’heure de la journée. Ces fichiers sont enregistrés dans le répertoire /opt/MSi/srv/apiexports . De là, vous pouvez les déplacer sur un support physique comme une clé USB. Vous pouvez ensuite copier ou importer les fichiers JSON sur le serveur MID, puis sur SGC, puis sur l’instance ServiceNow .
    Page d’exportation > paramètres

    Pour modifier l’API de la console, reportez-vous à la section Modifier les paramètres d’API.