riskDetection リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

Microsoft Entra テナントで検出されたリスクに関する情報を表します。

Microsoft Entra ID Protection は、さまざまなシグナルと機械学習に基づいて、ユーザー リスクとアプリまたはユーザーのサインイン リスクを継続的に評価します。 この API を使用すると、Microsoft Entra 環境内のすべてのリスク検出にプログラムでアクセスできます。

リスク検出の詳細については、「Microsoft Entra ID 保護」と「リスク検出とは」を参照してください。

注:

リスク検出データの可用性は、Microsoft Entra データ保持ポリシーによって管理されます。

メソッド

メソッド 戻り値の型 説明
List riskDetection コレクション リスク検出とそのプロパティを一覧表示します。
Get riskDetection 特定の危険性のある検出とそのプロパティを取得します。

プロパティ

プロパティ 型 説明
アクティビティ activityType 検出されたリスクがリンクされているアクティビティの種類を示します。
activityDateTime DateTimeOffset 危険なアクティビティが発生した日時。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
additionalInfo string リスク検出に関連する追加情報 (JSON 形式)。
correlationId string リスク検出に関連付けられているサインインの関連付け ID。 リスク検出がサインインに関連付けられていない場合、このプロパティは null です。
detectedDateTime DateTimeOffset リスクが検出された日時。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
detectionTimingType riskDetectionTimingType 検出されたリスクのタイミング (リアルタイム/オフライン)。 指定できる値は、 notDefined、 realtime、 nearRealtime、 offline、 unknownFutureValue です。
id string リスク検出の一意の ID。
ipAddress string リスクが発生したクライアントの IP アドレスを提供します。
lastUpdatedDateTime DateTimeOffset リスク検出が最後に更新された日時。
location signInLocation サインインの場所。
requestId string リスク検出に関連付けられているサインインの要求 ID。 リスク検出がサインインに関連付けられていない場合、このプロパティは null です。
riskEventType 文字列 検出されたリスク イベントの種類。 可能な値は、 adminConfirmedUserCompromised、 anomalousUserActivity、 anomalousToken、 anonymizedIPAddress、attackerinTheMiddle、attemptedPRTAccess、 generic、 investigationsThreatIntelligence、 investigationsThreatIntelligenceSigninLinked、leakedCredentials、 maliciousIPAddress、 maliciousIPAddressValidCredentialsBlockedIP、 malwareInfectedIPAddress、 mcasImpossibleTravel、mcasFinSuspiciousFileAccess、 mcasSuspiciousInboxManipulationRules、nationStateIP、 newCountry、 passwordSpray、 riskyIPAddress、 suspiciousAPITraffic、 suspiciousBrowser、 suspiciousInboxForwarding、 suspiciousIPAddress、suspiciousSendingPatterns、 tokenIssuerAnomaly、 unfamiliarFeatures、 unlikelyTravel、 userReportedSuspiciousActivity です。
各値の詳細については、 リスクの種類と検出を参照してください。
riskDetail riskDetail 検出されたリスクの詳細。

メモ:このプロパティの詳細は、Microsoft Entra ID P2 のお客様のみが利用できます。 P1 の顧客は hidden返されます。
riskLevel riskLevel 検出されたリスクのレベル。 可能な値は、 low、 medium、 high、 hidden、 none、 unknownFutureValue です。
メモ:このプロパティの詳細は、Microsoft Entra ID P2 のお客様のみが利用できます。 P1 の顧客は hidden返されます。
riskState riskState 検出された危険なユーザーまたはサインインの状態。 指定できる値は、 none、 confirmedSafe、 remediated、 dismissed、 atRisk、 confirmedCompromised、 unknownFutureValue です。
source string リスク検出のソース。 たとえば、「 activeDirectory 」のように入力します。
tokenIssuerType tokenIssuerType 検出されたサインイン リスクに対するトークン発行者の種類を示します。 使用可能な値は AzureAD、ADFederationServices、および unknownFutureValue。
userId string ユーザーの一意の ID。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
userDisplayName string ユーザーの名前
userPrincipalName string ユーザーのユーザー プリンシパル名 (UPN)。
riskType (非推奨) riskEventType リスク イベントの種類の一覧。
メモ: このプロパティは非推奨です。 代わりに riskEventType を使用してください。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
 "id": "string",
    "requestId": "string",
    "correlationId": "string",
    "riskType": {"@odata.type": "microsoft.graph.riskEventType"},
    "riskState": {"@odata.type": "microsoft.graph.riskState"},
    "riskLevel": {"@odata.type": "microsoft.graph.riskLevel"},
    "riskDetail": {"@odata.type": "microsoft.graph.riskDetail"},
    "source": "string",
    "detectionTimingType": {"@odata.type": "microsoft.graph.riskDetectionTimingType"},
    "activity": {"@odata.type": "microsoft.graph.riskUserActivity"},
    "tokenIssuerType": {"@odata.type": "microsoft.graph.tokenIssuerType"},
    "ipAddress": "string",
    "location": {"@odata.type": "microsoft.graph.signInLocation"},
    "activityDateTime": "string (timestamp)",
    "detectedDateTime": "string (timestamp)",
    "lastUpdatedDateTime": "string (timestamp)",
    "userId": "string",
    "userDisplayName": "string",
    "userPrincipalName": "string",
    "additionalInfo": "string"
}
  • 最終更新: