Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy: 
Dzierżawy zewnętrzne (dowiedz się więcej)
Atrybuty użytkownika zbierane podczas rejestracji są przechowywane wraz 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 usłudze Microsoft Entra External ID. 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
Microsoft Entra External ID 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ść | Sznurek | Maksymalna długość to 128 znaków. |
| Kraj/region | kraj | Sznurek | Maksymalna długość to 128 znaków. |
| Wyświetlana nazwa | nazwa wyświetlana | Sznurek | Maksymalna długość to 256 znaków. |
| Adres e-mail | Sznurek | Ta właściwość nie może zawierać znaków diakrytycznych. W interfejsie API uwierzytelniania natywnego ten atrybut jest przywołyny jako nazwa użytkownika. | |
| Imię | givenName | Sznurek | Maksymalna długość to 64 znaki. |
| Stanowisko | tytuł stanowiska | Sznurek | Maksymalna długość to 128 znaków. |
| Kod pocztowy | kod pocztowy | Sznurek | Maksymalna długość to 40 znaków. |
| Województwo | stan | Sznurek | Maksymalna długość to 128 znaków. |
| Ulica i numer | adres ulicy | Sznurek | Maksymalna długość to 1024 znaki. |
| Nazwisko | nazwisko | Sznurek | 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 niestandardowy użytkownika, należy najpierw utworzyć go na poziomie instancji, aby mógł być używany w dowolnym przepływie użytkownika w tej instancji. Następnie przypiszesz atrybut do procesu rejestracji użytkownika i skonfigurujesz, jak ma się pojawić na stronie rejestracji.
Dowiedz się, jak tworzyć niestandardowe atrybuty użytkownika w artykule.
Niestandardowe typy wejściowe 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 pola wprowadzania:
- Pole tekstowe ciągu znaków
- Przyciski radiowe
- Wielokrotne pola wyboru
- Pole tekstowe liczbowe
- Pole wyboru 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 |
|---|---|---|
| Sznurek | Pole tekstowe | Pole wprowadzania tekstu w dowolnej formie. |
| Sznurek | RadioSingleSelect (RadioPojedynczy wybór) | 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. |
| Sznurek | Pole wyboruWielokrotny wybór | Seria co najmniej jednego pola wyboru pozwalająca na wybór wielu opcji. Tekst dla poszczególnych pól wyboru może zawierać hiperlinki sformatowane w języku Markdown. |
| logiczny | Pola wyboru Pojedynczy wybór | Jedno pole wyboru logicznego z etykietą. Etykieta dla pola wyboru może zawierać hiperlinki sformatowane w języku Markdown. |
| Int | PoleTekstoweNumeryczne | 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. Można skonfigurować jedno pole wyboru przy użyciu typu danych Boolean, który domyślnie ma wartość CheckboxSingleSelect jako typ wejścia użytkownika. Użyj języka Markdown, aby dodać hiperlinki do etykiety pola wyboru.
Dowiedz się, jak skonfigurować typy wejściowe atrybutów użytkownika w artykule Konfigurowanie wejściowych typów 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 ona dodawana do obiektu użytkownika i może być wywoływana za pośrednictwem Microsoft Graph API przy użyciu konwencji nazewnictwa extension_{appId-without-hyphens}_{custom-attribute-name}, w której:
-
{appId-without-hyphens}to zredukowany 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 notacji camel case, 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.