클래스 사용자

이 클래스는 Atlas App Services 애플리케이션의 사용자를 나타냅니다. 자격 증명은 다양한 타사 제공자(Facebook, Google 등)에서 제공합니다. 사용자는 서버에 로그인할 수 있으며 액세스 권한이 부여되면 로컬 Realm과 원격 Realm을 동기화할 수 있습니다. 또한 사용자가 로그아웃하면 동기화가 중지됩니다. 사용자를 유지할 수 있습니다. 사용자를 검색하면 타사 제공업체에 다시 로그인할 필요가 없습니다. 세션 사이에 사용자를 유지하면 사용자의 자격 증명이 디바이스에 로컬로 저장되며 민감한 데이터로 처리되어야 합니다.

상속

객체

사용자

구현

IEquatable<사용자>

네임스페이스: Realms.동기화

어셈블리: Realm.exe

구문

public class User : IEquatable<User>

속성

AccessToken

이 사용자의 액세스 토큰을 가져옵니다. 이는 MongoDB Atlas 데이터에 액세스하기 위한 사용자 자격 증명이므로 민감한 정보로 취급되어야 합니다.

선언

public string AccessToken { get; }

속성 값

유형	설명
문자열	서버 앞에서 이 사용자를 나타내는 데 사용할 수 있는 고유 문자열입니다.

API 키

사용자 API 키를 관리하기 위한 기능을 노출하는 User.ApiKeyClient 인스턴스를 가져옵니다.

선언

public User.ApiKeyClient ApiKeys { get; }

속성 값

유형	설명
사용자.ApiKeyClient	이 User 로 범위가 지정된 User.ApiKeyClient 인스턴스입니다.

다음도 참조하세요.

API 키 인증 Docs

앱

이 사용자가 연결된 앱을 가져옵니다.

선언

public App App { get; }

속성 값

유형	설명
앱	이 사용자를 소유한 앱 인스턴스입니다.

DeviceId

사용자가 로그인한 장치의 고유 식별자를 가져옵니다.

선언

public string DeviceId { get; }

속성 값

유형	설명
문자열	현재 장치를 식별하는 고유 문자열입니다.

함수

원격 Atlas Functions를 호출하기 위한 기능을 노출하는 User.FunctionsClient 인스턴스를 가져옵니다.

선언

public User.FunctionsClient Functions { get; }

속성 값

유형	설명
사용자.FunctionsClient	이 User 로 범위가 지정된 User.FunctionsClient 인스턴스입니다.

다음도 참조하세요.

함수 Docs

ID

Atlas App Services에서 이 사용자의 ID를 가져옵니다.

선언

public string Id { get; }

속성 값

유형	설명
문자열	해당 사용자를 고유하게 식별하는 문자열입니다.

ID

이 사용자와 연결된 모든 ID의 collection을 가져옵니다.

선언

public UserIdentity[] Identities { get; }

속성 값

유형	설명
UserIdentity[]	다양한 Credentials.AuthProvider에 대한 사용자의 ID.

프로필

해당 사용자의 프로필 정보를 가져옵니다.

선언

public UserProfile Profile { get; }

속성 값

유형	설명
사용자 프로필	사용자 이름, 이메일 등에 대한 정보가 포함된 UserProfile 객체입니다.

제공자

이 사용자가 로그인한 Credentials.AuthProvider 를 나타내는 값을 가져옵니다.

선언

[Obsolete("User.Provider wasn't working consistently and will be removed in a future version. You can get the provider of the user identity instead.")]
public Credentials.AuthProvider Provider { get; }

속성 값

유형	설명
자격 증명.AuthProvider	사용자 로그인에 사용되는 Credentials.AuthProvider 입니다.

새로 고침 토큰

이 사용자의 새로 고침 토큰을 가져옵니다. 이는 MongoDB Atlas 데이터에 액세스하기 위한 사용자 자격 증명이므로 민감한 정보로 취급되어야 합니다.

선언

public string RefreshToken { get; }

속성 값

유형	설명
문자열	사용자의 자격 증명을 새로 고치는 데 사용할 수 있는 고유 문자열입니다.

상태

사용자의 현재 상태를 가져옵니다.

선언

public UserState State { get; }

속성 값

유형	설명
UserState	사용자가 활성 상태인지, 로그아웃했는지 또는 오류가 발생했는지를 나타내는 값입니다.

방법

Equals(사용자?)

ID를 비교하여 이 인스턴스와 다른 User 인스턴스가 동일한지 여부를 확인합니다.

선언

public bool Equals(User? other)

매개변수

유형	이름	설명
사용자	기타	비교할 사용자 인스턴스입니다.

반환

유형	설명
부울	두 인스턴스가 같으면 true 이고, 그렇지 않으면 false 를 반환합니다. 그렇지 않으면 false.

GetCustomData()

Realm 앱에서 이 사용자와 연결된 사용자 지정 사용자 데이터를 가져옵니다.

선언

public BsonDocument? GetCustomData()

반환

유형	설명
BsonDocument	사용자 데이터가 포함된 문서입니다.

비고

데이터는 사용자의 액세스 토큰을 새로 고치거나 refreshCustomDataAsync() 를 명시적으로 호출할 때만 새로 고쳐집니다.

다음도 참조하세요.

사용자 지정 사용자 데이터 Docs

GetCustomData<T>()

Realm 앱에서 이 사용자와 연결된 사용자 지정 사용자 데이터를 가져와서 지정된 유형으로 구문 분석합니다.

선언

public T? GetCustomData<T>() where T : class

반환

