С помощью Firebase Authentication можно создавать и использовать временные анонимные аккаунты для аутентификации в Firebase. Эти временные анонимные аккаунты можно использовать, чтобы разрешить пользователям, которые ещё не зарегистрировались в вашем приложении, работать с данными, защищенными правилами безопасности. Если анонимный пользователь решит зарегистрироваться в вашем приложении, вы можете связать его учетные данные с анонимным аккаунтом, чтобы он мог продолжать работать со своими защищенными данными в будущих сеансах.
Подготовка
- Добавьте Firebase в свой проект JavaScript.
- Если вы ещё не подключили приложение к проекту Firebase, сделайте это в консоли Firebase.
-
Включите анонимную аутентификацию:
- В консоли Firebase выберите Безопасность > Аутентификация.
- На вкладке Sign-in method (Способ входа) включите поставщика Anonymous (Анонимный).
- Необязательно. Если вы перешли на тарифный план Firebase Authentication with Identity Platform, то можете включить автоматическую очистку. Если вы включите этот параметр, анонимные аккаунты, созданные более 30 дней назад, будут автоматически удалены. В проектах с включенной автоматической очисткой анонимная аутентификация больше не будет учитываться в лимитах на использование или квотах на оплату. Подробнее об автоматической очистке…
Анонимная аутентификация с помощью Firebase
Если пользователь, не выполнивший вход, использует функцию приложения, для которой требуется аутентификация с помощью Firebase, выполните следующие действия:
- Вызовите метод
signInAnonymously:Здесь же можно отслеживать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по Auth.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; // ... });
Web
firebase.auth().signInAnonymously() .then(() => { // Signed in.. }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; // ... });
- Если метод
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 // ... } });
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 // ... } });
Как преобразовать анонимный аккаунт в постоянный
Когда анонимный пользователь регистрируется в вашем приложении, вы можете разрешить ему продолжить работу с новым аккаунтом. Например, вы можете сделать товары, которые пользователь добавил в корзину до регистрации, доступными в корзине его нового аккаунта. Для этого выполните следующие действия:
- Когда пользователь регистрируется, выполните процедуру входа для его поставщика аутентификации, но не вызывайте методы
Auth.signInWith. Например, получите токен идентификатора Google, токен доступа Facebook или адрес электронной почты и пароль пользователя. Получите
AuthCredentialдля нового поставщика услуг аутентификации:вход с аккаунтом Google
Web
import { GoogleAuthProvider } from "firebase/auth"; const credential = GoogleAuthProvider.credential( googleUser.getAuthResponse().id_token);
Web
var credential = firebase.auth.GoogleAuthProvider.credential( googleUser.getAuthResponse().id_token);
Вход через Facebook
Web
import { FacebookAuthProvider } from "firebase/auth"; const credential = FacebookAuthProvider.credential( response.authResponse.accessToken);
Web
var credential = firebase.auth.FacebookAuthProvider.credential( response.authResponse.accessToken);
Вход с помощью адреса электронной почты и пароля
Web
import { EmailAuthProvider } from "firebase/auth"; const credential = EmailAuthProvider.credential(email, password);
Web
var credential = firebase.auth.EmailAuthProvider.credential(email, password);
Передайте объект
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); });
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 выполнен успешно, новый аккаунт пользователя получит доступ к данным Firebase анонимного аккаунта.
Автоматическая очистка
Если вы перевели проект на тарифный план Firebase Authentication with Identity Platform, то можете включить автоматическую очистку в консоли Firebase. Включив эту функцию, вы разрешаете Firebase автоматически удалять анонимные аккаунты, созданные более 30 дней назад. В проектах с включенной автоматической очисткой анонимная аутентификация не будет учитываться в лимитах на использование или квотах на оплату.
- Любые анонимные аккаунты, созданные после включения автоматической очистки, могут быть автоматически удалены в любое время по истечении 30 дней после создания.
- Существующие анонимные аккаунты будут автоматически удалены через 30 дней после включения автоматической очистки.
- Если вы отключите автоматическую очистку, все анонимные аккаунты, запланированные к удалению, останутся в этом статусе.
- Если вы "обновите" анонимный аккаунт, связав его с любым способом входа, он не будет удален автоматически.
Если вы хотите узнать, сколько пользователей затронет включение этой функции, и вы обновили проект до Firebase Authentication with Identity Platform, вы можете отфильтровать данные по is_anon в Cloud Logging.
Дальнейшие действия
Теперь, когда пользователи могут проходить аутентификацию с помощью Firebase, вы можете управлять их доступом к данным в базе данных Firebase, используя правила Firebase.