Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Representa Microsoft Entra principais de serviço que estão em risco. Microsoft Entra ID avalia continuamente o risco do principal de serviço com base em vários sinais e machine learning. Esta API fornece acesso programático a todos os principais de serviço em risco no seu inquilino Microsoft Entra.
Herda de entidade.
Nota: A utilização da API riskyServicePrincipal requer uma licença identidades de carga de trabalho Premium.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | coleção riskyServicePrincipal | Listar principais de serviço de risco e as respetivas propriedades de risco. |
| Get | riskyServicePrincipal | Obtenha um principal de serviço de risco específico e as respetivas propriedades de risco. |
| Dismiss | Nenhum | Dispensar o risco de um principal de serviço de risco. |
| Confirmar comprometimento | Nenhum | Confirme um principal de serviço de risco como comprometido. |
| Histórico de listas | riskyServicePrincipalHistoryItem collection | Obtenha o histórico de riscos de um principal de serviço Microsoft Entra. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| appId | Cadeia de caracteres | O identificador exclusivo global da aplicação associada (a respetiva propriedade appId ), se existir. |
| displayName | String | O nome de exibição da entidade de serviço. |
| id | Cadeia de caracteres | O identificador exclusivo atribuído ao principal de serviço em risco. Herdado da entidade. |
| isEnabled | Booliano |
true se a conta da entidade de serviço estiver habilitada; caso contrário, false. |
| isProcessing | Booliano | Indica se Microsoft Entra ID está atualmente a processar o estado de risco do principal de serviço. |
| riskDetail | riskDetail | Detalhes do risco detetado. Nota: Os detalhes desta propriedade só estão disponíveis para os clientes do Workload Identities Premium. Serão devolvidos hiddeneventos em inquilinos sem esta licença. |
| riskLastUpdatedDateTime | DateTimeOffset | A data e hora em que o estado de risco foi atualizado pela última vez. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2021 é 2021-01-01T00:00:00Z. Suporta $filter (eq). |
| riskLevel | riskLevel | Nível da identidade de carga de trabalho de risco detetada. Os valores possíveis são: low, medium, high, hidden, none, unknownFutureValue. Suporta $filter (eq). |
| riskState | riskState | Estado do risco do principal de serviço. Os valores possíveis são none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue. |
| servicePrincipalType | Cadeia de caracteres | Identifica se o principal de serviço representa uma Applicationaplicação , uma ManagedIdentityou uma aplicação legada (socialIdp). Esta definição é definida por Microsoft Entra ID internamente e é herdada do servicePrincipal. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| histórico | riskyServicePrincipalHistoryItem collection | Representa o histórico de riscos dos principais de serviço Microsoft Entra. |
Representação JSON
A representação JSON seguinte mostra o tipo de 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"
}