> 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/set-or-remove-mobile-phone-mfa.md).

# Mobiltelefon-MFA festlegen oder entfernen

Die Mobiltelefon-MFA-Methode dieses Benutzers festlegen oder entfernen

### Beschreibung

Fügt das Mobiltelefon dieses Benutzers als MFA-Methode für Anrufe und Textnachrichten hinzu oder aktualisiert es, oder entfernt es. Optional erhält der Benutzer eine E-Mail über die Änderung. Wenn der Mandant SMS-Anmeldung zulässt, versucht Microsoft außerdem, die Nummer dafür zu registrieren. Eine bereits von jemand anderem verwendete Nummer führt dann zu einer Warnung; die MFA-Methode wird in der Regel trotzdem gesetzt, und das Runbook prüft und meldet den tatsächlichen Zustand. Details zu diesem Konflikt finden sich in der Runbook-Dokumentation (docs.realmjoin.com).

### Benutzerbenachrichtigung aktivieren

Dieses Runbook kann optional eine Benachrichtigungs-E-Mail an den Zielbenutzer senden, die ihn darüber informiert, dass seine MFA-Methode für das Mobiltelefon von einem Administrator hinzugefügt, aktualisiert oder entfernt wurde. Um dies zu aktivieren, müssen Sie die Benutzerbenachrichtigung in der Runbook-Anpassung aktivieren.

Die JSON-Konfiguration dafür lautet wie folgt:

```json
"rjgit-user_security_set-or-remove-mobile-phone-mfa": {
    "parameters": {
        "UserId": {
            "Hide": true
        },
        "NotifyUser": {
            "Default": true,
            "Hide": true
        },
        "EmailFrom": {
            "Hide": true
        },
        "ServiceDeskDisplayName": {
            "Hide": true
        },
        "ServiceDeskEmail": {
            "Hide": true
        },
        "ServiceDeskPhone": {
            "Hide": true
        },
        "ServiceDeskPortalUrl": {
            "Hide": true
        },
        "ServiceDeskTicketUrl": {
            "Hide": true
        },
        "LanguageOverride": {
            "Hide": true
        },
        "CallerName": {
            "Hide": true
        }
    }
}
```

Weitere Informationen zur Anpassung von Runbooks finden Sie im [Runbook-Anpassungsleitfaden](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

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

Das Senden einer Benachrichtigungs-E-Mail ist optional und erfolgt nur, wenn `NotifyUser` aktiviert ist. 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).

### Konflikte bei der SMS-Anmeldung

Die Microsoft Graph-API für Telefonmethoden bietet keine Möglichkeit, eine Telefonnummer als reine MFA-Methode hinzuzufügen, ohne dass Microsoft gleichzeitig versucht, sie für die SMS-Anmeldung zu registrieren. Wenn der Benutzer durch die Richtlinie für Authentifizierungsmethoden des Mandanten für die SMS-Anmeldung aktiviert ist, versucht Graph diese Registrierung unmittelbar nachdem die Telefonmethode erstellt oder aktualisiert wurde. Wenn ein anderer Benutzer die Nummer bereits für die SMS-Anmeldung verwendet, antwortet Graph mit einem `409 Conflict` und dem Fehlercode `phoneNumberNotUnique`, obwohl die Telefonmethode für die reguläre MFA in der Regel dennoch erstellt oder aktualisiert wird.

Das `smsSignInState` Eigenschaft ist schreibgeschützt und kann in der Erstellungs- oder Aktualisierungsanforderung nicht gesetzt werden; SMS-Anmeldung kann nur explizit über die separate `enableSmsSignIn` und `disableSmsSignIn` Endpunkte umgeschaltet werden. Das Runbook prüft daher nach einem solchen Fehler den tatsächlichen Zustand und meldet Erfolg mit einer Warnung, wenn die MFA-Methode zugewiesen wurde. Wenn die Zuweisung wirklich fehlgeschlagen ist, sucht es den Benutzer nach, der die Nummer besitzt, und nennt ihn in der Ausgabe.

### Speicherort

Benutzer → Sicherheit → Mobile Phone MFA festlegen oder entfernen

**Voller Runbook-Name**

rjgit-user\_security\_set-or-remove-mobile-phone-MFA

### Details

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

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * AuditLog.Read.All
    * *Fragt userRegistrationDetails ab, um herauszufinden, welcher Benutzer eine konfliktverursachende SMS-Anmeldenummer besitzt*
  * User.Read.All
    * *Ermittelt den Zielbenutzer und liest die Telefonmethoden anderer Benutzer stapelweise für Konfliktprüfungen aus*
  * UserAuthenticationMethod.ReadWrite.All
    * *Setzt, aktualisiert oder entfernt die Mobiltelefon-Authentifizierungsmethode des Benutzers*
  * Mail.Send *(optional — Funktion: E-Mail-Bericht)*
    * *Benachrichtigt den Benutzer per E-Mail, dass ein Administrator sein MFA-Telefon geändert hat, wenn NotifyUser aktiviert ist*
  * Organization.Read.All *(optional — Funktion: E-Mail-Benachrichtigung)*
    * *Liest den Tenant-Anzeigenamen für die Benachrichtigungs-E-Mail, wenn NotifyUser aktiviert ist*

### Parameter

#### Benutzer-ID

Objekt-ID 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) |

#### phoneNumber

Nummer im E.164-Format, z. B. +491701234567.

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

#### Entfernen

Hinzufügen oder Aktualisieren speichert die Nummer als MFA-Methode für Anrufe und Textnachrichten. Entfernen löscht sie.

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

**Portaloptionen**

| Portaloption                                               | Wert   |
| ---------------------------------------------------------- | ------ |
| Diese Nummer als MFA-Methode hinzufügen oder aktualisieren | falsch |
| Die MFA-Methode für das Mobiltelefon entfernen             | wahr   |

#### NotifyUser

Ob der Benutzer per E-Mail über die Änderung informiert wird. Voreingestellt in der Runbook-Anpassung.

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

#### EmailFrom

Absenderadresse der Benachrichtigungs-E-Mail. Aus der Tenant-Einstellung 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) |

#### ServiceDeskDisplayName

Im E-Mail-Text angezeigter Name des Service Desks. Aus der Tenant-Einstellung RJReport.ServiceDesk\_DisplayName übernommen.

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

#### ServiceDeskEmail

Im E-Mail-Text angezeigte E-Mail-Adresse des Service Desks. Aus der Tenant-Einstellung RJReport.ServiceDesk\_EMail übernommen.

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

#### ServiceDeskPhone

Im E-Mail-Text angezeigte Telefonnummer des Service Desks. Aus der Tenant-Einstellung RJReport.ServiceDesk\_Phone übernommen.

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

#### ServiceDeskPortalUrl

Im E-Mail-Text angezeigter Link zum Service-Desk-Portal. Aus der Tenant-Einstellung RJReport.ServiceDesk\_PortalUrl übernommen.

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

#### ServiceDeskTicketUrl

Im E-Mail-Text angezeigter Link zum Ticket für diese Anfrage. Pro Ausführung oder in der Runbook-Anpassung voreingestellt; leer bedeutet keinen Link.

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

#### LanguageOverride

Erzwingt die E-Mail-Sprache, DE oder EN. Leer übernimmt die Sprache aus dem Nutzungsort des Benutzers. Voreingestellt in der Runbook-Anpassung.

| Eigenschaft            | Wert                                            |
| ---------------------- | ----------------------------------------------- |
| Erforderlich           | falsch                                          |
| Standardwert           |                                                 |
| Typ                    | Zeichenfolge                                    |
| 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/set-or-remove-mobile-phone-mfa.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.