Para acceder a Atlas App Services y usar Atlas Device Sync con el SDK de Flutter de Realm, primero debe autenticar a un usuario con un proveedor de autenticación de App Services.
Para obtener más información sobre cómo configurar la autenticación de App Services, consulte Autenticación de servicios de aplicaciones en la documentación de Atlas App Services.
Crear y eliminar usuarios
Para todos los proveedores de autenticación que no sean de correo electrónico y contraseña, App Services registra automáticamente al usuario la primera vez que se autentica. Al usar el proveedor de autenticación de correo electrónico y contraseña, debe registrar al usuario manualmente. Si un usuario se autentica mediante más de un método, puede vincular estas identidades a un único objeto de usuario.
También puedes eliminar usuarios. Al eliminar un usuario, se eliminan los metadatos asociados a él de App Services, pero no se eliminan los datos introducidos por el usuario del backend.
Tip
Requisitos para eliminar una cuenta de Apple
Apple exige que las aplicaciones que se enumeran a través de su App StoreDebe dar a cualquier usuario que cree una cuenta la opción de eliminarla. Tanto si utiliza un método de autenticación que requiere el registro manual de un usuario, como la autenticación por correo electrónico y contraseña, como uno que crea un usuario automáticamente, como Iniciar sesión con Apple, debe implementar la eliminación de cuentas de usuario antes del de junio 30 2022del.
Conectar y desconectar usuarios
Utilice uno o más proveedores de autenticación para iniciar y cerrar la sesión de los usuarios en su aplicación cliente. Puede:
Inicie sesión a los usuarios con una cuenta social existente, como Apple, Facebook o Google.
Crea nuevas cuentas de usuario con la gestión de correo electrónico/contraseña de Servicios de aplicación, o con tu propia función personalizada o la gestión personalizada de usuarios JWT.
Permita que los usuarios anónimos puedan acceder a su aplicación de Servicios de aplicaciones sin conservar los datos del usuario.
Cuando tengas un usuario conectado, podrás:
Abrir un reino sincronizado con el objeto de configuración del usuario
Ejecutar una función de backend como el usuario que inició sesión
Cambiar el usuario activo en una aplicación multiusuario
Eliminar un usuario del dispositivo
Al iniciar sesión correctamente, el SDK de Flutter almacena las credenciales en caché en el dispositivo. Puedes omitir el proceso de inicio de sesión y acceder al usuario almacenado en caché. Úsalo para abrir un dominio o llamar a una función Atlas al abrir la aplicación.
Objeto de usuario
App Services administra sesiones con tokens de acceso y tokens de actualización. Los SDK de cliente proporcionan la lógica para administrar los tokens y proporcionarles solicitudes.
Realm utiliza tokens de actualización para actualizar automáticamente el token de acceso de un usuario cuando caduca. Sin embargo, Realm no actualiza automáticamente el token de actualización. Cuando caduca, el SDK ya no puede obtener un token de acceso actualizado y el dispositivo no puede sincronizarse hasta que el usuario vuelva a iniciar sesión.
Para obtener más información sobre cómo administrar sesiones de usuario y tokens, consulte Sesiones de usuario en la documentación de App Services.
Algunos proveedores de autenticación permiten a los desarrolladores acceder a metadatos de usuario, como el nombre completo o la dirección de correo electrónico. Al configurar estos campos de metadatos en la aplicación de App Services, podrá leerlos desde su aplicación cliente.
Para obtener más información sobre el objeto de usuario que App Services proporciona al SDK de Flutter, consulta la siguiente documentación:
Objetos de usuario en la documentación de App Services.
Metadatos de usuario en la documentación del SDK de Flutter.
Usuario en la documentación de referencia del SDK de Flutter.
Escuchar cambios del usuario
Puede escuchar y reaccionar ante los cambios en una instancia de usuario. Por ejemplo, recibir notificaciones cuando cambia el estado de un usuario o se actualiza su token de acceso.
Para obtener más información, consulte Registrar un detector de cambios de instancia de usuario.
Datos de usuario personalizados
Puede asociar datos personalizados a un usuario, como su idioma preferido o zona horaria local, y leerlos desde su aplicación cliente. Para obtener más información sobre cómo trabajar con datos de usuario personalizados, consulte Datos de usuario personalizados.