Сбор настраиваемых атрибутов пользователя при регистрации внешнего арендатора

Применяется: Внешние клиенты (дополнительные сведения)

Если приложению требуется больше информации, чем предоставляются встроенные атрибуты пользователя, можно добавить собственные атрибуты. Эти атрибуты называются настраиваемыми пользовательскими атрибутами.

Чтобы определить настраиваемый атрибут пользователя, сначала создайте атрибут на уровне клиента, чтобы его можно было использовать в любом потоке пользователя в клиенте. Затем вы назначаете атрибут процессу регистрации пользователя и настраиваете, как он будет отображаться на странице регистрации.

Дополнительные сведения о настраиваемых атрибутах пользователя см. в статье атрибутов профиля пользователя .

Создание настраиваемых атрибутов пользователя

1. Войдите в Центр администрирования Microsoft Entra.

2. Если у вас есть доступ к нескольким арендаторам, воспользуйтесь значком параметров в верхнем меню, чтобы переключиться на внешнего арендатора из меню каталоги и подписка.

3. Перейдите к Entra ID>Внешние удостоверения>Обзор.

4. Выберите настраиваемые атрибуты пользователя. Список содержит все атрибуты пользователя, доступные в клиенте, включая любые созданные пользовательские атрибуты. Столбец типа атрибута указывает, является ли атрибут встроенным или настраиваемым.

5. Нажмите кнопку "Добавить". В области "Добавление атрибута" введите имя настраиваемого атрибута (например, "Условия использования").

6. В типе данных выберите String,Boolean или Int в зависимости от типа данных и пользовательского элемента управления входным данными , которые требуется создать. Строковые атрибуты имеют значение типа ввода пользователя по умолчанию TextBox, но вы можете изменить его на следующем шаге (например, если требуется настроить переключатели или флажки с несколькими выборками).

7. (Необязательно) В поле Description введите описание пользовательского атрибута для внутреннего использования. Это описание невидимо для пользователя.

   

8. Нажмите кнопку "Создать". Настраиваемый атрибут теперь доступен в списке атрибутов пользователя и может быть добавлен в потоки пользователей.

Включите пользовательский атрибут в поток регистрации

Выполните следующие действия, чтобы добавить настраиваемые атрибуты пользователей в созданный поток пользователя. (Если вам нужно создать новый поток пользователя, см. статью "Создание потока пользователей для регистрации и входа в систему для клиентов".)

1. Войдите в Центр администрирования Microsoft Entra.

2. Если у вас есть доступ к нескольким арендаторам, воспользуйтесь значком параметров в верхнем меню, чтобы переключиться на внешнего арендатора из меню каталоги и подписка.

3. Перейдите к Entra ID>Внешние идентификаторы>потокам пользователей.

4. Выберите пользовательский поток из списка.

5. Выберите атрибуты пользователя. Этот список содержит все пользовательские атрибуты пользователя, определенные в предыдущем разделе. Например, новый атрибут "Условия использования" теперь отображается в списке. Выберите все атрибуты, которые нужно собрать от пользователя во время регистрации.

   

6. Нажмите кнопку "Сохранить".

Настройка типов ввода пользователей и макета страницы

На странице макета страницы можно указать необходимые атрибуты и упорядочить порядок отображения. Вы также можете изменять метки атрибутов, создавать переключатели или флажки и добавлять гиперссылки в большее содержимое (например, условия использования или политика конфиденциальности).

1. Войдите в Центр администрирования Microsoft Entra.

2. Перейдите к Entra ID>Внешние идентификаторы>потокам пользователей.

3. В списке выберите пользовательский поток.

4. В разделе "Настройка" выберите макеты страниц. Появятся атрибуты, которые вы выбрали для сбора.

5. Измените метку для любого атрибута, выбрав значение в столбце Label и изменив текст.

