> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/user/security/list-signin-events.md).

# Lister les événements de connexion

Afficher les connexions récentes de cet utilisateur et leurs échecs

### Description

Liste les connexions Entra ID de cet utilisateur pour le nombre de jours choisi, avec l’application, l’heure, le résultat, l’application cliente, l’appareil et l’emplacement. Les échecs sont agrégés par application afin que le support puisse voir où les connexions échouent, et les connexions ayant échoué affichent aussi l’adresse IP. Le rapport peut être envoyé par e-mail ou fourni sous forme de lien de téléchargement.

### Cas d’utilisation courants

* Détermine quelle application génère des échecs de connexion pour un utilisateur spécifique et pourquoi, regroupés par code d’erreur.
* Affinez les résultats avec `ApplicationName` (correspondance partielle) ou `FailedSignInsOnly` lorsqu’un utilisateur signale des problèmes d’accès.
* Exportez les données de connexion au format CSV ou Excel pour une analyse plus poussée lorsque le nombre d’événements est trop élevé pour être consulté dans le portail.

### Comportement

* Les données du journal de connexion sont récupérées à partir du point de terminaison bêta de Microsoft Graph, car le filtrage par type d’événement de connexion et la récupération des connexions non interactives nécessitent des propriétés disponibles uniquement en version bêta (`signInEventTypes`, `authenticationRequirement`).
* Les résultats sont écrits dans l’onglet **onglet Données de sortie** de la tâche à chaque exécution : un résumé, le résumé par application, les connexions ayant échoué et, sauf si seules les connexions ayant échoué sont demandées, toutes les connexions. La console affiche les compteurs.
* Les connexions non interactives dépassent largement en nombre les connexions interactives ; les tableaux de connexions dans l’onglet Output Data sont limités aux 250 entrées les plus récentes, mais les fichiers de rapport exportés contiennent toujours l’ensemble complet des résultats.

### Licence et autorisations requises

La lecture des journaux de connexion via l’API Microsoft Graph nécessite un **licence Entra ID P1 ou P2** dans le locataire. Les locataires qui n’en disposent pas reçoivent une erreur 403 de la requête du journal de connexion, même lorsque toutes les autorisations Graph sont accordées. Avec P1/P2, les journaux de connexion sont conservés jusqu’à 30 jours ; la rétention de 7 jours de l’offre gratuite s’applique au portail Entra, et non à ce runbook.

Si la requête du journal de connexion renvoie un 403 alors que `AuditLog.Read.All` est accordée et que le locataire est licencié, certains locataires nécessitent en plus `Directory.Read.All` sur l’API de reporting Entra. L’accorder est la solution de contournement connue ; elle n’est pas déclarée par défaut, car elle donne un accès en lecture à tous les objets du répertoire.

### Livraison du rapport

Les fichiers du rapport ne sont générés que lorsqu’une méthode de livraison est sélectionnée via l’ **Livraison du rapport** option (e-mail et/ou lien de téléchargement). Avec *Uniquement les données de sortie* sélectionné, aucun fichier de rapport n’est créé et l’analyse des connexions est lue dans l’onglet Output Data de la tâche dans le portail RealmJoin. La livraison par e-mail et la génération du lien de téléchargement sont indépendantes et peuvent être combinées.

Pour le lien de téléchargement, les fichiers du rapport sont téléversés vers le Storage Account Azure configuré dans les `RJReport.StorageAccount.*` paramètres du Tenant, et des liens de téléchargement SAS à durée limitée sont renvoyés. Le téléversement vers le Storage Account s’authentifie avec l’identité managée du compte Automation ; cette identité nécessite le **Reader and Data Access** rôle RBAC sur le Storage Account cible (il s’agit d’une attribution Azure RBAC, pas d’une autorisation d’application Graph).

### Configuration de l’envoi d’e-mails

L’envoi du rapport par e-mail est facultatif et ne se produit que lorsque *Envoyer aussi le rapport par e-mail* ou *Envoyer aussi par e-mail et lien de téléchargement* est sélectionné comme mode de livraison du rapport ; un destinataire est alors requis. L’adresse de l’expéditeur est prise à partir de la `RJReport.EmailSender` paramètre Tenant.

