Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Управление пользователями в Firebase

Создать пользователя

Вы можете создать нового пользователя в проекте Firebase, вызвав createUserWithEmailAndPassword метод или войдя в пользователь в первый раз с помощью федеративного провайдера идентификации, таких как Google для входа в систему или Facebook Войти .

Вы также можете создать новый пароль , прошедших проверку подлинности пользователей в разделе Проверка подлинности Firebase консоли , на странице пользователей, или с помощью администратора SDK .

Получить текущего пользователя, вошедшего в систему

Рекомендуемый способ получить текущего пользователя - установить наблюдателя на объект Auth:

Веб-версия 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
    // ...
  }
});

Веб-версия 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
    // ...
  }
});

Используя наблюдателя, вы гарантируете, что объект Auth не находится в промежуточном состоянии - таком как инициализация - когда вы получаете текущего пользователя. Когда вы используете signInWithRedirect , то onAuthStateChanged ждет наблюдателя до getRedirectResult решает перед запуском.

Вы также можете получить в настоящее время зарегистрированы пользователем с помощью currentUser свойства. Если пользователь не вошел в систему , currentUser равно нулю:

Веб-версия 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.
}

Веб-версия 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.
}

Получить профиль пользователя

Чтобы получить информацию о профиле пользователя, использовать свойство экземпляра User . Например:

Веб-версия 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;
}

Веб-версия 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;
}

Получите информацию о профиле пользователя, зависящую от провайдера

Для того, чтобы получить информацию о профиле , извлеченной из знака в поставщиках , связанных с пользователем, используйте providerData свойство. Например:

Веб-версия 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);
  });
}

Веб-версия 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);
  });
}

Обновить профиль пользователя

Вы можете обновить пользователя информации в основной профиль пользователя Отображаемое имя и фото в профиле URL-с updateProfile методом. Например:

Веб-версия 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
  // ...
});

Веб-версия 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
  // ...
});  

Установите адрес электронной почты пользователя

Вы можете установить адрес электронной почты пользователя с updateEmail методом. Например:

Веб-версия 9

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

Веб-версия 8

const user = firebase.auth().currentUser;

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

Отправить пользователю письмо с подтверждением

Вы можете отправить адрес проверочное письмо пользователю с sendEmailVerification методом. Например:

Веб-версия 9

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

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

Веб-версия 8

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

Вы можете настроить шаблон электронной почты , который используется в разделе Проверка подлинности Firebase консоли , на странице Шаблоны электронной почты. См Email шаблоны в Firebase справочном центре.

Также можно пройти через состояние продолжить URL для перенаправления обратно в приложение при отправке подтверждения по электронной почте.

Кроме того, вы можете локализовать письмо с подтверждением, обновив код языка в экземпляре Auth перед отправкой электронного письма. Например:

Веб-версия 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();

Веб-версия 8

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

Установите пароль пользователя

Вы можете установить пароль пользователя с updatePassword методом. Например:

Веб-версия 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
  // ...
});

Веб-версия 8

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

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

Отправить электронное письмо для сброса пароля

Вы можете отправить по электронной почте для сброса пароля для пользователя с sendPasswordResetEmail методом. Например:

Веб-версия 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;
    // ..
  });

Веб-версия 8

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

Вы можете настроить шаблон электронной почты , который используется в разделе Проверка подлинности Firebase консоли , на странице Шаблоны электронной почты. См Email шаблоны в Firebase справочном центре.

Также можно пройти через состояние продолжить URL для перенаправления обратно в приложение при отправке по электронной почте для сброса пароля.

Кроме того, вы можете локализовать электронное письмо для сброса пароля, обновив код языка в экземпляре Auth перед отправкой электронного письма. Например:

Веб-версия 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();

Веб-версия 8

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

Вы также можете отправлять электронные письма для сброса пароля из консоли Firebase.

Удалить пользователя

Вы можете удалить учетную запись пользователя с delete метода. Например:

Веб-версия 9

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

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

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

Веб-версия 8

const user = firebase.auth().currentUser;

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

Вы можете также удалять пользователей из раздела Проверка подлинности Firebase консоли , на странице Users.

Повторно аутентифицировать пользователя

Некоторые безопасности чувствительных действия, такие как удаление учетной записи , установив основной адрес электронной почты , и изменение пароля -require , что пользователь недавно подписанные в. Если выполнить один из этих действий, и пользователь вошел в слишком давно, действие завершается ошибкой. Когда это происходит, повторно проверить подлинность пользователя, получая новые регистрационные данные от пользователя и передавая полномочия для reauthenticateWithCredential . Например:

Веб-версия 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
  // ...
});

Веб-версия 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
  // ...
});

Импортировать учетные записи пользователей

Вы можете импортировать учетные записи пользователей из файла в проект Firebase, используя в Firebase CLI по auth:import команды. Например:

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