Kenmerken van gebruikersprofiel
Van toepassing op:
Externe tenants
van 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 | 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 als
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Loyaliteitsnummer dan heet het aangepaste kenmerk als
extension_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.