Aangepaste gebruikerskenmerken verzamelen tijdens het registreren

Van toepassing op: Tenants van werknemers Externe tenants (meer informatie)

Tip

Dit artikel is van toepassing op gebruikersstromen in externe tenants. Voor informatie over werknemershuurders, zie Aangepaste kenmerken definiëren voor gebruikersstromen.

Als uw app meer informatie vereist dan de ingebouwde gebruikerskenmerken bevatten, kunt u uw eigen kenmerken toevoegen. We verwijzen naar deze kenmerken als aangepaste gebruikerskenmerken.

Als u een aangepast gebruikerskenmerk wilt definiëren, maakt u eerst het kenmerk op tenantniveau, zodat het kan worden gebruikt in elke gebruikersstroom in de tenant. Vervolgens wijst u het kenmerk toe aan uw gebruikersstroom voor registratie en configureert u hoe het moet worden weergegeven op de registratiepagina.

Meer informatie over aangepaste gebruikerskenmerken in het artikel Gebruikersprofielkenmerken .

Aangepaste gebruikerskenmerken maken

1. Meld u aan bij het Microsoft Entra-beheercentrum.

2. Als u toegang hebt tot meerdere tenants, gebruikt u het pictogram Instellingen in het bovenste menu om vanuit het menu Mappen en abonnementen over te schakelen naar uw externe tenant.

3. Blader naar Identiteit>Externe Identiteiten>Overzicht.

4. Selecteer de Aangepaste gebruikerskenmerken. De lijst bevat alle gebruikerskenmerken die beschikbaar zijn in de tenant, inclusief aangepaste gebruikerskenmerken die zijn gemaakt. De kolom Kenmerktype geeft aan of een kenmerk ingebouwd of aangepast is.

5. Selecteer Toevoegen. Voer in het deelvenster Een kenmerk toevoegen een naam in voor het aangepaste kenmerk (bijvoorbeeld 'Gebruiksvoorwaarden').

6. Kies in Gegevenstype voor tekenreeks, Booleaanse waarde of Int, afhankelijk van het type gegevens en het besturingselement voor gebruikersinvoer dat u wilt maken. Tekenreekskenmerken hebben een standaard invoertype van Tekstvak, maar u kunt dit in een latere stap wijzigen (bijvoorbeeld als u radioknoppen of selectievakjes wilt configureren).

7. (Optioneel) Voer in Beschrijving een beschrijving in van het aangepaste kenmerk voor intern gebruik. De beschrijving is niet zichtbaar voor de gebruiker.

   

8. Selecteer Creëer. Het aangepaste kenmerk is nu beschikbaar in de lijst met gebruikerskenmerken en kan worden toegevoegd aan uw gebruikersstromen.

Het aangepaste gebruikerskenmerk opnemen in een aanmeldingsproces

Volg deze stappen om aangepaste gebruikerskenmerken toe te voegen aan een gebruikersstroom die u al hebt gemaakt. (Als u een nieuwe gebruikersflow moet maken, zie Maak een gebruikersflow voor registratie en aanmelding voor klanten.)

1. Meld u aan bij het Microsoft Entra-beheercentrum.

2. Als u toegang hebt tot meerdere tenants, gebruikt u het pictogram Instellingen in het bovenste menu om vanuit het menu Mappen en abonnementen over te schakelen naar uw externe tenant.

3. Blader naar Identiteit>Externe Identiteiten>Gebruikersstromen.

4. Selecteer de gebruikersstroom uit de lijst.

5. Selecteer Gebruikerskenmerken. De lijst bevat aangepaste gebruikerskenmerken die u hebt gedefinieerd zoals beschreven in de vorige sectie. Het nieuwe kenmerk Gebruiksvoorwaarden wordt nu bijvoorbeeld weergegeven in de lijst. Kies alle kenmerken die u tijdens de registratie van de gebruiker wilt verzamelen.

   

6. Selecteer Opslaan.

De invoertypen en pagina-indeling van de gebruiker configureren

Op de pagina Pagina-indeling kunt u aangeven welke kenmerken vereist zijn en de weergavevolgorde rangschikken. U kunt ook kenmerklabels bewerken, keuzerondjes of selectievakjes maken en hyperlinks toevoegen aan meer inhoud (zoals gebruiksvoorwaarden of een privacybeleid).

1. Meld u aan bij het Microsoft Entra-beheercentrum.

2. Blader naar Identiteit>Externe identiteiten>Gebruikersstromen.

3. Selecteer uw gebruikersstroom in de lijst.

4. Selecteer onder Aanpassen de optie Pagina-indelingen. De kenmerken die u wilt verzamelen, worden weergegeven.

5. Bewerk het label voor een kenmerk door de waarde in de kolom Label te selecteren en de tekst te wijzigen.

6. Selectievakjes of radioknoppen configureren:

   • Selectievakje met één selectievakje: een Booleaanse kenmerktype wordt weergegeven als een selectievakje met één selectievakje op de registratiepagina. Als u de tekst wilt configureren die naast het selectievakje wordt weergegeven, selecteert en bewerkt u de waarde in de kolom Label . Gebruik markdown-taal om hyperlinks toe te voegen. Zie voor meer informatie Een selectievakje configureren (CheckboxSingleSelect).
   • Selectievakjes voor meervoudige selectie: zoek het kenmerk Stringgegevenstype dat u wilt configureren en selecteer de waarde in de kolom Gebruikersinvoertype om het editorvenster te openen. Kies het invoertype van de gebruiker CheckboxMultiSelect en voer de waarden in. Zie Multiselect-selectievakjes configureren (CheckboxMultiSelect) voor meer informatie.
   • Keuzerondjes: zoek het tekenreekskenmerk dat u wilt configureren en selecteer de waarde in de kolom Gebruikersinvoertype om het editorpaneel te openen. Kies het invoertype radioSingleSelect en voer de waarden in. Voor meer informatie, zie Keuzerondjes configureren (RadioSingleSelect)

7. Wijzig de weergavevolgorde door een kenmerk te selecteren en Omhoog, Omlaag, Naar boven of Naar beneden te gaan.

8. Maak een kenmerk dat vereist is door het selectievakje in de kolom Vereist in te schakelen. Alle kenmerken kunnen als vereist worden gemarkeerd. Voor selectievakjes met meerdere selecties betekent 'Vereist' dat de gebruiker ten minste één selectievakje moet selecteren.

9. Wanneer alle wijzigingen zijn voltooid, selecteert u Opslaan.

Een selectievakje voor een enkele selectie configureren (CheckboxSingleSelect)

Een kenmerk met een Boole-gegevenstype heeft een gebruikersinvoertype checkboxSingleSelect. U kunt de tekst die naast het selectievakje wordt weergegeven, wijzigen en hyperlinks opnemen.

Tip

Als u deze functie wilt uitproberen, gaat u naar de demo Woodgrove Boodschappen en start u de use case 'Koppelingen toevoegen naar gebruiksvoorwaarden en privacybeleid'.

Volg deze stappen om een selectievakje voor enkelvoudige selectie te configureren:

1. Zoek op de Pagina-indelingen de attribuut met het gegevenstype Booleaans dat u wilt configureren.

