> 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/org/security/sync-mfa-secure-users-to-group_scheduled.md).

# Sichere MFA-Benutzer mit Gruppe synchronisieren, geplant

Eine Gruppe mit Benutzern füllen, die eine sichere MFA-Methode registriert haben

{% hint style="info" %}
Dies ist ein geplantes Runbook. Es ist dafür ausgelegt, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, statt für ein einzelnes Objekt ausgelöst zu werden. Siehe [Zeitplanung](https://docs.realmjoin.com/de/automatisierung/runbooks/scheduling.md) für Details zur Konfiguration von Runbook-Zeitplänen.
{% endhint %}

### Beschreibung

Behält eine Entra ID-Gruppe mit den Benutzern synchronisiert, die mindestens eine sichere Authentifizierungsmethode registriert haben, z. B. einen Passkey oder die Microsoft Authenticator-App. Benutzer, die ihre sichere Methode verlieren, werden entfernt, und Administratoren, eine Ausschlussgruppe sowie einzelne Benutzer können ausgeschlossen werden, z. B. wenn die Gruppe das Self-Service-Kennwortzurücksetzen steuert. Ein Probelauf zeigt nur die Änderungen an, und jeder Lauf schreibt eine Zusammenfassung und die Änderungen als Output Data. Der Bericht kann per E-Mail gesendet oder über einen Downloadlink bereitgestellt werden. Details zu den Optionen finden sich in der Runbook-Dokumentation (docs.realmjoin.com).

### So funktioniert es

Das Runbook liest die Entra ID [Authentifizierungsmethoden-Registrierungsbericht](https://learn.microsoft.com/en-us/graph/api/authenticationmethodsroot-list-userregistrationdetails) (`userRegistrationDetails`) und spiegelt die Zielgruppe gegen alle **Mitgliedsbenutzer** die sich qualifizieren:

* Ein Benutzer qualifiziert sich, wenn mindestens eine seiner registrierten Methoden in der konfigurierten **sicheren** Menge enthalten ist.
* In **strenger Modus** (`SecureOnly`) darf ein Benutzer zusätzlich keine Methode aus der **unsicheren** Menge registriert haben — ein Passkey-Benutzer, der auch einen SMS-Faktor beibehält, qualifiziert sich nicht.
* Qualifizierende Benutzer, die noch keine Gruppenmitglieder sind, werden hinzugefügt; Mitglieder, die sich nicht mehr qualifizieren, werden entfernt (Spiegel-Sync).
* Gastbenutzer werden niemals hinzugefügt oder entfernt. Nicht-Benutzer-Gruppenmitglieder (Geräte, Service Principals, verschachtelte Gruppen) werden niemals angetastet.

Die Zielgruppe sollte ausschließlich von diesem Runbook verwaltet werden.

### Gruppen mit sicheren Methoden

Jeder Schalter steuert, welche `methodsRegistered` Werte als sicher zählen:

| Schalter                             | Standard | Abgedeckte Werte                                                                     |
| ------------------------------------ | -------- | ------------------------------------------------------------------------------------ |
| Passkeys / FIDO2 Security Key        | ein      | `fido2SecurityKey`, `passKeyDeviceBound`, `passKeyDeviceBoundAuthenticator`          |
| Plattformanmeldedaten                | ein      | `windowsHelloForBusiness`, `passKeyDeviceBoundWindowsHello`, `macOsSecureEnclaveKey` |
| Microsoft Authenticator-App          | ein      | `microsoftAuthenticatorPush`, `microsoftAuthenticatorPasswordless`                   |
| Software-OTP                         | aus      | `softwareOneTimePasscode`                                                            |
| Hardware-OTP                         | aus      | `hardwareOneTimePasscode`                                                            |
| Zertifikatbasierte Authentifizierung | ein      | `certificateBasedAuthentication`                                                     |

### Strenger Modus (SecureOnly)

Wenn der strenge Modus aktiviert ist, qualifizieren sich Benutzer mit einer der folgenden integrierten unsicheren Methoden niemals:

`mobilePhone`, `alternateMobilePhone`, `officePhone`, `email`, `securityQuestion`

Wenn eine Methode am Ende sowohl in der sicheren als auch in der unsicheren Menge landet (nur über die Override-Parameter möglich), gewinnt unsicher — solche Benutzer qualifizieren sich im strengen Modus niemals. Das Runbook warnt beim Start davor.

### Ausschlüsse

Ausgeschlossene Benutzer qualifizieren sich unabhängig von ihren registrierten Methoden niemals: Sie werden nie zur Zielgruppe hinzugefügt und werden entfernt, wenn sie bereits Mitglieder sind. Der benutzerbezogene Bericht zeigt den Grund in der `ExclusionReason` Spalte.

#### Administratoren ausschließen (`ExcludeAdmins`, standardmäßig aktiviert)

Benutzer mit einer Entra ID-Verzeichnisrolle werden ausgeschlossen. Dies umfasst:

* **Aktive Rollenzuweisungen** (`roleManagement/directory/roleAssignments`)
* **PIM-berechtigte Zuweisungen** (`roleManagement/directory/roleEligibilitySchedules`, erfordert Entra ID P2 — wenn Graph die fehlende Lizenz meldet, fällt das Runbook auf aktive Zuweisungen zurück und protokolliert eine Warnung; jeder andere Fehler lässt den Auftrag fehlschlagen, bevor die Gruppe geändert wird)
* **Rollenzuweisbare Gruppen**: Gruppen, die eine Rolle besitzen, werden auf ihre transitiven Benutzer-Mitglieder erweitert

Hintergrund: Wenn die Zielgruppe **SSPR** steuert und die SSPR-Administratorrichtlinie deaktiviert ist, müssten Administratoren in der Gruppe trotzdem gezwungen werden, einen zweiten Faktor zu registrieren, sobald zwei SSPR-Methoden erforderlich sind. Administratoren aus der Gruppe herauszuhalten vermeidet dies.

Diese Option erfordert die zusätzliche Graph-Berechtigung `RoleManagement.Read.Directory` für die verwaltete Identität.

#### Ausschlussgruppe (`ExcludeGroupId`, optional)

Transitive Benutzer-Mitglieder der konfigurierten Gruppe werden ausgeschlossen — gedacht für Konten, die niemals von diesem Sync verwaltet werden dürfen, z. B. **Break-Glass-Konten** oder **Dienstkonten**. Verschachtelte Gruppen werden berücksichtigt. Die Ausschlussgruppe darf nicht die Zielgruppe selbst sein.

#### Einzeln ausgeschlossene Benutzer (`ExcludeUserIds`, optional)

Einzelne Benutzer können direkt über die Mehrbenutzer-Auswahl ausgeschlossen werden — für einmalige Ausschlüsse, bei denen sich die Pflege einer eigenen Ausschlussgruppe nicht lohnt. Die Liste akzeptiert Benutzer **Objekt-IDs** und **Benutzer-Principal-Namen** (UPNs). Nicht auflösbare Einträge (z. B. ein gelöschtes Konto) protokollieren eine Warnung und werden ignoriert, sodass ein veralteter Eintrag einen geplanten Sync nie unterbricht.

#### Ausschlüsse über Runbook Customization verwalten (ohne die Auswahlen)

Beide Ausschlussparameter können zentral vorab über [JSON-basierte Runbook Customization](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) (RealmJoin-Portal: **Einstellungen** → **Runbook Customizations**) festgelegt werden — nützlich, wenn die Ausschlüsse für den Tenant feststehen und nicht jedes Mal manuell ausgewählt werden sollen, wenn das Runbook gestartet oder geplant wird:

```json
{
    "Runbooks": {
        "rjgit-org_security_sync-mfa-secure-users-to-group_scheduled": {
            "Parameter": {
                "ExcludeGroupId": {
                    "DefaultValue": "00000000-0000-0000-0000-000000000000",
                    "Hide": true
                },
                "ExcludeUserIds": {
                    "DefaultValue": [
                        "11111111-1111-1111-1111-111111111111",
                        "breakglass@contoso.com"
                    ],
                    "Hide": true
                }
            }
        }
    }
}
```

* **ExcludeGroupId** nimmt eine einzelne Gruppen- **Objekt-ID** (GUID) als einfachen String — kopiere sie von der Übersichtsseite der Gruppe im Entra admin center oder im RealmJoin-Portal.
* **ExcludeUserIds** nimmt ein JSON **Array von Strings**; jeder Eintrag kann ein Benutzer **Objekt-ID** oder ein **UPN**sein. Einträge werden getrimmt und dedupliziert; das Runbook löst sie beim Start auf.
* **Empfohlen:** wenn die Ausschlüsse über Runbook Customization verwaltet werden, setze auch `"Hide": true` am Parameter (wie im obigen Beispiel). Dadurch wird er vollständig aus dem Startformular entfernt, sodass die zentral konfigurierten Ausschlüsse beim Starten oder Planen des Runbooks in der UI nicht überschrieben werden können. Ohne `Hide`, erscheinen die konfigurierten Werte nur vorausgefüllt und können dort weiterhin geändert werden.

### Referenz zur Methodenklassifizierung

Verwende beim Erstellen der durch Kommas getrennten Override-Strings die exakten Graph-Werte aus dieser Tabelle:

| `methodsRegistered` Wert             | Anzeigename                                             | Klassifizierung | Von Schalter abgedeckt (Standard)               |
| ------------------------------------ | ------------------------------------------------------- | --------------- | ----------------------------------------------- |
| `fido2SecurityKey`                   | FIDO2-Sicherheitsschlüssel                              | Sicher          | Passkeys / FIDO2 (ein)                          |
| `passKeyDeviceBound`                 | Passkey (gerätegebunden)                                | Sicher          | Passkeys / FIDO2 (ein)                          |
| `passKeyDeviceBoundAuthenticator`    | Passkey in Microsoft Authenticator                      | Sicher          | Passkeys / FIDO2 (ein)                          |
| `windowsHelloForBusiness`            | Windows Hello for Business                              | Sicher          | Plattformanmeldedaten (ein)                     |
| `passKeyDeviceBoundWindowsHello`     | Passkey in Windows Hello                                | Sicher          | Plattformanmeldedaten (ein)                     |
| `macOsSecureEnclaveKey`              | Plattformanmeldedaten für macOS                         | Sicher          | Plattformanmeldedaten (ein)                     |
| `microsoftAuthenticatorPush`         | Microsoft Authenticator (Push-Benachrichtigung)         | Sicher          | Microsoft Authenticator-App (ein)               |
| `microsoftAuthenticatorPasswordless` | Microsoft Authenticator (kennwortlose Telefonanmeldung) | Sicher          | Microsoft Authenticator-App (ein)               |
| `softwareOneTimePasscode`            | Software-OATH-Token (TOTP-App)                          | Sicher          | Software-OTP (aus)                              |
| `hardwareOneTimePasscode`            | Hardware-OATH-Token                                     | Sicher          | Hardware-OTP (aus)                              |
| `certificateBasedAuthentication`     | Zertifikatbasierte Authentifizierung                    | Sicher          | Zertifikatbasierte Authentifizierung (ein)      |
| `mobilePhone`                        | Telefon (SMS / Sprachanruf)                             | Unsicher        | integrierte unsichere Liste                     |
| `alternateMobilePhone`               | Alternatives Telefon (Sprachanruf)                      | Unsicher        | integrierte unsichere Liste                     |
| `officePhone`                        | Office-Telefon (Sprachanruf)                            | Unsicher        | integrierte unsichere Liste                     |
| `email`                              | E-Mail (nur SSPR)                                       | Unsicher        | integrierte unsichere Liste                     |
| `securityQuestion`                   | Sicherheitsfragen (nur SSPR)                            | Unsicher        | integrierte unsichere Liste                     |
| `temporaryAccessPass`                | Temporary Access Pass                                   | Neutral         | qualifiziert sich nie, disqualifiziert sich nie |

Unbekannte oder zukünftige Graph-Werte werden als neutral behandelt, sofern sie nicht ausdrücklich in einem Override-Parameter aufgeführt sind.

### Override-Parameter

Beide Override-Parameter sind standardmäßig ausgeblendet und für die Runbook-Customization von RealmJoin gedacht:

* **SecureMethodsOverride** — kommagetrennte Liste von `methodsRegistered` Werten, die die sichere Menge definieren. Wenn gesetzt, **alle** werden Methoden-Gruppenschalter ignoriert. Beispiel: `fido2SecurityKey,passKeyDeviceBound,passKeyDeviceBoundAuthenticator,windowsHelloForBusiness`
* **UnsecureMethodsOverride** — kommagetrennte Liste, die die integrierte unsichere Liste ersetzt. Wird nur im strengen Modus ausgewertet. Beispiel: `mobilePhone,alternateMobilePhone,officePhone,email,securityQuestion,softwareOneTimePasscode`

Unbekannte Werte erzeugen eine Warnung, werden aber trotzdem ausgewertet, sodass zukünftige Graph-Werte verwendet werden können, bevor diese Dokumentation nachgezogen ist.

### Ausgabedaten

Jeder Lauf schreibt seine Ergebnisse in die Registerkarte Output Data des RealmJoin-Portals, von wo aus jede Tabelle nach Excel exportiert werden kann:

* *Zusammenfassung* - die gewählte Konfiguration und die Ergebniszähler: Berichtseinträge, ausgewertete Mitgliedsbenutzer, qualifizierende Benutzer, vorherige Mitglieder sowie die hinzugefügten und entfernten Benutzer (im Probelaufmodus die Benutzer, die hinzugefügt oder entfernt würden; fehlgeschlagene Hinzufügungen und Entfernungen werden separat aufgeführt). Ein Benutzer, der bereits Mitglied war, zählt als hinzugefügt, einer, der bereits weg war, als entfernt.
* *Änderungen* - jeder Benutzer, der zur Gruppe hinzugefügt oder daraus entfernt wird (im Probelaufmodus die ausstehenden Änderungen) mit den methodenspezifischen Details pro Benutzer

*Änderungen* hat dieselben Zeilen und Spalten wie die Berichtsdatei und das gleichnamige Arbeitsblatt. Ein Lauf ohne Änderungen zeigt eine Statuszeile anstelle der *Änderungen* Tabelle. Die Auswertung jedes Mitgliedsbenutzers steht nur in den Berichtsdateien (*Alle Benutzer*): Eine Zeile pro Benutzer in jedem Lauf würde die Job-Ausgabe großer Tenants zu groß machen.

### Berichtsübermittlung

Die **Berichtsübermittlung** Die Option im Run-Dialog entscheidet, ob der Bericht auch als Dateien zugestellt wird – besonders nützlich, um den allerersten Lauf zu prüfen (idealerweise kombiniert mit dem Probelaufmodus):

* *Nur Output Data* (Standard): keine Berichtdateien, keine E-Mail.
* *Den Bericht zusätzlich per E-Mail senden*: sendet den Bericht an die E-Mail-Adresse(n) des Empfängers, die dann ein Pflichtfeld sind. Erfordert die `RJReport.EmailSender` Tenant-Einstellung (siehe die [RealmJoin Report Settings-Dokumentation](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings)).
* *Erstelle außerdem einen Downloadlink*: lädt die Berichtsdateien in einen Azure Storage Account hoch und gibt zeitlich begrenzte Download-Links zurück (verwendet die `RJReport.StorageAccount.*` Tenant-Einstellungen).
* *Den Bericht zusätzlich per E-Mail und Downloadlink senden*: beides.

Mit einer E-Mail oder einem Downloadlink **Format der Berichtdatei** wählt CSV-Dateien, die Excel-Arbeitsmappe oder beides aus. Die Option setzt die versteckten Parameter `SendEmail` und `CreateDownloadLink`; geplante Ausführungen und API-Aufrufe, die diese Parameter direkt übergeben, funktionieren weiterhin wie bisher.

Planungen, die vor dem **Berichtsübermittlung** Option existierte, behalten ihre Zustellung. Wenn eine solche Planung zum Bearbeiten geöffnet wird, zeigt die Option *Nur Output Data* obwohl der gespeicherte E-Mail- oder Downloadlink aktiv bleibt; wähle die Zustellung vor dem Speichern erneut aus, damit der Dialog dem entspricht, was die Planung macht.

Berichtsdateien werden nur erzeugt, wenn E-Mail oder ein Downloadlink ausgewählt ist. Der Bericht besteht aus:

* **mfa-secure-users-group-sync-changes.csv** - alle durchgeführten (oder, im Probelauf, ausstehenden) Änderungen mit methodenspezifischen Details pro Benutzer
* **mfa-secure-users-group-sync-all-users.csv** - die Auswertung jedes Mitgliedsbenutzers: registrierte Methoden, sichere/unsichere Klassifizierung, Qualifizierung, Ausschlussgrund und Gruppenmitgliedschaft
* **mfa-secure-users-group-sync-report.xlsx** - dieselben Daten als formatiertes Excel-Arbeitsbuch: ein "Info"-Titelblatt mit den gewählten Parametern und Ergebniszählern, ein "Changes"-Arbeitsblatt (hinzugefügte Benutzer grün hervorgehoben, entfernte rot) und ein "All Users"-Arbeitsblatt

In großen Tenants können die rohen CSV-Dateien das Größenlimit für E-Mail-Anhänge überschreiten (Graph lehnt Mails bei insgesamt etwa 4 MB ab). Wenn die CSV-Dateien ein Budget von 2,5 MB überschreiten, wird die E-Mail nur mit der Excel-Arbeitsmappe als Anhang gesendet (die die vollständigen Daten in komprimierter Form enthält) und mit einem Hinweis auf die Auslassung; ein fehlgeschlagener Vollgrößenversand wird ebenfalls automatisch nur mit der Arbeitsmappe erneut versucht. Das Hochladen über den Downloadlink umfasst immer alle Dateien, unabhängig von der Größe.

#### E-Mail-Branding

Die Berichts-E-Mail berücksichtigt die optionalen `RJReport.Branding.*` Tenant-Einstellungen:

* **Header- und Footer-Bild** – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. jeweils 200 KB
* **Footer-Link** – Ziel des Footer-Bildes
* **Akzent- und Textfarbe** – 6-stellige Hex-Werte, z. B. `#0052cc`

Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert die Berichts-E-Mail niemals – stattdessen wird der entsprechende Standard verwendet.

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

### Hinweise und Einschränkungen

* Der Registrierungsbericht erfordert eine **Entra ID P1- oder P2** Lizenz.
* PIM-berechtigte Rollenzuweisungen (Admin-Ausschluss) erfordern eine **Entra ID P2** Lizenz — ohne sie werden nur aktive Rollenzuweisungen ausgeschlossen.
* Wenn das Lesen einer Liste fehlschlägt (Registrierungsbericht, Rollenzuweisungen, Mitglieder einer rollenzuweisbaren Gruppe oder der Ausschlussgruppe, aktuelle Mitglieder der Zielgruppe), schlägt der Auftrag fehl, bevor die Gruppe geändert wird, sodass ein Sync nie mit unvollständigen Daten läuft.
* Der Bericht enthält keine **deaktivierten** oder softgelöschten Benutzer — solche Konten werden beim nächsten Lauf aus der Gruppe entfernt.
* Berichtsdaten können hinter aktuellen Registrierungsänderungen zurückbleiben; bis eine neu registrierte Methode im nächsten Sync-Zyklus sichtbar wird, kann es einen Sync-Zyklus dauern.
* Das Runbook verarbeitet große Tenants (20k+ Benutzer) über seitenweise Berichtsläufe und gruppierte Gruppen-Schreibvorgänge mit automatischen Drosselungs-Wiederholungen.

### Zeitplanung

Der Sync ist idempotent — eine einzelne wiederkehrende Planung (z. B. täglich) hält die Gruppe auf dem neuesten Stand, und Wiederholungen nach teilweisen Fehlern heilen sich selbst. Empfehlung: einmal ausführen mit **Probelauf (WhatIf)** aktiviert und die Job-Ausgabe prüfen, bevor das Runbook im Live-Modus geplant wird.

### Ort

Organisation → Sicherheit → MFA-Sichere Benutzer mit Gruppe synchronisieren (geplant)

**Vollständiger Runbook-Name**

rjgit-org\_security\_sync-MFA-secure-users-to-group\_scheduled

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * AuditLog.Read.All
    * *Liest userRegistrationDetails, um die registrierten MFA-Methoden jedes Benutzers zu bewerten*
  * Group.Read.All
    * *Liest die Ziel- und Ausschlussgruppen und deren transitive Benutzer-Mitglieder*
  * GroupMember.ReadWrite.All
    * *Fügt Benutzer in der Zielgruppe hinzu und entfernt sie daraus über gebündelte /groups/{id}/members/$ref-Aufrufe*
  * Organization.Read.All
    * *Liest /organization für den Tenant-Namen auf dem Berichts-Titelblatt und in der E-Mail*
  * RoleManagement.Read.Directory
    * *Liest Rollenzuweisungen und Berechtigungspläne, um Admin-Benutzer auszuschließen, wenn ExcludeAdmins aktiviert ist*
  * User.Read.All
    * *Löst Admin-Rollen-Principals und ExcludeUserIds-Einträge in Benutzerobjekte auf*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Sendet die Bericht-E-Mail über Send-RjRbReportEmail, wenn die E-Mail-Berichterstellung aktiviert ist*

### Parameter

#### TargetGroupId

Gruppe, deren Mitglieder von diesem Runbook verwaltet werden. Mitglieder, die sich nicht mehr qualifizieren, werden entfernt.

| Eigenschaft           | Wert         |
| --------------------- | ------------ |
| Erforderlich          | wahr         |
| Standardwert          |              |
| Typ                   | Zeichenfolge |
| Anzeigename im Portal | Zielgruppe   |

#### IncludePasskeys

Passkeys und FIDO2 Security Key, die phishing-resistent sind, zählen als sicher.

| Eigenschaft           | Wert                                               |
| --------------------- | -------------------------------------------------- |
| Erforderlich          | falsch                                             |
| Standardwert          | Wahr                                               |
| Typ                   | Boolesch                                           |
| Anzeigename im Portal | Zählen Passkeys und FIDO2 Security Key als sicher? |

#### IncludePlatformCredentials

Windows Hello for Business und macOS-Plattformanmeldedaten zählen als sicher.

| Eigenschaft           | Wert                                     |
| --------------------- | ---------------------------------------- |
| Erforderlich          | falsch                                   |
| Standardwert          | Wahr                                     |
| Typ                   | Boolesch                                 |
| Anzeigename im Portal | Zählen Plattformanmeldedaten als sicher? |

#### IncludeMicrosoftAuthenticator

Die Microsoft Authenticator-App mit Push- oder kennwortloser Anmeldung zählt als sicher.

| Eigenschaft           | Wert                                      |
| --------------------- | ----------------------------------------- |
| Erforderlich          | falsch                                    |
| Standardwert          | Wahr                                      |
| Typ                   | Boolesch                                  |
| Anzeigename im Portal | Zählt Microsoft Authenticator als sicher? |

#### IncludeSoftwareOtp

Zeitbasierte Einmalkodes aus Authenticator-Apps zählen als sicher.

| Eigenschaft           | Wert                           |
| --------------------- | ------------------------------ |
| Erforderlich          | falsch                         |
| Standardwert          | Falsch                         |
| Typ                   | Boolesch                       |
| Anzeigename im Portal | Zählt Software-OTP als sicher? |

#### IncludeHardwareOtp

Hardware-Einmalpasswort-Token zählen als sicher.

| Eigenschaft           | Wert                                  |
| --------------------- | ------------------------------------- |
| Erforderlich          | falsch                                |
| Standardwert          | Falsch                                |
| Typ                   | Boolesch                              |
| Anzeigename im Portal | Zählen Hardware-OTP-Token als sicher? |

#### IncludeCertificateBasedAuth

Die Anmeldung mit einem Zertifikat, zum Beispiel von einer Smartcard, zählt als sicher.

| Eigenschaft           | Wert                                                   |
| --------------------- | ------------------------------------------------------ |
| Erforderlich          | falsch                                                 |
| Standardwert          | Wahr                                                   |
| Typ                   | Boolesch                                               |
| Anzeigename im Portal | Zählt zertifikatbasierte Authentifizierung als sicher? |

#### SecureOnly

Strenger Modus: Benutzer, die zusätzlich eine Telefon-, E-Mail- oder Sicherheitsfragen-Methode registriert haben, qualifizieren sich niemals, selbst mit einer sicheren Methode.

| Eigenschaft           | Wert            |
| --------------------- | --------------- |
| Erforderlich          | falsch          |
| Standardwert          | Falsch          |
| Typ                   | Boolesch        |
| Anzeigename im Portal | Strenger Modus? |

#### SecureMethodsOverride

Benutzerdefinierte Liste von Methodennamen, die als sicher zählen, getrennt durch Kommas. Wenn gesetzt, werden die einzelnen Methodenschalter ignoriert. Im Runbook-Customization vorgegeben; die Methodennamen sind in der Runbook-Dokumentation aufgeführt.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Benutzerdefinierte sichere Methoden          |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### UnsecureMethodsOverride

Benutzerdefinierte Liste von Methodennamen, die im strengen Modus als unsicher zählen, getrennt durch Kommas. Im Runbook-Customization vorgegeben.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           |                                              |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Benutzerdefinierte unsichere Methoden        |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### ExcludeAdmins

Benutzer mit einer Entra ID-Verzeichnisrolle, aktiv oder berechtigt, qualifizieren sich niemals und werden aus der Gruppe entfernt. Nützlich, wenn die Gruppe Self-Service-Kennwortzurücksetzen steuert.

| Eigenschaft           | Wert                          |
| --------------------- | ----------------------------- |
| Erforderlich          | falsch                        |
| Standardwert          | Wahr                          |
| Typ                   | Boolesch                      |
| Anzeigename im Portal | Administratoren ausschließen? |

#### ExcludeGroupId

Mitglieder dieser Gruppe, z. B. Break-Glass- oder Dienstkonten, qualifizieren sich niemals und werden aus der Zielgruppe entfernt. Leer lassen, wenn keine.

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

#### ExcludeUserIds

Benutzer, die sich niemals qualifizieren und aus der Zielgruppe entfernt werden. Es können mehrere ausgewählt werden.

| Eigenschaft           | Wert                     |
| --------------------- | ------------------------ |
| Erforderlich          | falsch                   |
| Standardwert          | @()                      |
| Typ                   | String\[]                |
| Anzeigename im Portal | Ausgeschlossene Benutzer |

#### WhatIfMode

Protokolliert nur, welche Benutzer hinzugefügt oder entfernt würden, ohne die Gruppe zu ändern.

| Eigenschaft           | Wert       |
| --------------------- | ---------- |
| Erforderlich          | falsch     |
| Standardwert          | Falsch     |
| Typ                   | Boolesch   |
| Anzeigename im Portal | Probelauf? |

#### SendEmail

Sendet den Bericht an die E-Mail-Adresse des Empfängers. Wird durch die Option "Report delivery" im Portal festgelegt.

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

#### EmailTo

Senden Sie den Bericht an diese Adressen. Mehrere mit Kommas trennen; 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 (vordefiniert über die Runbook-Anpassung) |

#### EmailFrom

Absenderadresse der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.EmailSender übernommen.

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

#### BrandingHeaderImageUrl

Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.HeaderImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Header verwendet.

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

#### BrandingFooterImageUrl

Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Tenant-Einstellung RJReport.Branding.FooterImageUrl übernommen; wenn leer, wird der standardmäßige RealmJoin-Footer verwendet.

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

#### BrandingFooterLink

Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Tenant-Einstellung RJReport.Branding.FooterLink übernommen; wenn leer, wird realmjoin.com verwendet.

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

#### BrandingAccentColor

Akzentfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.AccentColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### BrandingTextColor

Textfarbe der Berichts-E-Mail als 6-stelliger Hex-Wert. Wird aus der Tenant-Einstellung RJReport.Branding.TextColor übernommen; wenn leer oder ungültig, wird der RealmJoin-Standard verwendet.

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

#### ReportFileFormat

Stellt den Bericht als CSV, als Excel-Arbeitsmappe oder beides bereit.

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | CSV & XLSX                                   |
| Typ                    | Zeichenfolge                                 |
| Anzeigename im Portal  | Format der Berichtdatei                      |
| Im Portal ausgeblendet | ja (vordefiniert ü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. Wird durch die Option "Report delivery" im Portal festgelegt.

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

#### ContainerName

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

| Eigenschaft            | Wert                                         |
| ---------------------- | -------------------------------------------- |
| Erforderlich           | falsch                                       |
| Standardwert           | sync-mfa-secure-users-to-group               |
| Typ                    | Zeichenfolge                                 |
| Im Portal ausgeblendet | ja (vordefiniert über die Runbook-Anpassung) |

#### ResourceGroupName

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

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

#### StorageAccountName

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

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

#### SubscriptionId

Abonnement-ID des Storage Account für Bericht-Uploads. Wird aus der Tenant-Einstellung RJReport.StorageAccount.SubscriptionId übernommen; wenn leer, wird das Abonnement verwendet, bei dem sich die verwaltete Identität anmeldet.

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

#### LinkExpiryDays

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

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

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/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/org/security/sync-mfa-secure-users-to-group_scheduled.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.
