Definiowanie atrybutów niestandardowych dla przepływów użytkownika
Napiwek
Ten artykuł dotyczy przepływów użytkownika współpracy B2B. Jeśli dzierżawa jest skonfigurowana na potrzeby zarządzania tożsamościami i dostępem klienta, zobacz Zbieranie atrybutów użytkownika podczas rejestracji klientów.
Dla każdej aplikacji mogą istnieć różne wymagania dotyczące informacji, które chcesz zebrać podczas rejestracji. Tożsamość zewnętrzna Microsoft Entra zawiera wbudowany zestaw informacji przechowywanych w atrybutach, takich jak imię, nazwisko, miasto i kod pocztowy. Dzięki Tożsamość zewnętrzna Microsoft Entra można rozszerzyć zestaw atrybutów przechowywanych na koncie gościa, gdy użytkownik zewnętrzny zarejestruje się za pośrednictwem przepływu użytkownika.
Możesz utworzyć atrybuty niestandardowe w centrum administracyjnym firmy Microsoft Entra i używać ich w przepływach użytkownika rejestracji samoobsługowej. Te atrybuty można również odczytywać i zapisywać przy użyciu interfejsu API programu Microsoft Graph. Interfejs API programu Microsoft Graph obsługuje tworzenie i aktualizowanie użytkownika za pomocą atrybutów rozszerzenia. Atrybuty rozszerzenia w interfejsie API programu Graph są nazwane przy użyciu konwencji extension_<extensions-app-id>_attributename. Na przykład:
"extension_831374b3bd5041bfaa54263ec9e050fc_loyaltyNumber": "212342"
Element <extensions-app-id> jest specyficzny dla twojej dzierżawy. Aby znaleźć ten identyfikator, przejdź do pozycji Aplikacje> tożsamości>Rejestracje aplikacji> Wszystkie aplikacje. Wyszukaj aplikację rozpoczynającą się od ciągu "aad-extensions-app" i wybierz ją. Na stronie Przegląd aplikacji zanotuj identyfikator aplikacji (klienta).
Tworzenie atrybutu niestandardowego
Napiwek
Kroki opisane w tym artykule mogą się nieznacznie różnić w zależności od portalu, od którego zaczynasz.
Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako użytkownik Administracja istrator.
Przejdź do sekcji Identity External Identities>Overview (Przegląd tożsamości>zewnętrznych).
Wybierz pozycję Atrybuty niestandardowe użytkownika. Wyświetlane są dostępne atrybuty użytkownika.
Aby dodać atrybut, wybierz pozycję Dodaj.
W okienku Dodaj atrybut wprowadź następujące wartości:
- Nazwa — podaj nazwę atrybutu niestandardowego (na przykład "Rozmiar buta").
- Typ danych — wybierz typ danych (ciąg, wartość logiczna lub int).
- Opis — opcjonalnie wprowadź opis atrybutu niestandardowego do użytku wewnętrznego. Ten opis nie jest widoczny dla użytkownika.
Wybierz pozycję Utwórz.
Po dodaniu atrybutu niestandardowego do listy atrybutów użytkownika staje się on dostępny do użycia w przepływach użytkownika. Jednak atrybut jest tworzony tylko przy pierwszym użyciu w dowolnym przepływie użytkownika. Po utworzeniu nowego użytkownika za pomocą przepływu użytkownika, który zawiera nowo dodany atrybut niestandardowy, obiekt może być odpytywany w Eksploratorze programu Microsoft Graph. Na liście atrybutów zebranych podczas rejestracji obiektu użytkownika powinna być teraz widoczna wartość ShoeSize . Interfejs API programu Graph można wywołać z aplikacji, aby pobrać dane z tego atrybutu po dodaniu go do obiektu użytkownika.