Atrybuty profilu użytkownika
Dotyczy:
Dzierżawcy siły roboczej — dzierżawcy zewnętrzni 
(dowiedz się więcej)
Atrybuty użytkownika zbierane podczas rejestracji są przechowywane z profilem użytkownika w katalogu. Możesz wybrać spośród wbudowanych atrybutów użytkownika lub utworzyć niestandardowe atrybuty użytkownika.
Wbudowane atrybuty użytkownika, takie jak miasto, kraj/region, adres e-mail itd., są dostępne w Tożsamość zewnętrzna Microsoft Entra. Możesz wybrać wbudowane atrybuty użytkownika, które chcesz zebrać podczas rejestracji.
Aby uzyskać dodatkowe informacje, które chcesz zebrać, możesz utworzyć niestandardowe atrybuty użytkownika. Do strony rejestracji można dodać kilka niestandardowych kontrolek wejściowych w celu zbierania atrybutów, w tym pól tekstowych, przycisków radiowych i pól wyboru. W poniższym przykładzie pokazano, jak można używać niestandardowych kontrolek wejściowych do zbierania atrybutów numerów lojalnościowych, zgody na warunki użytkowania i zgody na zasady ochrony prywatności.
Wbudowane atrybuty użytkownika
Tożsamość zewnętrzna Microsoft Entra ma wbudowane atrybuty użytkownika, które można zbierać podczas rejestracji. Te atrybuty można skonfigurować podczas tworzenia przepływów użytkownika w centrum administracyjnym firmy Microsoft Entra.
Ta tabela zawiera podsumowanie wbudowanych atrybutów użytkownika, które można zebrać podczas przepływu rejestracji:
- Etykieta w centrum administracyjnym firmy Microsoft Entra to nazwa atrybutu użytkownika wyświetlana w centrum administracyjnym firmy Microsoft Entra.
- Programowalna nazwa to nazwa atrybutu użytkownika używana w zasobie użytkownika interfejsu API programu Microsoft Graph. Ta nazwa jest używana, gdy chcesz użyć tego atrybutu użytkownika programowo, na przykład w uwierzytelnianiu natywnym.
- Typ danych to typ danych atrybutu użytkownika.
| Etykieta w centrum administracyjnym firmy Microsoft Entra | Nazwa programowalna | Typ danych | Uwagi |
|---|---|---|---|
| Miejscowość | miejscowość | String | Maksymalna długość to 128 znaków. |
| Kraj/region | kraj | String | Maksymalna długość to 128 znaków. |
| Wyświetlana nazwa | displayName | String | Maksymalna długość to 256 znaków. |
| Adres e-mail | adres e-mail | String | Ta właściwość nie może zawierać znaków wyróżniających. W interfejsie API uwierzytelniania natywnego ten atrybut jest przywołyny jako nazwa użytkownika. |
| Imię | givenName | String | Maksymalna długość to 64 znaki. |
| Stanowisko | jobTitle | String | Maksymalna długość to 128 znaków. |
| Kod pocztowy | postalCode | String | Maksymalna długość to 40 znaków. |
| Województwo | stan | String | Maksymalna długość to 128 znaków. |
| Ulica i numer | streetAddress | String | Maksymalna długość to 1024 znaki. |
| Nazwisko | surname | String | Maksymalna długość to 64 znaki. |
Niestandardowe atrybuty użytkownika
Jeśli aplikacja wymaga więcej informacji niż podane wbudowane atrybuty użytkownika, możesz dodać własne atrybuty. Te atrybuty nazywamy atrybutami użytkownika niestandardowego.
Aby zdefiniować atrybut użytkownika niestandardowego, należy najpierw utworzyć atrybut na poziomie dzierżawy, aby można go było używać w dowolnym przepływie użytkownika w dzierżawie. Następnie przypiszesz atrybut do przepływu użytkownika rejestracji i skonfigurujesz sposób wyświetlania go na stronie rejestracji.
Dowiedz się, jak tworzyć niestandardowe atrybuty użytkownika Tworzenie niestandardowych atrybutów użytkownika.
Niestandardowe typy danych wejściowych atrybutów użytkownika
Przed użyciem atrybutów użytkownika niestandardowego określ najlepszy sposób zbierania danych wejściowych użytkownika dla każdego atrybutu niestandardowego, który chcesz zebrać. Informacje od użytkowników podczas rejestracji można zbierać przy użyciu następujących kontrolek typu danych wejściowych:
- Pole tekstowe ciągu
- Przycisków
- Pola wyboru wielokrotnego wyboru
- Pole tekstowe liczbowe
- Pole wyboru wyboru zaznaczanego jednokrotnego
Zapoznaj się z tą tabelą, aby znaleźć odpowiednie typy danych i typy danych wejściowych użytkownika:
| Typ danych | Typ danych wejściowych użytkownika | opis |
|---|---|---|
| String | TextBox | Pole wprowadzania tekstu w dowolnej formie. |
| String | RadioSingleSelect | Seria przycisków radiowych z dozwolonym tylko jednym wyborem. Tekst dla poszczególnych przycisków radiowych może zawierać hiperlinki sformatowane w języku Markdown. |
| String | CheckboxMultiSelect | Serie co najmniej jednego pola wyboru z dozwolonymi wieloma opcjami. Pola wyboru Tekst dla poszczególnych pól wyboru mogą zawierać hiperlinki sformatowane w języku Markdown. |
| Wartość logiczna | Pola wyboruWybierz | Jedno pole wyboru wartości logicznej z etykietą. Pole wyboru Etykieta może zawierać hiperlinki sformatowane w języku Markdown. |
| Int | NumericTextBox | Wpis liczby całkowitej w dowolnej formie. |
Pola wyboru i przyciski radiowe mogą zawierać hiperlinki do innej zawartości, takie jak warunki użytkowania i zasady ochrony prywatności. Przykład na początku tego artykułu przedstawia stronę rejestracji, która łączy wbudowane atrybuty i atrybuty niestandardowe. W przykładzie:
- Pole Nazwa wyświetlana jest wbudowanym atrybutem.
- Numer lojalnościowy jest atrybutem niestandardowym z polem wprowadzania w dowolnej formie, które akceptuje liczbową liczbę całkowitą. Ten format można skonfigurować przy użyciu typu danych Int i typu danych wejściowych LiczbicTextBox .
- Warunki użytkowania i atrybuty niestandardowe zasad ochrony prywatności są oddzielnymi polami wyboru z pojedynczym zaznaczeniem z etykietami zawierającymi hiperlinki. Jedno pole wyboru można skonfigurować przy użyciu typu danych logicznych , który domyślnie ma wartość Pola wyboruWybierz typ danych wejściowych użytkownika. Użyj języka Markdown, aby dodać hiperlinki do etykiety pola wyboru.
Dowiedz się, jak skonfigurować typy danych wejściowych atrybutów użytkownika w artykule Konfigurowanie typów danych wejściowych użytkownika.
Gdzie przechowywane są niestandardowe atrybuty użytkownika
Niestandardowe atrybuty użytkownika są również nazywane atrybutami rozszerzenia katalogu, ponieważ rozszerzają informacje o profilu użytkownika przechowywane w katalogu. Wszystkie atrybuty rozszerzenia dla dzierżawy zewnętrznej są przechowywane w aplikacji o nazwie b2c-extensions-app. Gdy użytkownik wprowadzi wartość atrybutu niestandardowego podczas rejestracji, jest dodawany do obiektu użytkownika i może być wywoływany za pośrednictwem interfejsu API programu Microsoft Graph przy użyciu konwencji extension_{appId-without-hyphens}_{custom-attribute-name} nazewnictwa, w której:
{appId-without-hyphens}to pozbawiony identyfikator klienta dla aplikacji b2c-extensions-app.{custom-attribute-name}to nazwa przypisana do atrybutu niestandardowego.
Jeśli na przykład identyfikator klienta aplikacji b2c-extensions-app to 2588a-bcdwh-tfeehj-jeeqw-ertc , a nazwa atrybutu to:
- loyaltyNumber, a następnie atrybut niestandardowy ma nazwę as
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Numer lojalnościowy, a następnie atrybut niestandardowy ma nazwę as
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Usuwasz spację i używasz wielkości liter wielbłąda, aby oddzielić wyrazy.
Skorzystaj z artykułu Znajdowanie identyfikatora aplikacji dla aplikacji rozszerzeń, aby dowiedzieć się, jak znaleźć identyfikator aplikacji dla aplikacji b2c-extensions-app zarejestrowanej w dzierżawie zewnętrznej.
Interfejsy API programu Microsoft Graph
Atrybuty użytkownika są określane jako atrybuty przepływu użytkownika w programie Microsoft Graph. Użyj typu zasobu identityUserFlowAttribute i skojarzonych z nim metod do zarządzania zarówno wbudowanymi, jak i niestandardowymi atrybutami przepływu użytkownika.
Powiązana zawartość
Dodaj atrybuty do tokenu identyfikatora zwróconego do aplikacji.
Dowiedz się więcej na temat tworzenia przepływu rejestracji i logowania użytkowników dla klientów.
Konstruktor atrybutów zestawu SDK systemu Android dla natywnego uwierzytelniania MSAL.