riskyUser リソースの種類

名前空間: microsoft.graph

危険にさらされている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 を取得する	riskyUser	riskyUser オブジェクトのプロパティとリレーションシップを読み取ります。
riskyUser を無視する	なし	1 つ以上の riskyUser オブジェクトのリスクを 無視します。
危険なユーザーが侵害されたことを確認する	なし	1 つ以上 の riskyUser オブジェクトが侵害されたことを確認します。
履歴を一覧表示する	riskyUserHistoryItem コレクション	history ナビゲーション プロパティから riskyUserHistoryItems を取得します。
履歴を取得する	riskyUserHistoryItem	riskyUserHistoryItem オブジェクトのプロパティとリレーションシップを読み取ります。

プロパティ

プロパティ	型	説明
id	String	危険にさらされているユーザーの一意の ID。
isDeleted	ブール型	ユーザーが削除されているかどうかを示します。 可能な値は、true、false です。
isProcessing	ブール型	バックエンドによってユーザーの危険な状態が処理されているかどうかを示します。
riskDetail	riskDetail	検出されたリスクの詳細。 可能な値は、none、adminGeneratedTemporaryPassword、userPerformedSecuredPasswordChange、userPerformedSecuredPasswordReset、adminConfirmedSigninSafe、aiConfirmedSigninSafe、userPassedMFADrivenByRiskBasedPolicy、adminDismissedAllRiskForUser、adminConfirmedSigninCompromised、hidden、adminConfirmedUserCompromised、unknownFutureValue です。
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	ユーザーのリスクの状態。 可能な値は、none、confirmedSafe、remediated、dismissed、atRisk、confirmedCompromised、unknownFutureValue です。
userDisplayName	String	危険なユーザー表示名。
userPrincipalName	String	危険なユーザー プリンシパル名。

リレーションシップ

リレーションシップ	型	説明
歴史	riskyUserHistoryItem コレクション	ユーザー リスク レベルの変更に関連するアクティビティ

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.riskyUser",
  "id": "String (identifier)",
  "isDeleted": "Boolean",
  "isProcessing": "Boolean",
  "riskLastUpdatedDateTime": "String (timestamp)",
  "riskLevel": "String",
  "riskState": "String",
  "riskDetail": "String",
  "userDisplayName": "String",
  "userPrincipalName": "String"
}