Naslaginformatie voor Defender for IoT-API
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 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:
Selecteer In het venster Systeeminstellingen de optie Integraties-toegangstokens>.
Selecteer Het token genereren.
Beschrijf in Beschrijving waar het nieuwe token voor is en selecteer Genereren.
Het toegangstoken wordt weergegeven. Kopieer deze, omdat deze niet opnieuw wordt weergegeven.
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) |
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 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: