Kenmerken van gebruikersprofiel

Van toepassing op:Externe tenantsvan werknemers (meer informatie)

De gebruikerskenmerken die u tijdens de registratie verzamelt, worden opgeslagen met het profiel van de gebruiker in uw directory. U kunt kiezen uit ingebouwde gebruikerskenmerken of aangepaste gebruikerskenmerken maken.

• Ingebouwde gebruikerskenmerken, zoals plaats, land/regio, e-mailadres, enzovoort, zijn beschikbaar in Microsoft Entra Externe ID. U kunt de ingebouwde gebruikerskenmerken kiezen die u wilt verzamelen tijdens de registratie.

• Voor aanvullende informatie die u wilt verzamelen, kunt u aangepaste gebruikerskenmerken maken. Er kunnen verschillende aangepaste invoerbesturingselementen worden toegevoegd aan de registratiepagina om de kenmerken te verzamelen, waaronder tekstvakken, keuzerondjes en selectievakjes. In het volgende voorbeeld ziet u hoe aangepaste invoerbesturingselementen kunnen worden gebruikt voor het verzamelen van kenmerken voor loyaliteitsnummer, toestemming voor gebruiksvoorwaarden en toestemming van het privacybeleid.

  

Ingebouwde gebruikerskenmerken

Microsoft Entra Externe ID ingebouwde gebruikerskenmerken heeft die u tijdens de registratie kunt verzamelen. U configureert deze kenmerken wanneer u gebruikersstromen maakt in het Microsoft Entra-beheercentrum.

Deze tabel bevat een overzicht van de ingebouwde gebruikerskenmerken die u kunt verzamelen tijdens de registratiestroom:

• Label in het Microsoft Entra-beheercentrum is de naam van het gebruikerskenmerk zoals deze wordt weergegeven in het Microsoft Entra-beheercentrum .
• Programmeerbare naam is de naam van het gebruikerskenmerk dat wordt gebruikt in de gebruikersresource van de Microsoft Graph API. U gebruikt deze naam als u dit gebruikerskenmerk programmatisch wilt gebruiken, zoals in systeemeigen verificatie.
• Gegevenstype is het gegevenstype van het gebruikerskenmerk.

Label in het Microsoft Entra-beheercentrum	Programmeerbare naam	Gegevenstype	Opmerkingen
Plaats	plaats	String	De maximale lengte is 128 tekens.
Land/regio	land	String	De maximale lengte is 128 tekens.
Weergavenaam	displayName	String	De maximale lengte is 256 tekens.
E-mailadres	e-mail	String	Deze eigenschap mag geen accenttekens bevatten. In de systeemeigen verificatie-API wordt naar dit kenmerk verwezen als gebruikersnaam.
Voornaam	givenName	String	De maximale lengte is 64 tekens.
Functie	jobTitle	String	De maximale lengte is 128 tekens.
Postcode	postalCode	String	De maximale lengte is 40 tekens.
Provincie	staat	String	De maximale lengte is 128 tekens.
Adres	streetAddress	String	De maximumlengte is 1024 tekens.
Achternaam	surname	String	De maximale lengte is 64 tekens.

Aangepaste gebruikerskenmerken

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 het maken van aangepaste gebruikerskenmerken Artikel aangepaste gebruikerskenmerken maken.

Invoertypen voor aangepaste gebruikerskenmerken

Voordat u aangepaste gebruikerskenmerken gebruikt, bepaalt u de beste manier om gebruikersinvoer te verzamelen voor elk aangepast kenmerk dat u wilt verzamelen. U kunt tijdens het registreren gegevens van uw gebruikers verzamelen met behulp van de volgende besturingselementen voor invoertypen:

• Tekstvak tekenreeks
• Keuzerondjes
• Selectievakjes voor meervoudige selectie
• Numeriek tekstvak
• Selectievakje met één selectievakje

Raadpleeg deze tabel om de juiste gegevenstypen en invoertypen van gebruikers te vinden:

Gegevenstype	Invoertype gebruiker	Beschrijving
String	TextBox	Vrije tekstinvoerveld.
String	RadioSingleSelect	Reeks keuzerondjes met slechts één selectie toegestaan. De tekst voor afzonderlijke keuzerondjes kan hyperlinks bevatten die zijn opgemaakt in de Markdown-taal.
String	SelectievakjeMultiSelect	Reeks van een of meer selectievakjes waarvoor meerdere selecties zijn toegestaan. De tekst voor afzonderlijke selectievakjes kan hyperlinks bevatten die zijn opgemaakt in de Markdown-taal.
Booleaanse waarde	SelectievakjesingleSelect	Eén Booleaanse selectievakje met een label. Het label voor het selectievakje kan hyperlinks bevatten die zijn opgemaakt in de Markdown-taal.
Int	NumericTextBox	Vrije-formulier gehele waarde.

Selectievakjes en keuzerondjes kunnen hyperlinks naar andere inhoud bevatten, zoals gebruiksvoorwaarden en privacybeleid. In het voorbeeld aan het begin van dit artikel ziet u een registratiepagina waarin ingebouwde kenmerken en aangepaste kenmerken worden gecombineerd. In het voorbeeld:

• Het veld Weergavenaam is een ingebouwd kenmerk.
• Het loyaliteitsnummer is een aangepast kenmerk met een vrije invoerveld dat een numeriek geheel getal accepteert. U kunt deze indeling configureren met behulp van het gegevenstype Int en het invoertype NumericTextBox .
• De gebruiksvoorwaarden en aangepaste kenmerken van het privacybeleid zijn afzonderlijke selectievakjes met één selectievakje met labels die hyperlinks bevatten. U kunt één selectievakje configureren met behulp van het booleaanse gegevenstype, dat standaard wordt ingesteld op het invoertype van de gebruiker CheckboxSingleSelect . Gebruik de Markdown-taal om hyperlinks toe te voegen aan het selectievakjelabel.

Meer informatie over het configureren van invoertypen voor gebruikerskenmerken in het artikel Gebruikersinvoertypen configureren.

Waar aangepaste gebruikerskenmerken worden opgeslagen

Aangepaste gebruikerskenmerken worden ook wel directory-extensiekenmerken genoemd, omdat ze de gebruikersprofielgegevens uitbreiden die zijn opgeslagen in uw directory. Alle extensiekenmerken voor uw externe tenant 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 stripped versie van de client-id voor de b2c-extensions-app.
• {custom-attribute-name} is de naam die u hebt toegewezen aan het aangepaste kenmerk.

Als de client-id van de b2c-extensions-app bijvoorbeeld is 2588a-bcdwh-tfeehj-jeeqw-ertc en de kenmerknaam:

• loyaltyNumber, dan heet het aangepaste kenmerk alsextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber.
• Loyaliteitsnummer dan heet het aangepaste kenmerk alsextension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. U verwijdert de spatie en gebruikt kameelkast om de woorden te scheiden.

Gebruik het artikel De toepassings-id zoeken voor het app-artikel extensies voor meer informatie over het vinden van de toepassings-id voor de b2c-extensions-app die is geregistreerd in uw externe tenant.

Microsoft Graph API's

Gebruikerskenmerken worden aangeduid als gebruikersstroomkenmerken in Microsoft Graph. Gebruik het resourcetype identityUserFlowAttribute en de bijbehorende methoden om zowel ingebouwde als aangepaste gebruikersstroomkenmerken te beheren.

Gerelateerde inhoud

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

• Meer informatie over het maken van een gebruikersstroom voor registratie en aanmelding voor klanten.

• Systeemeigen verificatie MSAL Android SDK attribute builder.