managed 사용자 메타데이터 - Kotlin SDK
이 페이지에서는 Realm Kotlin SDK를 사용하여 권한이 부여된 App Services 앱 사용자의 사용자 메타데이터를 관리하는 방법을 설명합니다. 자세한 내용은 App Services 문서에서 인증 제공자 메타데이터 를 참조하세요.
Atlas App Services는 인증 제공자로부터 사용자 메타데이터 를 읽을 수 있습니다. 그런 다음 App Services는 User 객체의 필드에 각 사용자의 데이터를 노출합니다. 예를 들어 사용자의 이름, 이메일, 생일 또는 성별에 액세스하고 싶을 수 있습니다.
사용자의 메타데이터 읽기
해당 사용자의 User 객체를 통해 현재 로그인한 사용자의 사용자 메타데이터를 읽을 수 있습니다. User 객체를 통해 사용자 메타데이터를 편집할 수 없습니다.
데이터를 읽으려면 로그인한 사용자의 User 객체에서 profileAsBsonDocument 메서드를 호출합니다.
// Log in a user val user = app.login(Credentials.emailPassword(email, password)) // Access the user's metadata val userEmail = user.profileAsBsonDocument()["email"] Log.i("The logged-in user's email is: $userEmail")
사용자 메타데이터 옵션은 사용 중인 제공자와 활성화하는 메타데이터 필드에 따라 달라집니다.
경고
사용자 메타데이터가 오래되었을 수 있습니다.
Atlas App Services는 사용자가 로그인하면 최신 버전의 사용자 메타데이터를 가져옵니다. 예를 들어 사용자가 로그인 제공자를 통해 이메일 주소나 프로필 사진을 변경하는 경우 사용자가 다시 로그인할 때까지 해당 변경 사항은 사용자 메타데이터에서 업데이트되지 않습니다. 자격 증명을 캐시하고 로그인 흐름을 우회할 수 있도록 하기 때문에 사용자에게 다시 로그인하도록 강제하지 않는 한 사용자 메타데이터가 유효하지 않을 수 있습니다.
직렬화 가능한 사용자 메타데이터
버전 1.9.0의 새로운 기능
Kotlin SDK 버전 1.9.0에는 다음을 지원하는 API가 도입되었습니다.
반환되는 사용자 메타데이터에 대한 제한적이지만 안정적인 EJSON 인코더
User.profileAsBsonDocument()User.profile() 확장 메서드에서 반환된 사용자 메타데이터에 대한 전체 문서 직렬화를 지원하는 실험적 EJSON 인코더입니다. 이 인코더 및 메서드를 사용하려면 실험적 옵트인이 필요합니다.
공식 Kotlin 직렬화 를 추가해야 합니다. 라이브러리를 프로젝트에 추가하여 Realm Kotlin SDK의 EJSON 직렬화를 사용합니다. 자세한 내용은 직렬화를 참조하세요.
사용자 메타데이터 구성
App Services 애플리케이션에서 구성한 클라이언트 앱에서만 사용자 메타데이터를 읽을 수 있습니다.
인증 제공자에게 요청하는 사용자 메타데이터 를 구성할 수 있습니다. 인증 제공자의 구성에서 직접 이 작업을 수행합니다. 사용할 수 있는 메타데이터 필드에 대한 자세한 내용은 제공자 세부 정보를 참조하세요.
사용자 메타데이터 업데이트
인증 제공자를 통해 액세스하는 사용자 메타데이터는 읽기 전용 데이터입니다. 이 소스에서 가져온 사용자 메타데이터는 업데이트하거나 편집할 수 없습니다.
사용자에게 클라이언트 앱 내에서 메타데이터를 업데이트하는 옵션을 제공하려면 대신 사용자 지정 사용자 데이터 를 사용하세요.