Type de ressource signIn

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Détaille l’activité de connexion des utilisateurs ou des applications dans votre répertoire. Vous devez disposer d’une licence Microsoft Entra ID P1 ou P2 pour télécharger les journaux de connexion à l’aide du API Graph Microsoft.

Les stratégies de conservation des données Microsoft Entra régissent la disponibilité des journaux de connexion.

Remarque

Cette API retourne uniquement les connexions interactives, sauf si vous définissez un filtre explicite. Par exemple, le filtre pour obtenir des connexions non interactives est https://graph.microsoft.com/beta/auditLogs/signIns?&$filter=signInEventTypes/any(t: t eq 'nonInteractiveUser').

Méthodes

Méthode Type renvoyé Description
List signIn Lit les propriétés et les relations des objets signIn.
Obtenir signIn Lit les propriétés et les relations d’un objet signIn.
Confirmer la compromission Aucun Marquez un événement dans les journaux de connexion Microsoft Entra comme risqué.
Confirmer la sécurité Aucun marquer un événement dans Microsoft Entra journaux de connexion comme étant sécurisé.

Propriétés

Propriété Type Description
appDisplayName String Nom de l’application affiché dans le centre d’administration Microsoft Entra.

Prend en charge $filter (eq, startsWith).
appId String Identificateur d’application dans Microsoft Entra ID.

Prend en charge $filter (eq).
appliedConditionalAccessPolicies collection appliedConditionalAccessPolicy Liste des stratégies d’accès conditionnel déclenchées par l’activité de connexion correspondante. Les applications ont besoin de plus de privilèges liés à l’accès conditionnel pour lire les détails de cette propriété. Pour plus d’informations, consultez Autorisations d’affichage des stratégies d’accès conditionnel appliquées dans les connexions.
appliedEventListeners collection appliedAuthenticationEventListener Informations détaillées sur les écouteurs, tels qu’Azure Logic Apps et Azure Functions, sur lesquels les événements correspondants dans l’événement de connexion ont déclenché.
appTokenProtectionStatus tokenProtectionStatus La protection des jetons crée une liaison sécurisée du point de vue du chiffrement entre le jeton et l’appareil pour lequel il est émis. Ce champ indique si le jeton d’application était lié à l’appareil.
authenticationAppDeviceDetails authenticationAppDeviceDetails Fournit des détails sur l’application et l’appareil utilisés lors d’une étape d’authentification Microsoft Entra.
authenticationAppPolicyEvaluationDetails collection authenticationAppPolicyDetails Fournit des détails sur les stratégies Microsoft Entra appliquées à une application d’authentification utilisateur et cliente pendant une étape d’authentification.
authenticationContextClassReferences collection authenticationContext Contient une collection de valeurs qui représentent les contextes d’authentification d’accès conditionnel appliqués à la connexion.
authenticationDetails collection authenticationDetail Résultat de la tentative d’authentification et plus de détails sur la méthode d’authentification.
authenticationMethodsUsed String collection Méthodes d’authentification utilisées. Valeurs possibles : SMS, Authenticator App, App Verification code, PasswordFIDO, PTA, ou PHS.
authenticationProcessingDetails Collection keyValue Plus de détails de traitement de l’authentification, tels que le nom de l’agent pour PTA et PHS, ou un nom de serveur ou de batterie pour l’authentification fédérée.
authenticationProtocol protocolType Listes le type de protocole ou le type d’octroi utilisé dans l’authentification. Les valeurs possibles sont , none, oAuth2, ropcwsFederation, saml20, deviceCode, unknownFutureValue, , authenticationTransfer, , nativeAuth. Utilisez none pour toutes les authentifications qui n’ont pas de valeur spécifique dans cette liste. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : authenticationTransfer, nativeAuth.
authenticationRequirement String Cela permet d’obtenir le niveau d’authentification le plus élevé nécessaire à toutes les étapes de connexion, pour que la connexion réussisse.

Prend en charge $filter (eq, startsWith).
authenticationRequirementPolicies collection authenticationRequirementPolicy Sources d’exigence d’authentification, telles que l’accès conditionnel, l’authentification multifacteur par utilisateur, la protection des identités et les paramètres de sécurité par défaut.
autonomousSystemNumber Int32 Numéro de système autonome (ASN) du réseau utilisé par l’acteur.
azureResourceId String Contient un ID de Resource Manager Azure complet d’une ressource Azure accessible pendant la connexion.
clientAppUsed String Client hérité utilisé pour l’activité de connexion. Par exemple : Browser, , Modern clientsExchange ActiveSync, IMAP, MAPI, SMTPou POP.

Prend en charge $filter (eq).
clientCredentialType clientCredentialType Décrit le type d’informations d’identification qu’un client utilisateur ou un principal de service a fourni à Microsoft Entra ID pour s’authentifier. Vous pouvez examiner cette propriété pour suivre et éliminer les types d’informations d’identification moins sécurisés ou pour watch pour les clients et les principaux de service à l’aide de types d’informations d’identification anormaux. Les valeurs possibles sont none, clientSecret, clientAssertion, federatedIdentityCredential, managedIdentity, certificate, unknownFutureValue.
conditionalAccessAudiences String Liste qui indique l’audience évaluée par l’accès conditionnel lors d’un événement de connexion.

Prend en charge $filter (eq).
conditionalAccessStatus conditionalAccessStatus Status de la stratégie d’accès conditionnel déclenchée. Valeurs possibles : success, failure, notAppliedou unknownFutureValue.

Prend en charge $filter (eq).
correlationId String Identificateur que le client envoie quand la connexion est lancée. Cette propriété est utilisée pour résoudre les problèmes liés à l’activité de connexion correspondante lors de l’appel au support technique.

Prend en charge $filter (eq).
createdDateTime DateTimeOffset Date et heure de démarrage de la connexion. Le type d’horodatage est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.

Prend en charge $orderby, $filter (eq, leet ge).
crossTenantAccessType signInAccessType Décrit le type d’accès interlocataire utilisé par l’acteur pour accéder à la ressource. Les valeurs possibles sont les suivantes : none, b2bCollaboration, b2bDirectConnect, microsoftSupport, serviceProvider, unknownFutureValue et passthrough. En outre, vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir la ou les valeurs suivantes dans cette énumération évolutive : passthrough. Si la connexion n’a pas franchi les limites du locataire, la valeur est none.
deviceDetail deviceDetail Informations sur l’appareil à partir de laquelle la connexion s’est produite. Inclut des informations telles que deviceId, système d’exploitation et navigateur.

Prend en charge $filter (eq, startsWith) sur les propriétés browser et operatingSystem .
federatedCredentialId String Contient l’identificateur des informations d’identification d’identité fédérée d’une application, si des informations d’identification d’identité fédérée ont été utilisées pour la connexion.
indicateurForReview Boolean Lors d’une connexion ayant échoué, un utilisateur peut sélectionner un bouton dans le Portail Azure pour marquer l’événement ayant échoué pour les administrateurs de locataire. Si un utilisateur sélectionne le bouton pour marquer l’échec de la connexion, cette valeur est true.
globalSecureAccessIpAddress String Adresse IP globale d’accès sécurisé à partir de laquelle la connexion a été lancée.
homeTenantId String Identificateur de locataire de l’utilisateur qui lance la connexion. Non applicable dans identité managée ou connexions de principal de service.
homeTenantName String Pour les connexions utilisateur, identificateur du locataire dont l’utilisateur est membre. Renseigné uniquement dans les cas où le locataire d’origine fournit un consentement positif pour Microsoft Entra ID d’afficher le contenu du locataire.
id String Identificateur représentant l’activité de connexion. Hérité de l’entité.

Prend en charge $filter (eq).
incomingTokenType incomingTokenType Indique les types de jetons qui ont été présentés à Microsoft Entra ID pour authentifier l’acteur dans la connexion. Les valeurs possibles sont none, primaryRefreshToken, saml11, saml20, unknownFutureValue, remoteDesktopToken, refreshToken.

REMARQUE Microsoft Entra ID avez peut-être également utilisé des types de jetons non répertoriés dans ce type d’énumération pour authentifier l’acteur. Ne déduitz pas l’absence d’un jeton s’il ne s’agit pas de l’un des types répertoriés. En outre, vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir la ou les valeurs suivantes dans cette énumération évolutive : remoteDesktopToken, refreshToken.
ipAddress String Adresse IP du client à partir duquel la connexion s’est produite.

Prend en charge $filter (eq, startsWith).
ipAddressFromResourceProvider String Adresse IP utilisée par un utilisateur pour atteindre un fournisseur de ressources, utilisée pour déterminer la conformité de l’accès conditionnel pour certaines stratégies. Par exemple, lorsqu’un utilisateur interagit avec Exchange Online, l’adresse IP que Microsoft Exchange reçoit de l’utilisateur peut être enregistrée ici. Cette valeur est souvent null.
isInteractive Boolean Indique si une connexion utilisateur est interactive. Dans la connexion interactive, l’utilisateur fournit un facteur d’authentification pour Microsoft Entra ID. Ces facteurs incluent les mots de passe, les réponses aux défis de l’authentification multifacteur, les facteurs biométriques ou les codes QR qu’un utilisateur fournit à Microsoft Entra ID ou à une application associée. Dans la connexion non interactive, l’utilisateur ne fournit pas de facteur d’authentification. Au lieu de cela, l’application cliente utilise un jeton ou un code pour authentifier ou accéder à une ressource pour le compte d’un utilisateur. Les connexions non interactives sont couramment utilisées pour qu’un client se connecte pour le compte d’un utilisateur dans un processus transparent pour l’utilisateur.
isTenantRestricted Boolean Indique si l’événement de connexion a été soumis à une stratégie de restriction de locataire Microsoft Entra.
isThroughGlobalSecureAccess Boolean Indique si un utilisateur est passé par le service Global Secure Access.
location signInLocation Code de la ville, de l’État et du pays à deux lettres à partir duquel la connexion s’est produite.