6. Настройка флажков или переключателей:

   • Флажок с одним выбором: логический тип атрибута отображается в виде флажка с одним выбором на странице регистрации. Чтобы настроить текст, отображаемый рядом с флажком, выберите и измените значение в столбце Label . Используйте язык Markdown для добавления гиперссылок. Дополнительные сведения см. в разделе "Настройка флажка для одиночного выбора" (CheckboxSingleSelect)
   • Флажки с несколькими выборками: найдите атрибут типа данных string , который вы хотите настроить, и выберите значение в столбце " Тип ввода пользователя ", чтобы открыть область редактора. Выберите тип ввода для пользователя CheckboxMultiSelect и введите значения. Дополнительные сведения см. в разделе "Настройка флажков с несколькими выборами" (CheckboxMultiSelect).
   • Переключатели: найдите атрибут типа данных string , который вы хотите настроить, и выберите значение в столбце " Тип ввода пользователя ", чтобы открыть область редактора. Выберите тип входных данных пользователя RadioSingleSelect и введите значения. Дополнительные сведения см. в разделе "Настройка переключателей" (RadioSingleSelect)

7. Измените порядок отображения, выбрав атрибут, затем выбрав Переместить вверх, Переместить вниз, Переместить в начало или Переместить в конец.

8. Сделайте атрибут обязательным, установив флажок в столбце "Обязательный". Все атрибуты можно пометить как обязательные. Для мультивыбор флажков "Обязательный" означает, что пользователь должен выбрать хотя бы один флажок.

9. После завершения всех изменений нажмите кнопку "Сохранить".

Настройка одновариантного флажка (CheckboxSingleSelect)

Атрибут с логическим типом данных имеет тип ввода пользователя CheckboxSingleSelect. Вы можете изменить текст, отображаемый рядом с флажком, и включить гиперссылки.

Чтобы настроить флажок с одним выбором, выполните следующие действия.

1. На странице макетов страницы найдите атрибут с типом данных boolean , который требуется настроить.

2. Выберите значение в столбце "Метка " и введите текст, который вы хотите отобразить рядом с флажком. Используйте язык Markdown для добавления гиперссылок. Например:

   • Чтобы настроить метку для атрибута "Условия использования ", можно ввести следующее:

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

   • Кроме того, вы можете объединить условия использования и политики конфиденциальности в один обязательный флажок:

     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. Нажмите кнопку "ОК".

   

4. На странице макетов страницы нажмите кнопку "Сохранить".

Настройка флажков с несколькими выборами (CheckboxMultiSelect)

Атрибут с типом данных String можно настроить как тип ввода для пользователя CheckboxMultiSelect, который представляет собой ряд из одной или нескольких флажков, которые отображаются под меткой атрибута. Пользователь может установить один или несколько флажков. Вы можете определить текст для отдельных флажков и включить гиперссылки на другое содержимое. Создание этого атрибута "Обязательный" означает, что пользователь должен выбрать хотя бы один из флажков.

1. На странице макетов страницы найдите атрибут с типом данных String , который необходимо настроить в виде ряда флажков.

2. Выберите значение в столбце Label и введите заголовок, который нужно отобразить над рядом флажков, например How did you hear about us?.

3. Выберите значение в столбце "Тип ввода пользователя" , чтобы открыть область редактора.

4. В области редактора в разделе Тип ввода пользователя выберите CheckboxMultiSelect.

5. Для каждого флажка, который вы хотите добавить, запустите новую строку и введите следующие сведения:

   • В разделе "Текст" введите текст, который вы хотите отобразить рядом с флажком. Используйте язык Markdown для добавления гиперссылок.

   • Под «Значения» введите значение для записи в объект пользователя и вернуть в качестве утверждения, если пользователь выбирает флажок.

6. Нажмите кнопку "ОК".

   

7. На странице макетов страницы нажмите кнопку "Сохранить".

Настройте радиокнопки (RadioSingleSelect)

Атрибут с типом данных String можно настроить как тип ввода пользователя RadioSingleSelect, который представляет собой ряд переключателей, которые отображаются под меткой атрибута. Пользователь может выбрать только одну радиокнопку. Вы можете определить текст для отдельных переключателей и включить гиперссылки на другое содержимое.

1. На странице макетов страницы найдите атрибут с типом данных String, который требуется настроить в качестве переключателя или группы переключателей.

