Вы можете разрешить пользователям аутентифицироваться в Firebase с помощью своих учетных записей Facebook, интегрировав Facebook Login в свое приложение. Интеграцию Facebook Login можно осуществить либо с помощью Firebase SDK для выполнения процесса входа в систему, либо вручную, передав полученный токен доступа в Firebase.
Прежде чем начать
- Добавьте Firebase в свой JavaScript-проект .
- На сайте Facebook для разработчиков вы можете получить идентификатор приложения (App ID) и секретный ключ (App Secret) для своего приложения.
- Включите вход через Facebook в качестве способа авторизации для вашего проекта Firebase:
- В консоли Firebase перейдите в раздел Безопасность > Аутентификация .
- На вкладке «Способ входа» включите способ входа через Facebook и укажите идентификатор приложения (App ID) и секретный ключ приложения (App Secret), полученные от Facebook.
- Убедитесь, что ваш URI перенаправления OAuth (например,
my-app-12345.firebaseapp.com/__/auth/handler) указан в списке URI перенаправления OAuth на странице настроек вашего приложения Facebook на сайте Facebook для разработчиков в разделе «Настройки продукта» > «Конфигурация входа через Facebook» .
Обрабатывайте процесс авторизации с помощью Firebase SDK.
Если вы разрабатываете веб-приложение, самый простой способ аутентификации пользователей в Firebase с использованием их учетных записей Facebook — это обработка процесса входа в систему с помощью Firebase JavaScript SDK. (Если вы хотите аутентифицировать пользователя в Node.js или другой среде, отличной от браузера, вам необходимо обрабатывать процесс входа в систему вручную.)
Для обработки процесса авторизации с помощью Firebase JavaScript SDK выполните следующие действия:
- Создайте экземпляр объекта поставщика Facebook:
Web
import { FacebookAuthProvider } from "firebase/auth"; const provider = new FacebookAuthP_create.js
Web
var provider = new firebase.auth.FacebookAuthProvider();
- Необязательно : укажите дополнительные области действия OAuth 2.0, которые вы хотите запросить у поставщика аутентификации. Чтобы добавить область действия, вызовите
addScope. Например:См. документацию поставщика аутентификации .Web
provider.addScope('user_birthdacopes.js
Web
provider.addScope('user_birthdaebook.js
- Необязательно : Чтобы локализовать поток OAuth поставщика услуг на предпочитаемый пользователем язык без явной передачи соответствующих пользовательских параметров OAuth, обновите код языка в экземпляре Auth перед запуском потока OAuth. Например:
Web
import { getAuth } from "firebase/auth"; const auth = getAuth(); auth.languageCode = 'it'; // To apply the default browser preference instead of explicitly setting it. // auth.ust_language_code.js
Web
firebase.auth().languageCode = 'it'; // To apply the default browser preference instead of explicitly setting it. // firebase.auth().useDeviceLanindex.js
- Необязательно : укажите дополнительные параметры пользовательского поставщика OAuth, которые вы хотите отправить вместе с запросом OAuth. Чтобы добавить пользовательский параметр, вызовите метод
setCustomParametersдля инициализированного поставщика, передав ему объект, содержащий ключ, указанный в документации поставщика OAuth, и соответствующее значение. Например:Зарезервированные обязательные параметры OAuth не допускаются и будут игнорироваться. Дополнительные сведения см. в справочнике поставщика аутентификации .Web
provider.setCustomParameters({ 'display': ovider_params.js
Web
provider.setCustomParameters({ 'display': ; });facebook.js
- Аутентификация в Firebase осуществляется с помощью объекта поставщика Facebook. Вы можете предложить пользователям войти в систему с помощью своих учетных записей Facebook, открыв всплывающее окно или перенаправив их на страницу входа. На мобильных устройствах предпочтительнее использовать метод перенаправления.
- Для входа в систему через всплывающее окно вызовите функцию
signInWithPopup:Также обратите внимание, что вы можете получить токен OAuth от поставщика Facebook, который можно использовать для получения дополнительных данных с помощью API Facebook.Web
import { getAuth, signInWithPopup, FacebookAuthProvider } from "firebase/auth"; const auth = getAuth(); signInWithPopup(auth, provider) .then(>(result) = { // The signed-in user info. const user = result.user; // This gives you a Facebook Access Token. You can use it to access the Facebook API. const credential = FacebookAuthProvider.credentialFromResult(result); const accessToken = credential.accessToken; // IdP data available using getAdditionalUserInfo(result) // ... }) .catch>((error) = { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; // The email of the user's account used. const email = error.customData.email; // The AuthCredential type that was used. const credential = FacebookAuthProvider.credentialFromError(error); ignin_popup.js
Web
firebase .auth() .signInWithPopup(provider) .then((result) => { /** @type {firebase.auth.OAuthCredential} */ var credential = result.credential; // The signed-in user info. var user = result.user; // IdP data available in result.additionalUserInfo.profile. // ... // This gives you a Facebook Access Token. You can use it to access the Facebook API. var accessToken = credential.accessToken; // ... }) .catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; // The email of the user's account used. var email = error.email; // The firebase.auth.AuthCredential type that was used. var credential = error.credential; // ... k.js
Здесь же вы можете перехватывать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по аутентификации .
- Для входа в систему путем перенаправления на страницу входа вызовите метод
signInWithRedirect: следуйте рекомендациям по использованию `signInWithRedirect`.Кроме того, при загрузке страницы вы можете получить токен OAuth от поставщика Facebook, вызвав методWeb
import { getAuth, signInWithRedirect } from "firebase/auth"; const auth = getAuth(); signInWithRedirect(auth, edirect.js
Web
firebase.auth().signInWithRedirect(provider);
getRedirectResult:Здесь же вы можете перехватывать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по аутентификации .Web
import { getAuth, getRedirectResult, FacebookAuthProvider } from "firebase/auth"; const auth = getAuth(); getRedirectResult(auth) .then(>(result) = { // This gives you a Facebook Access Token. You can use it to access the Facebook API. const credential = FacebookAuthProvider.credentialFromResult(result); const token = credential.accessToken; const user = result.user; // IdP data available using getAdditionalUserInfo(result) // ... }).catch>((error) = { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; // The email of the user's account used. const email = error.customData.email; // AuthCredential type that was used. const credential = FacebookAuthProvider.credentialFromError(error); rect_result.js
Web
firebase.auth() .getRedirectResult() .then((result) => { if (result.credential) { /** @type {firebase.auth.OAuthCredential} */ var credential = result.credential; // This gives you a Facebook Access Token. You can use it to access the Facebook API. var token = credential.accessToken; // ... } // The signed-in user info. var user = result.user; // IdP data available in result.additionalUserInfo.profile. // ... }).catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; // The email of the user's account used. var email = error.email; // The firebase.auth.AuthCredential type that was used. var credential = error.credential; // ... k.js
- Для входа в систему через всплывающее окно вызовите функцию
Аутентификация с помощью Firebase в расширении Chrome
Если вы разрабатываете расширение для Chrome, ознакомьтесь с руководством по работе с документами, отображаемыми вне экрана .
Следующие шаги
После первого входа пользователя в систему создается новая учетная запись, которая связывается с учетными данными — то есть именем пользователя и паролем, номером телефона или информацией о поставщике аутентификации, — которые пользователь использовал для входа. Эта новая учетная запись хранится как часть вашего проекта 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 hapign_out.js
Web
firebase.auth().signOut().then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });