riskyUser リソースの種類

名前空間: microsoft.graph

重要

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

危険にさらされているAzure ADユーザーを表します。 Azure ADは、さまざまなシグナルと機械学習に基づいてユーザー リスクを継続的に評価します。 この API を使用すると、Azure AD内のすべてのリスクの高いユーザーにプログラムでアクセスできます。

リスク イベントの詳細については、「Azure Active Directory Identity Protection」を参照してください。

注意

  1. riskyUsers API を使用するには、Azure AD Premium P2 ライセンスが必要です。
  2. リスクの高いユーザー データの可用性は、Azure ADデータ保持ポリシーによって管理されます。

メソッド

メソッド 戻り値の型 説明
list riskyUsers riskyUser コレクション 危険なユーザーとそのプロパティを一覧表示します。
riskyUser を取得する riskyUser 特定の危険なユーザーとそのプロパティを取得します。
履歴を一覧表示する riskyUserHistoryItem コレクション Azure AD ユーザーのリスク履歴を取得します。
riskyUsers が侵害されたことを確認する なし 危険なユーザーが侵害されたことを確認します。
riskyUsers を無視する なし 危険なユーザーのリスクを無視します。

プロパティ

プロパティ 説明
id string 危険にさらされているユーザーの一意の ID。
isDeleted ブール値 ユーザーが削除されているかどうかを示します。 可能な値は、truefalse です。
isProcessing ブール値 バックエンドによってユーザーの危険な状態が処理されているかどうかを示します。
riskLastUpdatedDateTime DateTimeOffset 危険なユーザーが最後に更新された日時。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
riskLevel riskLevel 検出された危険なユーザーのレベル。 指定できる値はlow、 , , medium, high``hidden, none. unknownFutureValue
riskState riskState ユーザーのリスクの状態。 可能な値は、noneconfirmedSaferemediateddismissedatRiskconfirmedCompromisedunknownFutureValue です。
riskDetail riskDetail 指定できる値はnone、 , , , adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, adminConfirmedSigninSafe``userPerformedSecuredPasswordReset, adminDismissedAllRiskForUser``adminConfirmedUserCompromised``adminConfirmedSigninCompromised``unknownFutureValue``aiConfirmedSigninSafe``userPassedMFADrivenByRiskBasedPolicy``hidden.
userDisplayName string 危険なユーザー表示名。
userPrincipalName string 危険なユーザー プリンシパル名。

リレーションシップ

なし。

JSON 表記

リソースの JSON 表記を次に示します。

{
"id": "string",
"riskLastUpdatedDateTime": "dateTimeOffset",
"isProcessing": "boolean",
"isDeleted": "boolean",
"riskDetail":  "string",
"riskLevel":  "string",
"riskState":  "string",
"userDisplayName": "string",
"userPrincipalName": "string"
}