Construtor de atributos SDK de autenticação nativa

Aplica-se a: Locatários da força de trabalho Locatários externos (saiba mais)

Na autenticação nativa, as informações coletadas do usuário durante a inscrição são configuradas no fluxo de usuários no centro de administração do Microsoft Entra. O nome do atributo de usuário como ele aparece no centro de administração do Microsoft Entra é diferente do nome da variável que você usa quando o referencia em seu aplicativo.

Felizmente, o SDK de autenticação nativo permite que você crie os atributos do usuário e atribua valores a eles antes de usá-los no método SDKs signUp() .

Criar atributos de usuário

Androide (Kotlin)

Para criar atributos de usuário no SDK do Android:

• Use a classe UserAttribute.Builder de utilitário que o SDK fornece. A UserAttributes.Builder classe contém métodos cujo parâmetro é o valor que você coleta do usuário.

• Identifique os atributos de usuário que você deseja criar e use o seguinte trecho de código para criá-los:

      //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
          )
      }  
  

• Para criar atributos personalizados, use UserAttribute.Builder o método de classe customAttribute() . O método aceita o nome programável do atributo personalizado e o valor do atributo:

     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)

Para criar atributos de usuário no sdk MSAL do iOS/macOS:

• Identifique os atributos de usuário que você deseja criar e, em seguida, crie uma variável de dicionário, onde:

  • o key é o nome programável do atributo user, como uma cadeia de caracteres. O nome programável pode ser para atributo interno ou personalizado.
  • o value no valor do atributo user que você coleta do usuário.

• Identifique os atributos de usuário que você deseja criar e use o seguinte trecho de código para criá-los:

     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)
  

• Para criar atributos personalizados, use UserAttribute.Builder o método de classe customAttribute() . O método aceita o nome programável do atributo personalizado e o valor do atributo:

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

Para saber mais sobre os nomes programáveis dos atributos de perfil de usuário, consulte o artigo Atributos de perfil de usuário.

Conteúdos relacionados

• Tipos de desafio de autenticação nativa
• Tutoriais de autenticação nativa do iOS/macOS
• Tutoriais de autenticação nativa do Android