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 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ě Nastavení systému 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 výstrah (načtení informací o upozorněních) |
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, aby se konkrétní senzor dotazuje jenom na zařízení 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: