A Defender for IoT API referenciája
Ez a szakasz a Microsoft Defender for IoT által támogatott nyilvános API-kat ismerteti. Az IoT-alapú Defender API-kra a Microsoft API-licenc és a használati feltételek vonatkoznak.
A Defender for IoT API-k segítségével hozzáférhet az érzékelők és a helyszíni felügyeleti konzolok által felderített adatokhoz, és műveleteket hajthat végre az adatokkal.
Az API-kapcsolatok SSL-en keresztül vannak védve.
API hozzáférési jogkivonat létrehozása
Sok IoT-alapú Defender API-hoz hozzáférési jogkivonat szükséges. A hitelesítési API-khoz nincs szükség hozzáférési jogkivonatokra.
Jogkivonat létrehozása:
A System Gépház ablakban válassza az Integrációs>hozzáférési jogkivonatok lehetőséget.
Válassza a Jogkivonat létrehozása lehetőséget.
A Leírásban írja le az új jogkivonatot, és válassza a Létrehozás lehetőséget.
Megjelenik a hozzáférési jogkivonat. Másolja ki, mert nem jelenik meg újra.
Válassza a Befejezés lehetőséget.
A létrehozott jogkivonatok megjelennek az Access-jogkivonatok párbeszédpanelen. A Használt érték azt jelzi, hogy mikor érkezett utoljára külső hívás ezzel a jogkivonattal.
A Használt mezőben található N/A azt jelzi, hogy az érzékelő és a csatlakoztatott kiszolgáló közötti kapcsolat nem működik.
A jogkivonat létrehozása után adjon hozzá egy ENGEDÉLYEZÉS címet tartalmazó HTTP-fejlécet a kéréshez, és állítsa az értékét a létrehozott jogkivonatra.
A Sensor API verzióreferenciája
| Verzió | Supported APIs |
|---|---|
| Nincs verzió | Hitelesítés és jelszókezelés: - set_password (Jelszó módosítása) - set_password_by_admin (Felhasználói jelszó frissítése rendszergazda szerint) - érvényesítés (Felhasználói hitelesítő adatok érvényesítése) |
| Új az 1-es verzióban | Leltár: - kapcsolatok (eszköz kapcsolati adatainak lekérése) - cves (Információk lekérése a CVE-ről) - eszközök (Eszközadatok lekérése) Riasztások: - riasztások (riasztási információk lekérése) - események (Idősoresemények lekérése) Biztonsági rések: - működési (működési biztonsági rések lekérése) - eszközök (Eszköz biztonsági résének adatainak lekérése) - kockázatcsökkentés (A kockázatcsökkentési lépések lekérése) - biztonság (Biztonsági rések lekérése) |
| A 2- es verzió újdonságai | Riasztások: - riasztások Frissítések (riasztási információk lekérése) |
Helyszíni felügyeleti konzol API-verzióreferenciája
| Verzió | APIs |
|---|---|
| Nincs verzió | Hitelesítés és jelszókezelés: - set_password (Jelszó módosítása) - set_password_by_admin (Felhasználói jelszó frissítése a rendszergazda által) - érvényesítés (Felhasználói hitelesítő adatok hitelesítése) |
| Új az 1-es verzióban | Helyek - berendezések (OT érzékelő berendezések kezelése) Leltár: - eszközök (Az összes eszközinformáció lekérése) Riasztások: - riasztások (riasztási információk lekérése) - maintenanceWindow (Riasztási kizárások létrehozása) |
| A 2- es verzió újdonságai | Riasztások: - riasztások Frissítések (riasztási információk lekérése) - pcap (Riasztás kérése PCAP) |
| A 3. verzió új verziója | Integrációs API-k: - kapcsolatok (Eszközkapcsolatok lekérése) - eszköz (Eszköz adatainak lekérése) - devicecves (Eszköz cves-ek lekérése) - eszközök (eszközök létrehozása és frissítése) - deleteddevices (Törölt eszközök lekérése) - érzékelők (Érzékelők lekérése) |
Megjegyzés:
Az integrációs API-k célja, hogy folyamatosan fussanak, és folyamatosan futó adatfolyamot hozzanak létre, például új adatok lekérdezésére az elmúlt öt percből. Az integrációs API-k időbélyeggel adnak vissza adatokat.
Az adatok egyszerű lekérdezéséhez használja inkább a hagyományos, nem integrációs API-kat, hogy egy helyszíni felügyeleti konzol lekérdezhesse az összes eszközt, vagy hogy egy adott érzékelő csak az adott érzékelőről kérdezzen le eszközöket.
Időszaki idő
Az IoT-alapú Defender összes időbélyeg-értékében az epoch idő 1970.01.01.
További lépések
For more information, see: