Аутентификация в Firebase анонимно с использованием JavaScript

С помощью Firebase Authentication можно создавать и использовать временные анонимные учетные записи для аутентификации в Firebase. Эти временные анонимные учетные записи позволяют пользователям, еще не зарегистрировавшимся в вашем приложении, работать с данными, защищенными правилами безопасности. Если анонимный пользователь решит зарегистрироваться в вашем приложении, вы можете связать его учетные данные для входа с анонимной учетной записью , чтобы он мог продолжать работать со своими защищенными данными в будущих сессиях.

Прежде чем начать

1. Добавьте Firebase в свой JavaScript-проект .
2. Если вы еще не подключили свое приложение к проекту Firebase, сделайте это через консоль Firebase .
3. Включить анонимную аутентификацию:
   1. В консоли Firebase откройте раздел «Аутентификация» .
   2. На странице «Способы входа» включите анонимный способ входа.
      Совет: Если вы предпочитаете использовать Firebase CLI , выполните команду firebase init auth для настройки поставщиков аутентификации, а затем команду firebase deploy --only auth для развертывания изменений в вашем проекте.
   3. Необязательно : Если вы обновили свой проект до Firebase Authentication with Identity Platform , вы можете включить автоматическую очистку. При включении этой настройки анонимные учетные записи старше 30 дней будут автоматически удаляться. В проектах с включенной автоматической очисткой анонимная аутентификация больше не будет учитываться в лимитах использования или платежных квотах. См. раздел «Автоматическая очистка» .

Аутентификация с помощью Firebase анонимно

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

1. Вызовите метод signInAnonymously :

   Web

   import { getAuth, signInAnonymously } from "firebase/auth";
   
   const auth = getAuth();
   signInAnonymously(auth)
     .then(() => {
       // Signed in..
     })
     .catch((error) => {
       const errorCode = error.code;
       const errorMessage = error.message;
       // ...
     });
   auth_anon_sign_in.js

   Web

   firebase.auth().signInAnonymously()
     .then(() => {
       // Signed in..
     })
     .catch((error) => {
       var errorCode = error.code;
       var errorMessage = error.message;
       // ...
     });
   anonymous.js

   Здесь же вы можете перехватывать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по аутентификации .
2. Если метод signInAnonymously завершится без ошибок, сработает наблюдатель, зарегистрированный в методе onAuthStateChanged и вы сможете получить данные учетной записи анонимного пользователя из объекта User :

   Web

   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/auth.user
       const uid = user.uid;
       // ...
     } else {
       // User is signed out
       // ...
     }
   });
   auth_state_listener.js

   Web

   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/v8/firebase.User
       var uid = user.uid;
       // ...
     } else {
       // User is signed out
       // ...
     }
   });
   index.js

Для защиты вашего проекта от злоупотреблений Firebase ограничивает количество новых регистраций по электронной почте/паролю и анонимных регистраций с одного и того же IP-адреса за короткий период времени. Вы можете запросить и запланировать временное изменение этой квоты в консоли Firebase .

Преобразовать анонимный аккаунт в постоянный.

Когда анонимный пользователь регистрируется в вашем приложении, вы можете разрешить ему продолжить работу с новой учетной записью — например, вы можете захотеть сделать товары, добавленные пользователем в корзину до регистрации, доступными в корзине покупок новой учетной записи. Для этого выполните следующие шаги:

1. Когда пользователь регистрируется, завершите процесс авторизации для поставщика аутентификации пользователя, включая вызов одного из методов Auth.signInWith . Например, получите токен Google ID пользователя, токен доступа Facebook или адрес электронной почты и пароль.

2. Получите учетные данные AuthCredential для нового поставщика аутентификации:

   Вход через Google

   Web

   import { GoogleAuthProvider } from "firebase/auth";
   
   const credential = GoogleAuthProvider.credential(
     googleUser.getAuthResponse().id_token);
   auth_make_google_credential.js

   Web

   var credential = firebase.auth.GoogleAuthProvider.credential(
     googleUser.getAuthResponse().id_token);
   index.js

   Вход через Facebook

   Web

   import { FacebookAuthProvider } from "firebase/auth";
   
   const credential = FacebookAuthProvider.credential(
     response.authResponse.accessToken);
   auth_make_facebook_credential.js

   Web

   var credential = firebase.auth.FacebookAuthProvider.credential(
     response.authResponse.accessToken);
   index.js

   Вход по электронной почте и паролю

   Web

   import { EmailAuthProvider } from "firebase/auth";
   
   const credential = EmailAuthProvider.credential(email, password);
   auth_make_email_credential.js

   Web

   var credential = firebase.auth.EmailAuthProvider.credential(email, password);
   link-multiple-accounts.js

3. Передайте объект AuthCredential методу link , используемому для входа в систему:

   Web

   import { getAuth, linkWithCredential } from "firebase/auth";
   
   const auth = getAuth();
   linkWithCredential(auth.currentUser, credential)
     .then((usercred) => {
       const user = usercred.user;
       console.log("Anonymous account successfully upgraded", user);
     }).catch((error) => {
       console.log("Error upgrading anonymous account", error);
     });
   auth_anonymous_link.js

   Web

   auth.currentUser.linkWithCredential(credential)
     .then((usercred) => {
       var user = usercred.user;
       console.log("Anonymous account successfully upgraded", user);
     }).catch((error) => {
       console.log("Error upgrading anonymous account", error);
     });
   link-multiple-accounts.js

Если вызов для link пройдет успешно, новая учетная запись пользователя сможет получить доступ к данным анонимной учетной записи в Firebase.

Этот метод также можно использовать для связывания любых двух учетных записей .

Автоматическая очистка

Если вы обновили свой проект до Firebase Authentication with Identity Platform , вы можете включить автоматическую очистку в консоли Firebase . Включение этой функции позволяет Firebase автоматически удалять анонимные учетные записи старше 30 дней. В проектах с включенной автоматической очисткой анонимная аутентификация не будет учитываться в лимитах использования или платежных квотах.

• Любые анонимные учетные записи, созданные после включения автоматической очистки, могут быть автоматически удалены в любое время по истечении 30 дней с момента создания.
• Существующие анонимные учетные записи будут автоматически удалены через 30 дней после включения автоматической очистки.
• Если отключить автоматическую очистку, все анонимные учетные записи, запланированные к удалению, останутся запланированными к удалению.
• Если вы "обновите" анонимный аккаунт, связав его с любым способом входа в систему, аккаунт не будет удален автоматически.

Если вы хотите узнать, сколько пользователей будет затронуто до включения этой функции, и вы обновили свой проект до Firebase Authentication with Identity Platform , вы можете отфильтровать данные по параметру is_anon в Cloud Logging .

Следующие шаги

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