tipo de recurso de domínio
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.
Fornece detalhes sobre a atividade de login de usuário ou de aplicativo em seu diretório. Você deve ter uma licença P1 ou P2 Microsoft Entra ID para baixar logs de entrada usando o microsoft API do Graph.
As políticas de retenção de dados Microsoft Entra regem a disponibilidade de logs de entrada.
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Listar entrar | signIn | Leia as propriedades e os relacionamentos de objetos de domínio. |
Obter entrar | signIn | Ler propriedades e relações de um objeto signIn. |
Confirmar comprometimento | Nenhum | Marque um evento nos logs de entrada Microsoft Entra como arriscados. |
Confirmar seguro | Nenhum | marcar um evento em logs de entrada Microsoft Entra como seguros. |
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
appDisplayName | Cadeia de caracteres | O nome do aplicativo exibido no centro de administração do Microsoft Entra. Suporta $filter (eq , startsWith ). |
appId | Cadeia de caracteres | O identificador de aplicativo no Microsoft Entra ID. Suporta $filter (eq ). |
appliedConditionalAccessPolicies | coleção appliedConditionalAccessPolicy | Uma lista de políticas de acesso condicional que a atividade de entrada correspondente dispara. Os aplicativos precisam de mais privilégios relacionados ao Acesso Condicional para ler os detalhes desta propriedade. Para obter mais informações, confira Exibir políticas de AC (acesso condicional) aplicadas em entradas. |
appliedEventListeners | coleção appliedAuthenticationEventListener | Informações detalhadas sobre os ouvintes, como Aplicativos Lógicos do Azure e Azure Functions, que os eventos correspondentes no evento de entrada dispararam. |
authenticationAppDeviceDetails | authenticationAppDeviceDetails | Fornece detalhes sobre o aplicativo e o dispositivo usados durante uma etapa de autenticação Microsoft Entra. |
authenticationAppPolicyEvaluationDetails | coleção authenticationAppPolicyDetails | Fornece detalhes das políticas de Microsoft Entra aplicadas a um aplicativo de autenticação de usuário e cliente durante uma etapa de autenticação. |
authenticationContextClassReferences | coleção authenticationContext | Contém uma coleção de valores que representam os contextos de autenticação de acesso condicional aplicados à entrada. |
authenticationDetails | coleção authenticationDetail | O resultado da tentativa de autenticação e mais detalhes sobre o método de autenticação. |
authenticationMethodsUsed | Coleção String | Os métodos de autenticação usados. Valores possíveis: SMS , , Authenticator App , App Verification code , Password , FIDO , PTA ou PHS . |
authenticationProcessingDetails | Coleção KeyValue | Mais detalhes de processamento de autenticação, como o nome do agente para PTA e PHS, ou um servidor ou nome do farm para autenticação federada. |
authenticationProtocol | Protocoltype | Listas o tipo de protocolo ou tipo de concessão usado na autenticação. Os valores possíveis são: none , , oAuth2 , ropc , wsFederation , saml20 , deviceCode , unknownFutureValue , authenticationTransfer , nativeAuth . Use none para todas as autenticações que não têm um valor específico nessa lista. Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores neste enumerável em evolução: authenticationTransfer , nativeAuth . |
authenticationRequirement | Cadeia de caracteres | Isso contém o nível mais alto de autenticação necessário em todas as etapas de entrada, para que a entrada tenha êxito. Suporta $filter (eq , startsWith ). |
authenticationRequirementPolicies | coleção authenticationRequirementPolicy | Fontes de requisito de autenticação, como acesso condicional, MFA por usuário, proteção de identidade e padrões de segurança. |
autonomousSystemNumber | Int32 | O ASN (Número do Sistema Autônomo) da rede usada pelo ator. |
azureResourceId | Cadeia de caracteres | Contém uma ID do Azure Resource Manager totalmente qualificada de um recurso do Azure acessado durante a entrada. |
clientAppUsed | Cadeia de caracteres | O cliente herdado usado para atividade de entrada. Por exemplo: Browser , , Exchange ActiveSync , IMAP Modern clients , MAPI , SMTP , ou POP . Suporta $filter (eq ). |
Clientcredentialtype | Clientcredentialtype | Descreve o tipo de credencial que um cliente ou entidade de serviço do usuário forneceu para Microsoft Entra ID para se autenticar. Você pode examinar essa propriedade para rastrear e eliminar tipos de credencial menos seguros ou para watch para clientes e entidades de serviço usando tipos de credencial anômalas. Os valores possíveis são none , clientSecret , clientAssertion , federatedIdentityCredential , managedIdentity , certificate , unknownFutureValue . |
condicionalAccessAudiences | Cadeia de caracteres | Uma lista que indica o público-alvo avaliado pelo Acesso Condicional durante um evento de entrada. Suporta $filter (eq ). |
conditionalAccessStatus | conditionalAccessStatus | O status da política de acesso condicional disparada. Valores possíveis: success , failure , notApplied ou unknownFutureValue . Suporta $filter (eq ). |
correlationId | Cadeia de caracteres | O identificador que o cliente envia quando a entrada é iniciada. Isso é usado para solucionar problemas da atividade de entrada correspondente ao pedir suporte. Suporta $filter (eq ). |
createdDateTime | DateTimeOffset | A data e a hora em que a entrada foi iniciada. O tipo de Timestamp é sempre UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . $orderby Dá suporte a , $filter (eq , le , e ge ). |
crossTenantAccessType | signInAccessType | Descreve o tipo de acesso entre locatários usado pelo ator para acessar o recurso. Os valores possíveis são: none , b2bCollaboration , b2bDirectConnect , microsoftSupport , serviceProvider , unknownFutureValue , passthrough . Além disso, você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter o seguinte valor ou valores neste enumerável em evolução: passthrough . Se a entrada não ultrapassou os limites do locatário, o valor será none . |
deviceDetail | deviceDetail | As informações do dispositivo de onde ocorreu a entrada. Inclui informações como deviceId, sistema operacional e navegador. $filter Dá suporte (eq , startsWith ) às propriedades do navegador e do operatingSystem. |
federatedCredentialId | Cadeia de caracteres | Contém o identificador da credencial de identidade federada de um aplicativo, se uma credencial de identidade federada foi usada para entrar. |
flaggedForReview | Booliano | Durante uma entrada com falha, um usuário pode selecionar um botão no portal do Azure para marcar o evento com falha para administradores de locatários. Se um usuário selecionar o botão para sinalizar a entrada com falha, esse valor será true . |
globalSecureAccessIpAddress | Cadeia de caracteres | O endereço IP de Acesso Seguro Global do qual a entrada foi iniciada. |
homeTenantId | Cadeia de caracteres | O identificador de locatário do usuário que inicia a entrada. Não aplicável em entradas de Identidade Gerenciada ou entidade de serviço. |
homeTenantName | Cadeia de caracteres | Para entradas de usuário, o identificador do locatário do qual o usuário é membro. Somente preenchido nos casos em que o locatário da casa forneceu consentimento afirmativo para Microsoft Entra ID para mostrar o conteúdo do locatário. |
id | Cadeia de caracteres | O identificador que representa a atividade de entrada. Herdado da entidade. Suporta $filter (eq ). |
incomingTokenType | incomingTokenType | Indica os tipos de token que foram apresentados a Microsoft Entra ID para autenticar o ator na entrada. Os valores possíveis são: none , primaryRefreshToken , saml11 , saml20 , unknownFutureValue , remoteDesktopToken . OBSERVAÇÃO Microsoft Entra ID também podem ter usado tipos de token não listados neste tipo de enumeração para autenticar o ator. Não infera a falta de um token se ele não for um dos tipos listados. Além disso, você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter o seguinte valor ou valores neste enumerável em evolução: remoteDesktopToken . |
ipAddress | Cadeia de caracteres | O endereço IP do cliente de onde ocorreu a entrada. Suporta $filter (eq , startsWith ). |
ipAddressFromResourceProvider | Cadeia de caracteres | O endereço IP usado por um usuário para alcançar um provedor de recursos, usado para determinar a conformidade do Acesso Condicional para algumas políticas. Por exemplo, quando um usuário interage com Exchange Online, o endereço IP que o Microsoft Exchange recebe do usuário pode ser gravado aqui. Esse valor geralmente null é . |
isInteractive | Booliano | Indica se uma entrada do usuário é interativa. Na entrada interativa, o usuário fornece um fator de autenticação para Microsoft Entra ID. Esses fatores incluem senhas, respostas a desafios de MFA, fatores biométricos ou códigos QR que um usuário fornece para Microsoft Entra ID ou um aplicativo associado. No logon não interativo, o usuário não fornece um fator de autenticação. Em vez disso, o aplicativo cliente usa um token ou código para autenticar ou acessar um recurso em nome de um usuário. Entradas não interativas são comumente usadas para um cliente entrar em nome de um usuário em um processo transparente para o usuário. |
isTenantRestricted | Booliano | Mostra se o evento de entrada estava sujeito a uma política de restrição de locatário Microsoft Entra. |
isThroughGlobalSecureAccess | Booliano | Indica se um usuário passou pelo serviço de Acesso Seguro Global. |
location | signInLocation | A cidade, o estado e o código do país de duas letras de onde ocorreu a entrada. $filter Dá suporte (eq , startsWith ) em propriedades de cidade, estado e countryOrRegion. |
managedServiceIdentity | managedIdentity | Contém informações sobre a identidade gerenciada usada para a entrada, incluindo seu tipo, ID de recurso do Azure Resource Manager (ARM) associada e informações de token federado. |
networkLocationDetails | coleção networkLocationDetail | Os detalhes da localização da rede, incluindo o tipo de rede usada e seus nomes. |
originalRequestId | Cadeia de caracteres | O identificador de solicitação da primeira solicitação na sequência de autenticação. Suporta $filter (eq ). |
originalTransferMethod | originalTransferMethods | Método de transferência usado para iniciar uma sessão durante toda a solicitação subsequente. Os valores possíveis são: none , deviceCodeFlow , authenticationTransfer , unknownFutureValue . |
privateLinkDetails | privateLinkDetails | Contém informações sobre a política de Microsoft Entra Link Privado associada ao evento de entrada. |
processingTimeInMilliseconds | Int | O tempo de processamento de solicitação em milissegundos no AD STS. |
resourceDisplayName | Cadeia de caracteres | O nome do recurso ao qual o usuário entrou. Suporta $filter (eq ). |
resourceId | Cadeia de caracteres | O identificador do recurso ao qual o usuário entrou. Suporta $filter (eq ). |
resourceServicePrincipalId | Cadeia de caracteres | O identificador da entidade de serviço que representa o recurso de destino no evento de entrada. |
resourceTenantId | Cadeia de caracteres | O identificador de locatário do recurso referenciado na entrada. |
riskDetail | riskDetail | O motivo por trás de um estado específico de um usuário arriscado, entrada 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 . Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter o seguinte valor ou valores neste enumerável em evolução: adminConfirmedServicePrincipalCompromised , adminDismissedAllRiskForServicePrincipal , , m365DAdminDismissedDetection userChangedPasswordOnPremises , , adminDismissedRiskForSignIn adminConfirmedAccountSafe . O valor none significa que Microsoft Entra detecção de risco não sinalizou o usuário ou a entrada como um evento arriscado até agora. Suporta $filter (eq ).Nota: Os detalhes dessa propriedade só estão disponíveis para clientes Microsoft Entra ID P2. Todos os outros clientes são retornados hidden . |
riskEventTypes_v2 | Coleção String | A lista de tipos de evento de risco associados à entrada. Valores possíveis: unlikelyTravel , , anonymizedIPAddress , maliciousIPAddress , unfamiliarFeatures , malwareInfectedIPAddress , suspiciousIPAddress , leakedCredentials , investigationsThreatIntelligence , generic , ou unknownFutureValue . Suporta $filter (eq , startsWith ). |
riskLevelAggregated | riskLevel | O nível de risco agregado. Valores possíveis: none , , medium low , high , , hidden ou unknownFutureValue . O valor hidden significa que o usuário ou a entrada não estava habilitada para Microsoft Entra ID Protection. Suporta $filter (eq ). Nota: Os detalhes dessa propriedade só estão disponíveis para clientes Microsoft Entra ID P2. Todos os outros clientes são retornados hidden . |
riskLevelDuringSignIn | riskLevel | O nível de risco durante a entrada. Valores possíveis: none , , medium low , high , , hidden ou unknownFutureValue . O valor hidden significa que o usuário ou a entrada não estava habilitada para Microsoft Entra ID Protection. Suporta $filter (eq ). Nota: Os detalhes dessa propriedade só estão disponíveis para clientes Microsoft Entra ID P2. Todos os outros clientes são retornados hidden . |
riskState | riskState | O estado de risco de um usuário arriscado, entrada ou evento de risco. Valores possíveis: none , , confirmedSafe , remediated , dismissed , atRisk , confirmedCompromised ou unknownFutureValue . Suporta $filter (eq ). |
servicePrincipalCredentialKeyId | Cadeia de caracteres | O identificador exclusivo da credencial de chave usada pela entidade de serviço para autenticação. |
servicePrincipalCredentialThumbprint | Cadeia de caracteres | A impressão digital do certificado usado pela entidade de serviço para autenticação. |
servicePrincipalId | Cadeia de caracteres | O identificador de aplicativo usado para entrar. Esse campo é preenchido quando você está entrando usando um aplicativo. Suporta $filter (eq , startsWith ). |
servicePrincipalName | Cadeia de caracteres | O nome do aplicativo usado para entrada. Esse campo é preenchido quando você está entrando usando um aplicativo. Suporta $filter (eq , startsWith ). |
sessionLifetimePolicies | coleção sessionLifetimePolicy | Todas as políticas de gerenciamento de sessão de acesso condicional que foram aplicadas durante o evento de entrada. |
signInEventTypes | Coleção String | Indica a categoria de entrada que o evento representa. Para entradas de usuário, a categoria pode ser interactiveUser ou nonInteractiveUser e corresponde ao valor da propriedade isInteractive no recurso de entrada. Para entradas de identidade gerenciada, a categoria é managedIdentity . Para entradas de entidade de serviço, a categoria é servicePrincipal. Os valores possíveis são: interactiveUser , nonInteractiveUser , servicePrincipal , managedIdentity , unknownFutureValue . Suporta $filter (eq , ne ). |
signInIdentifier | Cadeia de caracteres | A identificação que o usuário forneceu para entrar. Ele pode ser o userPrincipalName, mas também é preenchido quando um usuário entra usando outros identificadores. |
signInIdentifierType | signInIdentifierType | O tipo de identificador de entrada. Os possíveis valores são: userPrincipalName , phoneNumber , proxyAddress , qrCode , onPremisesUserPrincipalName , unknownFutureValue . |
signInTokenProtectionStatus | tokenProtectionStatus | A proteção de token cria um vínculo criptograficamente seguro entre o token e o dispositivo ao qual ele é emitido. Esse campo indica se o token de entrada estava vinculado ao dispositivo ou não. Os valores possíveis são: none , bound , unbound , unknownFutureValue . |
status | signInStatus | O status de entrada. Inclui o código de erro e a descrição do erro (para uma falha de entrada). $filter Dá suporte (eq ) à propriedade errorCode. |
tokenIssuerName | Cadeia de caracteres | O nome do provedor de identidade. Por exemplo, sts.microsoft.com . Suporta $filter (eq ). |
tokenIssuerType | tokenIssuerType | O tipo de provedor de identidade. Os valores possíveis são: AzureAD , ADFederationServices , UnknownFutureValue , AzureADBackupAuth , ADFederationServicesMFAAdapter , NPSExtension . Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores neste enumerável em evolução: AzureADBackupAuth , , ADFederationServicesMFAAdapter . NPSExtension |
uniqueTokenIdentifier | Cadeia de caracteres | Um identificador de solicitação codificado base64 exclusivo usado para rastrear tokens emitidos pelo Microsoft Entra ID à medida que são resgatados em provedores de recursos. |
Useragent | Cadeia de caracteres | As informações do agente de usuário relacionadas à entrada. Suporta $filter (eq , startsWith ). |
userDisplayName | Cadeia de caracteres | O nome de exibição do usuário. Suporta $filter (eq , startsWith ). |
userId | Cadeia de caracteres | O identificador do usuário. Suporta $filter (eq ). |
userPrincipalName | Cadeia de caracteres | O UPN do usuário. Suporta $filter (eq , startsWith ). |
userType | signInUserType | Identifica se o usuário é membro ou convidado no locatário. Os valores possíveis são: member , guest , unknownFutureValue . |
mfaDetail (preterido) | Cadeia de caracteres | Essa propriedade está preterida. |
Relações
Nenhum
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.signIn",
"appDisplayName": "String",
"appId": "String",
"authenticationContextClassReferences": [{"@odata.type": "microsoft.graph.authenticationContext"}],
"appliedConditionalAccessPolicies": [
{
"@odata.type": "microsoft.graph.appliedConditionalAccessPolicy"
}
],
"appliedEventListeners": [
{
"@odata.type": "microsoft.graph.appliedAuthenticationEventListener"
}
],
"appTokenProtectionStatus": "String",
"authenticationAppDeviceDetails": {
"@odata.type": "microsoft.graph.authenticationAppDeviceDetails"
},
"authenticationAppPolicyEvaluationDetails": [
{
"@odata.type": "microsoft.graph.authenticationAppPolicyDetails"
}
],
"authenticationDetails": [
{
"@odata.type": "microsoft.graph.authenticationDetail"
}
],
"authenticationMethodsUsed": [
"String"
],
"authenticationProcessingDetails": [
{
"@odata.type": "microsoft.graph.keyValue"
}
],
"authenticationRequirement": "String",
"authenticationRequirementPolicies": [
{
"@odata.type": "microsoft.graph.authenticationRequirementPolicy"
}
],
"autonomousSystemNumber": "Integer",
"azureResourceId": "String",
"clientAppUsed": "String",
"conditionalAccessStatus": "String",
"correlationId": "String",
"createdDateTime": "String (timestamp)",
"crossTenantAccessType": "String",
"deviceDetail": {
"@odata.type": "microsoft.graph.deviceDetail"
},
"federatedCredentialId": "String",
"flaggedForReview": "Boolean",
"id": "String (identifier)",
"homeTenantId": "String",
"homeTenantName": "String",
"isInteractive": "Boolean",
"isTenantRestricted": "Boolean",
"ipAddress": "String",
"ipAddressFromResourceProvider": "String",
"location": {
"@odata.type": "microsoft.graph.signInLocation"
},
"mfaDetail": {
"@odata.type": "microsoft.graph.mfaDetail"
},
"networkLocationDetails": [
{
"@odata.type": "microsoft.graph.networkLocationDetail"
}
],
"originalRequestId": "String",
"originalTransferMethod": "String",
"privateLinkDetails": {
"@odata.type": "microsoft.graph.privateLinkDetails"
},
"processingTimeInMilliseconds": "Integer",
"riskDetail": "String",
"riskEventTypes": [
"String"
],
"riskEventTypes_v2": [
"String"
],
"riskLevelAggregated": "String",
"riskLevelDuringSignIn": "String",
"riskState": "String",
"resourceDisplayName": "String",
"resourceId": "String",
"resourceTenantId": "String",
"servicePrincipalCredentialKeyId": "String",
"servicePrincipalCredentialThumbprint": "String",
"servicePrincipalId": "String",
"servicePrincipalName": "String",
"sessionLifetimePolicies": [{"@odata.type": "microsoft.graph.sessionLifetimePolicy"}],
"signInEventTypes": [
"String"
],
"signInIdentifier": "String",
"signInIdentifierType": "String",
"signInTokenProtectionStatus": "String",
"status": {
"@odata.type": "microsoft.graph.signInStatus"
},
"tokenIssuerName": "String",
"tokenIssuerType": "String",
"userAgent": "String",
"userDisplayName": "String",
"userId": "String",
"userPrincipalName": "String",
"userType": "String"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de