Aangepaste kenmerken voor gebruikersstromen definiëren

  • Artikel
  • 2 minuten om te lezen

Voor elke toepassing hebt u mogelijk verschillende vereisten voor de gegevens die u wilt verzamelen tijdens de registratie. Azure AD wordt geleverd met een ingebouwde set met informatie die is opgeslagen in kenmerken, zoals de naam, de voor waarde, de plaats en de post code. Met Azure AD kunt u de set met kenmerken die zijn opgeslagen op een gast account uitbreiden wanneer de externe gebruiker zich aanmeldt via een gebruikers stroom.

U kunt aangepaste kenmerken in de Azure Portal maken en deze gebruiken in uw eigen service-aanmeld gebruikers stromen. U kunt deze kenmerken ook lezen en schrijven met behulp van de Microsoft Graph-API. Microsoft Graph-API ondersteunt het maken en bijwerken van een gebruiker met extensie kenmerken. Extensie kenmerken in de Graph API worden genoemd met behulp van de Conventie extension_<extensions-app-id>_attributename . Bijvoorbeeld:

"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"

De <extensions-app-id> is specifiek voor uw Tenant. Om deze id te vinden, gaat u naar Azure Active Directory > App-registraties > alle toepassingen. Zoek de app die begint met ' Aad-Extensions-app ' en selecteer deze. Op de overzichts pagina van de app ziet u de toepassings-ID (client).

Een aangepast kenmerk maken

  1. Meld u als een Azure AD-administrator aan bij de Azure Portal.

  2. Onder Azure-Services selecteert u Azure Active Directory.

  3. Selecteer in het linkermenu externe identiteiten.

  4. Selecteer aangepaste gebruikers kenmerken. De beschik bare gebruikers kenmerken worden weer gegeven.

    Gebruikers kenmerken selecteren voor registratie

  5. Selecteer toevoegen om een kenmerk toe te voegen.

  6. Voer in het deel venster een kenmerk toevoegen de volgende waarden in:

    • Naam : Geef een naam op voor het aangepaste kenmerk (bijvoorbeeld ' Shoesize ').
    • Gegevens type : Kies een gegevens type (teken reeks, Booleaanse waarde of int).
    • Beschrijving : Voer eventueel een beschrijving in van het aangepaste kenmerk voor intern gebruik. Deze beschrijving is niet zichtbaar voor de gebruiker.

    Een kenmerk toevoegen

  7. Selecteer Maken.

Het aangepaste kenmerk is nu beschikbaar in de lijst met gebruikers kenmerken en voor gebruik in uw gebruikers stromen. Een aangepast kenmerk wordt alleen gemaakt wanneer het voor de eerste keer wordt gebruikt in een gebruikers stroom en niet wanneer u het toevoegt aan de lijst met gebruikers kenmerken.

Zodra u een nieuwe gebruiker hebt gemaakt met behulp van een gebruikers stroom die gebruikmaakt van het zojuist gemaakte aangepaste kenmerk, kan het object in Microsoft Graph Explorerworden opgevraagd. U ziet nu ShoeSize in de lijst met kenmerken die zijn verzameld tijdens het registreren van het gebruikers object. U kunt de Graph API vanuit uw toepassing aanroepen om de gegevens op te halen uit dit kenmerk nadat het is toegevoegd aan het gebruikers object.

Volgende stappen

Een self-service-aanmeldings stroom voor een gebruiker toevoegen aan een app