Informations de référence sur l’API Defender pour IoT

  • Article

Cette section décrit les API publiques prises en charge par Microsoft Defender pour IoT. Les API Defender pour IoT sont régies par les conditions d’utilisation et la licence d’API Microsoft.

Utilisez les API Defender pour IoT afin d’accéder aux données découvertes par les capteurs et les consoles de gestion locales et d’effectuer des actions avec ces données.

Les connexions API sont sécurisées via SSL.

Générer un jeton d’accès d’API

De nombreuses API Defender pour IoT nécessitent un jeton d’accès. Les jetons d’accès ne sont pas requis pour les API d’authentification.

Pour générer un jeton :

  1. Dans la fenêtre Paramètres système, sélectionnez Intégrations>Jetons d’accès.

  2. Sélectionnez Generate token.

  3. Dans Description, décrivez à quoi sert le nouveau jeton, puis sélectionnez Générer.

  4. Le jeton d'accès apparaît. Copiez-le, car il ne s’affichera plus.

  5. Sélectionnez Terminer.

    • Les jetons que vous créez apparaissent dans la boîte de dialogue Jetons d’accès. Utilisé indique l’heure à laquelle le dernier appel externe avec ce jeton a été reçu.

    • N/A dans le champ Utilisé indique que la connexion entre le capteur et le serveur connecté ne fonctionne pas.

Après avoir généré le jeton, ajoutez un en-tête HTTP intitulé Autorisation à votre requête et définissez sa valeur avec le jeton que vous avez généré.

Informations de référence sur la version de l’API de capteur

Version API prises en charge
Aucune version Gestion des authentifications et des mots de passe :
- set_password (Changer votre mot de passe)
- set_password_by_admin (Mettre à jour un mot de passe utilisateur par administrateur)
- validation (valider des informations d’identification utilisateur)
Nouveautés de la version 1 Inventaire :
- connexions (Récupérer les informations de connexion de l’appareil)
- cves (Récupérer des informations sur les CVE)
- appareils (Récupérer les informations des appareils)

Alertes :
- alertes (Récupérer les informations d’alerte)
- événements (Récupérer les événements de chronologie)

Vulnérabilités :
- opérationnel (Récupérer les vulnérabilités opérationnelles)
- appareils (Récupérer les informations sur les vulnérabilités des appareils)
- atténuation (Récupérer les étapes d’atténuation)
- sécurité (Récupérer les vulnérabilités de sécurité)
Nouveautés de la version 2 Alertes :
- Mises à jour des alertes (Récupérer les informations d’alerte)

Informations de référence sur la version de l’API de console de gestion locale

Version API
Aucune version Gestion des authentifications et des mots de passe :
- set_password (Changer le mot de passe)
- set_password_by_admin (Mise à jour du mot de passe utilisateur par l’administrateur système)
- validation (Authentifier les informations d’identification)
Nouveautés de la version 1 Sites
- appliances (Gérer les appliances de capteurs OT)
Inventaire :
- appareils (Récupérer toutes les informations sur les appareils)

Alertes :
- alertes (Récupérer les informations d’alerte)
- maintenanceWindow (Créer des exclusions d’alerte)
Nouveautés de la version 2 Alertes :
- Mises à jour des alertes (Récupérer les informations d’alerte)
- pcap (Demander un PCAP d’alerte)
Nouveautés de la version 3 API d’intégration :
- connexions (Obtenir des connexions d’appareil)
- appareil (Obtenir des détails pour un appareil)
- devicecves (Obtenir les CVE d’appareil)
- appareils (Créer, supprimer et mettre à jour des appareils)
- deleteddevices (Obtenir les appareils supprimés)
- capteurs (Obtenir des capteurs)

Notes

Les API d’intégration sont destinées à s’exécuter en continu et à créer un flux de données constant, par exemple pour interroger de nouvelles données au cours des cinq dernières minutes. Les API d’intégration retournent des données avec un timestamp.

Pour simplement interroger des données, utilisez plutôt les API normales et non intégrées pour une console de gestion locale afin d’interroger tous les appareils, ou pour un capteur spécifique afin d’interroger uniquement les appareils à partir de ce capteur.

Heure epoch

Dans toutes les valeurs d’horodatage Defender pour IoT, l’heure epoch est égale à 1/1/1970.

Étapes suivantes

Pour plus d'informations, consultez les pages suivantes :