Prend en charge $filter (eq, startsWith) sur les propriétés city, state et countryOrRegion .
managedServiceIdentity managedIdentity Contient des informations sur l’identité managée utilisée pour la connexion, notamment son type, l’ID de ressource Azure Resource Manager (ARM) associé et les informations de jeton fédéré.
networkLocationDetails Collection networkLocationDetail Détails de l’emplacement réseau, y compris le type de réseau utilisé et ses noms.
originalRequestId String Identificateur de la première requête dans la séquence d’authentification.

Prend en charge $filter (eq).
originalTransferMethod originalTransferMethods Méthode de transfert utilisée pour lancer une session dans toutes les requêtes suivantes. Les valeurs possibles sont : none, deviceCodeFlow, authenticationTransfer, unknownFutureValue.
privateLinkDetails privateLinkDetails Contient des informations sur la stratégie Microsoft Entra Private Link associée à l’événement de connexion.
processingTimeInMilliseconds Int Temps de traitement de la demande en millisecondes dans AD STS.
resourceDisplayName String Nom de la ressource à laquelle l’utilisateur s’est connecté.

Prend en charge $filter (eq).
resourceId String Identificateur de la ressource à laquelle l’utilisateur s’est connecté.

Prend en charge $filter (eq).
resourceServicePrincipalId String Identificateur du principal de service représentant la ressource cible dans l'événement de connexion.
resourceTenantId String Identificateur de locataire de la ressource référencée dans la connexion.
riskDetail riskDetail Raison d’un état spécifique d’un utilisateur à risque, d’une connexion ou d’un événement à risque. Les valeurs possibles sont none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, aiConfirmedSigninSafeuserPassedMFADrivenByRiskBasedPolicy, adminDismissedAllRiskForUser, adminConfirmedSigninCompromised, hidden, adminConfirmedUserCompromised, m365DAdminDismissedDetectionadminConfirmedServicePrincipalCompromisedunknownFutureValueadminDismissedAllRiskForServicePrincipal, userChangedPasswordOnPremises, , . adminConfirmedAccountSafeadminDismissedRiskForSignIn Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir la ou les valeurs suivantes dans cette énumération évolutive : adminConfirmedServicePrincipalCompromised, adminDismissedAllRiskForServicePrincipal, m365DAdminDismissedDetection, adminConfirmedAccountSafeuserChangedPasswordOnPremisesadminDismissedRiskForSignIn. La valeur none signifie que Microsoft Entra détection des risques n’a pas marqué l’utilisateur ou la connexion comme un événement à risque jusqu’à présent.

Prend en charge $filter (eq).
Note: Les détails de cette propriété sont disponibles uniquement pour les clients Microsoft Entra ID P2. Tous les autres clients sont retournés hidden.
riskEventTypes_v2 String collection Liste des types d’événements à risque associés à la connexion. Valeurs possibles : unlikelyTravel, anonymizedIPAddress, maliciousIPAddress, unfamiliarFeatures, malwareInfectedIPAddress, suspiciousIPAddressleakedCredentials, investigationsThreatIntelligencegeneric, ou unknownFutureValue.

Prend en charge $filter (eq, startsWith).
riskLevelAggregated riskLevel Niveau de risque agrégé. Valeurs possibles : none, low, medium, highhidden, ou unknownFutureValue. La valeur hidden signifie que l’utilisateur ou la connexion n’a pas été activé pour Protection Microsoft Entra ID.

Prend en charge $filter (eq).
Note: Les détails de cette propriété sont disponibles uniquement pour les clients Microsoft Entra ID P2. Tous les autres clients sont retournés hidden.
riskLevelDuringSignIn riskLevel Niveau de risque pendant la connexion. Valeurs possibles : none, low, medium, highhidden, ou unknownFutureValue. La valeur hidden signifie que l’utilisateur ou la connexion n’a pas été activé pour Protection Microsoft Entra ID.

Prend en charge $filter (eq).
Note: Les détails de cette propriété sont disponibles uniquement pour les clients Microsoft Entra ID P2. Tous les autres clients sont retournés hidden.
riskState riskState État de risque d’un utilisateur à risque, d’une connexion ou d’un événement à risque. Valeurs possibles : none, confirmedSafe, remediated, dismissedatRisk, confirmedCompromised, ou unknownFutureValue.

