С помощью Firebase Authentication можно разрешить пользователям выполнять аутентификацию в Firebase, используя адреса электронной почты и пароли, а также управлять аккаунтами на основе паролей в приложении.
Запрос к ИИ для получения помощи
Чтобы получить помощь от ИИ, скопируйте запрос ниже в ИИ-агента программирования (например, Antigravity, Claude Code, Codex или Cursor). Вы можете изменить запрос и попросить агента переделать изображение. Подробную информацию об установке можно найти в разделе Навыки агента Firebase.
Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up and use Firebase Authentication with email and password authentication in my app.
Подготовка
- Добавьте Firebase в свой проект JavaScript.
- Если вы ещё не подключили приложение к проекту Firebase, сделайте это в консоли Firebase.
-
Включите в проекте Firebase вход с адресом электронной почты и паролем:
- В консоли Firebase выберите Безопасность > Аутентификация.
- На вкладке Sign-in method (Способ входа) включите поставщика Email/password (Электронная почта/пароль).
- Нажмите Сохранить.
Как создать аккаунт с паролем
Чтобы создать новый аккаунт с паролем, выполните следующие действия на странице регистрации в приложении:
- Когда новый пользователь регистрируется с помощью формы в вашем приложении, выполните все необходимые шаги для проверки нового аккаунта, например убедитесь, что пароль введен правильно и соответствует требованиям к сложности.
- Создайте новый аккаунт, передав адрес электронной почты и пароль нового пользователя в
createUserWithEmailAndPassword:Если новый аккаунт был создан, пользователь автоматически входит в него. Чтобы получить информацию о пользователе, выполните инструкции из раздела "Дальнейшие действия" ниже.Web
import { getAuth, createUserWithEmailAndPassword } from "firebase/auth"; const auth = getAuth(); createUserWithEmailAndPassword(auth, email, password) .then((userCredential) => { // Signed up const user = userCredential.user; // ... }) .catch((error) => { const errorCode = error.code; const errorMessage = error.message; // .. });
Web
firebase.auth().createUserWithEmailAndPassword(email, password) .then((userCredential) => { // Signed in var user = userCredential.user; // ... }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; // .. });
Здесь же можно выявлять и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по аутентификации.
Как войти в аккаунт с помощью адреса электронной почты и пароля
Шаги для входа пользователя с паролем похожи на шаги для создания нового аккаунта. На странице входа в приложение выполните следующие действия:
- Когда пользователь входит в ваше приложение, передайте его адрес электронной почты и пароль в
signInWithEmailAndPassword:Чтобы получить информацию о пользователе, выполните инструкции из раздела "Дальнейшие действия" ниже.Web
import { getAuth, signInWithEmailAndPassword } from "firebase/auth"; const auth = getAuth(); signInWithEmailAndPassword(auth, email, password) .then((userCredential) => { // Signed in const user = userCredential.user; // ... }) .catch((error) => { const errorCode = error.code; const errorMessage = error.message; });
Web
firebase.auth().signInWithEmailAndPassword(email, password) .then((userCredential) => { // Signed in var user = userCredential.user; // ... }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; });
Здесь же можно выявлять и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по аутентификации.
Рекомендуется: задайте правила для паролей
Вы можете повысить безопасность аккаунта, введя обязательные критерии сложности паролей.
Чтобы настроить правила в отношении паролей для проекта, откройте раздел Правила в отношении паролей на вкладке Безопасность > Аутентификация > Настройки консоли Firebase:
Firebase Authentication поддерживает следующие требования к паролям:
Требуется строчная буква
Требуется заглавная буква
Требуется цифра
Требуется символ, не являющийся буквой или цифрой
К символам, не являющимся буквами или цифрами, относятся:
^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~Минимальная длина пароля (от 6 до 30 символов; по умолчанию – 6)
Максимальная длина пароля (максимум 4096 символов).
Применение правил в отношении паролей можно включить в двух режимах:
Требовать. Пользователь не может зарегистрироваться, пока не изменит пароль на соответствующий критериям.
Уведомление. Пользователь может зарегистрироваться с паролем, не соответствующим требованиям. В этом режиме вам нужно проверить, соответствует ли пароль пользователя правилам на стороне клиента, и предложить пользователю обновить пароль, если он не соответствует правилам.
Новые пользователи всегда должны выбирать пароль, соответствующий вашим правилам.
Если у вас есть активные пользователи, мы рекомендуем не включать принудительное обновление при входе, если вы не планируете блокировать доступ пользователям, чьи пароли не соответствуют правилам. Вместо этого используйте режим уведомлений, который позволяет пользователям входить в систему с текущими паролями и сообщает им о требованиях, которым не соответствует их пароль.
Проверка пароля на стороне клиента
import { getAuth, validatePassword } from "firebase/auth";
const status = await validatePassword(getAuth(), passwordFromUser);
if (!status.isValid) {
// Password could not be validated. Use the status to show what
// requirements are met and which are missing.
// If a criterion is undefined, it is not required by policy. If the
// criterion is defined but false, it is required but not fulfilled by
// the given password. For example:
const needsLowerCase = status.containsLowercaseLetter !== true;
}
Рекомендуется включить защиту от перечисления адресов электронной почты
Некоторые методы Firebase Authentication, которые принимают адреса электронной почты в качестве параметров, выдают определенные ошибки, если адрес электронной почты не зарегистрирован, когда он должен быть зарегистрирован (например, при входе с использованием адреса электронной почты и пароля), или зарегистрирован, когда он должен быть неиспользованным (например, при изменении адреса электронной почты пользователя). Это может быть полезно для предоставления пользователям конкретных рекомендаций, но злоумышленники могут использовать эту функцию, чтобы узнавать адреса электронной почты, зарегистрированные вашими пользователями.
Чтобы снизить этот риск, рекомендуем включить защиту от перечисления адресов электронной почты для вашего проекта. Проверить эту настройку можно в консоли Firebase: выберите Безопасность > Аутентификация > вкладка Настройки и нажмите Действия пользователя.
Обратите внимание, что при включении этой функции меняется поведение при регистрации ошибок для Firebase Authentication, поэтому убедитесь, что ваше приложение не полагается на более конкретные ошибки.
Дальнейшие действия
После первого входа пользователя создается новый аккаунт, связанный с учетными данными, которые он использовал (именем пользователя и паролем, номером телефона или информацией поставщика услуг аутентификации). Этот новый аккаунт хранится в проекте Firebase и позволяет идентифицировать пользователя во всех приложениях проекта независимо от того, как он вошел в аккаунт.
-
В приложениях рекомендуется отслеживать статус аутентификации пользователя, установив наблюдатель для объекта
Auth. Затем вы можете получить основную информацию о профиле пользователя из объектаUser. Подробнее о том, как управлять пользователями… В Firebase Realtime Database и Cloud Storage правилах безопасности можно получить уникальный идентификатор пользователя, выполнившего вход, из переменной
authи использовать его, чтобы контролировать, к каким данным у пользователя есть доступ.
Вы можете разрешить пользователям входить в ваше приложение, используя несколько поставщиков услуг аутентификации, связав учетные данные поставщика услуг аутентификации с существующим аккаунтом пользователя.
Чтобы выйти из аккаунта пользователя, вызовите функцию
signOut:
Web
import { getAuth, signOut } from "firebase/auth"; const auth = getAuth(); signOut(auth).then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });
Web
firebase.auth().signOut().then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });