Referens för Defender för IoT API
I det här avsnittet beskrivs de offentliga API:er som stöds av Microsoft Defender för IoT. Defender for IoT-API:er styrs av Licens och användningsvillkor för Microsoft API.
Använd Defender för IoT-API:er för att komma åt data som identifieras av sensorer och utföra åtgärder med dessa data.
API-anslutningar skyddas via SSL.
Generera en API-åtkomsttoken
Många Defender för IoT-API:er kräver en åtkomsttoken. Åtkomsttoken krävs inte för autentiserings-API:er.
Så här genererar du en token:
I fönstret Systeminställningar väljer du Åtkomsttoken för integreringar>.
Välj Generera token.
I Beskrivning beskriver du vad den nya token är till för och väljer Generera.
Åtkomsttoken visas. Kopiera den eftersom den inte visas igen.
Välj Slutför.
De token som du skapar visas i dialogrutan Åtkomsttoken . Använd anger den senaste gången ett externt anrop med den här token togs emot.
N/A i fältet Används anger att anslutningen mellan sensorn och den anslutna servern inte fungerar.
När du har genererat token lägger du till ett HTTP-huvud med rubriken Auktorisering i din begäran och anger dess värde till den token som du genererade.
Referens för sensor-API-version
| Version | API:er som stöds |
|---|---|
| Ingen version | Autentisering och lösenordshantering: - set_password (Ändra ditt lösenord) - set_password_by_admin (Uppdatera ett användarlösenord av administratör) - validering (Verifiera användarautentiseringsuppgifter) |
| Ny i version 1 | Inventering: - anslutningar (Hämta information om enhetsanslutning) - cves (Hämta information om CVE:er) - enheter (Hämta enhetsinformation) Aviseringar: - aviseringar (Hämta aviseringsinformation) - händelser (Hämta tidslinjehändelser) Sårbarheter: - drift (Hämta sårbarheter i drift) - enheter (Hämta information om enhetens säkerhetsrisker) - mitigation (Hämta åtgärdssteg) - säkerhet (Hämta säkerhetsrisker) |
| Nytt i version 2 | Aviseringar: – Uppdateringar av aviseringar (Hämta aviseringsinformation) |
Kommentar
Integrerings-API:er är avsedda att köras kontinuerligt och skapa en dataström som körs hela tiden, till exempel för att fråga efter nya data från de senaste fem minuterna. Integrerings-API:er returnerar data med en tidsstämpel.
Om du bara vill fråga efter data använder du vanliga API:er som inte är integrerings-API:er i stället, för att en specifik sensor endast ska köra frågor mot enheter från sensorn.
Epoktid
I alla Tidsstämpelvärden för Defender för IoT är epoktiden lika med 1/1/1970.
Nästa steg
Mer information finns i: