Добавление атрибутов пользователя в утверждения токенов

Применяется: зеленый круг с символом белой галочки, указывающим, что следующее содержимое применяется к внешним клиентам. Внешние клиенты (дополнительные сведения)

Атрибутами пользователя называются значения, полученные от пользователя во время самостоятельной регистрации. Помимо встроенных пользовательских атрибутов, можно создавать настраиваемые атрибуты при необходимости сбора дополнительных сведений. Поскольку ваше приложение может полагаться на определенные атрибуты пользователя, чтобы функционировать так, как задумано, вы можете добавить любой из этих атрибутов в токен, отправляемый из Microsoft Entra ID в ваше приложение.

Вы можете указать встроенные или настраиваемые атрибуты, которые хотите добавить в качестве утверждений в маркер, который Microsoft Entra ID отправляет вашему приложению.

Предварительные условия

Добавление встроенных или настраиваемых атрибутов в маркер

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

  2. Перейдите к Entra ID>Регистрация приложений.

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

    Снимок экрана: страница обзора регистрации приложения.

  4. В разделе Essentials в разделе "Управляемое приложение в локальном каталоге" выберите ссылку с именем приложения.

    Снимок экрана управляемого приложения в локальном каталоге.

  5. В разделе "Управление" выберите единый вход.

  6. В разделе "Атрибуты и утверждения" выберите значок "Изменить".

    Снимок экрана: раздел атрибутов и утверждений и значок редактирования.

Добавление встроенного атрибута в токен в качестве утверждения

  1. На странице "Атрибуты и утверждения" выберите "Добавить новое утверждение".

  2. Введите Имя.

  3. Рядом с источником выберите атрибут. Затем используйте раскрывающийся список, чтобы выбрать встроенный атрибут.

    Снимок экрана: раскрывающийся список встроенных атрибутов.

  4. Выберите Сохранить. Повторите действие для всех встроенных атрибутов, которые вы хотите добавить.

Добавить пользовательский атрибут в токен в качестве утверждения

  1. На странице "Атрибуты и утверждения" выберите "Добавить новое утверждение".

  2. Введите Имя.

  3. Рядом с источником выберите расширение схемы каталога.

    Снимок экрана: параметр расширения схемы каталога.

  4. В области "Выбор приложения" выберите приложение b2c-extensions-app (приложение, содержащее все атрибуты расширения для внешнего клиента), а затем нажмите кнопку "Выбрать".

  5. На панели "Добавление атрибутов расширения" найдите настраиваемый атрибут, который необходимо добавить в токен в качестве утверждения, а затем выберите его.

  6. Выберите Добавить.

  7. Выберите Сохранить. Повторите для каждого настраиваемого атрибута, который требуется добавить.

Обновите манифест приложения, чтобы принять сопоставленные утверждения в манифесте приложения Microsoft Graph(New)

  1. Войдите в центр администрирования Microsoft Entra.
  2. Перейдите к Entra ID>Регистрация приложений.
  3. Выберите приложение в списке, чтобы открыть страницу обзора приложения.
  4. В меню слева в разделе "Управление" выберите "Манифест" , чтобы открыть манифест приложения.
  5. Найдите ключ acceptMappedClaims и задайте для нее значение true.
  6. Найдите ключ isFallbackPublicClient и задайте значение true.
  7. Выберите Сохранить.

См. также

  • Last updated on