Anmelden mit einem Alias oder Benutzernamen

Gilt für: Externe Mandanten (weitere Informationen)

Sie können Benutzern, die sich mit einer E-Mail-Adresse und einem Kennwort anmelden, auch erlauben, sich mit einem Benutzernamen und Kennwort anzumelden. Ein Benutzername, auch als alternativer Anmeldebezeichner bezeichnet, kann eine Kunden-ID, Kontonummer oder ein anderer bezeichner sein, den Sie auswählen.

Voraussetzungen

• Falls Sie Ihren eigenen externen Microsoft Entra-Mandanten noch nicht erstellt haben, erstellen Sie ihn jetzt.
• Registrieren sie eine App.
• Erstellen Sie einen Benutzerablauf.
• Fügen Sie Ihre Anwendung zum Benutzerflow hinzu.

Benutzername in der Anmeldebezeichnerrichtlinie aktivieren

Um den Benutzernamen als Anmeldebezeichner zu aktivieren, aktivieren Sie zuerst die Anmelde-ID-Richtlinie im Microsoft Entra Admin Center. UserPrincipalName (UPN) und E-Mail-Adresse sind standardmäßig ausgewählt. Sobald der Benutzername ebenfalls aktiviert ist, können sich Benutzer, denen ein Benutzername zugewiesen wurde, entweder über ihre E-Mail-Adresse oder ihren Benutzernamen anmelden.

1. Melden Sie sich beim Microsoft Entra Admin Center mindestens mit der Rolle Authentifizierungsrichtlinienadministrator an.

2. Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Einstellungen-Symbol im oberen Menü, um über das Menü Verzeichnisse + Abonnements zu Ihrem externen Mandanten zu wechseln.

3. Navigieren Sie zu Anmeldekennungen entweder über Entra ID>Externe Identitäten oder über Entra ID>Authentifizierungsmethoden.

4. Aktivieren Sie auf der Anmeldebezeichnerseiteden Benutzernamen als Anmeldebezeichner, indem Sie "Default regex" auswählen, das eine beliebige Zeichenfolge akzeptiert oder bis zu zwei benutzerdefinierte Muster für reguläre Ausdrücke für eine strengere Überprüfung angibt. Wenn ein Muster übereinstimmt, gilt der Benutzername als gültig. Beachten Sie, dass es keine integrierte Überprüfung für benutzerdefinierte reguläre Ausdrücke gibt, abgesehen davon, dass sie nicht mit dem Format einer E-Mail-Adresse übereinstimmen. Die Authentifizierung kann zur Laufzeit fehlschlagen, wenn der bereitgestellte Wert nicht mit dem regex übereinstimmt oder wenn der regex selbst ungültig ist.

   

5. Wählen Sie im oberen Bereich der Seite Speichern aus.

Erstellen und Aktualisieren von Benutzern mit Benutzername

Nachdem Sie den Benutzernamen als Anmeldebezeichner aktiviert haben, können Sie neue Benutzer mit E-Mail-Adresse und Benutzername als Anmelde-IDs erstellen. Sie können auch vorhandene Benutzer aktualisieren, um einen Benutzernamen hinzuzufügen. Dazu können Sie entweder das Microsoft Entra Admin Center oder die Microsoft Graph-API verwenden.

POST https://graph.microsoft.com/v1.0/users
Content-type: application/json
{
    "displayName": "Test User",
    "identities": [
        {
            "signInType": "emailAddress",
            "issuer": "contoso.onmicrosoft.com",
            "issuerAssignedId": "dylan@woodgrovebank.com"
        },
        {
            "signInType": "username",
            "issuer": "contoso.onmicrosoft.com",
            "issuerAssignedId": "dylan123"
        }
    ],
    "mail": "dylan@woodgrovebank.com",
    "passwordProfile": {
        "password": "passwordValue",
        "forceChangePasswordNextSignIn": false
    },
    "passwordPolicies": "DisablePasswordExpiration"
}

GET https://graph.microsoft.com/v1.0/users?$select=displayName,id,identities&$filter=identities/any(c:c/issuerAssignedId eq 'dylan@woodgrovebank.com' and c/issuer eq 'contoso.onmicrosoft.com')

HTTP/1.1 200 OK
Content-type: application/json
 
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users(displayName,id,identities)",
    "value": [
        {
            "displayName": "ciam test 1",
            "id": "0daaf9dd-3583-4cd4-8934-a2ffd0490287",
            "identities": [
                {
                    "signInType": "userPrincipalName",
                    "issuer": "contoso.onmicrosoft.com",
                    "issuerAssignedId": "0daaf9dd-3583-4cd4-8934-a2ffd0490287@contoso.onmicrosoft.com"
                },
                {
                    "signInType": "emailAddress",
                    "issuer": "contoso.onmicrosoft.com",
                    "issuerAssignedId": "dylan@woodgrovebank.com"
                }
            ]
        }
    ]
}

POST https://graph.microsoft.com/v1.0/users/00aa00aa-bb11-cc22-dd33-44ee44ee44ee
Content-type: application/json 
{
            "identities": [
                {
                    "signInType": "userPrincipalName",
                    "issuer": "contoso.onmicrosoft.com",
                    "issuerAssignedId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee@contoso.onmicrosoft.com"
                },
                {
                    "signInType": "emailAddress",
                    "issuer": "contoso.onmicrosoft.com",
                    "issuerAssignedId": "dylan@woodgrovebank.com"
                },
                {
                    "signInType": "userName",
                    "issuer": "contoso.onmicrosoft.com",
                    "issuerAssignedId": "dylan1234"
                }
            ]
}

Registrieren mit einem Alias oder Benutzernamen (Vorschau)

Sie können es Benutzern ermöglichen, sich zusätzlich zu ihrer E-Mail-Adresse in der externen Microsoft Entra-ID mit einem Benutzernamen oder Alias anzumelden. Während der Registrierung erfassen Sie den Benutzernamen des Benutzers. Der Benutzername muss für den gesamten Mandanten eindeutig sein. Führen Sie die folgenden Schritte aus, um den Benutzerablauf so zu konfigurieren, dass ein Benutzername erfasst wird.

Schritt 1: Hinzufügen des Benutzernamen-Attributs zu Ihrem Benutzerablauf

1. Melden Sie sich beim Microsoft Entra Admin Center mindestens mit der Rolle Authentifizierungsrichtlinienadministrator an.

2. Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Einstellungen-Symbol im oberen Menü, um über das Menü Verzeichnisse + Abonnements zu Ihrem externen Mandanten zu wechseln.

3. Wechseln Sie in Ihrem externen Mandanten zu Entra ID>Externe Identitäten>Benutzer Flows.

4. Wählen Sie den Benutzerfluss aus, den Sie in den Voraussetzungen erstellt haben.

5. Wählen Sie unter "Einstellungen" die Option "Benutzerattribute" aus.

6. Wählen Sie das Attribut "Benutzername" aus.

7. Wählen Sie "Speichern" aus, um dem Benutzerablauf das Attribut hinzuzufügen.

   

Schritt 2: (Optional) Ändern der Bezeichnung des Benutzernamenfelds

Sie können die Bezeichnung des Benutzernamenfelds ändern, das auf der Anmeldeseite angezeigt wird.

1. Wechseln Sie in Ihrem externen Mandanten zu Entra ID>Externe Identitäten>Benutzer Flows.

2. Wechseln Sie zum Seitenlayout.

3. Suchen Sie das Username-Attribut , und bearbeiten Sie die Bezeichnung. Sie können es beispielsweise in "Alias" oder "Benutzer-ID" ändern.

4. Wählen Sie Speichern aus.

   

Schritt 3: (Optional) Festlegen einer benutzerdefinierten Gültigkeitsprüfungs-Regex für Benutzernamen mit der Microsoft Graph-API

Sie können einen benutzerdefinierten regulären Ausdruck für die Eingabeüberprüfung festlegen, indem Sie das validationRegEx Attribut für den Benutzernamen konfigurieren. Diese Einstellung ist derzeit nicht in der Admin Center-Benutzeroberfläche verfügbar, Sie können sie jedoch mit Microsoft Graph konfigurieren. Zum Festlegen dieses Werts verwenden Sie den Ressourcentyp authenticationAttributeCollectionInputConfiguration. Als Referenz finden Sie das Beispiel Aktualisierung des Seitenlayouts eines Self-Service Sign-Up Benutzer Flows.

