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 entidades de serviço do Microsoft Entra que estão em risco. O Microsoft Entra ID avalia continuamente o risco da entidade de serviço com base em vários sinais e aprendizado de máquina. Essa API fornece acesso programático a todas as entidades de serviço em risco em seu locatário do Microsoft Entra.
Herda de entidade.
Observação: O uso da API riskyServicePrincipal requer uma licença Premium de Identidades de Carga de Trabalho.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | coleta riskyServicePrincipal | Liste entidades de serviço de risco e suas propriedades de risco. |
| Get | riskyServicePrincipal | Obtenha uma entidade de serviço de risco específica e suas propriedades de risco. |
| Dismiss | Nenhum | Ignore o risco de uma entidade de serviço arriscada. |
| Confirmar comprometimento | Nenhum | Confirme que uma entidade de serviço de risco está comprometida. |
| Listar histórico | coleção riskyServicePrincipalHistoryItem | Obtenha o histórico de risco de uma entidade de serviço do Microsoft Entra. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| appId | Cadeia de caracteres | O identificador global exclusivo do aplicativo associado (sua propriedade appId ), se houver. |
| displayName | String | O nome de exibição da entidade de serviço. |
| id | Cadeia de caracteres | O identificador exclusivo atribuído à entidade 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 o Microsoft Entra ID está processando o estado de risco da entidade de serviço. |
| riskDetail | riskDetail | Detalhes do risco detectado. Observação: Os detalhes dessa propriedade só estão disponíveis para clientes Premium de Identidades de Carga de Trabalho. Eventos em locatários sem essa licença serão retornados hidden. |
| 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 em 1º de janeiro de 2021 é 2021-01-01T00:00:00Z. Suporta $filter (eq). |
| riskLevel | riskLevel | Nível da identidade da carga de trabalho de risco detectada. Os valores possíveis são: low, medium, high, hidden, none, unknownFutureValue. Suporta $filter (eq). |
| riskState | riskState | Estado do risco da entidade de serviço. Os valores possíveis são none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue. |
| servicePrincipalType | Cadeia de caracteres | Identifica se a entidade de serviço representa um aplicativo herdado ManagedIdentityousocialIdp um Application(). Isso é definido internamente pelo Microsoft Entra ID e é herdado do servicePrincipal. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| História | coleção riskyServicePrincipalHistoryItem | Representa o histórico de risco das entidades de serviço do Microsoft Entra. |
Representação JSON
A representação JSON a seguir 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"
}