riskyUser-RessourcentypriskyUser resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Stellt Azure AD Benutzer dar, die gefährdet sind.Represents Azure AD users who are at risk. Azure AD evaluiert das Benutzer Risiko kontinuierlich anhand verschiedener Signale und maschineller Lernprozesse.Azure AD continually evaluates user risk based on various signals and machine learning. Diese API bietet programmgesteuerten Zugriff auf alle gefährdeten Benutzer in ihrer Azure AD.This API provides programmatic access to all at-risk users in your Azure AD.

Weitere Informationen zu Risikoereignissen finden Sie unter Azure Active Directory Identity Protection.For more information about risk events, see Azure Active Directory Identity Protection.

Hinweis: Für die Verwendung der riskyUsers-API ist eine Azure AD Premium P2-Lizenz erforderlich.Note: Using the riskyUsers API requires an Azure AD Premium P2 license.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
RiskyUsers auflistenList riskyUsers riskyUser -SammlungriskyUser collection Listen riskanter Benutzer und deren Eigenschaften auf.List risky users and their properties.
RiskyUser abrufenGet riskyUser riskyUserriskyUser Abrufen eines bestimmten riskanten Benutzers und seiner Eigenschaften.Get a specific risky user and its properties.
Listen VerlaufList history riskyUserHistoryItem -SammlungriskyUserHistoryItem collection Rufen Sie den Risikoverlauf eines Azure AD Benutzers ab.Get the risk history of an Azure AD user.
Bestätigen, dass riskyUsers kompromittiert wurdeConfirm riskyUsers compromised KeineNone Bestätigen Sie einen riskanten Benutzer als kompromittiert.Confirm a risky user as compromised.
RiskyUsers schließenDismiss riskyUsers KeineNone Schließen Sie das Risiko eines riskanten Benutzers ab.Dismiss the risk of a risky user.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
id string Eindeutige ID des gefährdeten BenutzersUnique id of the user at risk
isDeleted bool Gibt an, ob der Benutzer gelöscht wird.Indicates whether the user is deleted. Mögliche Werte sind: true,falsePossible values are: true, false
isGuest bool Gibt an, ob der Benutzer ein Gastbenutzer ist.Indicates whether the user is a guest user. Mögliche Werte sind: true und false.Possible values are: true, false. True, wenn die Identität des Benutzers außerhalb des Mandanten liegt, der berücksichtigt wird.True if user’s identity lies outside of the tenant in consideration. Dieser Benutzer kann ein B2B-oder ein B2C-Benutzer mit Identität in Azure AD, MSA oder Drittanbieter-Identitätsanbieter sein.This user could be a B2B or a B2C user with identity in Azure AD, MSA or 3rd party identity provider. False, wenn die Identität des Benutzers in Betracht liegt in der MandantenFalse if user’s identity lies inside the tenant in consideration
isProcessing bool Gibt an, wehther der Risikozustand eines Benutzers vom Back-End verarbeitet wird.Indicates wehther a user's risky state is being processed by the backend
riskLastUpdatedDateTime datetime Datum und Uhrzeit der letzten Aktualisierung des riskanten BenutzersThe date and time that the risky user was last updated
riskLevel riskLevel Die möglichen Werte sind Low, Medium, High, Hidden, None, Enumerationsmember unknownfuturevalue ".The possible values are low, medium, high, hidden, none, unknownFutureValue.
riskState riskState Die möglichen Werte sind None, confirmedSafe, remedied, Risiko, Enumerationsmember unknownfuturevalue ".The possible values are none, confirmedSafe, remediated, atRisk, unknownFutureValue.
riskDetail riskDetail Die möglichen Werte sind None, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, Hidden, adminConfirmedUserCompromised, Enumerationsmember unknownfuturevalue ".The possible values are none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, hidden, adminConfirmedUserCompromised, unknownFutureValue.
userDisplayName string Anzeigename für riskanten BenutzerRisky user display name
userPrincipalName string Riskanter BenutzerprinzipalnameRisky user principal name

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
Verlaufhistory riskyUserHistoryItem -SammlungriskyUserHistoryItem collection Stellt den Risikoverlauf eines Azure AD Benutzers dar, der durch Azure AD Identity Protection bestimmt wird.Represents the risk history of an Azure AD user as determined by Azure AD Identity Protection.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.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"
}