2. Selecteer de waarde in de kolom Label en voer de tekst in die u naast het selectievakje wilt weergeven. Gebruik markdown-taal om hyperlinks toe te voegen. Voorbeeld:

   • Als u het label wilt configureren voor een kenmerk Gebruiksrechtovereenkomst , kunt u het volgende invoeren:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use).

   • Of u kunt uw gebruiksvoorwaarden en privacybeleid combineren tot één vereist selectievakje:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use) and the [privacy policy](https://woodgrove.com/privacy).

3. Selecteer OK.

   

4. Selecteer Opslaan op de pagina Pagina-indelingen.

Meervoudige selectievakjes configureren (CheckboxMultiSelect)

Een kenmerk met het gegevenstype String kan worden geconfigureerd als invoertype CheckboxMultiSelect, een reeks van een of meer selectievakjes die onder het attribuutlabel verschijnen. De gebruiker kan een of meer selectievakjes selecteren. U kunt de tekst voor afzonderlijke selectievakjes definiëren en hyperlinks naar andere inhoud opnemen. Als u dit kenmerk Vereist maakt, moet de gebruiker ten minste één van de selectievakjes selecteren.

1. Zoek op de pagina Pagina-indelingen het kenmerk met het gegevenstype Tekenreeks dat u wilt configureren als een reeks selectievakjes.

2. Selecteer de waarde in de kolom Label en voer de kop in die u wilt weergeven boven de reeks selectievakjes, bijvoorbeeld How did you hear about us?.

3. Selecteer de waarde in de kolom Gebruikersinvoertype om het deelvenster Editor te openen.

4. Selecteer in het deelvenster Editor onder Invoertype Gebruiker de optie CheckboxMultiSelect.

5. Voor elk selectievakje dat u wilt toevoegen, begint u op een nieuwe regel en voert u de volgende gegevens in:

   • Voer onder Tekst de tekst in die u naast het selectievakje wilt weergeven. Gebruik markdown-taal om hyperlinks toe te voegen.

   • Voer onder Waarden een waarde in die moet worden geschreven op het gebruikersobject en geretourneerd als de claim als de gebruiker het selectievakje inschakelt.

6. Selecteer OK.

   

7. Selecteer Opslaan op de pagina Pagina-indelingen.

Keuzerondjes configureren (RadioSingleSelect)

Een kenmerk met een gegevenstype string kan worden geconfigureerd als een invoertype radioSingleSelect, wat een reeks keuzerondjes is die onder het kenmerklabel verschijnen. De gebruiker kan slechts één keuzerondje selecteren. U kunt de tekst voor afzonderlijke keuzerondjes definiëren en hyperlinks naar andere inhoud toevoegen.

1. Zoek op de Pagina-indelingenpagina het attribuut met gegevenstype Tekenreeks dat u wilt configureren als radioknop of reeks radioknoppen.

2. Selecteer de waarde in de kolom Label en voer de koptekst in die u wilt weergeven boven de serie keuzerondjes, bijvoorbeeld Sweatshirt size.

3. Selecteer de waarde in de kolom Gebruikersinvoertype om het deelvenster Editor te openen.

4. Selecteer RadioSingleSelect in het deelvenster Editor onder Invoertype Gebruiker.

5. Voor elke radioknop die u wilt toevoegen, begint u op een nieuwe regel en voert u de volgende informatie in:

   • Voer onder Tekst de tekst in die naast het keuzerondvakje moet worden weergegeven. Gebruik markdown-taal om hyperlinks toe te voegen.

   • Voer onder Waarden een waarde in die op het gebruikersobject moet worden geschreven en als claim moet worden geretourneerd als de gebruiker het selectievakje selecteert.

6. Selecteer Oké.

   

7. Selecteer Opslaan op de pagina Pagina-indelingen.

De toepassings-id voor de uitbreidings-app zoeken

Aangepaste gebruikerskenmerken worden opgeslagen in een app met de naam b2c-extensions-app. Nadat een gebruiker tijdens de registratie een waarde voor het aangepaste kenmerk invoert, wordt deze toegevoegd aan het gebruikersobject en kan deze worden aangeroepen via de Microsoft Graph API met behulp van de naamconventie extension_{appId-without-hyphens}_{custom-attribute-name} waarbij:

• {appId-without-hyphens} is de vereenvoudigde versie van de client-id voor de b2c-extensions-app.
• {custom-attribute-name} is de naam die u hebt toegewezen aan het aangepaste kenmerk.

Gebruik deze stappen om de toepassings-id voor de uitbreidings-app te vinden:

1. Meld u aan bij het Microsoft Entra-beheercentrum.
2. Blader naar Identiteit>> Alle toepassingen.
3. Selecteer de toepassing b2c-extensions-app. Niet wijzigen. Wordt gebruikt door AADB2C voor het opslaan van gebruikersgegevens.
4. Gebruik op de pagina Overzicht de waarde van de toepassings-id (client), bijvoorbeeld: 12345678-abcd-1234-1234-ab123456789, maar verwijder de afbreekstreepjes.

Als u bijvoorbeeld een aangepast kenmerk maakt met de naam loyaltyNumber, raadpleegt u het als extension_12345678abcd12341234ab123456789_loyaltyNumber

Aangepaste gebruikerskenmerken toevoegen aan het id-token

Wanneer gebruikers zich aanmelden bij uw app, ontvangt de app een id-token, dat de gebruikersgegevens bevat. Deze details worden tokenclaims genoemd. Indien nodig kunt u een aangepast gebruikerskenmerk opnemen dat beschikbaar moet zijn als claim in het id-token dat wordt geretourneerd naar uw app. Volg hiervoor de stappen in Kenmerken toevoegen aan het id-token dat wordt geretourneerd naar uw toepassingsartikel .

Volgende stappen

Voeg kenmerken toe aan het id-token dat is geretourneerd aan uw toepassing.

Maak een gebruikersstroom voor registratie en aanmelding voor klanten.