Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Popis rozhraní API
Izoluje zařízení od přístupu k externí síti.
Při izolování zařízení jsou povolené jenom určité procesy a cíle. Proto se zařízení, která jsou za úplným tunelem VPN, nebudou po izolaci zařízení moci připojit ke cloudové službě Microsoft Defender for Endpoint. Pro přenosy Microsoft Defender for Endpoint a Microsoft Defender Antivirové ochrany doporučujeme používat síť VPN s rozděleným tunelovým propojením.
Voláním tohoto rozhraní API na nespravovaných zařízeních se aktivuje akce obsahující zařízení ze sítě . Hodnota IsolationType by měla být nastavená na UnManagedDevice.
Omezení
Omezení rychlosti pro toto rozhraní API jsou 100 volání za minutu a 1 500 volání za hodinu.
Požadavky
Podporované operační systémy
- Úplná izolace je k dispozici pro zařízení ve Windows 10 verze 1703 a na Windows 11.
- Úplná izolace je k dispozici pro všechna podporovaná Linux zařízení. Viz Microsoft Defender for Endpoint na Linux.
- Selektivní izolace je k dispozici pro zařízení v Windows 10 verze 1709 nebo novější a na Windows 11.
Oprávnění
Při získávání tokenu pomocí přihlašovacích údajů uživatele:
- Uživatel musí mít alespoň následující oprávnění role: Aktivní akce nápravy. Další informace najdete v tématu Vytváření a správa rolí.
- Uživatel musí mít přístup k zařízení na základě nastavení skupiny zařízení. Další informace najdete v tématu Vytváření a správa skupin zařízení.
K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění. Další informace, včetně postupu výběru oprávnění, najdete v tématu Použití rozhraní MICROSOFT DEFENDER FOR ENDPOINT API.
| Typ oprávnění | Oprávnění | Zobrazovaný název oprávnění |
|---|---|---|
| Application | Machine.Isolate | Izolovat počítač |
| Delegovaný (pracovní nebo školní účet) | Machine.Isolate | Izolovat počítač |
Požadavek HTTP
POST https://api.security.microsoft.com/api/machines/{id}/isolate
Hlavičky požadavků
| Name (Název) | Typ | Popis |
|---|---|---|
| Autorizace | String | Nosný {token}. Povinné. |
| Typ obsahu | řetězec | application/json. Povinné. |
Text požadavku
V textu požadavku zadejte objekt JSON s následujícími parametry:
| Parametr | Typ | Popis |
|---|---|---|
| Komentování | String | Komentář, který chcete přidružit k akci. Povinné. |
| IsolationType | String | Typ izolace. Povolené hodnoty jsou : Full, Selective nebo UnManagedDevice. |
IsolationType určuje typ izolace, který se má provést, a může to být jedna z následujících možností:
- Úplná: Úplná izolace. Funguje pro spravovaná zařízení.
- Selektivní: Omezte přístup k síti na spravovaných zařízeních pouze omezené sadě aplikací. Další informace najdete v tématu Izolace zařízení od sítě.
- UnManagedDevice: Izolace cílí jenom na nespravovaná zařízení.
Reakce
Pokud je tato metoda úspěšná, vrátí v těle odpovědi kód odpovědi 201 – Vytvořený kód odpovědi a machine action .
Příklad
Požadavek
Tady je příklad požadavku.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/isolate
{
"Comment": "Isolate machine due to alert 1234",
"IsolationType": "Full"
}