2. Выберите значение в столбце "Метка " и введите заголовок, который нужно отобразить над рядом переключателей, например Sweatshirt size.

3. Выберите значение в столбце "Тип ввода пользователя" , чтобы открыть область редактора.

4. В области редактора в разделе "Тип ввода пользователя" выберите RadioSingleSelect.

5. Для каждого переключателя, который вы хотите добавить, начните на новой строке и введите следующую информацию:

   • В разделе "Текст" введите текст, который вы хотите отобразить рядом с переключателем. Используйте язык Markdown для добавления гиперссылок.

   • В разделе "Значения" введите значение, которое записывается в объект пользователя и возвращается в качестве утверждения, если пользователь выбирает радиокнопку.

6. Нажмите кнопку "ОК".

   

7. На странице макетов страницы нажмите кнопку "Сохранить".

Настройка видимости и редактирования атрибутов с помощью Microsoft Graph

Вы можете контролировать, какие атрибуты отображаются или собираются от пользователей во время регистрации, настраивая скрытые и редактируемые флаги для каждого атрибута. Эти параметры сейчас недоступны в пользовательском интерфейсе Центра администрирования, но их можно настроить с помощью Microsoft Graph.

Каждый атрибут поддерживает следующие флаги:

• hidden: этот флаг установлен по умолчанию, чтобы атрибут отображался на странице регистрации, но его можно установить на false, чтобы скрыть атрибут.
• editable: этот флаг true по умолчанию позволяет пользователям изменять атрибут, но его можно задать для false создания атрибута только для чтения.

Примеры.

• Чтобы отобразить атрибут на странице, но запретить пользователям изменять его, установите hidden на false и editable на false.
• Чтобы скрыть атрибут со страницы, но при этом сохранить возможность задавать его программно, установите hidden в true и editable в true. Например, можно назначить атрибуту значение, создав настраиваемое расширение проверки подлинности для события отправки коллекции атрибутов.

Чтобы задать скрытые и редактируемые флаги с помощью Microsoft Graph, используйте тип ресурса authenticationAttributeCollectionInputConfiguration . Дополнительные сведения см. в примере по обновлению макета страницы потока самостоятельной регистрации пользователей.

Найдите идентификатор приложения для приложения для расширений

Пользовательские атрибуты пользователяхранятся в приложении с именем b2c-extensions-app. Когда пользователь вводит значение для пользовательского атрибута во время регистрации, он добавляется в объект пользователя и может вызываться через API Microsoft Graph с помощью соглашения extension_{appId-without-hyphens}_{custom-attribute-name} об именовании, где:

• {appId-without-hyphens} — это отрезаная версия идентификатора клиента для приложения b2c-extensions-app.
• {custom-attribute-name} — это имя, назначенное пользовательскому атрибуту.

Чтобы найти идентификатор приложения для приложения расширений, выполните следующие действия.

1. Войдите в Центр администрирования Microsoft Entra.
2. Перейдите к Entra ID>Регистрации приложений>Все приложения.
3. Выберите приложение b2c-extensions-app. Не изменяйте. Используется AADB2C для хранения пользовательских данных.
4. На странице обзора используйте значение идентификатора приложения (клиента ), например, 12345678-abcd-1234-1234-ab123456789но удалите дефисы.

Например, если вы создаете настраиваемый атрибут с именем loyaltyNumber, обратитесь к нему как extension_12345678abcd12341234ab123456789_loyaltyNumber

Добавьте пользовательские атрибуты в токен идентификации

Когда пользователи входят в ваше приложение, оно получает идентификационный токен, который включает сведения о пользователе. Эти сведения называются данными токена. При необходимости можно включить настраиваемый атрибут пользователя, который будет использоваться в качестве утверждения в токене идентификатора, возвращаемом вашему приложению. Для этого следуйте шагам, описанным в статье "Добавление атрибутов к маркеру идентификатора", возвращаемого приложению.

Следующие шаги

Добавьте атрибуты в маркер идентификатора, возвращенный приложению.

Создайте процесс регистрации и входа для клиентов.