riskDetection tipo de recurso

Artigo
10/24/2024

Namespace: microsoft.graph

Representa informações sobre um risco detetado num inquilino Microsoft Entra.

Microsoft Entra ID 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	Obtenha uma lista dos objetos riskDetection e respetivas propriedades.
Get	riskDetection	Leia as propriedades e relações de um objeto riskDetection .

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, a meia-noite UTC a 1 de janeiro de 2014 tem o seguinte aspeto: `2014-01-01T00:00:00Z`
additionalInfo	Cadeia de caracteres	Informações adicionais associadas à deteção de riscos no formato JSON. Por exemplo, `"[{\"Key\":\"userAgent\",\"Value\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36\"}]"`. As chaves possíveis na cadeia JSON additionalInfo são: `userAgent`, `alertUrl`, `relatedEventTimeInUtc`, `relatedUserAgent`, `deviceInformation`, `relatedLocation`, `requestId`, `correlationId`, , `lastActivityTimeInUtc`, `malwareName`, , `clientLocation`, `clientIp`. `riskReasons` Para obter mais informações sobre riskReasons e valores possíveis, veja riskReasons values (valores riskReasons).
correlationId	Cadeia de caracteres	ID de Correlação do início de sessão associado à deteção de risco. Esta propriedade é `null` 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, a meia-noite UTC a 1 de janeiro de 2014 tem o seguinte aspeto: `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	Cadeia de caracteres	ID exclusivo da deteção de risco. Herdado da entidade
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. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, a meia-noite UTC a 1 de janeiro de 2014 tem o seguinte aspeto: `2014-01-01T00:00:00Z`
location	signInLocation	Localização do início de sessão.
requestId	Cadeia de caracteres	ID do pedido do início de sessão associado à deteção de risco. Esta propriedade é `null` se a deteção de risco não estiver associada a um início de sessão.
riskDetail	riskDetail	Detalhes do risco detetado. Os valores possíveis são: `none`, , `adminGeneratedTemporaryPassword`, `userPerformedSecuredPasswordChangeuserChangedPasswordOnPremises`, `userPerformedSecuredPasswordReset`, `adminConfirmedSigninSafe`, `aiConfirmedSigninSafe`, `userPassedMFADrivenByRiskBasedPolicy`, `adminDismissedAllRiskForUser`, , `adminConfirmedSigninCompromised`, `hidden`, , `adminConfirmedUserCompromised`, , . `m365DAdminDismissedDetectionunknownFutureValue` Tenha em atenção que tem de utilizar o cabeçalho do `Prefer: include - unknown -enum-members` pedido para obter os seguintes valores neste enum evoluível: `m365DAdminDismissedDetection`.
riskEventType	Cadeia de caracteres	O tipo de evento de risco detetado. Os valores possíveis são `adminConfirmedUserCompromised`, `anomalousToken`, `anomalousUserActivity`, `anonymizedIPAddress`, `generic`, `impossibleTravel`, `suspiciousSendingPatternsinvestigationsThreatIntelligence`, , `leakedCredentials`,`malwareInfectedIPAddressmcasSuspiciousInboxManipulationRulesmaliciousIPAddress` , , `newCountry`, `passwordSpray`, , `suspiciousAPITrafficriskyIPAddress`,`suspiciousBrowsersuspiciousInboxForwarding`, `suspiciousIPAddress`, , `tokenIssuerAnomaly`, `unfamiliarFeatures`. `unlikelyTravel` Se a deteção de risco for uma deteção premium, irá mostrar `generic`. Para obter mais informações sobre cada valor, veja Tipos de risco e deteção.
riskLevel	riskLevel	Nível do risco detetado. Os possíveis valores são: `low`, `medium`, `high`, `hidden`, `none`, `unknownFutureValue`.
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`, `confirmedCompromised`, `unknownFutureValue`.
source	Cadeia de caracteres	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`, `UnknownFutureValue`.
userDisplayName	String	O nome UPN do usuário.
userId	Cadeia de caracteres	ID exclusivo do usuário.
userPrincipalName	String	O nome UPN do usuário.

riskReasons valores

riskEventType	Valor	Cadeia de apresentação da IU
`investigationsThreatIntelligence`	`suspiciousIP`	Este início de sessão era de um endereço IP suspeito
`investigationsThreatIntelligence`	`passwordSpray`	Esta conta de utilizador foi atacada por um spray de palavra-passe.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.riskDetection",
  "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)",
  "userId": "String",
  "userDisplayName": "String",
  "userPrincipalName": "String",
  "additionalInfo": "String"
}

Compartilhar via