tipo de recurso riskyUserriskyUser resource type

Importante

Las API de /beta la versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

Representa los usuarios de Azure AD que están en riesgo.Represents Azure AD users who are at risk. Azure AD evalúa continuamente los riesgos de los usuarios en función de varias señales y aprendizaje automático.Azure AD continually evaluates user risk based on various signals and machine learning. Esta API proporciona acceso mediante programación a todos los usuarios en riesgo en su Azure AD.This API provides programmatic access to all at-risk users in your Azure AD.

Para obtener más información acerca de los eventos de riesgo, consulte Azure Active Directory Identity Protection.For more information about risk events, see Azure Active Directory Identity Protection.

Nota: El uso de la API de riskyUsers requiere una licencia de Azure AD Premium P2.Note: Using the riskyUsers API requires an Azure AD Premium P2 license.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
Enumerar riskyUsersList riskyUsers colección riskyUserriskyUser collection Enumerar los usuarios peligrosos y sus propiedades.List risky users and their properties.
Obtener riskyUserGet riskyUser riskyUserriskyUser Obtenga un usuario arriesgado específico y sus propiedades.Get a specific risky user and its properties.
Historial de listasList history colección riskyUserHistoryItemriskyUserHistoryItem collection Obtiene el historial de riesgos de un usuario de Azure AD.Get the risk history of an Azure AD user.
Confirmar riskyUsers en peligroConfirm riskyUsers compromised NingunoNone Confirmar que un usuario arriesgado está en peligro.Confirm a risky user as compromised.
Descartar riskyUsersDismiss riskyUsers NingunoNone Descartar el riesgo de un usuario arriesgado.Dismiss the risk of a risky user.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
id string Identificador único del usuario en peligroUnique id of the user at risk
isDeleted bool Indica si el usuario se ha eliminado.Indicates whether the user is deleted. Los valores posibles son true:falsePossible values are: true, false
isGuest bool Indica si el usuario es un usuario Guest.Indicates whether the user is a guest user. Los valores posibles son true y false.Possible values are: true, false. True si la identidad del usuario se encuentra fuera del inquilino en cuestión.True if user’s identity lies outside of the tenant in consideration. Este usuario podría ser un usuario B2B o B2C con una identidad en Azure AD, MSA o un proveedor de identidades de terceros.This user could be a B2B or a B2C user with identity in Azure AD, MSA or 3rd party identity provider. False si la identidad del usuario se encuentra dentro del inquilino en consideraciónFalse if user’s identity lies inside the tenant in consideration
isProcessing bool Indica wehther el back-end está procesando el estado arriesgado de un usuarioIndicates wehther a user's risky state is being processed by the backend
riskLastUpdatedDateTime datetime La fecha y la hora en que se actualizó por última vez el usuario peligrosoThe date and time that the risky user was last updated
riskLevel riskLevel Los valores posibles son Low, Medium, High, Hidden, None, unknownFutureValue.The possible values are low, medium, high, hidden, none, unknownFutureValue.
riskState riskState Los valores posibles son none, confirmedSafe, remediated, atRisk, unknownFutureValue.The possible values are none, confirmedSafe, remediated, atRisk, unknownFutureValue.
riskDetail riskDetail Los valores posibles son 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 Nombre para mostrar del usuario arriesgadoRisky user display name
userPrincipalName string Nombre principal de usuario arriesgadoRisky user principal name

RelacionesRelationships

RelaciónRelationship TipoType DescripciónDescription
Historialhistory colección riskyUserHistoryItemriskyUserHistoryItem collection Representa el historial de riesgos de un usuario de Azure AD según lo determinado por Azure AD Identity Protection.Represents the risk history of an Azure AD user as determined by Azure AD Identity Protection.

Representación JSONJSON representation

Aquí tiene una representación JSON del recurso.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"
}