Autenticar usuários — .NET SDK

Conecte-se

var user = await app.LogInAsync(Credentials.Anonymous());

var user = await app.LogInAsync(
    Credentials.EmailPassword("caleb@mongodb.com", "MySekritPwd"));

var user = await app.LogInAsync(Credentials.ApiKey(apiKey));

var user =
    await app.LogInAsync(Credentials.JWT(jwt_token));

var functionParameters = new
{
    username = "caleb",
    password = "MySekritPwd",
    IQ = 42,
    hasPets = true
};
var user =
    await app.LogInAsync(Credentials.Function(functionParameters));

var user =
    await app.LogInAsync(Credentials.Facebook(facebookToken));

var user =
    await app.LogInAsync(Credentials.Google(googleAuthCode, GoogleCredentialType.AuthCode));

var user =
    await app.LogInAsync(Credentials.Apple(appleToken));

Login off-line

Quando seu aplicativo Realm autentica um usuário, armazena em cache as credenciais do usuário. Você pode verificar as credenciais de usuário existentes para ignorar o fluxo de login e acessar o usuário em cache. Use isto para abrir um realm offline.

O exemplo a seguir verifica se há um objeto de usuário em cache. Caso contrário, ele registra o usuário. Caso contrário, ele usa as credenciais em cache:

if (app.CurrentUser == null)
{
    // App must be online for user to authenticate
    user = await app.LogInAsync(
        Credentials.EmailPassword("caleb@mongodb.com", "MySekritPwd"));
    config = new PartitionSyncConfiguration("_part", user);
    realm = await Realm.GetInstanceAsync(config);
}
else
{
    // This works whether online or offline
    user = app.CurrentUser;
    config = new PartitionSyncConfiguration("_part", user);
    realm = Realm.GetInstance(config);
}

Desconectar um usuário

Uma vez conectado, você pode sair chamando o método LogOutAsync() :

await user.LogOutAsync();

Recuperar o usuário atual

Depois de ter um usuário autenticado, você pode recuperar o objeto Usuário com a propriedade App.CurrentUser . O objeto CurrentUser é mantido no armazenamento local, portanto, mesmo que o aplicativo seja desligado após a autenticação inicial, não é necessário chamar o LoginAsync novamente (a menos que o usuário tenha se desconectado). Em vez disso, use Realm.GetInstance(config), onde config é um objeto PartitionSyncConfiguration . Essa abordagem resulta em uma inicialização mais rápida e também permite que o usuário trabalhe offline.

// Returns a valid user access token to authenticate requests
public async Task<string> GetValidAccessToken(User user)
{
    // An already logged in user's access token might be stale. To
    // guarantee that the token is valid, refresh it.
    await user.RefreshCustomDataAsync();
    return user.AccessToken;
}

Atualize a expiração do token

A atualização dos tokens expira após um período de tempo definido. Quando o token de atualização expira, o token de acesso não pode mais ser atualizado e o usuário deve se conectar novamente.

Se o token de atualização expirar após a abertura do domínio, o dispositivo não poderá sincronizar até que o usuário faça login novamente. Seu manipulador de erros de sincronização deve implementar uma lógica que capture um erro de token expirado ao tentar sincronizar e, em seguida, redirecionar os usuários para um fluxo de login.

Para obter informações sobre como configurar a expiração do token de atualização, consulte Gerencie sessões de usuário na documentação do App Services.

Observar alterações de autenticação

Você pode observar um fluxo de eventos de alteração de autenticação chamando User.Changed() em um objeto de usuário válido.

Atualmente, User.Changed() Atlas Triggers em todos os evento de usuário e você deve adicionar um manipulador para garantir que suas respostas aos evento sejam idempotentes.

app.CurrentUser.Changed += (change, _) =>
{
    Debug.WriteLine($"Auth change: {change}, {_}");
};