Beachten Sie, dass es keine integrierte Überprüfung für benutzerdefinierte reguläre Ausdrücke gibt, abgesehen davon, dass sie nicht mit dem Format einer E-Mail-Adresse übereinstimmen. Die Überprüfung kann zur Laufzeit fehlschlagen, wenn der angegebene Wert nicht mit dem regex übereinstimmt oder wenn der regex selbst ungültig ist.

Wenn Sie außerdem einen benutzerdefinierten regulären Ausdruck sowohl für die Überprüfung des Registrierungsattributs (dieser Schritt) als auch für die Richtlinie des Anmeldebezeichners konfigurieren, müssen diese zueinander kompatibel sein, da die Authentifizierung ansonsten fehlschlägt. Wenn beispielsweise ein Benutzername, der die Anmeldeüberprüfung besteht, nicht mit der Richtlinie des Anmeldebezeichners übereinstimmt, führt der reguläre Ausdruck zu einem Laufzeitfehler bei der Authentifizierung.

Vorfüllen oder Zuweisen von Benutzernamen (Vorschau)

Ebenso wie andere Attribute können Sie die Anmeldung anpassen, indem Sie den Benutzernamen vorab ausfüllen oder nach dem Erfassen weiterer Benutzerinformationen zuweisen. Verwenden Sie zum Vorfüllen des Werts eine benutzerdefinierte Erweiterung mit dem onAttributeCollectionStart-Ereignis , und konfigurieren Sie, wie sie über das Seitenlayout oder über Microsoft Graph dargestellt wird. Wenn Sie den Benutzernamen nach dem Sammeln weiterer Details zuweisen, ändern oder überprüfen müssen, verwenden Sie das onAttributeCollectionSubmit-Ereignis .

Testen der Anmeldung mit dem Alias oder Benutzernamen

Sie können die Registrierung und Anmeldung mit der E-Mail-Adresse und dem Benutzernamen testen, die Sie dem Benutzer zugewiesen haben, den Sie mit dem Feature " Benutzerablauf ausführen " erstellt haben. Wenn Sie sich mit einer E-Mail-Adresse anmelden, wird die E-Mail-Adresse im preferred_username Anspruch angezeigt. Wenn Sie sich mit dem Benutzernamen anmelden, wird der Benutzername im preferred_username Claim angezeigt.

Anpassen der Anmeldeseite (optional)

Sie können die Anmeldeseite anpassen, um Ihren Benutzern eine bessere Benutzererfahrung zu bieten. Sie können den Hinweistext des Bezeichnerfelds auf der Anmeldeseite anpassen und andere Zeichenfolgen im Zusammenhang mit dem Benutzernamen lokalisieren.

Anpassen des Hinweistexts des Identifikatorfelds auf der Anmeldeseite

Sie können den Hinweistext des Bezeichnerfelds auf der Anmeldeseite für alle Apps über benutzerdefiniertes Branding anpassen.

1. Melden Sie sich im Microsoft Entra Admin Center als mindestens ein Organisations-Branding-Administrator an.

2. Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Symbol "Einstellungen" im oberen Menü, um zu dem externen Mandanten zu wechseln, den Sie zuvor im Menü "Verzeichnisse + Abonnements " erstellt haben.

3. Navigieren Sie zum Unternehmensbranding entweder mithilfe der Suchleiste oder navigieren Sie zu Entra ID>Custom Branding.

4. Wählen Sie "Bearbeiten" aus, um das Branding zu ändern.

5. Auf der Registerkarte " Anmeldeformular " können Sie den Hinweistext des Bezeichnerfelds auf der Anmeldeseite anpassen. Sie können sie z. B. in E-Mail-Adresse oder Mitglieds-ID ändern.

   

6. Wählen Sie "Überprüfen" und "Speichern" aus, um Ihre Änderungen zu speichern.

Anpassen und Lokalisieren anderer Zeichenfolgen im Zusammenhang mit Benutzername

Sie können andere Zeichenfolgen im Zusammenhang mit der Anmeldung eines Endbenutzers mit einem Benutzernamen anpassen und lokalisieren, indem Sie eine Sprachdatei hochladen. Weitere Informationen finden Sie unter Hinzufügen von Sprachanpassungen zu einem Benutzerablauf.

Verwandte Inhalte

• Sie können die Benutzer-API verwenden, um Benutzer mit E-Mail-Adresse und Benutzername mit Microsoft Graph zu erstellen.