유형	설명
t	사용자 데이터가 포함된 문서입니다.

유형 매개변수

이름	설명
t	사용자 지정 데이터 문서의 형태와 일치하는 managed 유형입니다.

비고

데이터는 사용자의 액세스 토큰을 새로 고치거나 refreshCustomDataAsync() 를 명시적으로 호출할 때만 새로 고쳐집니다.

다음도 참조하세요.

사용자 지정 사용자 데이터 Docs

GetMongoClient(string)

MongoDB 데이터베이스의 문서에 액세스하기 위한 MongoClient 인스턴스를 가져옵니다.

선언

public MongoClient GetMongoClient(string serviceName)

매개변수

유형	이름	설명
문자열	serviceName	서버에 구성된 서비스의 이름입니다.

반환

유형	설명
몽고클라이언트	원격 서비스에 노출된 데이터베이스와 상호 작용할 수 있는 MongoClient 인스턴스입니다.

LinkCredentialsAsync(Credentials)

현재 사용자를 지정된 자격 증명으로 나타나는 새 사용자 ID와 연결합니다.

선언

public Task<User> LinkCredentialsAsync(Credentials credentials)

매개변수

유형	이름	설명
자격 증명	자격 증명	현재 사용자와 연결하기 위한 자격 증명입니다.

반환

유형	설명
작업<사용자>	원격 링크 자격 증명 작업을 나타내는 대기 가능한 Task<TResult> 입니다. 성공적으로 완료되면 작업 결과에 자격 증명이 연결된 사용자가 포함됩니다.

비고

더 많은 자격 증명을 가진 사용자를 연결하면, 사용자가 이러한 자격 증명 중 하나에 로그인할 수 있습니다. 또한 익명 사용자를 다음과 같이 연결하여 '업그레이드'할 수도 있습니다. 이메일/비밀번호 자격 증명.
참고: 두 명의 기존 Atlas App Services 사용자를 연결할 수 없습니다. 제공된 자격 증명은 다른 사용자가 사용한 적이 없어야 합니다.
이메일/비밀번호 인증 시 참고 사항: 새 EmailPassword(문자열, 문자열) 자격 증명 세트와 사용자를 연결하려면 먼저 RegisterUserAsync(string, string) 을 호출하여 이러한 자격 증명을 등록해야 합니다.

예시

다음 스니펫은 이메일 및 비밀번호를 익명의 사용자와 연결하여 다른 장치에서 로그인할 수 있도록 하는 방법을 보여줍니다.

var app = App.Create("app-id")
var user = await app.LogInAsync(Credentials.Anonymous());

// This step is only needed for email password auth - a password record must exist
// before you can link a user to it.
await app.EmailPasswordAuth.RegisterUserAsync("email", "password");
await user.LinkCredentialsAsync(Credentials.EmailPassword("email", "password"));

LogOutAsync()

사용자의 로컬 자격 증명을 제거하고 서버에서 새로 고침 토큰을 무효화하려고 시도합니다.

선언

public Task LogOutAsync()

반환

유형	설명
작업	원격 로그아웃 작업 을 나타내는 대기 가능한 작업입니다.

새로 고침CustomDataAsync()

서버에서 사용자의 사용자 지정 데이터를 다시 가져옵니다.

선언

public Task<BsonDocument?> RefreshCustomDataAsync()

반환

유형	설명
작업<BsonDocument>	원격 새로 고침 작업을 나타내는 대기 가능한 Task<TResult> 입니다. 결과는 업데이트된 사용자 지정 사용자 데이터를 포함하는 MongoDB.Bson.BsonDocument 입니다. GetCustomData() 에서 반환된 값도 새 정보로 업데이트됩니다.

새로 고침CustomDataAsync<T>()

서버에서 사용자의 사용자 지정 데이터를 다시 가져옵니다.

선언

public Task<T?> RefreshCustomDataAsync<T>() where T : class

반환

유형	설명
작업<T>	원격 새로 고침 작업을 나타내는 대기 가능한 Task<TResult> 입니다. 결과는 업데이트된 사용자 지정 사용자 데이터를 포함하는 객체입니다. GetCustomData<T>() 에서 반환된 값도 새 정보로 업데이트됩니다.

유형 매개변수

이름	설명
t	사용자 지정 데이터 문서의 형태와 일치하는 managed 유형입니다.

ToString()

현재 객체를 나타내는 문자열을 반환합니다.

선언

public override string ToString()

반환

유형	설명
문자열	현재 객체를 나타내는 문자열입니다.

재정의

object.ToString()

이벤트

변경됨

속성 값이 변경될 때 발생합니다.

선언

public event EventHandler? Changed

eventType

유형	설명
EventHandler

연산자

연산자 ==(사용자?, 사용자?)

두 User 인스턴스가 같은지 여부를 결정합니다.

선언

public static bool operator ==(User? user1, User? user2)

매개변수

유형	이름	설명
사용자	user1	비교할 첫 번째 사용자입니다.
사용자	user2	비교할 두 번째 사용자입니다.

반환

유형	설명
부울	true 두 인스턴스가 동일한 경우 그렇지 않으면 false 입니다.

operator !=(User?, User?)

두 User 인스턴스가 다른지 여부를 결정합니다.

선언

public static bool operator !=(User? user1, User? user2)

매개변수

유형	이름	설명
사용자	user1	비교할 첫 번째 사용자입니다.
사용자	user2	비교할 두 번째 사용자입니다.

반환

유형	설명
부울	true 두 인스턴스가 다른 경우 그렇지 않으면 false 입니다.

구현

IEquatable<T>