Usar a API de avaliação de ameaças do Microsoft Graph
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
A API de avaliação de ameaças do Microsoft Graph ajuda as organizações a avaliar a ameaça recebida por qualquer usuário em um locatário. Isso permite que os clientes relatem emails de spam, URLs de phishing ou anexos de malware recebidos na Microsoft. Os resultados da verificação de política e os resultados ao verificar novamente, podem ajudar os administradores de locatários a entender o veredicto da verificação de ameaças e ajustar sua política organizacional.
Autorização
O Microsoft Graph controla o acesso a recursos por meio de permissões. Você deve especificar as permissões necessárias para acessar os recursos de avaliação de ameaças. Normalmente, você especifica permissões no centro de administração do Microsoft Entra. Para saber mais, confira Referência de permissões do Microsoft Graph e Permissões de avaliação de ameaças.
Casos de uso comuns
A API de avaliação de ameaças do Microsoft Graph fornece métodos para listar, criar e obter solicitações de avaliação de ameaças e recuperar os resultados da avaliação.
| Casos de uso | Recursos REST | Confira também |
|---|---|---|
| Listar, criar e obter solicitações de avaliação de ameaças |
threatAssessmentRequest mailAssessmentRequest emailFileAssessmentRequest fileAssessmentRequest urlAssessmentRequest |
Create threatAssessmentRequest Get threatAssessmentRequest List threatAssessmentRequest |
| Obter os resultados da avaliação de ameaças | threatAssessmentResult | Get threatAssessmentResult |
Próximas etapas
As APIs e recursos da avaliação de ameaças podem criar novas maneiras de você se relacionar com os usuários e gerenciar as experiências deles com o Microsoft Graph. Para saber mais:
- Faça um drill down em métodos, propriedades e relações dos recursos de solicitação de avaliação de ameaças e deresultado da avaliação de ameaças.
- Experimente a API no Explorador do Graph.