Построитель атрибутов пакета SDK для машинной проверки подлинности

Область применения: клиенты рабочей силы внешние клиенты (дополнительные сведения)

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

К счастью, собственный пакет SDK проверки подлинности позволяет создавать атрибуты пользователя и назначать им значения перед их использованием в методе SDK signUp() .

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

Android (Kotlin)

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

• Используйте класс UserAttribute.Builder служебной программы, который предоставляет пакет SDK. Класс UserAttributes.Builder содержит методы, параметр которых является значением, собранным пользователем.

• Определите атрибуты пользователя, которые вы хотите создать, а затем используйте следующий фрагмент кода для их сборки:

      //build the user attributes, both built-in and custom attributes
      val userAttributes = UserAttributes.Builder()
          .country(country)
          .city(city)
          .displayName(displayName)
          .givenName(givenName)
          .jobTitle(jobTitle)
          .postalCode(postalCode)
          .state(state)
          .streetAddress(streetAddress)
          .surname(surname)
          .build() 
  
      CoroutineScope(Dispatchers.Main).launch {
          //use the userAttributes variable in your signUp method 
          val actionResult = authAuthClientInstance.signUp(
              username = emailAddress,
              attributes = userAttributes
          )
      }  
  

• Чтобы создать пользовательские атрибуты, используйте UserAttribute.Builder метод класса customAttribute() . Метод принимает программируемое имя настраиваемого атрибута и значение атрибута:

     val userAttributes = UserAttributes.Builder()
         .customAttribute("extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber", loyaltyNumber)
         .build() 
  
     CoroutineScope(Dispatchers.Main).launch {
         //use the userAttributes variable in your signUp method 
         val actionResult = authAuthClientInstance.signUp(
             username = emailAddress,
             attributes = userAttributes
         )
     }  
  

iOS/macOS (Swift)

Чтобы создать атрибуты пользователей в пакете SDK для MSAL для iOS и macOS:

• Определите атрибуты пользователя, которые требуется создать, а затем создайте переменную словаря, где:

  • — key это программируемое имя атрибута пользователя в виде строки. Программируемое имя может быть для встроенного или пользовательского атрибута.
  • value значение атрибута пользователя, полученного от пользователя.

• Определите атрибуты пользователя, которые вы хотите создать, а затем используйте следующий фрагмент кода для их сборки:

     let attributes = [
         "country": "United States",
         "city": "Redmond",
         "displayName": displayName,
         "givenName": givenName,
         "jobTitle": jobTitle,
         "postalCode": postalCode,
         "state": state,
         "streetAddress": streetAddress,
         "surname": surname
     ]
  
     authAuthClientInstance.signUp(username: email, attributes: attributes, delegate: self)
  

• Чтобы создать пользовательские атрибуты, используйте UserAttribute.Builder метод класса customAttribute() . Метод принимает программируемое имя настраиваемого атрибута и значение атрибута:

          let attributes = [
              "country": "United States",
              "extension_2588abcdwhtfeehjjeeqwertc_loyaltyNumber", loyaltyNumber
          ]
  
          authAuthClientInstance.signUp(username: email, attributes: attributes, delegate: self)
  

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

Связанный контент

• Собственные типы проблем проверки подлинности
• Руководства по собственной проверке подлинности iOS и macOS
• Учебники по собственной проверке подлинности Android