Как пройти аутентификацию в Firebase с помощью аккаунтов на основе пароля, используя JavaScript

Вы можете использовать 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.

Подготовка

  1. Добавьте Firebase в свой проект JavaScript.
  2. Если вы ещё не подключили приложение к проекту Firebase, сделайте это в консоли Firebase.
  3. Включите вход по адресу электронной почты и паролю в проекте Firebase:
    1. В консоли Firebase выберите Безопасность > Аутентификация.
    2. На вкладке Sign-in method (Способ входа) включите поставщика входа Email/password (Электронная почта/пароль).
    3. Нажмите Сохранить.

Создайте аккаунт с паролем

Чтобы создать аккаунт нового пользователя с паролем, выполните следующие действия на странице регистрации в приложении:

  1. Когда новый пользователь регистрируется в приложении, выполните все необходимые шаги по проверке аккаунта, например убедитесь, что пароль введен правильно и соответствует требованиям к сложности.
  2. Создайте аккаунт, передав адрес электронной почты и пароль нового пользователя в 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;
        // ..
      });
    Если аккаунт создан, вход в него выполняется автоматически. Чтобы получить сведения о пользователе, выполнившем вход, ознакомьтесь с разделом "Дальнейшие действия" ниже.

    Здесь же можно отслеживать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по Auth.

Как выполнить вход пользователя с помощью адреса электронной почты и пароля

Процедура входа пользователя с паролем аналогична процедуре создания нового аккаунта. На странице входа в приложение выполните следующие действия:

  1. Когда пользователь входит в приложение, передайте его адрес электронной почты и пароль в 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;
      });
    Чтобы получить сведения о пользователе, выполнившем вход, ознакомьтесь с разделом "Дальнейшие действия" ниже.

    Здесь же можно отслеживать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по Auth.

Рекомендуется: настройте правила для паролей

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

Чтобы настроить правила для паролей в проекте, откройте раздел Правила для паролей на вкладке Безопасность > Аутентификация > Настройки в консоли 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.
});