Sammeln von benutzerdefinierten Benutzerattributen während der Registrierung für die B2B-Zusammenarbeit

Gilt für: Grüner Kreis mit einem weißen Häkchensymbol, das angibt, dass der folgende Inhalt für Mitarbeiter(-)Mandanten gilt. Mitarbeiter(-)Mandanten (weitere Informationen)

Tipp

Dieser Artikel gilt für B2B Collaboration-Benutzerflows in Mitarbeitermandanten. Informationen zu externen Mandanten finden Sie unter Sammeln von benutzerdefinierten Benutzerattributen während der Registrierung eines externen Mandanten.

Sie haben unter Umständen für jede Anwendung andere Anforderungen an die Informationen, die Sie während der Registrierung sammeln möchten. Microsoft Entra External ID enthält einen integrierten Satz von Informationen, die in Attributen gespeichert sind, z. B. "Vorname", "Nachname", "Ort" und "Postleitzahl". Mit Microsoft Entra External ID können Sie den Satz von Attributen erweitern, die auf einem Gastkonto gespeichert sind, wenn sich der externe Benutzer über einen Benutzerablauf anmeldet.

Sie können benutzerdefinierte Attribute im Microsoft Entra Admin Center erstellen und in Ihren self-Service-Anmeldebenutzerflüssen verwenden. Sie können diese Attribute auch mithilfe der Microsoft Graph-API lesen und schreiben. Microsoft Graph-API unterstützt das Erstellen und Aktualisieren eines Benutzers mit Erweiterungsattributen. Erweiterungsattribute im Graph-API werden mithilfe der Konvention extension_<extensions-app-id>_attributename benannt. Zum Beispiel:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

Die <extensions-app-id> gilt nur für Ihren Mandanten. Um diesen Bezeichner zu finden, navigieren Sie zu Entra ID>App-Registrierungen>All applications. Suchen Sie nach der APP, die mit „aad-extensions-app“ beginnt, und wählen Sie sie aus. Notieren Sie sich auf der Übersichtsseite der App die Anwendungs(client)-ID.

Erstellen eines benutzerdefinierten Attributs

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Benutzeradministrator an.

  2. Navigieren Sie zu Entra ID>Externale Identitäten>Overview.

  3. Wählen Sie benutzerdefinierte Benutzerattribute aus. Die verfügbaren Benutzerattribute werden aufgelistet.

    Screenshot der Übersichtsseite

  4. Um ein Attribut hinzuzufügen, wählen Sie "Hinzufügen" aus.

  5. Geben Sie im Bereich "Attribut hinzufügen" die folgenden Werte ein:

    • Name – Geben Sie einen Namen für das benutzerdefinierte Attribut an (z. B. "Schuhgröße").
    • Datentyp – Wählen Sie einen Datentyp aus (Zeichenfolge, Boolean oder Int).
    • Beschreibung – Geben Sie optional eine Beschreibung des benutzerdefinierten Attributs für die interne Verwendung ein. Diese Beschreibung ist für den Benutzer nicht sichtbar.

    Screenshot des Bereichs

  6. Wählen Sie "Erstellen" aus.

Wenn Sie der Liste der Benutzerattribute ein benutzerdefiniertes Attribut hinzufügen, steht es für die Verwendung in Ihren Benutzerflows zur Verfügung. Das Attribut wird jedoch nur erstellt, wenn es zum ersten Mal in einem beliebigen Benutzerflow verwendet wird. Nachdem Sie einen neuen Benutzer über einen Benutzerfluss erstellt haben, der das neu hinzugefügte benutzerdefinierte Attribut enthält, kann das Objekt in Microsoft Graph Explorer abgefragt werden. Sie sollten ShoeSize jetzt in der Liste der Attribute sehen, die während der Registrierungsreise auf dem Benutzerobjekt gesammelt wurden. Sie können die Graph-API aus Ihrer Anwendung aufrufen, um die Daten aus diesem Attribut abzurufen, nachdem sie dem Benutzerobjekt hinzugefügt wurde.

Nächste Schritte