Získání bezpečnostního skóre zařízení
Platí pro:
- Plán 1 pro Microsoft Defender for Endpoint
- Plán 2 pro Microsoft Defender pro koncový bod
- Microsoft Defender XDR
Chcete vyzkoušet Defender pro Endpoint? Zaregistrujte se a získejte bezplatnou zkušební verzi,
Poznámka
Pokud jste zákazníkem státní správy USA, použijte identifikátory URI uvedené v programu Microsoft Defender for Endpoint pro zákazníky státní správy USA.
Tip
Pro lepší výkon můžete použít server blíže k vašemu geografickému umístění:
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
Načte vaše skóre zabezpečení microsoftu pro zařízení. Vyšší skóre zabezpečení microsoftu pro zařízení znamená, že vaše koncové body jsou odolnější proti útokům z kybernetické bezpečnosti.
Oprávnění
K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění. Další informace, včetně toho, jak zvolit oprávnění, najdete v tématu Použití rozhraní MICROSOFT Defender for Endpoint API .
Typ oprávnění | Povolení | Zobrazovaný název oprávnění |
---|---|---|
Application | Score.Read.All | Read Threat and Vulnerability Management Score (Přečíst skóre správy hrozeb a ohrožení zabezpečení) |
Delegovaný (pracovní nebo školní účet) | Score.Read | Read Threat and Vulnerability Management Score (Přečíst skóre správy hrozeb a ohrožení zabezpečení) |
Požadavek HTTP
GET /api/configurationScore
Hlavičky požadavků
Name (Název) | Typ | Popis |
---|---|---|
Oprávnění | String | Nosný {token}. Povinné. |
Text požadavku
Prázdný
Odpověď
V případě úspěchu vrátí tato metoda hodnotu 200 OK s daty skóre zabezpečení zařízení v těle odpovědi.
Příklad
Příklad požadavku
Tady je příklad požadavku.
GET https://api.securitycenter.microsoft.com/api/configurationScore
Příklad odpovědi
Tady je příklad odpovědi.
Poznámka
Tady uvedený seznam odpovědí může být kvůli stručnosti zkrácen.
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
"time": "2019-12-03T09:15:58.1665846Z",
"score": 340
}
Viz také
Tip
Chcete se dozvědět více? Spojte se s komunitou zabezpečení Microsoftu v naší technické komunitě: Technická komunita Microsoft Defenderu for Endpoint.