tipo de recurso riskDetection

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 detectado em um locatário do Microsoft Entra.

A Proteção do Microsoft Entra ID avalia continuamente os riscos do usuário e os riscos de entrada do aplicativo ou do usuário com base em vários sinais e aprendizado de máquina. Essa API fornece acesso programático a todas as detecções de risco em seu ambiente do Microsoft Entra.

Para obter mais informações sobre detecção de risco, consulte Proteção do Microsoft Entra ID e O que são detecções de risco?

Observação

A disponibilidade dos dados de detecção de risco é regida pelas políticas de retenção de dados do Microsoft Entra.

Métodos

Método Tipo de retorno Descrição
List coleção riskDetection Listar as detecções de risco e suas propriedades.
Get riskDetection Obtenha uma detecção de risco específica e suas propriedades.

Propriedades

Propriedade Tipo Descrição
atividade activityType Indica o tipo de atividade ao qual o risco detectado está vinculado.
activityDateTime DateTimeOffset Data e hora em que a atividade arriscada 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 à detecção de risco no formato JSON.
correlationId string ID de correlação da entrada associada à detecção de risco. Essa propriedade será null se a detecção de risco não estiver associada a uma entrada.
detectedDateTime DateTimeOffset Data e hora em que o risco foi detectado. 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 Momento do risco detectado (em tempo real/offline). Os valores possíveis são notDefined, realtime, nearRealtime, offline, unknownFutureValue.
id string ID exclusiva da detecção de risco.
ipAddress string Fornece o endereço IP do cliente do qual o risco ocorreu.
lastUpdatedDateTime DateTimeOffset Data e hora em que a detecção de risco foi atualizada pela última vez.
location signInLocation Local da entrada.
requestId string ID da solicitação da entrada associada à detecção de risco. Essa propriedade será null se a detecção de risco não estiver associada a uma entrada.
riskEventType Cadeia de caracteres O tipo de evento de risco detectado. Os valores possíveis são adminConfirmedUserCompromised, anomalousUserActivity, , anomalousToken,attackerinTheMiddleattemptedPRTAccessanonymizedIPAddress ,,tokenIssuerAnomalysuspiciousAPITrafficunlikelyTravelriskyIPAddressunfamiliarFeaturessuspiciousBrowsermaliciousIPAddressValidCredentialsBlockedIPmalwareInfectedIPAddresspasswordSpraysuspiciousInboxForwardingnationStateIPsuspiciousIPAddressmcasFinSuspiciousFileAccessnewCountrysuspiciousSendingPatternsmcasSuspiciousInboxManipulationRulesmaliciousIPAddressmcasImpossibleTravel, . userReportedSuspiciousActivitygenericinvestigationsThreatIntelligenceinvestigationsThreatIntelligenceSigninLinkedleakedCredentials
Para obter mais informações sobre cada valor, consulte Tipos de risco e detecção.
riskDetail riskDetail Detalhes do risco detectado.

Observação: Os detalhes desta propriedade estão disponíveis apenas para clientes do Microsoft Entra ID P2. P1 customers will be returned hidden.
riskLevel riskLevel Nível do risco detectado. Os valores possíveis são low, medium, high, hidden, none, unknownFutureValue.
Observação: Os detalhes desta propriedade estão disponíveis apenas para clientes do Microsoft Entra ID P2. P1 customers will be returned hidden.
riskState riskState O estado de um usuário ou entrada de risco detectado. Os valores possíveis são none, confirmedSafe, remediated, dismissedatRisk, , confirmedCompromised, e unknownFutureValue.
source string Fonte da detecção de risco. Por exemplo, activeDirectory.
tokenIssuerType tokenIssuerType Indica o tipo de emissor de token para o risco de entrada detectado. 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 usuário.
userPrincipalName string O nome UPN do usuário.
riskType (preterido) riskEventType Lista de tipos de eventos de risco.
Observação: Essa propriedade foi preterida. Em vez disso, use riskEventType .

Relações

Nenhum

Representação JSON

A representação JSON a seguir 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"
}
  • Última atualização em