/ /

/ /

SDK de dispositivos Atlas

SDK de Java

Administrar usuarios

Aplicaciones multiusuario - SDK de Java

Los SDK de dispositivos Atlas están obsoletos. Consulte Página de desuso para más detalles.

El SDK de Realm permite múltiples Los usuarios deben iniciar sesión simultáneamente en una aplicación en un dispositivo determinado. Las aplicaciones cliente de Realm se ejecutan en el contexto de un solo usuario activo, incluso si varios usuarios inician sesión simultáneamente. Puede cambiar rápidamente entre usuarios autenticados sin necesidad de que vuelvan a iniciar sesión.

Advertencia

Cualquier usuario que haya iniciado sesión puede convertirse en el usuario activo sin tener que volver a autenticarse. Dependiendo de la aplicación, esto podría representar una vulnerabilidad de seguridad. Por ejemplo, un usuario en un dispositivo compartido podría cambiar a la cuenta iniciada de un compañero sin proporcionar sus credenciales ni requerir su permiso explícito. Si su aplicación requiere una autenticación más estricta, evite cambiar de usuario y cierre la sesión del usuario activo explícitamente antes de autenticar a otro.

Estados de la cuenta de usuario

Cuando un usuario inicia sesión por primera vez a través de un SDK de Realm en un dispositivo o navegador, el SDK guarda su información y registra su estado en el dispositivo. Los datos del usuario permanecen en el dispositivo, incluso si cierra sesión, a menos que lo elimine activamente.

Los siguientes estados describen a un usuario en el dispositivo en un momento dado:

Autenticado: cualquier usuario que haya iniciado sesión en el dispositivo y no haya cerrado sesión o se le haya revocado la sesión.
- Activo: un único usuario autenticado que utiliza la aplicación en un dispositivo determinado. El SDK asocia este usuario con las solicitudes salientes y Atlas App Services evalúa los permisos de acceso a los datos y ejecuta funciones en su contexto. Consulte la sección "Usuario activo" para obtener más información.
- Inactivo: todos los usuarios autenticados que no son el usuario activo actual. Puede cambiar el usuario activo a inactivo en cualquier momento.
Desconectado: cualquier usuario que se autenticó en el dispositivo pero desde entonces cerró sesión o se le revocó su sesión.

El siguiente diagrama muestra cómo los usuarios dentro de una aplicación cliente de Realm pasan de un estado a otro cuando ocurren determinados eventos:

Un diagrama que describe los diferentes estados en los que puede estar un usuario: desconectado, conectado y activo, y conectado e inactivo.

Agregar un nuevo usuario al dispositivo

El SDK de Realm añade automáticamente usuarios a un dispositivo cuando inician sesión por primera vez. Al iniciar sesión, se convierte inmediatamente en usuario activo de la aplicación.

String appID = YOUR_APP_ID; // replace this with your App ID
App app = new App(new AppConfiguration.Builder(appID).build());
// Log in as Joe
Credentials joeCredentials = Credentials.emailPassword(firstUserEmail, firstUserPassword);
app.loginAsync(joeCredentials, it -> {
    if (it.isSuccess()) {
        // The active user is now Joe
        User joe = it.get();
        assert joe == app.currentUser();
    } else {
        Log.e("EXAMPLE", "Failed to log in: " + it.getError().getErrorMessage());
    }
});
// Log in as Emma
Credentials emmaCredentials = Credentials.emailPassword(secondUserEmail, secondUserPassword);
app.loginAsync(emmaCredentials, it -> {
    if (it.isSuccess()) {
        // The active user is now Emma
        User emma = it.get();
        assert emma == app.currentUser();
    } else {
        Log.e("EXAMPLE", "Failed to log in: " + it.getError().getErrorMessage());
    }
});

val appID: String = YOUR_APP_ID // replace this with your App ID
val app = App(AppConfiguration.Builder(appID).build())
// Log in as Joe
val joeCredentials = Credentials.emailPassword(firstUserEmail, firstUserPassword)
app.loginAsync(joeCredentials) {
    if (it.isSuccess) {
        // The active user is now Joe
        val joe = it.get()
        assert(joe === app.currentUser())
    } else {
        Log.e("EXAMPLE", "Failed to log in: ${it.error.errorMessage}")
    }
}
// Log in as Emma
val emmaCredentials = Credentials.emailPassword(secondUserEmail, secondUserPassword)
app.loginAsync(emmaCredentials) {
    if (it.isSuccess) {
        // The active user is now Emma
        val emma = it.get()
        assert(emma === app.currentUser())
    } else {
        Log.e("EXAMPLE", "Failed to log in: ${it.error.errorMessage}")
    }
}

Listar todos los usuarios en el dispositivo

Puede acceder a una lista de todas las cuentas de usuario almacenadas en el dispositivo. Esta lista incluye todos los usuarios que han iniciado sesión en la aplicación cliente en un dispositivo determinado, independientemente de si están autenticados.

Map<String, User> users = app.allUsers();
for (Map.Entry<String, User> user : users.entrySet()) {
    Log.v("EXAMPLE", "User: " + user.getKey());
}

val users = app.allUsers()
for ((key) in users) {
    Log.v("EXAMPLE", "User: $key")
}

Eliminar un usuario del dispositivo

Para eliminar toda la información sobre un usuario de un dispositivo, utilice user.remove() o user.removeAsync():

app.loginAsync(credentials, it -> {
    if (it.isSuccess()) {
        User user = it.get();
        user.removeAsync(result -> {
            if (result.isSuccess()) {
                Log.v("EXAMPLE", "Successfully removed user from device.");
            } else {
                Log.e("EXAMPLE", "Failed to remove user from device.");
            }
        });
    } else {
        Log.e("EXAMPLE", "Failed to log in: " + it.getError().getErrorMessage());
    }
});

app.loginAsync(credentials) {
    if (it.isSuccess) {
        val user = it.get()
        user.removeAsync { result: App.Result<User?> ->
            if (result.isSuccess) {
                Log.v("EXAMPLE",
                    "Successfully removed user from device.")
            } else {
                Log.e("EXAMPLE", "Failed to remove user from device.")
            }
        }
    } else {
        Log.e("EXAMPLE", "Failed to log in: ${it.error.errorMessage}")
    }
}

Cambiar el usuario activo

Puedes cambiar rápidamente usuario activo de la aplicación a otro usuario con sesión iniciada en cualquier momento.

// Joe is already logged in and is the currently active user
User joe = app.currentUser();
// Log in as Emma
Credentials emmaCredentials = Credentials.emailPassword(secondUserEmail, secondUserPassword);
app.loginAsync(emmaCredentials, result -> {
    if (result.isSuccess()) {
        // The active user is now Emma
        User emma = result.get();
        assert emma == app.currentUser();
        // Switch active user back to Joe
        app.switchUser(joe);
        assert joe == app.currentUser();
    } else {
        Log.e("EXAMPLE", "Failed to log in: " + result.getError().getErrorMessage());
    }
});

// Joe is already logged in and is the currently active user
val joe = app.currentUser()
// Log in as Emma
val emmaCredentials = Credentials.emailPassword(
    secondUserEmail,
    secondUserPassword
)
app.loginAsync(emmaCredentials) { result ->
    if (result.isSuccess) {
        // The active user is now Emma
        val emma = result.get()
        assert(emma === app.currentUser())
        // Switch active user back to Joe
        app.switchUser(joe)
        assert(joe === app.currentUser())
    } else {
        Log.e("EXAMPLE", "Failed to log in: ${result.error.errorMessage}")
    }
}

Volver

Administrar usuarios de correo electrónico y contraseña

Vincular identidades de usuario