riskyUser リソースの種類riskyUser resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

危険にさらされている Azure AD ユーザーを表します。Represents Azure AD users who are at risk. Azure AD は、さまざまなシグナルやマシン学習に基づいて、ユーザーのリスクを継続的に評価します。Azure AD continually evaluates user risk based on various signals and machine learning. この API は、プログラムによって Azure AD 内のすべてのリスクユーザーにアクセスを提供します。This API provides programmatic access to all at-risk users in your Azure AD.

リスクイベントの詳細については、「 Azure Active Directory Id 保護」を参照してください。For more information about risk events, see Azure Active Directory Identity Protection.

注: RiskyUsers API を使用するには、Azure AD Premium P2 ライセンスが必要です。Note: Using the riskyUsers API requires an Azure AD Premium P2 license.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
リスト riskyUsersList riskyUsers riskyUserコレクションriskyUser collection リスクの高いユーザーとそのプロパティを一覧表示します。List risky users and their properties.
RiskyUser を取得するGet riskyUser riskyUserriskyUser 特定の危険なユーザーおよびそのプロパティを取得します。Get a specific risky user and its properties.
リストの履歴List history riskyUserHistoryItemコレクションriskyUserHistoryItem collection Azure AD ユーザーのリスク履歴を取得します。Get the risk history of an Azure AD user.
RiskyUsers が侵害されたことを確認するConfirm riskyUsers compromised NoneNone 危険なユーザーが侵害されていることを確認します。Confirm a risky user as compromised.
RiskyUsers を閉じるDismiss riskyUsers NoneNone 危険なユーザーのリスクを無視します。Dismiss the risk of a risky user.

プロパティProperties

プロパティProperty Type 説明Description
id string 危険にさらされているユーザーの一意の idUnique id of the user at risk
isDeleted bool ユーザーが削除されるかどうかを示します。Indicates whether the user is deleted. 可能な値はtrue、です。falsePossible values are: true, false
isGuest bool ユーザーがゲストユーザーであるかどうかを示します。Indicates whether the user is a guest user. 可能な値は、truefalse です。Possible values are: true, false. True の場合は、ユーザーの id がテナントの外部にある場合に考慮します。True if user’s identity lies outside of the tenant in consideration. このユーザーは、Azure AD、MSA、またはサードパーティの id プロバイダーで id を持つ B2B または B2C ユーザーの場合があります。This user could be a B2B or a B2C user with identity in Azure AD, MSA or 3rd party identity provider. False 場合は、ユーザーの id がテナントの内側にある場合False if user’s identity lies inside the tenant in consideration
isProcessing bool ユーザーの危険な状態がバックエンドによって処理されていることを示します。Indicates wehther a user's risky state is being processed by the backend
riskLastUpdatedDateTime datetime 危険性のあるユーザーが最後に更新された日時The date and time that the risky user was last updated
riskLevel riskLevel 使用可能な値は、low、medium、high、hidden、none、Unknownfuturevalue というです。The possible values are low, medium, high, hidden, none, unknownFutureValue.
riskState riskState 使用可能な値は、none、confirmedSafe、修復済み、atRisk、Unknownfuturevalue というです。The possible values are none, confirmedSafe, remediated, atRisk, unknownFutureValue.
riskDetail riskDetail 使用可能な値は、none、adminGeneratedTemporaryPassword、userPerformedSecuredPasswordChange、userPerformedSecuredPasswordReset、adminConfirmedSigninSafe、aiConfirmedSigninSafe、userPassedMFADrivenByRiskBasedPolicy、adminDismissedAllRiskForUser、adminConfirmedSigninCompromised、hidden、adminConfirmedUserCompromised、Unknownfuturevalue という。The possible values are none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, hidden, adminConfirmedUserCompromised, unknownFutureValue.
userDisplayName string 危険ユーザーの表示名Risky user display name
userPrincipalName string 危険ユーザープリンシパル名Risky user principal name

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
履歴history riskyUserHistoryItemコレクションriskyUserHistoryItem collection Azure ad Id 保護によって決定された Azure AD ユーザーのリスク履歴を表します。Represents the risk history of an Azure AD user as determined by Azure AD Identity Protection.

JSON 表記JSON representation

以下は、リソースの JSON 表記です。Here is a JSON representation of the resource.

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