Ce runbook envoie des e-mails à l’aide de l’API Microsoft Graph. Pour envoyer des e-mails via l’API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Voir la [documentation des paramètres de rapport RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails sur tous les paramètres disponibles.

#### Branding des e-mails

L’e-mail du rapport prend en compte l’optionnel `RJReport.Branding.*` paramètres Tenant :

* **Image d’en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune
* **Lien de pied de page** – cible de l’image de pied de page
* **Couleur d’accent et de texte** – valeurs hexadécimales à 6 chiffres, par ex. `#0052cc`

Lorsque ces paramètres ne sont pas configurés, les graphismes et couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur non valide, n’empêche jamais l’envoi de l’e-mail du rapport : le défaut correspondant est utilisé à la place.

Instructions de configuration et exigences relatives aux images : [Branding des e-mails](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Interprétation des résultats

Entra considère certaines interruptions de connexion comme des erreurs (par exemple 50140 « Keep me signed in », 50058 et 50076), elles apparaissent donc comme des échecs et sont incluses dans le taux d’échec par application. Vérifiez la raison de l’échec avant de considérer un taux d’échec élevé comme un véritable problème. Les codes d’erreur sont des codes d’erreur de connexion Entra ID ; consultez-les à <https://login.microsoftonline.com/error>.

Les données du journal de connexion présentent généralement un retard d’environ 15 minutes, mais certains enregistrements peuvent prendre jusqu’à 2 heures ; une connexion très récente peut ne pas encore apparaître. Tous les horodatages sont affichés en UTC.

### Emplacement

Utilisateur → Sécurité → Lister les événements de connexion

**Nom complet du runbook**

rjgit-user\_security\_list-signin-events

### Détails

| Propriété      | Valeur                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version        | 1.1.0                                                                                                              |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planifiable    | non                                                                                                                |

### Autorisations

#### Autorisations d’application

* **Type**: Microsoft Graph
  * AuditLog.Read.All
    * *Lit les événements de connexion Entra ID de l’utilisateur cible à partir de auditLogs/signIns (beta) pour générer le rapport*
  * User.Read.All
    * *Résout l’utilisateur cible pour obtenir id, userPrincipalName et displayName*
  * Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Envoie l’e-mail du rapport de connexion avec des pièces jointes CSV/XLSX via Send-RjRbReportEmail lorsque la livraison par e-mail est sélectionnée*
  * Organization.Read.All *(facultatif — fonctionnalité : rapport par e-mail)*
    * *Lit /organization pour placer le nom du locataire dans le pied de page de l’e-mail du rapport*

#### Notes sur les autorisations

Azure Storage Account: rôle 'Reader and Data Access' pour l’identité managée du compte Automation sur le Storage Account cible - le téléversement récupère les clés du compte via listKeys (requis uniquement pour les options de lien de téléchargement)

### Paramètres

#### Nom d'utilisateur

Nom principal de l'utilisateur sur lequel le runbook agit. Défini par le portail à partir de l'utilisateur sélectionné.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | vrai                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### Jours

Nombre de jours de journaux de connexion à inclure, de 1 à 30.

| Propriété                  | Valeur                     |
| -------------------------- | -------------------------- |
| Obligatoire                | faux                       |
| Valeur par défaut          | 7                          |
| Type                       | Int32                      |
| Nom d’affichage du portail | Nombre de jours à remonter |

#### SignInType

Connexions interactives effectuées par l’utilisateur, connexions non interactives par les applications et les jetons, ou les deux.

| Propriété                  | Valeur                  |
| -------------------------- | ----------------------- |
| Obligatoire                | faux                    |
| Valeur par défaut          | Interactives uniquement |
| Type                       | Chaîne                  |
| Nom d’affichage du portail | Type de connexion       |

#### FailedSignInsOnly

Masque les connexions réussies afin que les échecs et leurs raisons ressortent.

| Propriété                  | Valeur                                   |
| -------------------------- | ---------------------------------------- |
| Obligatoire                | faux                                     |
| Valeur par défaut          | Faux                                     |
| Type                       | Booléen                                  |
| Nom d’affichage du portail | Uniquement les connexions ayant échoué ? |

#### ApplicationName

Affiche uniquement les connexions aux applications dont le nom contient ce texte. Laisser vide pour toutes les applications.

| Propriété                  | Valeur               |
| -------------------------- | -------------------- |
| Obligatoire                | faux                 |
| Valeur par défaut          |                      |
| Type                       | Chaîne               |
| Nom d’affichage du portail | Filtre d’application |

#### EmailFrom

Adresse de l’expéditeur de l’e-mail du rapport. Prise dans le paramètre Tenant RJReport.EmailSender.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingHeaderImageUrl

Image d’en-tête de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.HeaderImageUrl ; l’en-tête RealmJoin par défaut est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterImageUrl

Image de pied de page de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterLink

Lien derrière l’image de pied de page de l’e-mail du rapport. Pris dans le paramètre Tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingAccentColor

Couleur d’accent de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingTextColor

Couleur du texte de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### SendEmailReport

Indique si le rapport est envoyé par e-mail. Défini à l’avance dans la personnalisation du runbook.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### EmailTo

Envoyez le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail distinct.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Adresse(s) e-mail du destinataire                  |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### ReportFileFormat

Distribuez le rapport en CSV, en classeur Excel ou dans les deux formats.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          | CSV et XLSX                                        |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Format du fichier de rapport                       |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

**Options du portail**

| Option du portail | Valeur          |
| ----------------- | --------------- |
| CSV et XLSX       | CSV et XLSX     |
| CSV uniquement    | CSV uniquement  |
| XLSX uniquement   | XLSX uniquement |

#### Créer un lien de téléchargement

Télécharge également le rapport et renvoie un lien de téléchargement qui expire après quelques jours.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### Nom du conteneur

Conteneur de stockage vers lequel les fichiers du rapport sont téléversés. À définir par runbook.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      | user-signin-events                                 |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### Nom du groupe de ressources

Groupe de ressources du compte de stockage pour les téléversements du rapport. Pris à partir du paramètre du tenant RJReport.StorageAccount.ResourceGroup.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### Nom du Storage Account

Compte de stockage pour les téléversements du rapport. Pris à partir du paramètre du tenant RJReport.StorageAccount.StorageAccountName.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### LinkExpiryDays

Nombre de jours pendant lesquels un lien de téléchargement reste valide. Pris à partir du paramètre du tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      | 6                                                  |
| Type                   | Int32                                              |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

[Retour à l’aperçu de la référence du runbook](/fr/automatisation/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/user/security/list-signin-events.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
