riskDetection tipo de recurso
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa informações sobre um risco detetado num inquilino Microsoft Entra.
Microsoft Entra ID Protection avalia continuamente os riscos do utilizador e os riscos de início de sessão de aplicações ou utilizadores com base em vários sinais e machine learning. Esta API fornece acesso programático a todas as deteções de risco no seu ambiente de Microsoft Entra.
Para obter mais informações sobre a deteção de riscos, veja Microsoft Entra ID Protection e O que são deteções de risco?
Observação
A disponibilidade dos dados de deteção de riscos é regida pelas políticas de retenção de dados Microsoft Entra.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | riskDetection collection | Listar as deteções de risco e as respetivas propriedades. |
| Get | riskDetection | Obtenha uma deteção de risco específica e as respetivas propriedades. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| atividade | activityType | Indica o tipo de atividade ao qual o risco detetado está ligado. Os valores possíveis são signin, user, unknownFutureValue. |
| activityDateTime | DateTimeOffset | Data e hora em que a atividade de risco ocorreu. 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 2014 é 2014-01-01T00:00:00Z |
| additionalInfo | string | Informações adicionais associadas à deteção de riscos no formato JSON. |
| correlationId | string | ID de Correlação do início de sessão associado à deteção de risco. Esta propriedade é nula se a deteção de risco não estiver associada a um início de sessão. |
| detectedDateTime | DateTimeOffset | Data e hora em que o risco foi detetado. 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 2014 é 2014-01-01T00:00:00Z |
| detectionTimingType | riskDetectionTimingType | Temporização do risco detetado (em tempo real/offline). Os valores possíveis são notDefined, realtime, nearRealtime, offline, unknownFutureValue. |
| id | string | ID exclusivo da deteção de risco. |
| ipAddress | string | Fornece o endereço IP do cliente de onde ocorreu o risco. |
| lastUpdatedDateTime | DateTimeOffset | Data e hora em que a deteção de risco foi atualizada pela última vez. |
| location | signInLocation | Localização do início de sessão. |
| requestId | string | ID do pedido do início de sessão associado à deteção de risco. Esta propriedade é nula se a deteção de risco não estiver associada a um início de sessão. |
| riskEventType | Cadeia de caracteres | O tipo de evento de risco detetado. Os valores possíveis são , , ,attackerinTheMiddleanonymizedIPAddress,attemptedPRTAccess, generic, investigationsThreatIntelligence, investigationsThreatIntelligenceSigninLinked, maliciousIPAddressleakedCredentials, maliciousIPAddressValidCredentialsBlockedIP, malwareInfectedIPAddress, mcasImpossibleTravel,mcasFinSuspiciousFileAccess, mcasSuspiciousInboxManipulationRules,nationStateIP , suspiciousAPITrafficsuspiciousIPAddress, ,suspiciousSendingPatternsunfamiliarFeatures , unlikelyTravel, . userReportedSuspiciousActivityanomalousUserActivityadminConfirmedUserCompromised Para obter mais informações sobre cada valor, veja Tipos de risco e deteção. |
| riskDetail | riskDetail | Detalhes do risco detetado. Os valores possíveis são: none, , adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChangeuserPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, , hidden, adminConfirmedUserCompromised, , unknownFutureValue, , adminConfirmedServicePrincipalCompromised, , adminDismissedAllRiskForServicePrincipal, . m365DAdminDismissedDetection Tenha em atenção que tem de utilizar o cabeçalho do Prefer: include - unknown -enum-members pedido para obter os seguintes valores nesta enumeração evoluível: adminConfirmedServicePrincipalCompromised , , adminDismissedAllRiskForServicePrincipalm365DAdminDismissedDetection. Nota: Os detalhes desta propriedade só estão disponíveis para clientes Microsoft Entra ID P2. Os clientes P1 serão devolvidos hidden. |
| riskLevel | riskLevel | Nível do risco detetado. Os valores possíveis são low, medium, high, hidden, none, . unknownFutureValue Nota: Os detalhes desta propriedade só estão disponíveis para clientes Microsoft Entra ID P2. Os clientes P1 serão devolvidos hidden. |
| riskState | riskState | O estado de um utilizador de risco detetado ou início de sessão. Os valores possíveis são none, confirmedSafe, remediated, dismissed, atRisk, e unknownFutureValueconfirmedCompromised. |
| source | string | Origem da deteção de risco. Por exemplo, activeDirectory. |
| tokenIssuerType | tokenIssuerType | Indica o tipo de emissor de tokens para o risco de início de sessão detetado. Os valores possíveis são AzureAD, ADFederationServices e unknownFutureValue. |
| userId | cadeia de caracteres | ID exclusivo do usuário. 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 2014 é 2014-01-01T00:00:00Z |
| userDisplayName | string | Nome do utilizador. |
| userPrincipalName | string | O nome UPN do usuário. |
| riskType (preterido) | riskEventType | Lista de tipos de eventos de risco. Nota: Esta propriedade foi preterida. Em alternativa, utilize riskEventType . |
Relações
Nenhum
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"id": "string",
"requestId": "string",
"correlationId": "string",
"riskType": {"@odata.type": "microsoft.graph.riskEventType"},
"riskState": {"@odata.type": "microsoft.graph.riskState"},
"riskLevel": {"@odata.type": "microsoft.graph.riskLevel"},
"riskDetail": {"@odata.type": "microsoft.graph.riskDetail"},
"source": "string",
"detectionTimingType": {"@odata.type": "microsoft.graph.riskDetectionTimingType"},
"activity": {"@odata.type": "microsoft.graph.riskUserActivity"},
"tokenIssuerType": {"@odata.type": "microsoft.graph.tokenIssuerType"},
"ipAddress": "string",
"location": {"@odata.type": "microsoft.graph.signInLocation"},
"activityDateTime": "string (timestamp)",
"detectedDateTime": "string (timestamp)",
"lastUpdatedDateTime": "string (timestamp)",
"userId": "string",
"userDisplayName": "string",
"userPrincipalName": "string",
"additionalInfo": "string"
}