Skip to content

riskyserviceprincipal.md

Latest commit

 

History

History
81 lines (65 loc) · 14.5 KB

riskyserviceprincipal.md

File metadata and controls

81 lines (65 loc) · 14.5 KB
title riskyServicePrincipal resource type
description Represents Microsoft Entra Workload ID that are at risk, including risk for applications, service principals and Managed Identities.
author ebasseri
ms.localizationpriority medium
ms.subservice entra-sign-in
doc_type resourcePageType
ms.date 11/27/2025

riskyServicePrincipal resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Represents Microsoft Entra service principals that are at risk. Microsoft Entra ID Protection continually evaluates service principal risk based on various signals and machine learning. This API provides programmatic access to all at-risk service principals in your Microsoft Entra tenant.

Inherits from entity.

Note: Using the riskyServicePrincipal API requires a Microsoft Entra Workload ID license.

Methods

Method Return type Description
List riskyServicePrincipal collection List risky service principals and their risk properties.
Get riskyServicePrincipal Get a specific risky service principal and its risk properties.
Dismiss None Dismiss the risk of a risky service principal.
Confirm compromised None Confirm a risky service principal as compromised.
List history riskyServicePrincipalHistoryItem collection Get the risk history of a Microsoft Entra service principal.

Properties

Property Type Description
accountEnabled Boolean true if the service principal account is enabled; otherwise, false.
appId String The globally unique identifier for the associated application (its appId property), if any.
displayName String The display name for the service principal.
id String The unique identifier assigned to the service principal at risk. Inherited from entity.
isProcessing Boolean Indicates whether Microsoft Entra ID Protection is currently processing the service principal's risky state.
riskDetail riskDetail Details of the detected risk.
Note: Details for this property are only available for Workload Identities Premium customers. Events in tenants without this license will be returned hidden.
riskLastUpdatedDateTime DateTimeOffset The date and time that the risk state was last updated. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2021 is 2021-01-01T00:00:00Z. Supports $filter (eq).
riskLevel riskLevel Level of the detected risky workload identity. The possible values are: low, medium, high, hidden, none, unknownFutureValue. Supports $filter (eq).
riskState riskState State of the service principal's risk. The possible values are: none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.
servicePrincipalType String Identifies whether the service principal represents an Application, a ManagedIdentity, or a legacy application (socialIdp). This is set by Microsoft Entra ID internally and is inherited from servicePrincipal.

Relationships

Relationship Type Description
history riskyServicePrincipalHistoryItem collection Represents the risk history of Microsoft Entra service principals.

JSON representation

The following JSON representation shows the resource type.

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