Naslaginformatie voor Defender for IoT-API

  • Artikel

In deze sectie worden de openbare API's beschreven die worden ondersteund door Microsoft Defender for IoT. Defender for IoT-API's vallen onder de Microsoft API-licentie en gebruiksvoorwaarden.

Gebruik Defender for IoT-API's voor toegang tot gegevens die zijn gedetecteerd door sensoren en on-premises beheerconsoles en voer acties uit met die gegevens.

API-verbindingen worden beveiligd via SSL.

Een API-toegangstoken genereren

Voor veel Defender for IoT-API's is een toegangstoken vereist. Toegangstokens zijn niet vereist voor verificatie-API's.

Een token genereren:

  1. Selecteer In het venster System Instellingen de optie Integrations>Access Tokens.

  2. Selecteer Het token genereren.

  3. Beschrijf in Beschrijving waar het nieuwe token voor is en selecteer Genereren.

  4. Het toegangstoken wordt weergegeven. Kopieer deze, omdat deze niet opnieuw wordt weergegeven.

  5. Selecteer Voltooien.

    • De tokens die u maakt, worden weergegeven in het dialoogvenster Toegangstokens . De gebruikte waarde geeft aan wanneer een externe aanroep met dit token voor het laatst is ontvangen.

    • N.v.t. in het veld Gebruikt geeft aan dat de verbinding tussen de sensor en de verbonden server niet werkt.

Nadat u het token hebt gegenereerd, voegt u een HTTP-header met de titel Autorisatie toe aan uw aanvraag en stelt u de waarde ervan in op het token dat u hebt gegenereerd.

Naslaginformatie over sensor-API-versies

Versie Ondersteunde API's
Geen versie Verificatie en wachtwoordbeheer:
- set_password (uw wachtwoord wijzigen)
- set_password_by_admin (een gebruikerswachtwoord bijwerken per beheerder)
- validatie (gebruikersreferenties valideren)
Nieuw in versie 1 Inventaris:
- verbindingen (apparaatverbindingsgegevens ophalen)
- cves (informatie ophalen over CVE's)
- apparaten (apparaatgegevens ophalen)

Waarschuwingen:
- waarschuwingen (waarschuwingsgegevens ophalen)
- gebeurtenissen (tijdlijn-gebeurtenissen ophalen)

Beveiligingsproblemen:
- operationeel (operationele beveiligingsproblemen ophalen)
- apparaten (informatie over beveiligingsproblemen van apparaten ophalen)
- risicobeperking (risicobeperkingsstappen ophalen)
- beveiliging (beveiligingsproblemen ophalen)
Nieuw in versie 2 Waarschuwingen:
- Updates voor waarschuwingen (waarschuwingsgegevens ophalen)

Naslaginformatie over de API-versie van de on-premises beheerconsole

Versie API's
Geen versie Verificatie en wachtwoordbeheer:
- set_password (wachtwoord wijzigen)
- set_password_by_admin (update van gebruikerswachtwoord door systeembeheerder)
- validatie (gebruikersreferenties verifiëren)
Nieuw in versie 1 Sites
- apparaten (OT-sensorapparaten beheren)
Inventaris:
- apparaten (alle apparaatgegevens ophalen)

Waarschuwingen:
- waarschuwingen (waarschuwingsgegevens ophalen)
- maintenanceWindow (waarschuwingsuitsluitingen maken)
Nieuw in versie 2 Waarschuwingen:
- Updates voor waarschuwingen (waarschuwingsgegevens ophalen)
- pcap (waarschuwing voor PCAP aanvragen)
Nieuw in versie 3 Integratie-API's:
- verbindingen (apparaatverbindingen ophalen)
- apparaat (Details voor een apparaat ophalen)
- devicecves (APPARAAT-CV's ophalen)
- apparaten (apparaten maken en bijwerken)
- deleteddevices (Verwijderde apparaten ophalen)
- sensoren (Sensoren ophalen)

Notitie

Integratie-API's zijn bedoeld om continu uit te voeren en een voortdurend actieve gegevensstroom te maken, zoals het opvragen van nieuwe gegevens uit de afgelopen vijf minuten. Integratie-API's retourneren gegevens met een tijdstempel.

Als u alleen query's wilt uitvoeren op gegevens, gebruikt u de reguliere, niet-integratie-API's, voor een on-premises beheerconsole om query's uit te voeren op alle apparaten of voor een specifieke sensor om alleen een query uit te voeren op apparaten van die sensor.

Tijdsperiode

In alle Defender for IoT-tijdstempelwaarden is tijdsduur gelijk aan 1-1-1-1970.

Volgende stappen

Zie voor meer informatie: