Zbieranie niestandardowych atrybutów użytkownika podczas zapisu do zewnętrznej dzierżawy

Dotyczy: Dzierżawy zewnętrzne (dowiedz się więcej)

Napiwek

Niniejszy artykuł dotyczy przepływów użytkowników w dzierżawach zewnętrznych. Aby uzyskać informacje o użytkownikach pracujących, zobacz Zbieranie niestandardowych atrybutów użytkownika podczas rejestracji w ramach współpracy B2B.

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, tak aby mógł być używany w dowolnym przepływie użytkownika w tej dzierżawie. Następnie przypiszesz atrybut do przepływu rejestracji użytkownika i skonfigurujesz, jak ma się pojawić na stronie rejestracji.

Dowiedz się więcej o atrybutach użytkownika niestandardowych w artykule Atrybuty profilu użytkownika .

Tworzenie niestandardowych atrybutów użytkownika

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra.

2. Jeśli masz dostęp do kilku kont najemcy, użyj ikony Ustawienia w górnym menu, aby przełączyć się do zewnętrznego konta z menu Katalogi + subskrypcje.

3. Przejdź do Entra ID>Tożsamości zewnętrzne>Omówienie.

4. Wybierz Atrybuty użytkownika niestandardowe. Lista zawiera wszystkie atrybuty użytkownika dostępne w dzierżawie, w tym wszystkie niestandardowe atrybuty użytkownika, które zostały utworzone. Kolumna Typ atrybutu wskazuje, czy atrybut jest wbudowany, czy niestandardowy.

5. Wybierz pozycję Dodaj. W okienku Dodawanie atrybutu wprowadź nazwę atrybutu niestandardowego (na przykład "Warunki użytkowania").

6. W obszarze Typ danych wybierz pozycję Ciąg, Wartość logiczna lub Int w zależności od typu danych i kontrolki danych wejściowych użytkownika , którą chcesz utworzyć. Atrybuty ciągu mają domyślną wartość typu danych wejściowych użytkownika TextBox, ale można to zmienić w późniejszym kroku (na przykład jeśli chcesz skonfigurować przyciski radiowe lub pola wyboru wielokrotnego wyboru).

7. (Opcjonalnie) W polu Opis wprowadź opis atrybutu niestandardowego do użytku wewnętrznego. Ten opis nie jest widoczny dla użytkownika.

   

8. Wybierz pozycję Utwórz. Atrybut niestandardowy jest teraz dostępny na liście atrybutów użytkownika i można go dodać do przepływów użytkownika.

Dołącz niestandardowy atrybut użytkownika do przepływu rejestracji

Wykonaj następujące kroki, aby dodać niestandardowe atrybuty użytkownika do utworzonego przepływu użytkownika. (Jeśli musisz utworzyć nowy przepływ użytkownika, zobacz Tworzenie przepływu rejestracji i logowania dla klientów).

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra.

2. Jeśli masz dostęp do kilku kont najemcy, użyj ikony Ustawienia w górnym menu, aby przełączyć się do zewnętrznego konta z menu Katalogi + subskrypcje.

3. Przejdź do obszaru Entra ID>Zewnętrzne tożsamości>Przepływy użytkowników.

4. Wybierz przepływ użytkownika z listy.

5. Wybierz pozycję Atrybuty użytkownika. Lista zawiera wszystkie niestandardowe atrybuty użytkownika zdefiniowane zgodnie z opisem w poprzedniej sekcji. Na przykład nowy atrybut Warunki użytkowania jest teraz wyświetlany na liście. Wybierz wszystkie atrybuty, które chcesz zebrać od użytkownika podczas rejestracji.

   

6. Wybierz pozycję Zapisz.

Konfigurowanie typów danych wejściowych użytkownika i układu strony

Na stronie Układ strony można wskazać, które atrybuty są wymagane i uporządkować kolejność wyświetlania. Możesz również edytować etykiety atrybutów, tworzyć przyciski radiowe lub pola wyboru oraz dodawać hiperlinki do większej zawartości (np. warunki użytkowania lub zasady ochrony prywatności).

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra.

2. Przejdź do obszaru Entra ID>Zewnętrzne tożsamości>Przepływy użytkowników.

3. Z listy wybierz swój cykl użytkowania.

4. W obszarze Dostosuj wybierz pozycję Układy stron. Atrybuty, które wybrałeś do zbierania, pojawiają się.

5. Edytuj etykietę dla dowolnego atrybutu, wybierając wartość w kolumnie Etykieta i modyfikując tekst.

6. Skonfiguruj pola wyboru lub przyciski radiowe:

   • Pole wyboru pojedynczego zaznaczenia: typ atrybutu boolowskiego jest renderowany jako pole wyboru pojedynczego zaznaczenia na stronie rejestracji. Aby skonfigurować tekst wyświetlany obok pola wyboru, zaznacz i edytuj wartość w kolumnie Etykieta . Użyj języka Markdown, aby dodać hiperlinki. Aby uzyskać szczegółowe informacje, zobacz Konfigurowanie pola wyboru jednokrotnego wyboru (CheckboxSingleSelect)
   • Wielokrotne pola wyboru: znajdź atrybut typu danych Ciąg, który chcesz skonfigurować, i wybierz wartość w kolumnie Typ wejścia użytkownika, aby otworzyć okienko edytora. Wybierz typ danych wejściowych użytkownika Pole wyboru MultiSelect i wprowadź wartości. Aby uzyskać szczegółowe informacje, zobacz Konfigurowanie pól wyboru wielokrotnego wyboru (CheckboxMultiSelect).
   • Przyciski radiowe: Znajdź atrybut Typ danych Ciąg , który chcesz skonfigurować, i wybierz wartość w kolumnie Typ danych wejściowych użytkownika , aby otworzyć okienko edytora. Wybierz typ danych wejściowych użytkownika RadioSingleSelect i wprowadź wartości. Aby uzyskać szczegółowe informacje, zobacz Aby skonfigurować przyciski radiowe (RadioSingleSelect)

7. Zmień kolejność wyświetlania, wybierając atrybut i następnie opcję Przenieś w górę, Przenieś w dół, Przenieś na górę lub Przenieś na dół.

8. Ustaw atrybut wymagany, zaznaczając pole wyboru w kolumnie Wymagane . Wszystkie atrybuty można oznaczyć jako wymagane. W przypadku pól wyboru wielokrotnego zaznaczenia pole wyboru "Wymagane" oznacza, że użytkownik musi zaznaczyć co najmniej jedno pole wyboru.

9. Po zakończeniu wszystkich zmian wybierz pozycję Zapisz.

Skonfiguruj jednoprzyciskowe pole wyboru (CheckboxSingleSelect)

Atrybut z logicznym typem danych ma typ wejściowy użytkownika jako Pole wyboru SingleSelect. Możesz zmodyfikować tekst wyświetlany obok pola wyboru i dołączyć hiperlinki.

Aby skonfigurować pole wyboru z jedną opcją, wykonaj następujące kroki:

1. Na stronie Układy strony znajdź atrybut z typem danych wartości logicznej , którą chcesz skonfigurować.

2. Wybierz wartość w kolumnie Etykieta i wprowadź tekst, który chcesz wyświetlić obok pola wyboru. Użyj języka Markdown, aby dodać hiperlinki. Na przykład:

   • Aby skonfigurować etykietę dla atrybutu Warunki użytkowania , możesz wprowadzić:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use).

   • Możesz też połączyć warunki użytkowania i zasady ochrony prywatności w jedno wymagane pole wyboru:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use) and the [privacy policy](https://woodgrove.com/privacy).

3. Wybierz przycisk OK.

   

4. Na stronie Układy strony wybierz pozycję Zapisz.

Konfiguracja pól wielokrotnego wyboru (MultiSelect)

Atrybut z typem danych ciąg można skonfigurować jako typ wejściowy użytkownika CheckboxMultiSelect, który jest serią pól wyboru wyświetlanych pod etykietą atrybutu. Użytkownik może zaznaczyć jedno lub więcej pól wyboru. Możesz zdefiniować tekst poszczególnych pól wyboru i dołączyć hiperlinki do innego elementu zawartości. Ustawienie tego atrybutu "Wymagane" oznacza, że użytkownik musi zaznaczyć co najmniej jedno z pól wyboru.

1. Na stronie Układy strony znajdź atrybut z typem danych Ciąg , który chcesz skonfigurować jako serię pól wyboru.

2. Wybierz wartość w kolumnie Etykieta i wprowadź nagłówek, który chcesz wyświetlić powyżej serii pól wyboru, na przykład How did you hear about us?.

3. Wybierz wartość w kolumnie Typ danych wejściowych użytkownika , aby otworzyć okienko edytora.

4. W okienku edytora w obszarze Typ danych wejściowych użytkownika wybierz pozycję Pole wyboruMultiSelect.

5. Dla każdego pola wyboru, które chcesz dodać, zacznij od nowego wiersza i wprowadź następujące informacje:

   • W obszarze Tekst wprowadź tekst, który chcesz wyświetlić obok pola wyboru. Użyj języka Markdown, aby dodać hiperlinki.

   • W obszarze Wartości wprowadź wartość, która ma zostać zapisana w obiekcie użytkownika i zwrócona jako oświadczenie, jeśli użytkownik zaznaczy pole wyboru.

6. Wybierz przycisk OK.

   

7. Na stronie Układy strony wybierz pozycję Zapisz.

Konfigurowanie przycisków radiowych (RadioSingleSelect)

Atrybut z typem danych string można skonfigurować jako typ wejściowy użytkownika RadioSingleSelect, który jest serią przycisków radiowych wyświetlanych pod etykietą atrybutu. Użytkownik może wybrać tylko jeden przycisk radiowy. Możesz zdefiniować tekst dla poszczególnych przycisków radiowych i dołączyć hiperlinki do innego elementu zawartości.

1. Na stronie Układy strony znajdź atrybut z typem danych Ciąg , który chcesz skonfigurować jako przycisk radiowy lub serię przycisków radiowych.

2. Wybierz wartość w kolumnie Etykieta i wprowadź nagłówek, który chcesz wyświetlić powyżej serii przycisków radiowych, na przykład Sweatshirt size.

3. Wybierz wartość w kolumnie Typ danych wejściowych użytkownika , aby otworzyć okienko edytora.

4. W okienku edytora w obszarze Typ danych wejściowych użytkownika wybierz pozycję RadioSingleSelect.

5. Dla każdego przycisku radiowego, który chcesz dodać, zacznij od nowego wiersza i wprowadź następujące informacje:

   • W obszarze Tekst wprowadź tekst, który chcesz wyświetlić obok przycisku radiowego. Użyj języka Markdown, aby dodać hiperlinki.

   • W obszarze Wartości wprowadź wartość, która ma zostać zapisana w obiekcie użytkownika i zwrócona jako oświadczenie, jeśli użytkownik wybierze przycisk radiowy.

6. Wybierz przycisk OK.

   

7. Na stronie Układy strony wybierz pozycję Zapisz.

Konfigurowanie widoczności atrybutów i możliwości edycji za pomocą programu Microsoft Graph

Możesz kontrolować, które atrybuty są wyświetlane lub zbierane od użytkowników podczas rejestracji, konfigurując ukryte i edytowalne flagi dla każdego atrybutu. Te ustawienia nie są obecnie dostępne w interfejsie użytkownika centrum administracyjnego, ale można je skonfigurować przy użyciu programu Microsoft Graph.

Każdy atrybut obsługuje następujące flagi:

• hidden: Ta flaga jest false domyślnie wyświetlana na stronie rejestracji, ale można ją ustawić tak, aby true ukryć atrybut.
• editable: Ta flaga jest true domyślnie zezwalana użytkownikom na edytowanie atrybutu, ale można ustawić ją tak, aby false atrybut był tylko do odczytu.

Przykłady:

• Aby wyświetlić atrybut na stronie, ale uniemożliwić użytkownikom edytowanie go, ustaw wartość hiddenfalse i editable na false .
• Aby ukryć atrybut ze strony, jednocześnie zezwalając na jej programowe ustawienie, ustaw wartość hiddentrue i editable na truewartość . Można na przykład przypisać wartość do atrybutu, tworząc niestandardowe rozszerzenie uwierzytelniania dla zdarzenia przesyłania kolekcji atrybutów.

Aby ustawić ukryte i edytowalne flagi przy użyciu programu Microsoft Graph, użyj typu zasobu authenticationAttributeCollectionInputConfiguration . Aby uzyskać informacje referencyjne, zobacz przykład dotyczący aktualizowania układu strony przepływu użytkownika rejestracji samoobsługowej.

Znajdowanie identyfikatora aplikacji dla aplikacji rozszerzeń

Niestandardowe atrybuty użytkownika 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 interfejsu API Microsoft Graph zgodnie z konwencją nazewnictwa extension_{appId-without-hyphens}_{custom-attribute-name}, gdzie:

• {appId-without-hyphens} to przekształcony identyfikator klienta dla aplikacji b2c-extensions-app.
• {custom-attribute-name} to nazwa przypisana do atrybutu niestandardowego.

Wykonaj następujące kroki, aby znaleźć identyfikator aplikacji dla aplikacji rozszerzeń:

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra.
2. Przejdź do Entra ID>Rejestracje aplikacji>Wszystkie aplikacje.
3. Wybierz aplikację b2c-extensions-app. Nie modyfikuj. Używany przez usługę AADB2C do przechowywania danych użytkownika.
4. Na stronie Przegląd użyj wartości identyfikatora aplikacji (klienta), na przykład: 12345678-abcd-1234-1234-ab123456789, ale usuń łączniki.

Jeśli na przykład utworzysz atrybut niestandardowy o nazwie loyaltyNumber, użyj go jako extension_12345678abcd12341234ab123456789_loyaltyNumber

Dodaj niestandardowe atrybuty użytkownika do tokenu identyfikatora

Gdy użytkownicy loguje się do aplikacji, aplikacja otrzymuje token identyfikatora, który zawiera szczegóły użytkownika. Te dane są nazywane roszczeniami tokenów. W razie potrzeby możesz dołączyć niestandardowy atrybut użytkownika, który będzie dostępny jako roszczenie w tokenie identyfikacyjnym zwróconym do twojej aplikacji. Aby to zrobić, wykonaj kroki opisane w artykule Dodawanie atrybutów do tokenu identyfikatora zwróconego do aplikacji .

Następne kroki

Dodaj atrybuty do tokenu ID, który jest zwracany do twojej aplikacji.

Utwórz ścieżkę użytkownika logowania i rejestracji dla klientów.