Доступ к API Microsoft Defender XDR

Microsoft Defender предоставляет большую часть своих данных и действий с помощью набора программных API. Эти API помогают автоматизировать рабочие процессы и использовать возможности Microsoft Defender.

Как правило, для использования API необходимо выполнить следующие действия:

• Создание приложения Microsoft Entra
• Получение маркера доступа с помощью этого приложения
• Использование маркера для доступа к API Microsoft Defender

После выполнения этих действий вы будете готовы получить доступ к API Microsoft Defender с помощью определенного контекста.

Контекст приложения (рекомендуется)

Используйте этот контекст для приложений, которые выполняются без вошедшего пользователя, например фоновых служб или управляющих программ.

1. Создайте веб-приложение Microsoft Entra.
2. Назначьте приложению необходимые разрешения.
3. Создайте ключ для приложения.
4. Получите маркер безопасности с помощью приложения и его ключа.
5. Используйте маркер для доступа к API Microsoft Defender.

Дополнительные сведения см. в статье "Создание приложения для доступа к Microsoft Defender без пользователя".

Контекст пользователя

Используйте этот контекст для выполнения действий от имени одного пользователя.

1. Создание собственного приложения Microsoft Entra.
2. Назначьте приложению требуемое разрешение.
3. Получите маркер безопасности, используя учетные данные пользователя для приложения.
4. Используйте маркер для доступа к API Microsoft Defender.

Дополнительные сведения см. в статье "Создание приложения для доступа к MICROSOFT DEFENDER API от имени пользователя".

Контекст партнера

Используйте этот контекст, если необходимо предоставить приложению многим пользователям в нескольких клиентах.

1. Создание мультитенантного приложения Microsoft Entra.
2. Назначьте приложению требуемое разрешение.
3. Получите согласие администратора для приложения из каждого клиента.
4. Получите маркер безопасности, используя учетные данные пользователя на основе идентификатора клиента.
5. Используйте маркер для доступа к API Microsoft Defender.

Дополнительные сведения см. в статье "Создание приложения с партнерским доступом к Microsoft Defender API".

Статьи по теме

• Использование API безопасности Microsoft Graph — Microsoft Graph | Microsoft Learn

• Общие сведения об API Microsoft Defender XDR

• Авторизация OAuth 2.0 для входа пользователей и доступа к API

• Управление секретами в серверных приложениях с помощью Azure Key Vault

• Создание приложения Hello world, которое обращается к API Microsoft 365