Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Quản lý người dùng trong Firebase

Tạo người dùng

Bạn tạo một người dùng mới trong dự án căn cứ hỏa lực của bạn bằng cách gọi createUserWithEmailAndPassword phương pháp hoặc bằng cách đăng nhập người dùng lần đầu tiên sử dụng một nhà cung cấp danh tính liên kết, chẳng hạn như Google đăng nhập hoặc Facebook Login .

Bạn cũng có thể tạo người dùng mật khẩu xác thực mới từ phần xác thực của các căn cứ hỏa lực console , trên trang Users, hoặc bằng cách sử dụng các SDK quản trị .

Nhận người dùng hiện đã đăng nhập

Cách được đề xuất để có được người dùng hiện tại là đặt một người quan sát trên đối tượng Auth:

Phiên bản web 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
    // ...
  }
});

Phiên bản web 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
    // ...
  }
});

Bằng cách sử dụng trình quan sát, bạn đảm bảo rằng đối tượng Auth không ở trạng thái trung gian — chẳng hạn như khởi tạo — khi bạn có được người dùng hiện tại. Khi bạn sử dụng signInWithRedirect , các onAuthStateChanged chờ đợi quan sát cho đến khi getRedirectResult giải quyết trước khi kích hoạt.

Bạn cũng có thể nhận được hiện nay người dùng đăng nhập bằng cách sử dụng các currentUser tài sản. Nếu người dùng không đăng nhập, currentUser là null:

Phiên bản web 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.
}

Phiên bản web 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.
}

Nhận hồ sơ của người dùng

Để có được thông tin hồ sơ của người dùng, sử dụng các thuộc tính của một thể hiện của User . Ví dụ:

Phiên bản web 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;
}

Phiên bản web 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.getToken() instead.
  const uid = user.uid;
}

Nhận thông tin hồ sơ nhà cung cấp cụ thể của người dùng

Để có được thông tin hồ sơ lấy ra từ lần đăng nhập các nhà cung cấp liên quan đến một người sử dụng, sử dụng providerData tài sản. Ví dụ:

Phiên bản web 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);
  });
}

Phiên bản web 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);
  });
}

Cập nhật hồ sơ của người dùng

Bạn có thể cập nhật URL với tên hiển thị và ảnh hồ sơ của người dùng thông tin hồ sơ cá nhân cơ bản của người sử dụng các updateProfile phương pháp. Ví dụ:

Phiên bản web 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
  // ...
});

Phiên bản web 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
  // ...
});  

Đặt địa chỉ email của người dùng

Bạn có thể đặt địa chỉ email của người dùng với các updateEmail phương pháp. Ví dụ:

Phiên bản web 9

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

Phiên bản web 8

const user = firebase.auth().currentUser;

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

Gửi cho người dùng một email xác minh

Bạn có thể gửi một email xác minh địa chỉ cho một người dùng với sendEmailVerification phương pháp. Ví dụ:

Phiên bản web 9

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

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

Phiên bản web 8

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

Bạn có thể tùy chỉnh các mẫu email được sử dụng trong phần xác thực của các căn cứ hỏa lực console , trên Email trang mẫu. Xem Templates Email trong Trung tâm trợ giúp căn cứ hỏa lực.

Nó cũng có thể để vượt qua trạng thái thông qua một tiếp tục URL để chuyển hướng trở lại ứng dụng khi gửi email xác minh.

Ngoài ra, bạn có thể bản địa hóa email xác minh bằng cách cập nhật mã ngôn ngữ trên phiên bản Auth trước khi gửi email. Ví dụ:

Phiên bản web 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();

Phiên bản web 8

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

Đặt mật khẩu của người dùng

Bạn có thể đặt mật khẩu của người dùng với các updatePassword phương pháp. Ví dụ:

Phiên bản web 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
  // ...
});

Phiên bản web 8

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

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

Gửi email đặt lại mật khẩu

Bạn có thể gửi một email khôi phục mật khẩu cho một người dùng với sendPasswordResetEmail phương pháp. Ví dụ:

Phiên bản web 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;
    // ..
  });

Phiên bản web 8

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

Bạn có thể tùy chỉnh các mẫu email được sử dụng trong phần xác thực của các căn cứ hỏa lực console , trên Email trang mẫu. Xem Templates Email trong Trung tâm trợ giúp căn cứ hỏa lực.

Nó cũng có thể để vượt qua trạng thái thông qua một tiếp tục URL để chuyển hướng trở lại ứng dụng khi gửi email đặt lại mật khẩu.

Ngoài ra, bạn có thể bản địa hóa email đặt lại mật khẩu bằng cách cập nhật mã ngôn ngữ trên phiên bản Auth trước khi gửi email. Ví dụ:

Phiên bản web 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();

Phiên bản web 8

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

Bạn cũng có thể gửi email đặt lại mật khẩu từ bảng điều khiển Firebase.

Xóa người dùng

Bạn có thể xóa một tài khoản người dùng với delete phương pháp. Ví dụ:

Phiên bản web 9

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

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

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

Phiên bản web 8

const user = firebase.auth().currentUser;

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

Bạn cũng có thể sử dụng xóa từ phần xác thực của các căn cứ hỏa lực console , trên trang Users.

Xác thực lại người dùng

Một số hành động chẳng hạn an ninh nhạy cảm như xóa tài khoản , thiết lập một địa chỉ email chính , và thay đổi mật khẩu -require mà người dùng vừa đăng nhập. Nếu bạn thực hiện một trong những hành động này, và người sử dụng đăng nhập quá lâu trước, hành động không thành công với một lỗi. Khi điều này xảy ra, tái xác thực người dùng bằng cách đăng nhập mới thông tin từ người sử dụng và đi qua các thông tin quan trọng để reauthenticateWithCredential . Ví dụ:

Phiên bản web 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
  // ...
});

Phiên bản web 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 ocurred
  // ...
});

Nhập tài khoản người dùng

Bạn có thể nhập tài khoản người dùng từ một tập tin vào dự án căn cứ hỏa lực của bạn bằng cách sử dụng các căn cứ hỏa lực CLI của auth:import lệnh. Ví dụ:

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