Descubre las novedades de Firebase en Google I/O 2022. Más información

Administrar usuarios en Firebase

crear un usuario

Puede crear un nuevo usuario en su proyecto de Firebase de cuatro maneras:

  • Llame al método createUserWithEmailAndPassword() .
  • Inicie sesión con un usuario por primera vez mediante un proveedor de identidad federado , como el inicio de sesión de Google, el inicio de sesión de Facebook o Apple.

También puede crear nuevos usuarios autenticados con contraseña desde la sección Autenticación de Firebase console , en la página Usuarios.

Obtener un perfil de usuario

Para obtener la información del perfil de un usuario, utilice las propiedades de User . Hay tres formas de obtener un objeto User que represente al usuario actual:

  • Las authStateChanges , idTokenChanges y userChanges : sus oyentes recibirán el User actual, o null si no se autentica ningún usuario:

    FirebaseAuth.instance
      .authStateChanges()
      .listen((User? user) {
        if (user != null) {
          print(user.uid);
        }
      });
    

    Cuando se inicia la aplicación, se activa un evento después de que se hayan restaurado las credenciales del usuario (si las hay) del almacenamiento local, lo que significa que siempre se llama a sus oyentes cuando se inicializa el estado del usuario. Luego, cada vez que cambie el estado de autenticación, se generará un nuevo evento con el estado de usuario actualizado.

    Al escuchar el estado de autenticación, puede crear una interfaz de usuario que reaccione a estos cambios en el estado de autenticación.

  • El objeto UserCredential devuelto por los métodos de autenticación ( signIn -): el objeto UserCredential tiene una propiedad de user con el User actual:

    final userCredential =
        await FirebaseAuth.instance.signInWithCredential(credential);
    final user = userCredential.user;
    print(user?.uid);
    
  • La propiedad currentUser de la instancia de FirebaseAuth : si está seguro de que el usuario ha iniciado sesión actualmente, puede acceder al User desde la propiedad currentUser :

    if (FirebaseAuth.instance.currentUser != null) {
      print(FirebaseAuth.instance.currentUser?.uid);
    }
    

    El currentUser puede ser null por dos razones:

    • El usuario no ha iniciado sesión.
    • El objeto de autenticación no ha terminado de inicializarse. Si usa un agente de escucha para realizar un seguimiento del estado de inicio de sesión del usuario, no necesita manejar este caso.

Obtener la información de perfil específica del proveedor de un usuario

Para obtener la información del perfil recuperada de los proveedores de inicio de sesión vinculados a un usuario, use la propiedad providerData . Por ejemplo:

if (user != null) {
    for (final providerProfile in user.providerData) {
        // ID of the provider (google.com, apple.cpm, etc.)
        final provider = providerProfile.providerId;

        // UID specific to the provider
        final uid = providerProfile.uid;

        // Name, email address, and profile photo URL
        final name = providerProfile.displayName;
        final emailAddress = providerProfile.email;
        final profilePhoto = providerProfile.photoURL;
    }
}

Actualizar el perfil de un usuario

Puede actualizar la información básica del perfil de un usuario (el nombre para mostrar del usuario y la URL de la foto de perfil) con los métodos de update . Por ejemplo:

await user?.updateDisplayName("Jane Q. User");
await user?.updatePhotoURL("https://example.com/jane-q-user/profile.jpg");

Establecer la dirección de correo electrónico de un usuario

Puede configurar la dirección de correo electrónico de un usuario con el método updateEmail() . Por ejemplo:

await user?.updateEmail("janeq@example.com");

Enviar a un usuario un correo electrónico de verificación

Puede enviar un correo electrónico de verificación de dirección a un usuario con el método sendEmailVerification() . Por ejemplo:

await user?.sendEmailVerification();

Puede personalizar la plantilla de correo electrónico que se usa en la sección Autenticación de Firebase console , en la página Plantillas de correo electrónico. Consulte Plantillas de correo electrónico en el Centro de ayuda de Firebase.

También es posible pasar el estado a través de una URL de continuación para redirigir de nuevo a la aplicación al enviar un correo electrónico de verificación.

Además, puede localizar el correo electrónico de verificación actualizando el código de idioma en la instancia de autenticación antes de enviar el correo electrónico. Por ejemplo:

await FirebaseAuth.instance.setLanguageCode("fr");
await user?.sendEmailVerification();

Establecer una contraseña de usuario

Puede establecer la contraseña de un usuario con el método updatePassword() . Por ejemplo:

await user?.updatePassword(newPassword);

Enviar un correo electrónico de restablecimiento de contraseña

Puede enviar un correo electrónico de restablecimiento de contraseña a un usuario con el método sendPasswordResetEmail() . Por ejemplo:

await FirebaseAuth.instance
    .sendPasswordResetEmail(email: "user@example.com");

Puede personalizar la plantilla de correo electrónico que se usa en la sección Autenticación de Firebase console , en la página Plantillas de correo electrónico. Consulte Plantillas de correo electrónico en el Centro de ayuda de Firebase.

También es posible pasar el estado a través de una URL de continuación para redirigir de nuevo a la aplicación al enviar un correo electrónico de restablecimiento de contraseña.

Además, puede localizar el correo electrónico de restablecimiento de contraseña actualizando el código de idioma en la instancia de autenticación antes de enviar el correo electrónico. Por ejemplo:

await FirebaseAuth.instance.setLanguageCode("fr");

También puede enviar correos electrónicos de restablecimiento de contraseña desde la consola de Firebase.

Eliminar un usuario

Puede eliminar una cuenta de usuario con el método delete() . Por ejemplo:

await user?.delete();

También puede eliminar usuarios desde la sección Autenticación de Firebase console , en la página Usuarios.

Volver a autenticar a un usuario

Algunas acciones sensibles a la seguridad, como eliminar una cuenta , configurar una dirección de correo electrónico principal y cambiar una contraseña , requieren que el usuario haya iniciado sesión recientemente. Si realiza una de estas acciones y el usuario inició sesión hace mucho tiempo, el la acción falla y lanza una FirebaseAuthException con el código requires-recent-login . Cuando esto suceda, vuelva a autenticar al usuario obteniendo nuevas credenciales de inicio de sesión del usuario y transmitiendo las credenciales para volver a reauthenticate . Por ejemplo:

// Prompt the user to re-provide their sign-in credentials.
// Then, use the credentials to reauthenticate:
await user?.reauthenticateWithCredential(credential);

Importar cuentas de usuario

Puede importar cuentas de usuario desde un archivo a su proyecto de Firebase mediante el comando auth:import de Firebase CLI. Por ejemplo:

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14