Attribut för användarprofil
Gäller för:
Personalklientorganisationer 
Externa klienter (läs mer)
De användarattribut som du samlar in under registreringen lagras med användarens profil i din katalog. Du kan välja mellan inbyggda användarattribut eller skapa anpassade användarattribut.
Inbyggda användarattribut, till exempel stad, land/region, e-postadress och så vidare, är tillgängliga i Microsoft Entra Externt ID. Du kan välja de inbyggda användarattribut som du vill samla in under registreringen.
Om du vill ha ytterligare information som du vill samla in kan du skapa anpassade användarattribut. Flera anpassade indatakontroller kan läggas till på registreringssidan för att samla in attributen, inklusive textrutor, alternativknappar och kryssrutor. I följande exempel visas hur anpassade indatakontroller kan användas för att samla in attribut för lojalitetsnummer, användningsvillkorsmedgivande för användningsvillkor och medgivande för sekretesspolicy.
Inbyggda användarattribut
Microsoft Entra Externt ID har inbyggda användarattribut som du kan samla in under registreringen. Du konfigurerar dessa attribut när du skapar användarflöden i administrationscentret för Microsoft Entra.
Den här tabellen sammanfattar de inbyggda användarattribut som du kan samla in under registreringsflödet:
- Etiketten i administrationscentret för Microsoft Entra är namnet på användarattributet så som det visas i administrationscentret för Microsoft Entra.
- Programmerbart namn är namnet på användarattributet som används i användarresurseni Microsoft Graph-API:et. Du använder det här namnet när du vill använda det här användarattributet programmatiskt, till exempel i intern autentisering.
- Datatypen är användarattributets datatyp.
| Etikett i administrationscentret för Microsoft Entra | Programmerbart namn | Datatyp | Kommentarer |
|---|---|---|---|
| Ort | ort | String | Maximal längd är 128 tecken. |
| Land/region | land | String | Maximal längd är 128 tecken. |
| Visningsnamn | displayName | String | Maximal längd är 256 tecken. |
| E-postadress | e-post | String | Den här egenskapen får inte innehålla dekortecken. I det interna autentiserings-API:et refereras det här attributet som användarnamn. |
| Förnamn | givenName | String | Maximal längd är 64 tecken. |
| Titel | jobTitle | String | Maximal längd är 128 tecken. |
| Postnummer | postalCode | String | Maximal längd är 40 tecken. |
| Region | tillstånd | String | Maximal längd är 128 tecken. |
| Gatuadress | streetAddress | String | Maximal längd är 1 024 tecken. |
| Efternamn | surname | String | Maximal längd är 64 tecken. |
Anpassade användarattribut
Om din app kräver mer information än de inbyggda användarattributen anger kan du lägga till egna attribut. Vi refererar till dessa attribut som anpassade användarattribut.
Om du vill definiera ett anpassat användarattribut skapar du först attributet på klientorganisationsnivå så att det kan användas i valfritt användarflöde i klientorganisationen. Sedan tilldelar du attributet till ditt registreringsanvändarflöde och konfigurerar hur du vill att det ska visas på registreringssidan.
Lär dig hur du skapar anpassade användarattribut Artikeln Skapa anpassade användarattribut .
Indatatyper för anpassade användarattribut
Innan du använder anpassade användarattribut ska du bestämma det bästa sättet att samla in användarindata för varje anpassat attribut som du vill samla in. Du kan samla in information från dina användare under registreringen med hjälp av följande kontroller för indatatyp:
- Textruta för sträng
- Alternativknappar
- Kryssrutor för flera markeringar
- Numerisk textruta
- Kryssrutan Enkelval
I den här tabellen hittar du lämpliga datatyper och användarindatatyper:
| Datatyp | Indatatyp för användare | beskrivning |
|---|---|---|
| String | TextBox | Textinmatningsfält i fritt format. |
| String | RadioSingleSelect | Serie med alternativknappar med endast en markering tillåten. Text för enskilda alternativknappar kan innehålla hyperlänkar som är formaterade på Markdown-språk. |
| String | KryssrutaMultiVälj | Serie med en eller flera kryssrutor med flera val tillåtna. Kryssrutan Text för enskilda kryssrutor kan innehålla hyperlänkar som är formaterade på Markdown-språk. |
| Booleskt | KryssrutaVälj | En enda boolesk kryssruta med en etikett. Kryssrutan Etikett för kryssrutan kan innehålla hyperlänkar som är formaterade på Markdown-språk. |
| Int | NumeriskTextBox | Heltalspost i fri form. |
Kryssrutor och alternativknappar kan innehålla hyperlänkar till annat innehåll, till exempel användningsvillkor och sekretesspolicyer. Exemplet i början av den här artikeln visar en registreringssida som kombinerar inbyggda attribut och anpassade attribut. I exemplet:
- Fältet Visningsnamn är ett inbyggt attribut.
- Lojalitetsnumret är ett anpassat attribut med ett friformulärsinmatningsfält som accepterar ett numeriskt heltal. Du kan konfigurera det här formatet med indatatypen Int och användarindatatypen NumericTextBox .
- De anpassade attributen för användningsvillkor och sekretesspolicy är separata kryssrutor med enstaka kryssrutor med etiketter som innehåller hyperlänkar. Du kan konfigurera en enda kryssruta med hjälp av den booleska datatypen, som standard är indatatypen CheckboxSingleSelect . Använd Markdown-språk för att lägga till hyperlänkar i kryssrutans etikett.
Lär dig hur du konfigurerar indatatyper för användarattribut i artikeln Konfigurera användarindatatyper .
Där anpassade användarattribut lagras
Anpassade användarattribut kallas även katalogtilläggsattribut eftersom de utökar användarprofilinformationen som lagras i din katalog. Alla tilläggsattribut för din externa klient lagras i en app med namnet b2c-extensions-app. När en användare anger ett värde för det anpassade attributet under registreringen läggs det till i användarobjektet och kan anropas via Microsoft Graph-API:et med hjälp av namngivningskonventionen extension_{appId-without-hyphens}_{custom-attribute-name} där:
{appId-without-hyphens}är den avskalade versionen av klient-ID:t för b2c-extensions-app.{custom-attribute-name}är det namn som du tilldelade det anpassade attributet.
Om till exempel klient-ID :t för b2c-extensions-app är 2588a-bcdwh-tfeehj-jeeqw-ertc och attributnamnet är:
- loyaltyNumber, namnges det anpassade attributet som
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Lojalitetsnummer namnges det anpassade attributet som
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Du tar bort utrymmet och använder kamelfall för att separera orden.
Använd artikeln Hitta program-ID för tilläggsappen för att lära dig hur du hittar program-ID:t för b2c-extensions-app som är registrerad i din externa klientorganisation.
Microsoft Graph-API:er
Användarattribut kallas för användarflödesattribut i Microsoft Graph. Använd resurstypen identityUserFlowAttribute och dess associerade metoder för att hantera både inbyggda och anpassade användarflödesattribut.