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 SMS hinzu oder aktualisiert es, oder entfernt es. Optional erhält der Benutzer eine E-Mail über die Änderung. Wenn der Tenant die SMS-Anmeldung zulässt, versucht Microsoft außerdem, die Nummer dafür zu registrieren. Eine Nummer, die bereits von jemand anderem verwendet wird, löst dann eine Warnung aus; die MFA-Methode wird in der Regel dennoch gesetzt, und das Runbook prüft und meldet den tatsächlichen Zustand. Details zu diesem Konflikt finden Sie in der Runbook-Dokumentation (docs.realmjoin.com).
Benutzerbenachrichtigung aktivieren
Dieses Runbook kann optional eine Benachrichtigungs-E-Mail an den Zielbenutzer senden und ihn darüber informieren, 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:
"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 dazu, wie Runbooks angepasst werden, finden Sie im Leitfaden zur Runbook-Anpassung.
Einrichtung 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 der RJReport.EmailSender Mandanten-Einstellung übernommen.
Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Runbook-Anpassung eine vorhandene E-Mail-Adresse konfigurieren.
Siehe die RealmJoin Report Settings Dokumentation für Details zu allen verfügbaren Einstellungen.
E-Mail-Branding
Die Berichts-E-Mail berücksichtigt die optionalen RJReport.Branding.* Mandanten-Einstellungen:
Header- und Footer-Bild – öffentliche HTTPS-URLs, PNG/JPEG/GIF, jeweils max. 200 KB
Footer-Link – Ziel des Footer-Bildes
Akzent- und Textfarbe – 6-stellige Hexwerte, 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 niemals die Berichts-E-Mail – stattdessen wird der entsprechende Standard verwendet.
Einrichtungsanweisungen und Bildanforderungen: E-Mail-Branding.
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 außerdem versucht, sie für die SMS-Anmeldung zu registrieren. Wenn der Benutzer durch die Authentifizierungsmethodenrichtlinie des Tenants für die SMS-Anmeldung aktiviert ist, versucht Graph diese Registrierung direkt 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 normale MFA in der Regel dennoch erstellt oder aktualisiert wird.
Das smsSignInState Die Eigenschaft ist schreibgeschützt und kann in der Erstellungs- oder Aktualisierungsanforderung nicht festgelegt werden; die SMS-Anmeldung kann nur explizit über die separate enableSmsSignIn und disableSmsSignIn Endpunkte. 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 tatsächlich fehlgeschlagen ist, sucht es den Benutzer, dem die Nummer gehört, und nennt ihn in der Ausgabe.
Ort
Benutzer → Sicherheit → Mobiltelefon-MFA festlegen oder entfernen
Vollständiger Runbook-Name
rjgit-user_security_set-or-remove-mobile-phone-MFA
Details
Version
2.3.0
Erforderliche Module
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
Planbar
nein
Berechtigungen
Anwendungsberechtigungen
Typ: Microsoft Graph
AuditLog.Read.All
Fragt userRegistrationDetails ab, um zu ermitteln, welcher Benutzer eine konfliktverursachende SMS-Anmeldenummer besitzt
User.Read.All
Löst den Zielbenutzer auf und liest die Telefonmethoden anderer Benutzer stapelweise für Konfliktprüfungen
UserAuthenticationMethod.ReadWrite.All
Setzt, aktualisiert oder entfernt die Mobiltelefon-Authentifizierungsmethode des Benutzers
Mail.Send (optional — Funktion: E-Mail-Bericht)
Sendet dem Benutzer eine 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 Anzeigenamen des Tenant für die Benachrichtigungs-E-Mail, wenn NotifyUser aktiviert ist
Parameter
Benutzer-ID
Objekt-ID des Benutzers, auf den das Runbook angewendet wird. Vom Portal anhand des ausgewählten Benutzers festgelegt.
Erforderlich
ja
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
phoneNumber
Nummer im E.164-Format, z. B. +491701234567.
Erforderlich
ja
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Mobiltelefonnummer
Entfernen
Bei Hinzufügen oder Aktualisieren wird die Nummer als MFA-Methode für Anrufe und SMS gespeichert. Entfernen löscht sie.
Erforderlich
nein
Standardwert
Falsch
Typ
Boolesch
Anzeigename im Portal
Aktion
Portaloptionen
Diese Nummer als MFA-Methode hinzufügen oder aktualisieren
nein
Die MFA-Methode für das Mobiltelefon entfernen
ja
NotifyUser
Ob der Benutzer per E-Mail über die Änderung informiert wird. In der Runbook-Anpassung voreingestellt.
Erforderlich
nein
Standardwert
Falsch
Typ
Boolesch
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
EmailFrom
Absenderadresse der Benachrichtigungs-E-Mail. Übernommen aus der Tenant-Einstellung RJReport.EmailSender.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingHeaderImageUrl
Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.HeaderImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Header verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingFooterImageUrl
Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.FooterImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Footer verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingFooterLink
Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.Branding.FooterLink übernommen; bei leerem Wert wird realmjoin.com verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingAccentColor
Akzentfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.AccentColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
BrandingTextColor
Textfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.TextColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ServiceDeskDisplayName
Im E-Mail angezeigter Name des Service Desks. Übernommen aus der Tenant-Einstellung RJReport.ServiceDesk_DisplayName.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ServiceDeskEmail
Im E-Mail angezeigte E-Mail-Adresse des Service Desks. Übernommen aus der Tenant-Einstellung RJReport.ServiceDesk_EMail.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ServiceDeskPhone
Im E-Mail angezeigte Telefonnummer des Service Desks. Übernommen aus der Tenant-Einstellung RJReport.ServiceDesk_Phone.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ServiceDeskPortalUrl
Im E-Mail angezeigter Link zum Service-Desk-Portal. Übernommen aus der Tenant-Einstellung RJReport.ServiceDesk_PortalUrl.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
ServiceDeskTicketUrl
Im E-Mail angezeigter Link zum Ticket für diese Anfrage. Pro Lauf oder in der Runbook-Anpassung voreingestellt; leer bedeutet keinen Link.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
LanguageOverride
Erzwingt die Sprache der E-Mail, DE oder EN. Leer übernimmt die Sprache aus dem Nutzungsort des Benutzers. Voreingestellt in der Runbook-Anpassung.
Erforderlich
nein
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorkonfiguriert über Runbook-Anpassung)
Zuletzt aktualisiert
War das hilfreich?