> 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/de/automatisierung/runbooks/runbook-references/user/security/list-signin-events.md).

# Anmeldeereignisse auflisten

Die letzten Anmeldungen dieses Benutzers und ihre Fehler anzeigen

### Beschreibung

Listet die Entra ID-Anmeldungen dieses Benutzers für die gewählte Anzahl von Tagen mit Anwendung, Uhrzeit, Ergebnis, Client-App, Gerät und Standort auf. Fehler werden pro Anwendung zusammengefasst, damit der Support sehen kann, wo Anmeldungen schiefgehen, und fehlgeschlagene Anmeldungen zeigen außerdem die IP-Adresse. Der Bericht kann per E-Mail gesendet oder als Download-Link bereitgestellt werden.

### Häufige Anwendungsfälle

* Untersucht, welche Anwendung bei einem bestimmten Benutzer Anmeldefehler verursacht und warum, gruppiert nach Fehlercode.
* Schränken Sie die Ergebnisse mit `ApplicationName` (teilweiser Treffer) oder `FailedSignInsOnly` wenn ein Benutzer Zugriffsprobleme meldet.
* Exportieren Sie die Anmeldedaten als CSV oder Excel für weitere Analysen, wenn die Ereignisanzahl zu groß ist, um sie im Portal zu lesen.

### Verhalten

* Die Anmeldelogdaten werden vom Microsoft Graph-Beta-Endpunkt abgerufen, da das Filtern nach Anmeldeereignistypen und das Abrufen nicht interaktiver Anmeldungen Beta-exklusive Eigenschaften erfordern (`signInEventTypes`, `authenticationRequirement`).
* Die Ergebnisse werden in die **Ausgabedaten** Registerkarte des Jobs bei jedem Lauf geschrieben: eine Zusammenfassung, die Zusammenfassung pro Anwendung, die fehlgeschlagenen Anmeldungen und, sofern nicht nur fehlgeschlagene Anmeldungen angefordert werden, alle Anmeldungen. Die Konsole zeigt die Zählwerte.
* Nicht interaktive Anmeldungen übertreffen die interaktiven bei Weitem; die Anmeldetabellen in der Registerkarte Ausgabedaten sind auf die 250 neuesten Einträge begrenzt, aber die exportierten Berichtdateien enthalten immer den vollständigen Ergebnissatz.

### Erforderliche Lizenz und Berechtigungen

Das Lesen von Anmeldelogs über die Microsoft Graph-API erfordert eine **Entra ID P1- oder P2-Lizenz** im Mandanten. Mandanten ohne diese erhalten einen 403-Fehler von der Abfrage des Anmeldelogs, selbst wenn alle Graph-Berechtigungen gewährt sind. Mit P1/P2 werden Anmeldelogs bis zu 30 Tage aufbewahrt; die 7-tägige Aufbewahrung der kostenlosen Stufe gilt für das Entra-Portal, nicht für dieses Runbook.

Wenn die Abfrage des Anmeldelogs einen 403 zurückgibt, obwohl `AuditLog.Read.All` die Berechtigung erteilt ist und der Mandant lizenziert ist, benötigen einige Mandanten zusätzlich `Directory.Read.All` für die Entra-Berichts-API. Das Gewähren dieser Berechtigung ist der bekannte Workaround; sie wird standardmäßig nicht deklariert, da sie Lesezugriff auf jedes Verzeichnisobjekt gewährt.

### Berichtszustellung

Berichtsdateien werden nur generiert, wenn eine Zustellmethode über die **Berichtszustellung** Option (E-Mail und/oder Downloadlink) ausgewählt wird. Mit *Nur Ausgabedaten* ausgewählt, werden keine Berichtdateien erstellt und die Anmeldeanalyse wird in der Registerkarte Output Data des Jobs im RealmJoin-Portal gelesen. E-Mail-Zustellung und Download-Link-Generierung sind unabhängig und können kombiniert werden.

