SDK-Attribut-Generator für die native Authentifizierung

Gilt für: Mitarbeitermandanten Externe Mandanten (weitere Informationen)

Bei der nativen Authentifizierung werden die Informationen, die Sie während der Registrierung vom Benutzer sammeln, im Benutzerflow im Microsoft Entra Admin Center konfiguriert. Der im Microsoft Entra Admin Center angezeigte Name des Benutzerattributs unterscheidet sich von dem Variablennamen, den Sie verwenden, wenn Sie in Ihrer App darauf verweisen.

Glücklicherweise können Sie mit dem SDK für native Authentifizierung die Benutzerattribute erstellen und ihnen Werte zuweisen, bevor Sie sie in der signUp()-Methode des SDK verwenden.

Erstellen von Benutzerattributen

Android (Kotlin)

So erstellen Sie Benutzerattribute im Android SDK

• Verwenden Sie die Hilfsklasse UserAttribute.Builder, die das SDK bereitstellt. Die UserAttributes.Builder-Klasse enthält Methoden, deren Parameter der vom Benutzer gesammelte Wert ist.

• Identifizieren Sie die Benutzerattribute, die Sie erstellen möchten, und verwenden Sie dann den folgenden Codeschnipsel, um sie zu erstellen:

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

• Verwenden Sie die UserAttribute.Builder-Methode der customAttribute()-Klasse, um benutzerdefinierte Attribute zu erstellen. Die Methode akzeptiert den programmierbaren Namen des benutzerdefinierten Attributs und den Wert des Attributs:

     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)

So erstellen Sie Benutzerattribute im iOS/macOS-MSAL-SDK:

• Identifizieren Sie die Benutzerattribute, die Sie erstellen möchten, und erstellen Sie dann eine Wörterbuchvariable, wobei gilt:

  • key ist der programmierbare Name des Benutzerattributs als Zeichenfolge. Der programmierbare Name kann für ein integriertes oder ein benutzerdefiniertes Attribut verwendet werden.
  • value ist der Wert des Benutzerattributs, das Sie vom Benutzer sammeln.

• Identifizieren Sie die Benutzerattribute, die Sie erstellen möchten, und verwenden Sie dann den folgenden Codeschnipsel, um sie zu erstellen:

     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)
  

• Verwenden Sie die UserAttribute.Builder-Methode der customAttribute()-Klasse, um benutzerdefinierte Attribute zu erstellen. Die Methode akzeptiert den programmierbaren Namen des benutzerdefinierten Attributs und den Wert des Attributs:

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

Weitere Informationen zu den programmierbaren Namen von Benutzerprofilattributen finden Sie im Artikel zu Benutzerprofilattributen.

Zugehöriger Inhalt

• Aufforderungstypen für native Authentifizierung
• iOS/macOS-Tutorials zur nativen Authentifizierung
• Tutorials zur nativen Authentifizierung für Android