Prend en charge $filter (eq).
servicePrincipalCredentialKeyId String Identificateur unique des informations d’identification de clé utilisées par le principal de service pour l’authentification.
servicePrincipalCredentialThumbprint String Empreinte numérique du certificat utilisé par le principal de service pour l’authentification.
servicePrincipalId String Identificateur d’application utilisé pour la connexion. Ce champ est rempli lorsque vous vous connectez à l’aide d’une application.

Prend en charge $filter (eq, startsWith).
servicePrincipalName String Nom de l’application utilisé pour la connexion. Ce champ est rempli lorsque vous vous connectez à l’aide d’une application.

Prend en charge $filter (eq, startsWith).
sessionLifetimePolicies collection sessionLifetimePolicy Toutes les stratégies de gestion de session d’accès conditionnel qui ont été appliquées pendant l’événement de connexion.
signInEventTypes String collection Indique la catégorie de connexion que l’événement représente. Pour les connexions utilisateur, la catégorie peut être interactiveUser ou nonInteractiveUser et correspond à la valeur de la propriété isInteractive sur la ressource signin. Pour les connexions d’identité managée, la catégorie est managedIdentity. Pour les connexions du principal de service, la catégorie est servicePrincipal. Les valeurs possibles sont les suivantes : interactiveUser, nonInteractiveUser, servicePrincipal, managedIdentity, unknownFutureValue.

Prend en charge $filter (eq, ne).
sessionId String Identificateur de la session qui a été générée pendant la connexion.
signInIdentifier String Identification fournie par l’utilisateur pour se connecter. Il peut s’agir de userPrincipalName, mais est également renseigné lorsqu’un utilisateur se connecte à l’aide d’autres identificateurs.
signInIdentifierType signInIdentifierType Type d’identificateur de connexion. Les valeurs possibles sont userPrincipalName, phoneNumber, proxyAddress, qrCode, onPremisesUserPrincipalName, unknownFutureValue.
signInTokenProtectionStatus tokenProtectionStatus La protection des jetons crée une liaison sécurisée du point de vue du chiffrement entre le jeton et l’appareil pour lequel il est émis. Ce champ indique si le jeton de connexion était lié à l’appareil ou non. Les valeurs possibles sont : none, bound, unbound, unknownFutureValue.
statut signInStatus La connexion status. Inclut le code d’erreur et la description de l’erreur (en cas d’échec de connexion).

Prend en charge $filter (eq) sur la propriété errorCode .
tokenIssuerName String Nom du fournisseur d’identité. Par exemple : sts.microsoft.com.

Prend en charge $filter (eq).
tokenIssuerType tokenIssuerType Type de fournisseur d’identité. Les valeurs possibles sont AzureAD, ADFederationServices, UnknownFutureValue, AzureADBackupAuth, ADFederationServicesMFAAdapter, NPSExtension. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : AzureADBackupAuth , ADFederationServicesMFAAdapter , NPSExtension.
uniqueTokenIdentifier String Identificateur de requête encodé en base64 unique utilisé pour suivre les jetons émis par Microsoft Entra ID à mesure qu’ils sont échangés auprès des fournisseurs de ressources.
userAgent String Informations de l’agent utilisateur relatives à la connexion.

Prend en charge $filter (eq, startsWith).
userDisplayName String Nom d’affichage de l’utilisateur.

Prend en charge $filter (eq, startsWith).
userId String Identificateur de l’utilisateur.

Prend en charge $filter (eq).
userPrincipalName String Nom d’utilisateur principal de l’utilisateur qui a lancé la connexion. Cette valeur est toujours en minuscules. Pour les utilisateurs invités dont les valeurs dans l’objet utilisateur contiennent #EXT# généralement avant la partie de domaine, cette propriété stocke la valeur en minuscules et au format « true ». Par exemple, pendant que l’objet utilisateur stocke AdeleVance_fabrikam.com#EXT#@contoso.com, les journaux de connexion stockent adelevance@fabrikam.com.

Prend en charge $filter (eq, startsWith).
userType signInUserType Identifie si l’utilisateur est membre ou invité dans le locataire. Les valeurs possibles sont member, guest et unknownFutureValue.
mfaDetail (déconseillé) mfaDetail Cette propriété est déconseillée.

Relations

Aucun

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@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": {
      "@odata.type": "microsoft.graph.tokenProtectionStatus"
  },
  "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_v2": [
    "String"
  ],
  "riskLevelAggregated": "String",
  "riskLevelDuringSignIn": "String",
  "riskState": "String",
  "resourceDisplayName": "String",
  "resourceId": "String",
  "resourceTenantId": "String",
  "servicePrincipalCredentialKeyId": "String",
  "servicePrincipalCredentialThumbprint": "String",
  "servicePrincipalId": "String",
  "servicePrincipalName": "String",
  "sessionId": "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"
}