Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Administrar usuarios en Firebase

crear un usuario

Para crear un nuevo usuario en su proyecto de Firebase, llame al método createUserWithEmailAndPassword o inicie sesión en un usuario por primera vez con un proveedor de identidad federado, como el inicio de sesión de Google o el inicio de sesión de Facebook .

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

Obtener el usuario que ha iniciado sesión actualmente

La forma recomendada de obtener el usuario actual es establecer un observador en el objeto Auth:

Web version 9

import { getAuth, onAuthStateChanged } from "firebase/auth";

const auth = getAuth();
onAuthStateChanged(auth, (user) => {
  if (user) {
    // User is signed in, see docs for a list of available properties
    // https://firebase.google.com/docs/reference/js/firebase.User
    const uid = user.uid;
    // ...
  } else {
    // User is signed out
    // ...
  }
});

Web version 8

firebase.auth().onAuthStateChanged((user) => {
  if (user) {
    // User is signed in, see docs for a list of available properties
    // https://firebase.google.com/docs/reference/js/firebase.User
    var uid = user.uid;
    // ...
  } else {
    // User is signed out
    // ...
  }
});

Al usar un observador, se asegura de que el objeto Auth no esté en un estado intermedio, como la inicialización, cuando obtiene el usuario actual. Cuando usa signInWithRedirect , el observador onAuthStateChanged espera hasta getRedirectResult resuelva antes de activarse.

También puede obtener el usuario que ha iniciado sesión actualmente mediante la propiedad currentUser . Si un usuario no ha iniciado sesión, currentUser es nulo:

Web version 9

import { getAuth } from "firebase/auth";

const auth = getAuth();
const user = auth.currentUser;

if (user) {
  // User is signed in, see docs for a list of available properties
  // https://firebase.google.com/docs/reference/js/firebase.User
  // ...
} else {
  // No user is signed in.
}

Web version 8

const user = firebase.auth().currentUser;

if (user) {
  // User is signed in, see docs for a list of available properties
  // https://firebase.google.com/docs/reference/js/firebase.User
  // ...
} else {
  // No user is signed in.
}

Obtener un perfil de usuario

Para obtener la información del perfil de un usuario, use las propiedades de una instancia de User . Por ejemplo:

Web version 9

import { getAuth } from "firebase/auth";

const auth = getAuth();
const user = auth.currentUser;
if (user !== null) {
  // The user object has basic properties such as display name, email, etc.
  const displayName = user.displayName;
  const email = user.email;
  const photoURL = user.photoURL;
  const emailVerified = user.emailVerified;

  // The user's ID, unique to the Firebase project. Do NOT use
  // this value to authenticate with your backend server, if
  // you have one. Use User.getToken() instead.
  const uid = user.uid;
}

Web version 8

const user = firebase.auth().currentUser;
if (user !== null) {
  // The user object has basic properties such as display name, email, etc.
  const displayName = user.displayName;
  const email = user.email;
  const photoURL = user.photoURL;
  const emailVerified = user.emailVerified;

  // The user's ID, unique to the Firebase project. Do NOT use
  // this value to authenticate with your backend server, if
  // you have one. Use User.getIdToken() instead.
  const uid = user.uid;
}

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:

Web version 9

import { getAuth } from "firebase/auth";

const auth = getAuth();
const user = auth.currentUser;

if (user !== null) {
  user.providerData.forEach((profile) => {
    console.log("Sign-in provider: " + profile.providerId);
    console.log("  Provider-specific UID: " + profile.uid);
    console.log("  Name: " + profile.displayName);
    console.log("  Email: " + profile.email);
    console.log("  Photo URL: " + profile.photoURL);
  });
}

Web version 8

const user = firebase.auth().currentUser;

if (user !== null) {
  user.providerData.forEach((profile) => {
    console.log("Sign-in provider: " + profile.providerId);
    console.log("  Provider-specific UID: " + profile.uid);
    console.log("  Name: " + profile.displayName);
    console.log("  Email: " + profile.email);
    console.log("  Photo URL: " + profile.photoURL);
  });
}

Actualizar el perfil de un usuario

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

