tipo de recurso riskyServicePrincipal

Espacio de nombres: microsoft.graph

Representa Microsoft Entra entidades de servicio que están en riesgo. Microsoft Entra ID evalúa continuamente el riesgo de la entidad de servicio en función de varias señales y el aprendizaje automático. Esta API proporciona acceso mediante programación a todas las entidades de servicio en riesgo del inquilino de Microsoft Entra.

Hereda de la entidad.

Nota: El uso de la API riskyServicePrincipal requiere una licencia De identidades de carga de trabajo Premium.

Métodos

Método Tipo devuelto Descripción
Enumerar riskyServicePrincipals colección riskyServicePrincipal Enumera las entidades de servicio de riesgo y sus propiedades de riesgo.
Obtener riskyServicePrincipal riskyServicePrincipal Obtenga una entidad de servicio de riesgo específica y sus propiedades de riesgo.
Despedir Ninguno Descartar el riesgo de una entidad de servicio de riesgo.
confirmCompromised Ninguno Confirme que una entidad de servicio de riesgo está en peligro.
Historial de listas colección riskyServicePrincipalHistoryItem Obtenga el historial de riesgos de una entidad de servicio Microsoft Entra.

Propiedades

Propiedad Tipo Descripción
appId Cadena Identificador único global de la aplicación asociada (su propiedad appId ), si existe.
displayName Cadena El nombre para mostrar de la entidad de servicio.
id Cadena Identificador único asignado a la entidad de servicio en riesgo. Heredado de la entidad.
isEnabled Boolean true si la entidad de servicio está habilitada; en caso contrario, false.
isProcessing Booleano Indica si Microsoft Entra ID está procesando actualmente el estado de riesgo de la entidad de servicio.
riskDetail riskDetail Detalles del riesgo detectado.
Nota: Los detalles de esta propiedad solo están disponibles para los clientes de Workload Identities Premium. Los eventos de los inquilinos sin esta licencia se devolverán hidden.
Los valores posibles son: none, hidden, unknownFutureValue, adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal. Tenga en cuenta que debe usar el Prefer: include-unknown-enum-members encabezado de solicitud para obtener los siguientes valores en esta enumeración evolvable: adminConfirmedServicePrincipalCompromised , adminDismissedAllRiskForServicePrincipal.
riskLastUpdatedDateTime DateTimeOffset Fecha y hora en que se actualizó por última vez el estado de riesgo. El tipo DateTimeOffset representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, medianoche UTC del 1 de enero de 2021 es 2021-01-01T00:00:00Z. Admite $filter (eq).
riskLevel riskLevel Nivel de la identidad de carga de trabajo de riesgo detectada. Los valores posibles son: low, medium, high, hidden, none, unknownFutureValue. Admite $filter (eq).
riskState riskState Estado del riesgo de la entidad de servicio. Los valores posibles son: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised y unknownFutureValue.
servicePrincipalType Cadena Identifica si la entidad de servicio representa un Application, un ManagedIdentityo una aplicación heredada (socialIdp). Esto lo establece Microsoft Entra ID internamente y se hereda de servicePrincipal.

Relaciones

Relación Tipo Descripción
Historia colección riskyServicePrincipalHistoryItem Representa el historial de riesgos de Microsoft Entra entidades de servicio.

Representación JSON

La siguiente es una representación JSON del recurso

{
  "@odata.type": "#microsoft.graph.riskyServicePrincipal",
  "id": "String (identifier)",
  "isEnabled": "Boolean",
  "isProcessing": "Boolean",
  "riskLastUpdatedDateTime": "String (timestamp)",
  "riskLevel": "String",
  "riskState": "String",
  "riskDetail": "String",
  "displayName": "String",
  "appId": "String",
  "servicePrincipalType": "String"
}