Атрибуты профиля пользователя
Область применения: 
клиенты рабочей силы внешние
клиенты (дополнительные сведения)
Атрибуты пользователя, собранные во время регистрации, хранятся в профиле пользователя в каталоге. Вы можете выбрать встроенные атрибуты пользователя или создать настраиваемые атрибуты пользователя.
Встроенные атрибуты пользователя, такие как город, страна или регион, адрес электронной почты и т. д., доступны в Внешняя идентификация Microsoft Entra. Вы можете выбрать встроенные атрибуты пользователя, которые вы хотите собрать во время регистрации.
Для получения дополнительных сведений, которые требуется собрать, можно создать настраиваемые атрибуты пользователя. Несколько пользовательских элементов управления входными данными можно добавить на страницу регистрации для сбора атрибутов, включая текстовые поля, переключатели и флажки. В следующем примере показано, как пользовательские элементы управления входным вводом можно использовать для сбора атрибутов для номера лояльности, условий согласия на использование условий использования и согласия политики конфиденциальности.
Встроенные атрибуты пользователя
Внешняя идентификация Microsoft Entra имеет встроенные атрибуты пользователя, которые можно собирать во время регистрации. Эти атрибуты настраивается при создании потоков пользователей в Центре администрирования Microsoft Entra.
В этой таблице приведены встроенные атрибуты пользователя, которые можно собирать во время потока регистрации:
- Метка в Центре администрирования Microsoft Entra — это имя атрибута пользователя, как оно отображается в Центре администрирования Microsoft Entra.
- Программируемое имя — это имя атрибута пользователя, используемого в ресурсе пользователя API Microsoft Graph. Это имя используется при программном использовании этого атрибута пользователя, например при собственной проверке подлинности.
- Тип данных — это тип данных атрибута пользователя.
| Метка в Центре администрирования Microsoft Entra | Программируемое имя | Тип данных | Замечания |
|---|---|---|---|
| Город | city | Строка | Максимальная длина — 128 символов. |
| Страна или регион | country | Строка | Максимальная длина — 128 символов. |
| Отображаемое имя. | displayName | Строка | Максимальная длина составляет 256 символов. |
| Электронная почта | эл. почта | Строка | Это свойство не может содержать символы акцента. В собственном API проверки подлинности этот атрибут ссылается как имя пользователя. |
| Заданное имя | givenName | Строка | Максимальная длина — 64 символа. |
| Должность | jobTitle | Строка | Максимальная длина — 128 символов. |
| Почтовый индекс | postalCode | Строка | Максимальная длина — 40 символов. |
| Область, республика, край, округ | state | Строка | Максимальная длина — 128 символов. |
| Почтовый адрес | streetAddress | Строка | Максимальная длина: 1024 символа. |
| Фамилия | surname; | Строка | Максимальная длина — 64 символа. |
Настраиваемые атрибуты пользователя
Если приложению требуется больше информации, чем предоставляются встроенные атрибуты пользователя, можно добавить собственные атрибуты. Эти атрибуты называются пользовательскими атрибутами.
Чтобы определить настраиваемый атрибут пользователя, сначала создайте атрибут на уровне клиента, чтобы его можно было использовать в любом потоке пользователя в клиенте. Затем вы назначаете атрибут потоку пользователя регистрации и настраиваете способ его отображения на странице регистрации.
Узнайте, как создать настраиваемые атрибуты пользователя.
Пользовательские типы входных атрибутов пользователей
Прежде чем использовать настраиваемые атрибуты пользователя, определите лучший способ сбора данных пользователей для каждого настраиваемого атрибута, который требуется собрать. Вы можете собирать сведения от пользователей во время регистрации с помощью следующих элементов управления входными типами:
- Текстовое поле строки
- Переключатели
- Флажки с несколькими выборами
- Числовое текстовое поле
- Флажок с одним выбором
Ознакомьтесь с этой таблицей, чтобы найти соответствующие типы данных и типы входных данных пользователей:
| Тип данных | Тип входных данных пользователя | Description |
|---|---|---|
| Строка | TextBox | Поле записи текста в свободной форме. |
| Строка | RadioSingleSelect | Ряд переключателей с разрешенным выделением. Текст для отдельных переключателей может включать гиперссылки, отформатированные на языке Markdown. |
| Строка | CheckboxMultiSelect | Ряд один или несколько флажков с несколькими выбранными вариантами. Текст для отдельных флажков может содержать гиперссылки, отформатированные на языке Markdown. |
| Логический | ФлажокSingleSelect | Один логический флажок с меткой. Метка для флажка может содержать гиперссылки, отформатированные на языке Markdown. |
| Int | NumericTextBox | Целочисленная запись в свободной форме. |
Флажки и переключатели могут включать гиперссылки на другое содержимое, например условия использования и политики конфиденциальности. В примере в начале этой статьи показана страница регистрации, которая объединяет встроенные атрибуты и настраиваемые атрибуты. Ознакомьтесь со следующим примером:
- Поле отображаемого имени — это встроенный атрибут.
- Номер лояльности — это настраиваемый атрибут с полем записи свободной формы, которое принимает числовое целое число. Этот формат можно настроить с помощью типа данных Int и пользовательского типа ввода NumericTextBox.
- Условия использования и настраиваемые атрибуты политики конфиденциальности являются отдельными флажками с метками, содержащими гиперссылки. Можно настроить один флажок с помощью логического типа данных, который по умолчанию соответствует типу входных данных пользователя CheckboxSingleSelect . Используйте язык Markdown, чтобы добавить гиперссылки в метку флажка.
Узнайте, как настроить входные типы атрибутов пользователя в статье "Настройка типов входных данных пользователя".
Где хранятся пользовательские атрибуты пользователя
Пользовательские атрибуты пользователя также называются атрибутами расширения каталога, так как они расширяют сведения профиля пользователя, хранящиеся в каталоге. Все атрибуты расширения для внешнего клиента хранятся в приложении с именем b2c-extensions-app. Когда пользователь вводит значение для пользовательского атрибута во время регистрации, он добавляется в объект пользователя и может вызываться через API Microsoft Graph с помощью соглашения extension_{appId-without-hyphens}_{custom-attribute-name} об именовании, где:
{appId-without-hyphens}— это отрезаная версия идентификатора клиента для приложения b2c-extensions-app.{custom-attribute-name}— это имя, назначенное пользовательскому атрибуту.
Например, если идентификатор клиента приложения b2c-extensions-app и 2588a-bcdwh-tfeehj-jeeqw-ertc имя атрибута:
- значение loyaltyNumber, а затем настраиваемый атрибут называется как
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. - Номер лояльности, а затем настраиваемый атрибут называется как
extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber. Вы удаляете пространство и используете верблюдю для разделения слов.
Используйте идентификатор приложения для приложения расширений, чтобы узнать, как найти идентификатор приложения для приложения b2c-extensions-app, зарегистрированного во внешнем клиенте.
API-интерфейсы Microsoft Graph
Атрибуты пользователей называются атрибутами потока пользователя в Microsoft Graph. Используйте тип ресурса identityUserFlowAttribute и связанные с ним методы для управления встроенными и настраиваемыми атрибутами потока пользователя.
Связанный контент
Добавьте атрибуты в маркер идентификатора, возвращенный приложению.
Узнайте больше о создании потока пользователей регистрации и входа для клиентов.
Построитель атрибутов пакета SDK для MSAL для Android для машинной проверки подлинности.