原生驗證 SDK 屬性建立器

適用於： 員工租用戶 外部租用戶 (深入瞭解)

在原生驗證中，您在註冊期間從使用者收集的資訊會設定在 Microsoft Entra 系統管理中心的使用者流程中。 Microsoft Entra 系統管理中心中顯示的使用者屬性名稱與您在應用程式中參考時所使用的變數名稱不同。

幸運的是，原生驗證 SDK 可讓您建置使用者屬性，並在 SDK signUp() 方法中使用它們之前，將值指派給他們。

建置使用者屬性

Android (Kotlin)

若要在 Android SDK 中建置使用者屬性：

• 使用 SDK 提供的公用程式類別 UserAttribute.Builder。 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 (Swift)

若要在 iOS MSAL SDK 中建置使用者屬性：

• 識別您想要建置的使用者屬性，然後建立字典變數，其中：

  • 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 原生驗證教學課程
• Android 原生驗證教學課程