riskyUser-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt Azure AD Benutzer dar, die gefährdet sind. Azure AD bewertet das Benutzerrisiko kontinuierlich basierend auf verschiedenen Signalen und maschinellem Lernen. Diese API bietet programmgesteuerten Zugriff auf alle gefährdeten Benutzer in Ihrer Azure AD.

Weitere Informationen zu Risikoereignissen finden Sie unter Azure Active Directory Identity Protection.

Hinweis

1. Die Verwendung der riskyUsers-API erfordert eine Azure AD Premium P2 Lizenz.
2. Die Verfügbarkeit riskanter Benutzerdaten wird durch die Azure AD Datenaufbewahrungsrichtlinien geregelt.

Methoden

Methode	Rückgabetyp	Beschreibung
RiskyUsers auflisten	riskyUser-Sammlung	Listet riskante Benutzer und deren Eigenschaften auf.
Get riskyUser	riskyUser	Rufen Sie einen bestimmten riskanten Benutzer und seine Eigenschaften ab.
Listenverlauf	riskyUserHistoryItem-Sammlung	Rufen Sie den Risikoverlauf eines Azure AD Benutzers ab.
Bestätigen, dass riskyUsers kompromittiert ist	Keines	Bestätigen Sie, dass ein riskanter Benutzer kompromittiert ist.
"riskyUsers" schließen	Keines	Schließen Sie das Risiko eines riskanten Benutzers.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	string	Eindeutige ID des gefährdeten Benutzers.
isDeleted	Boolescher Wert	Gibt an, ob der Benutzer gelöscht wird. Mögliche Werte sind: true und false.
isProcessing	Boolescher Wert	Gibt an, ob der riskante Zustand eines Benutzers vom Back-End verarbeitet wird.
riskLastUpdatedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Aktualisierung des riskanten Benutzers. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
riskLevel	riskLevel	Ebene des erkannten riskanten Benutzers. Die möglichen Werte sind low, medium, high, hidden, none. unknownFutureValue
riskState	riskState	Status des Benutzerrisikos. Mögliche Werte: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.
riskDetail	riskDetail	Die möglichen Werte sind none, adminGeneratedTemporaryPassword, , userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, aiConfirmedSigninSafe``adminConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy``adminDismissedAllRiskForUser, adminConfirmedSigninCompromised``hidden, , adminConfirmedUserCompromised, . unknownFutureValue
userDisplayName	string	Riskanter Anzeigename des Benutzers.
userPrincipalName	string	Riskanter Benutzerprinzipalname.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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