Microsoft Graph の脅威評価 API を使用する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Graph の脅威評価 API は、テナント内のユーザーが受け取った脅威を組織が評価する上で役立ちます。 この API は、受信した迷惑メール、フィッシング URL、マルウェアの添付ファイルをお客様が Microsoft に報告するための手段を提供します。 ポリシーの確認結果と再スキャンの結果は、テナント管理者が脅威スキャニングの判定を理解し、組織ポリシーを調整する上で役に立ちます。
Authorization
Microsoft Graph では、アクセス許可によってリソースへのアクセスを制御します。 脅威評価リソースにアクセスするために必要なアクセス許可を指定する必要があります。 通常、Microsoft Entra 管理センターでアクセス許可を指定します。 詳細については、「Microsoft Graph のアクセス許可のリファレンス」および「脅威評価のアクセス許可」を参照してください。
一般的なユース ケース
Microsoft Graph 脅威評価 API では、脅威評価要求を一覧表示、作成、取得する方法および評価結果を取得する方法が提供されています。
ユース ケース | REST リソース | 関連項目 |
---|---|---|
脅威評価要求を一覧表示、作成、および取得する |
threatAssessmentRequest mailAssessmentRequest emailFileAssessmentRequest fileAssessmentRequest urlAssessmentRequest |
Create threatAssessmentRequest Get threatAssessmentRequest List threatAssessmentRequest |
脅威評価結果を取得する | threatAssessmentResult | Get threatAssessmentResult |
次のステップ
脅威評価リソースと API により、ユーザーとの連携や、ユーザーの Microsoft Graph のエクスペリエンスを管理する新しい方法が提供されます。 詳細情報:
- 脅威評価要求リソースおよび脅威評価結果リソースの methods、properties、および relationships に関する詳細を確認してください。
- Graph エクスプローラーで API をお試しください。