Aceder às APIs Microsoft Defender XDR

O Microsoft Defender expõe grande parte dos seus dados e ações através de um conjunto de APIs programáticas. Estas APIs ajudam-no a automatizar fluxos de trabalho e a tirar pleno partido das capacidades do Microsoft Defender.

Em geral, terá de seguir os seguintes passos para utilizar as APIs:

• Criar uma aplicação Microsoft Entra
• Obter um token de acesso com esta aplicação
• Use o token para aceder à API do Microsoft Defender

Depois de completares estes passos, estás pronto para aceder à API do Microsoft Defender usando um contexto específico.

Contexto da aplicação (Recomendado)

Utilize este contexto para aplicações que são executadas sem um utilizador com sessão iniciada presente, como serviços em segundo plano ou daemons.

1. Crie uma aplicação Web Microsoft Entra.
2. Atribua as permissões pretendidas à aplicação.
3. Crie uma chave para a aplicação.
4. Obtenha um token de segurança com a aplicação e a respetiva chave.
5. Use o token para aceder à API do Microsoft Defender.

Para mais informações, consulte Criar uma aplicação para aceder ao Microsoft Defender sem utilizador.

Contexto do utilizador

Utilize este contexto para efetuar ações em nome de um único utilizador.

1. Crie uma Microsoft Entra aplicação nativa.
2. Atribua a permissão pretendida à aplicação.
3. Obtenha um token de segurança com as credenciais de utilizador da aplicação.
4. Use o token para aceder à API do Microsoft Defender.

Para mais informações, consulte Criar uma aplicação para aceder às APIs do Microsoft Defender em nome de um utilizador.

Contexto de parceiro

Use este contexto quando precisar de fornecer uma aplicação a muitos utilizadores em múltiplos inquilinos.

1. Crie um Microsoft Entra aplicação multi-inquilino.
2. Atribua a permissão pretendida à aplicação.
3. Obtenha o consentimento do administrador para a aplicação de cada inquilino.
4. Obtenha um token de segurança com as credenciais de utilizador com base no ID de inquilino de um cliente.
5. Use o token para aceder à API do Microsoft Defender.

Para mais informações, consulte Criar uma aplicação com acesso de parceiro às APIs do Microsoft Defender.

Artigos relacionados

• Utilizar a API de segurança do Microsoft Graph – Microsoft Graph | Microsoft Learn

• descrição geral das APIs Microsoft Defender XDR

• Autorização OAuth 2.0 para início de sessão do utilizador e acesso à API

• Gerir segredos nas suas aplicações de servidor com Azure Key Vault

• Criar uma aplicação "Hello world" que acede às APIs do Microsoft 365