Microsoft Defender XDR API にアクセスする

Microsoft Defender XDRは、一連のプログラム API を通じて、そのデータとアクションの多くを公開します。 これらの API は、ワークフローを自動化し、Microsoft Defender XDRの機能を最大限に活用するのに役立ちます。

一般に、API を使用するには、次の手順を実行する必要があります。

• Microsoft Entra アプリケーションを作成する
• このアプリケーションを使用してアクセス トークンを取得する
• トークンを使用してMicrosoft Defender XDR API にアクセスする

これらの手順を完了すると、特定のコンテキストを使用してMicrosoft Defender XDR API にアクセスする準備が整います。

アプリケーション コンテキスト (推奨)

バックグラウンド サービスやデーモンなど、サインインしているユーザーが存在せずに実行されるアプリには、このコンテキストを使用します。

1. Microsoft Entra Web アプリケーションを作成します。
2. 目的のアクセス許可をアプリケーションに割り当てます。
3. アプリケーションのキーを作成します。
4. アプリケーションとそのキーを使用してセキュリティ トークンを取得します。
5. トークンを使用して、Microsoft Defender XDR API にアクセスします。

詳細については、「ユーザーなしでMicrosoft Defender XDRにアクセスするアプリを作成する」を参照してください。

ユーザー コンテキスト

このコンテキストを使用して、1 人のユーザーに代わってアクションを実行します。

1. Microsoft Entra ネイティブ アプリケーションを作成します。
2. 目的のアクセス許可をアプリケーションに割り当てます。
3. アプリケーションのユーザー資格情報を使用してセキュリティ トークンを取得します。
4. トークンを使用して、Microsoft Defender XDR API にアクセスします。

詳細については、「ユーザーの代わりにMicrosoft Defender XDR API にアクセスするアプリを作成する」を参照してください。

パートナー コンテキスト

複数のテナントにまたがる多くのユーザーにアプリを提供する必要がある場合は、このコンテキスト を使用します。

1. Microsoft Entra マルチテナント アプリケーションを作成します。
2. 目的のアクセス許可をアプリケーションに割り当てます。
3. 各テナントからアプリの 管理者の同意 を取得します。
4. 顧客のテナント ID に基づいて、ユーザー資格情報を使用してセキュリティ トークンを取得します。
5. トークンを使用して、Microsoft Defender XDR API にアクセスします。

詳細については、「Microsoft Defender XDR API へのパートナー アクセス権を持つアプリを作成する」を参照してください。

関連記事

• Microsoft Graph セキュリティ API を使用する - Microsoft Graph |Microsoft Learn

• Microsoft Defender XDR API の概要

• ユーザー サインインと API アクセスに対する OAuth 2.0 承認

• Azure Key Vaultを使用してサーバー アプリのシークレットを管理する

• Microsoft 365 API にアクセスする "Hello world" アプリケーションを作成する