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
Listar deteções de risco	riskDetection collection	Listar as deteções de risco e as respetivas propriedades.
Obter deteção de risco	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	cadeia de caracteres	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	cadeia de caracteres	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 .

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"
}