Autenticar usuarios - SDK .NET

Inicia sesión

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));

Inicio de sesión sin conexión

Cuando tu aplicación Realm autentica a un usuario, almacena en caché las credenciales del usuario. Puedes comprobar si existen credenciales de usuario para omitir el flujo de inicio de sesión y acceder al usuario almacenado en caché. Usa esto para abrir un realm sin conexión.

El siguiente ejemplo comprueba si hay un objeto Usuario en caché. De no ser así, inicia la sesión del usuario. De lo contrario, utiliza las credenciales en caché:

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

Cerrar la sesión de un usuario

Una vez que haya iniciado sesión, puede cerrar sesión llamando al método LogOutAsync():

await user.LogOutAsync();

Recuperar el usuario actual

Una vez que tenga un usuario autenticado, puede recuperar el objeto Usuario con la propiedad App.CurrentUser. El CurrentUser objeto se almacena localmente, por lo que, incluso si la aplicación se cierra después de la autenticación inicial, no es necesario volver a llamar LoginAsync a (a menos que el usuario haya cerrado sesión). En su lugar, utilice Realm.GetInstance(config), donde config es un objeto PartitionSyncConfiguration. Este enfoque acelera el inicio y permite al usuario trabajar sin conexión.

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

Vencimiento del token de actualización

Los tokens de actualización caducan tras un periodo determinado. Cuando caducan, el token de acceso ya no se puede actualizar y el usuario debe volver a iniciar sesión.

Si el token de actualización caduca después de abrir el dominio, el dispositivo no podrá sincronizarse hasta que el usuario vuelva a iniciar sesión. El controlador de errores de sincronización debe implementar una lógica que detecte un error de token caducado al intentar sincronizar y luego redirija a los usuarios a un flujo de inicio de sesión.

Para obtener información sobre cómo configurar la expiración del token de actualización, consulte Administrar sesiones de usuario en la documentación de App Services.

Observar los cambios de autenticación

Puede observar un flujo de eventos de cambio de autenticación llamando a User.Changed() en un objeto de usuario válido.

Actualmente, User.Changed() se activa en todos los eventos de usuario y debes agregar un controlador para garantizar que tus respuestas a los eventos sean idempotentes.

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