Web version 9

import { getAuth, updateProfile } from "firebase/auth";
const auth = getAuth();
updateProfile(auth.currentUser, {
  displayName: "Jane Q. User", photoURL: "https://example.com/jane-q-user/profile.jpg"
}).then(() => {
  // Profile updated!
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});

Web version 8

const user = firebase.auth().currentUser;

user.updateProfile({
  displayName: "Jane Q. User",
  photoURL: "https://example.com/jane-q-user/profile.jpg"
}).then(() => {
  // Update successful
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});  

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:

Web version 9

import { getAuth, updateEmail } from "firebase/auth";
const auth = getAuth();
updateEmail(auth.currentUser, "user@example.com").then(() => {
  // Email updated!
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});

Web version 8

const user = firebase.auth().currentUser;

user.updateEmail("user@example.com").then(() => {
  // Update successful
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});

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:

Web version 9

import { getAuth, sendEmailVerification } from "firebase/auth";

const auth = getAuth();
sendEmailVerification(auth.currentUser)
  .then(() => {
    // Email verification sent!
    // ...
  });

Web version 8

firebase.auth().currentUser.sendEmailVerification()
  .then(() => {
    // Email verification sent!
    // ...
  });

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:

Web version 9

import { getAuth } from "firebase/auth";

const auth = getAuth();
auth.languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();

Web version 8

firebase.auth().languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();

Establecer una contraseña de usuario

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

Web version 9

import { getAuth, updatePassword } from "firebase/auth";

const auth = getAuth();

const user = auth.currentUser;
const newPassword = getASecureRandomPassword();

updatePassword(user, newPassword).then(() => {
  // Update successful.
}).catch((error) => {
  // An error ocurred
  // ...
});

Web version 8

const user = firebase.auth().currentUser;
const newPassword = getASecureRandomPassword();

user.updatePassword(newPassword).then(() => {
  // Update successful.
}).catch((error) => {
  // An error ocurred
  // ...
});

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:

Web version 9

import { getAuth, sendPasswordResetEmail } from "firebase/auth";

const auth = getAuth();
sendPasswordResetEmail(auth, email)
  .then(() => {
    // Password reset email sent!
    // ..
  })
  .catch((error) => {
    const errorCode = error.code;
    const errorMessage = error.message;
    // ..
  });

Web version 8

firebase.auth().sendPasswordResetEmail(email)
  .then(() => {
    // Password reset email sent!
    // ..
  })
  .catch((error) => {
    var errorCode = error.code;
    var errorMessage = error.message;
    // ..
  });

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:

Web version 9

import { getAuth } from "firebase/auth";

const auth = getAuth();
auth.languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();

Web version 8

firebase.auth().languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();

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 de delete . Por ejemplo:

Web version 9

import { getAuth, deleteUser } from "firebase/auth";

const auth = getAuth();
const user = auth.currentUser;

deleteUser(user).then(() => {
  // User deleted.
}).catch((error) => {
  // An error ocurred
  // ...
});

Web version 8

const user = firebase.auth().currentUser;

user.delete().then(() => {
  // User deleted.
}).catch((error) => {
  // An error ocurred
  // ...
});

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 con un error. Cuando esto suceda, vuelva a autenticar al usuario obteniendo nuevas credenciales de inicio de sesión del usuario y pasándolas a reauthenticateWithCredential . Por ejemplo:

Web version 9

import { getAuth, reauthenticateWithCredential } from "firebase/auth";

const auth = getAuth();
const user = auth.currentUser;

// TODO(you): prompt the user to re-provide their sign-in credentials
const credential = promptForCredentials();

reauthenticateWithCredential(user, credential).then(() => {
  // User re-authenticated.
}).catch((error) => {
  // An error ocurred
  // ...
});

Web version 8

const user = firebase.auth().currentUser;

// TODO(you): prompt the user to re-provide their sign-in credentials
const credential = promptForCredentials();

user.reauthenticateWithCredential(credential).then(() => {
  // User re-authenticated.
}).catch((error) => {
  // An error occurred
  // ...
});

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