Вы можете разрешить пользователям проходить аутентификацию в Firebase с помощью поставщиков OAuth, таких как Yahoo, интегрировав в приложение общий вход OAuth с использованием Firebase SDK для выполнения сквозного процесса входа.
Подготовка
Чтобы пользователи могли входить в аккаунты Yahoo, сначала включите Yahoo в качестве поставщика идентификационной информации для проекта Firebase:
- Добавьте Firebase в свой проект JavaScript.
- В консоли Firebase выберите Безопасность > Аутентификация.
- На вкладке Sign-in method (Способ входа) включите поставщика аутентификации Yahoo.
-
Добавьте идентификатор клиента и секретный код клиента из консоли разработчика этого поставщика в конфигурацию поставщика:
-
Чтобы зарегистрировать клиент Yahoo OAuth, следуйте инструкциям в документации для разработчиков Yahoo по регистрации веб-приложения в Yahoo.
Выберите два разрешения OpenID Connect API:
profileиemail. -
При регистрации приложений у этих поставщиков обязательно укажите домен
*.firebaseapp.comдля своего проекта в качестве домена переадресации для приложения.
-
- Нажмите Сохранить.
Как настроить процесс входа с помощью Firebase SDK
Если вы создаете веб-приложение, проще всего аутентифицировать пользователей с помощью Firebase, используя их аккаунты Yahoo, – это позволит управлять всем процессом входа с помощью Firebase JavaScript SDK.
Чтобы настроить процесс входа с помощью Firebase JavaScript SDK, выполните следующие действия:
Создайте экземпляр OAuthProvider, используя идентификатор поставщика yahoo.com.
Web
import { OAuthProvider } from "firebase/auth"; const provider = new OAuthProvider('yahoo.com');
Web
var provider = new firebase.auth.OAuthProvider('yahoo.com');
Необязательно. Укажите дополнительные специальные параметры OAuth, которые нужно отправлять с запросом OAuth.
Web
provider.setCustomParameters({ // Prompt user to re-authenticate to Yahoo. prompt: 'login', // Localize to French. language: 'fr' });
Web
provider.setCustomParameters({ // Prompt user to re-authenticate to Yahoo. prompt: 'login', // Localize to French. language: 'fr' });
Поддерживаемые параметры перечислены в документации Yahoo по OAuth. Обратите внимание, что с помощью
setCustomParameters()нельзя передавать обязательные параметры Firebase. Это параметры client_id, redirect_uri, response_type, scope и state.Необязательно. Укажите дополнительные области действия OAuth 2.0, помимо
profileиemail, которые вы хотите запросить у поставщика аутентификации. Если вашему приложению требуется доступ к личным данным пользователей из Yahoo API, вам нужно будет запросить разрешения на доступ к Yahoo API в разделе API Permissions (Разрешения API) в консоли разработчика Yahoo. Запрашиваемые области действия OAuth должны точно соответствовать областям, предварительно настроенным в разрешениях API приложения. Например, если запрашивается доступ на чтение и запись к контактам пользователя и он предварительно настроен в разрешениях API приложения, необходимо передатьsdct-wвместо области OAuth только для чтенияsdct-r. В противном случае процесс завершится неудачно и конечный пользователь увидит сообщение об ошибке.Web
// Request access to Yahoo Mail API. provider.addScope('mail-r'); // Request read/write access to user contacts. // This must be preconfigured in the app's API permissions. provider.addScope('sdct-w');
Web
// Request access to Yahoo Mail API. provider.addScope('mail-r'); // Request read/write access to user contacts. // This must be preconfigured in the app's API permissions. provider.addScope('sdct-w');
Подробную информацию можно найти в документации Yahoo.
Выполните аутентификацию в Firebase с помощью объекта поставщика OAuth. Вы можете предложить пользователям войти в аккаунт Yahoo, открыв всплывающее окно или перенаправив их на страницу входа. На мобильных устройствах рекомендуется использовать метод переадресации.
Чтобы выполнить вход с помощью всплывающего окна, вызовите
signInWithPopup:Web
import { getAuth, signInWithPopup, OAuthProvider } from "firebase/auth"; const auth = getAuth(); signInWithPopup(auth, provider) .then((result) => { // IdP data available in result.additionalUserInfo.profile // ... // Yahoo OAuth access token and ID token can be retrieved by calling: const credential = OAuthProvider.credentialFromResult(result); const accessToken = credential.accessToken; const idToken = credential.idToken; }) .catch((error) => { // Handle error. });
Web
firebase.auth().signInWithPopup(provider) .then((result) => { // IdP data available in result.additionalUserInfo.profile // ... /** @type {firebase.auth.OAuthCredential} */ const credential = result.credential; // Yahoo OAuth access token and ID token can be retrieved by calling: var accessToken = credential.accessToken; var idToken = credential.idToken; }) .catch((error) => { // Handle error. });
Чтобы войти в аккаунт, перенаправив пользователя на страницу входа, вызовите
signInWithRedirect:
При использовании
signInWithRedirect,linkWithRedirectилиreauthenticateWithRedirectследуйте рекомендациям.firebase.auth().signInWithRedirect(provider);
После того как пользователь выполнит вход и вернется на страницу, вы можете получить результат входа, вызвав
getRedirectResult.Web
import { getAuth, signInWithRedirect } from "firebase/auth"; const auth = getAuth(); signInWithRedirect(auth, provider);
Web
firebase.auth().signInWithRedirect(provider);
После успешного завершения токен идентификатора OAuth и токен доступа, связанные с поставщиком, можно получить из возвращенного объекта
firebase.auth.UserCredential.Используя токен доступа OAuth, вы можете вызвать Yahoo API.
Например, чтобы получить основные данные профиля, можно вызвать следующий REST API:
curl -i -H "Authorization: Bearer ACCESS_TOKEN" https://social.yahooapis.com/v1/user/YAHOO_USER_UID/profile?format=json
где
YAHOO_USER_UID– идентификатор пользователя Yahoo, который можно получить из поляfirebase.auth().currentUser.providerData[0].uidили изresult.additionalUserInfo.profile.В примерах выше рассматривается процесс входа, но вы также можете связать поставщика Yahoo с существующим пользователем, используя
linkWithPopup/linkWithRedirect. Например, вы можете связать несколько поставщиков с одним пользователем, чтобы он мог входить в систему с помощью любого из них.Web
import { getAuth, linkWithPopup, OAuthProvider } from "firebase/auth"; const provider = new OAuthProvider('yahoo.com'); const auth = getAuth(); linkWithPopup(auth.currentUser, provider) .then((result) => { // Yahoo credential is linked to the current user. // IdP data available in result.additionalUserInfo.profile. // Get the OAuth access token and ID Token const credential = OAuthProvider.credentialFromResult(result); const accessToken = credential.accessToken; const idToken = credential.idToken; }) .catch((error) => { // Handle error. });
Web
var provider = new firebase.auth.OAuthProvider('yahoo.com'); firebase.auth().currentUser.linkWithPopup(provider) .then((result) => { // Yahoo credential is linked to the current user. // IdP data available in result.additionalUserInfo.profile. // Yahoo OAuth access token can be retrieved by calling: // result.credential.accessToken // Yahoo OAuth ID token can be retrieved by calling: // result.credential.idToken }) .catch((error) => { // Handle error. });
Тот же шаблон можно использовать с
reauthenticateWithPopup/reauthenticateWithRedirect, чтобы получать новые учетные данные для конфиденциальных операций, требующих недавнего входа.Web
import { getAuth, reauthenticateWithPopup, OAuthProvider } from "firebase/auth"; const provider = new OAuthProvider('yahoo.com'); const auth = getAuth(); reauthenticateWithPopup(auth.currentUser, provider) .then((result) => { // User is re-authenticated with fresh tokens minted and // should be able to perform sensitive operations like account // deletion and email or password update. // IdP data available in result.additionalUserInfo.profile. // Get the OAuth access token and ID Token const credential = OAuthProvider.credentialFromResult(result); const accessToken = credential.accessToken; const idToken = credential.idToken; }) .catch((error) => { // Handle error. });
Web
var provider = new firebase.auth.OAuthProvider('yahoo.com'); firebase.auth().currentUser.reauthenticateWithPopup(provider) .then((result) => { // User is re-authenticated with fresh tokens minted and // should be able to perform sensitive operations like account // deletion and email or password update. // IdP data available in result.additionalUserInfo.profile. // Yahoo OAuth access token can be retrieved by calling: // result.credential.accessToken // Yahoo OAuth ID token can be retrieved by calling: // result.credential.idToken }) .catch((error) => { // Handle error. });
Как выполнить аутентификацию с помощью 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 happened. });
Web
firebase.auth().signOut().then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });