tipo de recurso de domínio

  • Artigo

Namespace: microsoft.graph

Detalha a atividade de início de sessão do utilizador e da aplicação para um inquilino (diretório). Tem de ter uma licença do Microsoft Entra ID P1 ou P2 para transferir registos de início de sessão com a Microsoft Graph API.

As políticas de retenção de dados do Microsoft Entra regem a disponibilidade dos registos de início de sessão.

Métodos

Método Tipo de retorno Descrição
List signIn Leia as propriedades e relações dos objetos signIn .
Get signIn Leia as propriedades e relações do objeto signIn .

Propriedades

Propriedade Tipo Descrição
appDisplayName Cadeia de caracteres Nome da aplicação apresentado no centro de administração do Microsoft Entra.

Suporta $filter (eq, startsWith).
appId Cadeia de caracteres GUID exclusivo que representa o ID da aplicação no ID do Microsoft Entra.

Suporta $filter (eq).
appliedConditionalAccessPolicies appliedConditionalAccessPolicy collection (coleção appliedConditionalAccessPolicy ) Fornece uma lista de políticas de acesso condicional que a atividade de início de sessão correspondente aciona. As aplicações precisam de mais privilégios relacionados com o Acesso Condicional para ler os detalhes desta propriedade. Para obter mais informações, veja Ver políticas de acesso condicional (AC) aplicadas em inícios de sessão.
clientAppUsed Cadeia de caracteres Identifica o cliente utilizado para a atividade de início de sessão. Os clientes de autenticação moderna incluem Browser, modern clients. Os clientes de autenticação legados incluem Exchange ActiveSync, , , MAPI, SMTPe other clientsPOP. IMAP

Suporta $filter (eq).
conditionalAccessStatus conditionalAccessStatus Comunica o estado de uma política de acesso condicional ativada. Os valores possíveis são: success, failure, notApplied, e unknownFutureValue.

Suporta $filter (eq).
correlationId Cadeia de caracteres O ID do pedido enviado pelo cliente quando o início de sessão é iniciado. Utilizado para resolver problemas de atividade de início de sessão.

Suporta $filter (eq).
createdDateTime DateTimeOffset Data e hora (UTC) em que o início de sessão foi iniciado. Exemplo: a meia-noite de 1 de janeiro de 2014 é reportada como 2014-01-01T00:00:00Z.

$orderbySuporta , $filter (eq, lee ge).
deviceDetail deviceDetail Informações do dispositivo de onde ocorreu o início de sessão; inclui o ID do dispositivo, o sistema operativo e o browser.

Suporta (eq, startsWith) nas propriedades $filterbrowser e operatingSytem.
id Cadeia de caracteres ID exclusivo que representa a atividade de início de sessão.

Suporta $filter (eq).
ipAddress Cadeia de caracteres Endereço IP do cliente utilizado para iniciar sessão.

Suporta $filter (eq, startsWith).
isInteractive Booliano Indica se um início de sessão é interativo.
location signInLocation Fornece o código da cidade, do estado e do país de origem do início de sessão.

Suporta (eq, startsWith) nas propriedades $filtercidade, estado e paísRegião.
resourceDisplayName Cadeia de caracteres Nome do recurso no qual o utilizador iniciou sessão.

Suporta $filter (eq).
resourceId Cadeia de caracteres ID do recurso no qual o utilizador iniciou sessão.

Suporta $filter (eq).
riskDetail riskDetail O motivo subjacente a um estado específico de um utilizador de risco, início de sessão ou evento de risco. Os valores possíveis são none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafe, userPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, hidden, adminConfirmedUserCompromised, , unknownFutureValue, , adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal, , m365DAdminDismissedDetection, userChangedPasswordOnPremises, , , adminDismissedRiskForSignIn. adminConfirmedAccountSafe Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter o seguinte valor ou valores nesta enumeração evoluível: adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal, m365DAdminDismissedDetection, userChangedPasswordOnPremises, adminDismissedRiskForSignIn, . adminConfirmedAccountSafe O valor none significa que a deteção de riscos do Microsoft Entra não sinalizou o utilizador nem o início de sessão como um evento de risco até agora.

Suporta $filter (eq).
Nota: Os detalhes desta propriedade só estão disponíveis para clientes do Microsoft Entra ID P2. Todos os outros clientes são devolvidos hidden.
riskEventTypes_v2 Coleção de cadeias de caracteres A lista de tipos de eventos de risco associados ao início de sessão. Valores possíveis: unlikelyTravel, , anonymizedIPAddress, unfamiliarFeaturesmaliciousIPAddress, malwareInfectedIPAddress, , suspiciousIPAddress, leakedCredentialsinvestigationsThreatIntelligence, , genericou unknownFutureValue.

Suporta $filter (eq, startsWith).
riskLevelAggregated riskLevel Nível de risco agregado. Os valores possíveis são: none, low, medium, high, hidden, e unknownFutureValue. O valor hidden significa que o utilizador ou o início de sessão não foi ativado para a Proteção do Microsoft Entra ID.

Suporta $filter (eq).
Nota: Os detalhes desta propriedade só estão disponíveis para clientes do Microsoft Entra ID P2. Todos os outros clientes são devolvidos hidden.
riskLevelDuringSignIn riskLevel Nível de risco durante o início de sessão. Os valores possíveis são: none, low, medium, high, hidden, e unknownFutureValue. O valor hidden significa que o utilizador ou o início de sessão não foi ativado para a Proteção do Microsoft Entra ID.

Suporta $filter (eq).
Nota: Os detalhes desta propriedade só estão disponíveis para clientes do Microsoft Entra ID P2. Todos os outros clientes são devolvidos hidden.
riskState riskState Comunica o estado do utilizador de risco, do início de sessão ou de um evento de risco. Os valores possíveis são none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromised, unknownFutureValue.

Suporta $filter (eq).
status signInStatus Estado de início de sessão. Inclui o código de erro e a descrição do erro (se ocorrer uma falha de início de sessão).

$filter Suporta (eq) na propriedade errorCode.
userDisplayName Cadeia de caracteres Nome a apresentar do utilizador que iniciou o início de sessão.

Suporta $filter (eq, startsWith).
userId Cadeia de caracteres ID do utilizador que iniciou o início de sessão.

Suporta $filter (eq).
userPrincipalName Cadeia de caracteres Nome principal de utilizador do utilizador que iniciou o início de sessão. Este valor está sempre em minúsculas. Para utilizadores convidados cujos valores no objeto de utilizador normalmente contêm #EXT# antes da parte do domínio, esta propriedade armazena o valor em minúsculas e no formato "verdadeiro". Por exemplo, enquanto o objeto de utilizador armazena AdeleVance_fabrikam.com#EXT#@contoso.com, os registos de início de sessão armazenam adelevance@fabrikam.com.

Suporta $filter (eq, startsWith).

Relações

Nenhum

Representação JSON

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

{
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "appDisplayName": "String",
  "appId": "String",
  "ipAddress": "String",
  "clientAppUsed": "String",
  "correlationId": "String",
  "conditionalAccessStatus": "string",
  "appliedConditionalAccessPolicies": [{"@odata.type": "microsoft.graph.appliedConditionalAccessPolicy"}],
  "isInteractive": true,
  "deviceDetail": {"@odata.type": "microsoft.graph.deviceDetail"},
  "location": {"@odata.type": "microsoft.graph.signInLocation"},
  "riskDetail": "string",
  "riskLevelAggregated": "string",
  "riskLevelDuringSignIn": "string",
  "riskState": "string",
  "riskEventTypes": ["string"],
  "riskEventTypes_v2": ["String"],
  "resourceDisplayName": "string",
  "resourceId": "string",
  "status": {"@odata.type": "microsoft.graph.signInStatus"},
  "userDisplayName": "string",
  "userId": "string",
  "userPrincipalName": "string"
}