riskyServicePrincipal resource type
Namespace: microsoft.graph
Represents Microsoft Entra service principals that are at-risk. Microsoft Entra ID 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 Workload Identities Premium license.
Methods
Method | Return type | Description |
---|---|---|
List riskyServicePrincipals | riskyServicePrincipal collection | List risky service principals and their risk properties. |
Get riskyServicePrincipal | riskyServicePrincipal | Get a specific risky service principal and its risk properties. |
dismiss | None | Dismiss the risk of a risky service principal. |
confirmCompromised | 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 |
---|---|---|
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. |
isEnabled | Boolean | true if the service principal account is enabled; otherwise, false . |
isProcessing | Boolean | Indicates whether Microsoft Entra ID 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 . The possible values are: none , hidden , unknownFutureValue , adminConfirmedServicePrincipalCompromised , adminDismissedAllRiskForServicePrincipal . Note that you must use the Prefer: include-unknown-enum-members request header to get the following value(s) in this evolvable enum: adminConfirmedServicePrincipalCompromised , adminDismissedAllRiskForServicePrincipal . |
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 is a JSON representation of the resource.
{
"@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"
}
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기