Obter pontuação de exposição
Aplica-se a:
- Plano 1 do Microsoft Defender para Ponto de Extremidade
- Plano 2 do Microsoft Defender para Ponto de Extremidade
- Microsoft Defender XDR
Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita.
Observação
Se for um cliente do Governo norte-americano, utilize os URIs listados no Microsoft Defender para Ponto de Extremidade para clientes do Us Government.
Dica
Para um melhor desempenho, pode utilizar o servidor mais próximo da localização geográfica:
- 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
Importante
Algumas informações neste artigo estão relacionadas ao produto pré-lançado que pode ser modificado substancialmente antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, com relação às informações aqui fornecidas.
Obtém a pontuação de exposição organizacional.
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, veja Utilizar Microsoft Defender para Ponto de Extremidade APIs
| Tipo de permissão | Permissão | Nome a apresentar da permissão |
|---|---|---|
| Application | Score.Read.All | "Ler a classificação de Gestão de Ameaças e Vulnerabilidades" |
| Delegado (conta corporativa ou de estudante) | Score.Read | "Ler a classificação de Gestão de Ameaças e Vulnerabilidades" |
Solicitação HTTP
GET /api/exposureScore
Cabeçalhos de solicitação
| Nome | Tipo | Descrição |
|---|---|---|
| Autorização | Cadeia de caracteres | {token} de portador. Obrigatório. |
Corpo da solicitação
Vazio
Resposta
Se for bem-sucedido, este método devolve 200 OK, com os dados de exposição no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
GET https://api.security.microsoft.com/api/exposureScore
Resposta
Veja a seguir um exemplo da resposta.
Observação
A lista de respostas aqui apresentada pode ser truncada por questões de brevidade.
{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#ExposureScore/$entity",
"time": "2019-12-03T07:23:53.280499Z",
"score": 33.491554051195706
}
Confira também
- Gerenciamento de Vulnerabilidades do Microsoft Defender
- Gerenciamento de Vulnerabilidades do Defender pontuação de exposição
Dica
Você deseja aprender mais? Engage com a comunidade de Segurança da Microsoft na nossa Comunidade Tecnológica: Microsoft Defender para Ponto de Extremidade Tech Community.