Für den Downloadlink werden die Berichtsdateien in den in den Azure Storage Account hochgeladen, der in den `RJReport.StorageAccount.*` Tenant-Einstellungen konfiguriert ist, und zeitlich begrenzte SAS-Downloadlinks werden zurückgegeben. Der Speicher-Upload authentifiziert sich mit der verwalteten Identität des Automation-Kontos; diese Identität benötigt die **Reader and Data Access** RBAC-Rolle auf dem Ziel-Storage Account (dies ist eine Azure-RBAC-Zuweisung, keine Graph-Anwendungsberechtigung).

### Konfiguration für den E-Mail-Versand

Das Senden eines Berichts per E-Mail ist optional und erfolgt nur, wenn *Den Bericht auch per E-Mail senden* oder *Den Bericht auch per E-Mail senden & Downloadlink* als Berichtsversand ausgewählt ist; dann ist ein Empfänger erforderlich. Die Absenderadresse wird aus dem `RJReport.EmailSender` Mandanteneinstellung bezogen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph-API zu senden, müssen Sie eine vorhandene E-Mail-Adresse in der Runbook-Anpassung konfigurieren.

Siehe die [RealmJoin Report Settings Dokumentation](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) für Details zu allen verfügbaren Einstellungen.

#### E-Mail-Branding

Die Bericht-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Mandanteneinstellungen:

* **Kopf- und Fußzeilenbild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
* **Fußzeilenlink** – Ziel des Fußzeilenbildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die Standardgrafiken und -farben von RealmJoin verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die Bericht-E-Mail – stattdessen wird der entsprechende Standardwert verwendet.

