Administrar usuarios en Firebase

Crear un usuario

Puedes crear un nuevo usuario en tu proyecto de Firebase de cuatro maneras:

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

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

Obtener el perfil de un 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 transmisiones authStateChanges , idTokenChanges y userChanges : sus oyentes recibirán el User actual, o null si ningún usuario está autenticado:
```
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 del 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 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 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 motivos:
- El usuario no ha iniciado sesión.
- El objeto de autenticación no ha terminado de inicializarse. Si utiliza un oyente 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, utilice la propiedad providerData . Por ejemplo:

if (user != null) {
    for (final providerProfile in user.providerData) {
        // ID of the provider (google.com, apple.com, 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 del 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 utiliza 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 continua para redirigir nuevamente 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 la contraseña de un 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 para restablecer la 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");

También es posible pasar el estado a través de una URL continua para redirigir nuevamente 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 para restablecer la contraseña desde Firebase console.

Eliminar un usuario

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

await user?.delete();

También puedes 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 demasiado tiempo, el La acción falla y genera 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 pasándolas para 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

Puedes importar cuentas de usuario desde un archivo a tu proyecto de Firebase usando el comando auth:import Firebase CLI. Por ejemplo:

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