riskDetection リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

重要

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

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

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

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

注:

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

メソッド

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

プロパティ

プロパティ 型 説明
アクティビティ activityType 検出されたリスクがリンクされているアクティビティの種類を示します。 使用可能な値は、 signin、 user、 unknownFutureValueです。
activityDateTime DateTimeOffset 危険なアクティビティが発生した日時。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
additionalInfo 文字列 JSON 形式のリスク検出に関連する追加情報。
correlationId 文字列 リスク検出に関連付けられているサインインの関連付け 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 文字列 リスクが発生したクライアントの IP アドレスを提供します。
lastUpdatedDateTime DateTimeOffset リスク検出が最後に更新された日時。
location signInLocation サインインの場所。
requestId 文字列 リスク検出に関連付けられているサインインの要求 ID。 リスク検出がサインインに関連付けられていない場合、このプロパティは null です。
riskEventType String 検出されたリスク イベントの種類。 使用できる値は、 adminConfirmedUserCompromised、 anomalousUserActivity、 anonymizedIPAddress、attackerinTheMiddle、attemptedPRTAccess、 generic、 investigationsThreatIntelligence、 investigationsThreatIntelligenceSigninLinked、leakedCredentials、 maliciousIPAddress、 maliciousIPAddressValidCredentialsBlockedIP、 malwareInfectedIPAddress、 mcasImpossibleTravel、mcasFinSuspiciousFileAccessmcasSuspiciousInboxManipulationRules、nationStateIP、 suspiciousAPITraffic、 suspiciousIPAddress、suspiciousSendingPatterns、 unfamiliarFeatures、 unlikelyTravel、 userReportedSuspiciousActivityです。
各値の詳細については、「 リスクの種類と検出」を参照してください。
riskDetail riskDetail 検出されたリスクの詳細。 使用できる値は、 none、 adminGeneratedTemporaryPassword、 userPerformedSecuredPasswordChange、 userPerformedSecuredPasswordReset、 adminConfirmedSigninSafe、 aiConfirmedSigninSafe、 userPassedMFADrivenByRiskBasedPolicy、 adminDismissedAllRiskForUser、 adminConfirmedSigninCompromised、 hidden、 adminConfirmedUserCompromised、 unknownFutureValue、 adminConfirmedServicePrincipalCompromised、 adminDismissedAllRiskForServicePrincipal、 m365DAdminDismissedDetectionです。 Prefer: include - unknown -enum-members要求ヘッダーを使用して、この進化可能な列挙型で次の値を取得する必要があることに注意してください。adminConfirmedServicePrincipalCompromised、adminDismissedAllRiskForServicePrincipal、m365DAdminDismissedDetection。

手記： このプロパティの詳細は、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 文字列 リスク検出のソース。 たとえば、「 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"
}