Referenční informace k rozhraní API služby Defender for IoT
Tato část popisuje veřejná rozhraní API podporovaná v programu Microsoft Defender for IoT. Rozhraní API Defenderu pro IoT se řídí licenčními podmínkami a podmínkami použití rozhraní API microsoftu.
Pomocí rozhraní API Defenderu pro IoT můžete přistupovat k datům zjištěným senzory a místními konzolami pro správu a provádět s daty akce.
Připojení rozhraní API jsou zabezpečená přes protokol SSL.
Generování přístupového tokenu rozhraní API
Mnoho rozhraní API Defenderu pro IoT vyžaduje přístupový token. Pro rozhraní API pro ověřování se nevyžadují přístupové tokeny.
Generování tokenu:
V okně Systémové Nastavení vyberte Přístupové tokeny> integrace.
Vyberte Vygenerovat token.
V popisu popište, k čemu nový token slouží, a vyberte Vygenerovat.
Zobrazí se přístupový token. Zkopírujte ho, protože se znovu nezobrazí.
Vyberte Dokončit.
Tokeny, které vytvoříte, se zobrazí v dialogovém okně Přístupové tokeny . Použité označuje čas posledního přijetí externího volání s tímto tokenem.
Není k dispozici v poli Použité označuje, že připojení mezi senzorem a připojeným serverem nefunguje.
Po vygenerování tokenu přidejte do požadavku hlavičku HTTP s názvem Autorizace a nastavte její hodnotu na token, který jste vygenerovali.
Referenční informace k verzi rozhraní SENSOR API
| Verze | Podporovaná rozhraní API |
|---|---|
| Bez verze | Ověřování a správa hesel: - set_password (změna hesla) - set_password_by_admin (aktualizace uživatelského hesla správcem) - ověření (ověření přihlašovacích údajů uživatele) |
| Novinka ve verzi 1 | Inventář: - připojení (načtení informací o připojení zařízení) - cves (Načtení informací o CVEs) - zařízení (načtení informací o zařízení) Výstrahy: - výstrahy (načtení informací o upozorněních) - události (načtení událostí časové osy) Ohrožení zabezpečení: - operational (načtení provozních ohrožení zabezpečení) - zařízení (načtení informací o ohrožení zabezpečení zařízení) - zmírnění rizik (načtení kroků pro zmírnění rizik) - zabezpečení (načtení ohrožení zabezpečení) |
| Novinka ve verzi 2 | Výstrahy: – Aktualizace k upozorněním (načtení informací o výstrahách) |
Referenční informace k verzi rozhraní API místní konzoly pro správu
| Verze | Rozhraní API |
|---|---|
| Bez verze | Ověřování a správa hesel: - set_password (změna hesla) - set_password_by_admin (aktualizace uživatelského hesla správcem systému) - ověřování (ověření přihlašovacích údajů uživatele) |
| Novinka ve verzi 1 | Stránky - zařízení (správa zařízení snímačů OT) Inventář: - zařízení (načtení všech informací o zařízeních) Výstrahy: - výstrahy (načtení informací o upozorněních) - maintenanceWindow (vytvoření vyloučení výstrah) |
| Novinka ve verzi 2 | Výstrahy: – Aktualizace k upozorněním (načtení informací o výstrahách) - pcap (žádost o upozornění PCAP) |
| Novinka ve verzi 3 | Rozhraní API pro integraci: - připojení (získání připojení zařízení) - (Získání podrobností o zařízení) - devicecves (Získání cves zařízení) - zařízení (vytvoření a aktualizace zařízení) - odstraněná zařízení (získání odstraněných zařízení) - senzory (získání senzorů) |
Poznámka:
Rozhraní API pro integraci mají běžet nepřetržitě a vytvářet neustále spuštěný datový proud, jako je dotazování na nová data z posledních pěti minut. Rozhraní API pro integraci vrací data s časovým razítkem.
Pokud chcete jednoduše dotazovat data, použijte místo toho běžná rozhraní API bez integrace, ať už místní konzola pro správu k dotazování na všechna zařízení, nebo pro konkrétní senzor k dotazování zařízení pouze z daného senzoru.
Epocha
Ve všech hodnotách časového razítka Defenderu pro IoT se čas Epoch rovná 1/1/1/1970.
Další kroky
Další informace naleznete v tématu: