기본 인증 SDK 특성 작성기

적용: Workforce 테넌트 외부 테넌트(자세히 알아보기)

기본 인증에서는 등록 중에 사용자로부터 수집하는 정보가 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/macOS(Swift)

iOS/macOS 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/macOS 기본 인증 자습서
• Android 기본 인증 자습서