Einrichtungsanweisungen und Bildanforderungen: [E-Mail-Branding](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Interpretation der Ergebnisse

Entra zählt einige Anmeldeunterbrechungen als Fehler (zum Beispiel 50140 „Keep me signed in“, 50058 und 50076), daher erscheinen sie als Fehler und gehen in die Fehlerquote pro Anwendung ein. Prüfen Sie den Fehlergrund, bevor Sie eine hohe Fehlerquote als echtes Problem betrachten. Fehlercodes sind Entra ID-Anmeldefehlercodes; suchen Sie sie unter <https://login.microsoftonline.com/error>.

Die Anmeldelogdaten hinken typischerweise um etwa 15 Minuten hinterher, können bei manchen Datensätzen aber bis zu 2 Stunden benötigen - eine sehr kürzliche Anmeldung wird möglicherweise noch nicht angezeigt. Alle Zeitstempel werden in UTC angezeigt.

### Speicherort

Benutzer → Sicherheit → Anmeldeereignisse auflisten

**Voller Runbook-Name**

rjgit-user\_security\_list-signin-events

### Details

| Eigenschaft          | Wert                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version              | 1.1.0                                                                                                              |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Planbar              | nein                                                                                                               |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * AuditLog.Read.All
    * *Liest die Entra ID-Anmeldeereignisse des Zielbenutzers aus auditLogs/signIns (Beta), um den Bericht zu erstellen*
  * User.Read.All
    * *Ermittelt den Zielbenutzer, um ID, userPrincipalName und displayName zu erhalten*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die E-Mail mit dem Anmeldebericht und CSV/XLSX-Anlagen über Send-RjRbReportEmail, wenn die E-Mail-Zustellung ausgewählt ist*
  * Organization.Read.All *(optional — Funktion: E-Mail-Bericht)*
    * *Liest /organization, um den Mandantennamen in die Fußzeile der Berichts-E-Mail aufzunehmen*

#### Hinweise zu Berechtigungen

Azure Storage Account: Rolle 'Reader and Data Access' für die verwaltete Identität des Automation-Kontos auf dem Ziel-Storage Account - der Upload ruft die Kontoschlüssel über listKeys ab (nur für die Downloadlink-Optionen erforderlich)

### Parameter

#### Benutzername

Benutzerprinzipalname des Benutzers, auf den das Runbook angewendet wird. Wird vom Portal aus dem ausgewählten Benutzer gesetzt.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | wahr                                            |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### Tage

Wie viele Tage an Anmeldelogs einbezogen werden sollen, 1 bis 30.

| Eigenschaft           | Wert                |
| --------------------- | ------------------- |
| Erforderlich          | falsch              |
| Standardwert          | 7                   |
| Typ                   | Int32               |
| Anzeigename im Portal | Zurückliegende Tage |

#### SignInType

Interaktive Anmeldungen durch den Benutzer, nicht interaktive durch Apps und Tokens oder beides.

| Eigenschaft           | Wert            |
| --------------------- | --------------- |
| Erforderlich          | falsch          |
| Standardwert          | Nur interaktive |
| Typ                   | Zeichenfolge    |
| Anzeigename im Portal | Anmeldetyp      |

#### FailedSignInsOnly

Blendet erfolgreiche Anmeldungen aus, damit die Fehler und ihre Gründe hervorstechen.

| Eigenschaft           | Wert                             |
| --------------------- | -------------------------------- |
| Erforderlich          | falsch                           |
| Standardwert          | Falsch                           |
| Typ                   | Boolesch                         |
| Anzeigename im Portal | Nur fehlgeschlagene Anmeldungen? |

#### ApplicationName

Zeigt nur Anmeldungen bei Anwendungen an, deren Name diesen Text enthält. Leer lassen für alle Anwendungen.

| Eigenschaft           | Wert             |
| --------------------- | ---------------- |
| Erforderlich          | falsch           |
| Standardwert          |                  |
| Typ                   | Zeichenfolge     |
| Anzeigename im Portal | Anwendungsfilter |

#### EmailFrom

Absenderadresse der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.EmailSender übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingHeaderImageUrl

Kopfzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Kopfbereich verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterImageUrl

Fußzeilenbild der Bericht-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird die standardmäßige RealmJoin-Fußzeile verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingFooterLink

Link hinter dem Fußzeilenbild der Bericht-E-Mail. Wird aus der Mandanteneinstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingAccentColor

Akzentfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### BrandingTextColor

Textfarbe der Bericht-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanteneinstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der standardmäßige RealmJoin-Wert verwendet.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### SendEmailReport

Ob der Bericht per E-Mail gesendet wird. Voreingestellt in der Runbook-Anpassung.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### EmailTo

Senden Sie den Bericht an diese Adressen. Trennen Sie mehrere durch Kommas; jeder Empfänger erhält eine separate E-Mail.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Empfänger-E-Mail-Adresse(n)                     |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ReportFileFormat

Liefern Sie den Bericht als CSV, als Excel-Arbeitsmappe oder beides.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | CSV & XLSX                                      |
| Typ                    | Zeichenfolge                                    |
| Anzeigename im Portal  | Berichtsdateiformat                             |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

**Portaloptionen**

| Portaloption | Wert       |
| ------------ | ---------- |
| CSV & XLSX   | CSV & XLSX |
| Nur CSV      | Nur CSV    |
| Nur XLSX     | Nur XLSX   |

#### CreateDownloadLink

Lädt den Bericht außerdem hoch und gibt einen Downloadlink zurück, der nach einigen Tagen abläuft.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | Falsch                                          |
| Typ                    | Boolesch                                        |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ContainerName

Speichercontainer, in den die Berichtsdateien hochgeladen werden. Pro Runbook festlegen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | user-signin-events                              |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### ResourceGroupName

Ressourcengruppe des Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.ResourceGroup übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### StorageAccountName

Storage Account für Bericht-Uploads. Aus der Tenant-Einstellung RJReport.StorageAccount.StorageAccountName übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

#### LinkExpiryDays

Anzahl der Tage, die ein Downloadlink gültig bleibt. Aus der Tenant-Einstellung RJReport.StorageAccount.LinkExpiryDays übernommen.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           | 6                                               |
| Typ                    | Int32                                           |
| Im Portal ausgeblendet | ja (vorkonfiguriert über die Runbook-Anpassung) |

[Zurück zur Übersicht der Runbook-Referenz](/de/automatisierung/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/de/automatisierung/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.