servicePrincipalRiskDetection 资源类型
命名空间：microsoft.graph
表示有关在 entra 租户中检测到Microsoft风险服务主体的信息。 Microsoft Entra ID 会根据各种信号和机器学习持续评估风险。 此 API 提供对 Microsoft Entra 环境中所有服务主体风险检测的编程访问。
继承自 entity。
有关风险事件的详细信息，请参阅 Microsoft Entra ID Protection。
注意： 必须具有 Microsoft Entra Workload ID Premium 许可证才能使用 servicePrincipalRiskDetection API。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | servicePrincipalRiskDetection 集合 | 列出服务主体风险检测及其属性。 |
| Get | servicePrincipalRiskDetection | 获取特定的服务主体风险检测及其属性。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 活动 | activityType | 指示检测到的风险链接到的活动类型。 可能的值为： signin、 servicePrincipal。 请注意，必须使用 Prefer: include-unknown-enum-members 请求标头来获取以下值 (在此 可演变枚举中的) ： servicePrincipal。 |
| activityDateTime | DateTimeOffset | 发生风险活动的日期和时间。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
| additionalInfo | String | 与风险检测关联的其他信息。 此字符串值表示为 JSON 对象，引号已转义。 |
| appId | String | 关联应用程序的唯一标识符。 |
| correlationId | String | 与风险检测关联的登录活动的相关 ID。 如果风险检测未与登录活动关联，则此属性 null 为 。 |
| detectedDateTime | DateTimeOffset | 检测到风险的日期和时间。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| detectionTimingType | riskDetectionTimingType | 检测到的风险的计时，无论是实时还是脱机。 可能的值包括 notDefined、realtime、nearRealtime、offline、unknownFutureValue。 |
| id | String | 风险检测的唯一标识符。 继承自 entity。 |
| ipAddress | String | 提供发生风险的客户端的 IP 地址。 |
| keyIds | 字符串集合 | 与风险检测关联的密钥凭据的唯一标识符。 |
| lastUpdatedDateTime | DateTimeOffset | 上次更新风险检测的日期和时间。 |
| location | signInLocation | 启动登录的位置。 |
| requestId | String | 与风险检测关联的登录活动的请求标识符。 如果风险检测未与登录活动关联，则此属性 null 为 。 支持 $filter（eq）。 |
| riskDetail | riskDetail | 检测到的风险的详细信息。 注意： 此属性的详细信息仅适用于工作负载标识高级版客户。 将返回 hidden没有此许可证的租户中的事件。 可能的值包括 none、hidden、adminConfirmedServicePrincipalCompromised、adminDismissedAllRiskForServicePrincipal。 请注意，必须使用 Prefer: include-unknown-enum-members 请求标头来获取以下值 (在此 可演变枚举中的) ： adminConfirmedServicePrincipalCompromised 、 adminDismissedAllRiskForServicePrincipal。 |
| riskEventType | String | 检测到的风险事件类型。 可能的值为：investigationsThreatIntelligence、、generic、adminConfirmedServicePrincipalCompromised、suspiciousSigninsleakedCredentials、anomalousServicePrincipalActivity、maliciousApplication、 。 suspiciousApplication |
| riskLevel | riskLevel | 检测到的风险级别。 注意： 此属性的详细信息仅适用于工作负载标识高级版客户。 将返回 hidden没有此许可证的租户中的事件。 可能的值包括 low、medium、high、hidden、none。 |
| riskState | riskState | 检测到的风险服务主体或登录活动的状态。 可能的值包括 none、dismissed、atRisk、confirmedCompromised。 |
| servicePrincipalDisplayName | String | 服务主体的显示名称。 |
| servicePrincipalId | String | 服务主体的唯一标识符。 支持 $filter（eq）。 |
| source | String | 风险检测的来源。 例如，identityProtection。 |
| tokenIssuerType | tokenIssuerType | 指示检测到的登录风险的令牌颁发者类型。 可能的值为： AzureAD。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.servicePrincipalRiskDetection",
"id": "String (identifier)",
"requestId": "String",
"correlationId": "String",
"riskEventType": "String",
"riskState": "String",
"riskLevel": "String",
"riskDetail": "String",
"source": "String",
"detectionTimingType": "String",
"activity": "String",
"tokenIssuerType": "String",
"ipAddress": "String",
"location": {
"@odata.type": "microsoft.graph.signInLocation"
},
"activityDateTime": "String (timestamp)",
"detectedDateTime": "String (timestamp)",
"lastUpdatedDateTime": "String (timestamp)",
"servicePrincipalId": "String",
"servicePrincipalDisplayName": "String",
"appId": "String",
"keyIds": [
"String"
],
"additionalInfo": "String"
}