В этом документе описаны рекомендации по использованию входа с перенаправлением в браузерах, которые блокируют сторонние файлы cookie. Чтобы signInWithRedirect() работала правильно в рабочей среде и во всех браузерах, выберите один из вариантов ниже.
Обзор
Чтобы сделать процесс signInWithRedirect() удобным для вас и ваших пользователей, Firebase Authentication JavaScript SDK использует междоменный iframe, который подключается к домену Firebase Hosting вашего приложения.
Однако этот механизм не работает в браузерах, которые блокируют доступ к сторонним хранилищам.
Поскольку просить пользователей отключить разделение хранилища в браузере – не лучший вариант, вам следует применить к своему приложению один из следующих вариантов настройки в зависимости от особенностей вашего случая использования.
- Если вы размещаете приложение с помощью Firebase Hosting на субдомене
firebaseapp.com, эта проблема вас не затронет и никаких действий не требуется. - Если вы размещаете приложение с помощью Firebase Hosting в собственном домене или субдомене
web.app, используйте вариант 1. - Если вы размещаете приложение в другом сервисе, используйте вариант 2, вариант 3, вариант 4 или вариант 5.
Вариант 1. Обновите конфигурацию Firebase, чтобы использовать собственный домен в качестве authDomain
Если вы размещаете приложение в Firebase Hosting, используя собственный домен, вы можете настроить Firebase SDK так, чтобы этот домен использовался в качестве authDomain. Это гарантирует, что ваше приложение и iframe аутентификации используют один и тот же домен, что предотвращает проблему со входом. Если вы не используете Firebase Hosting, выберите другой вариант. Убедитесь, что вы настроили собственный домен в том же проекте, который используете для аутентификации.
Чтобы обновить конфигурацию Firebase и использовать собственный домен в качестве домена аутентификации, выполните следующие действия:
Настройте Firebase JS SDK, чтобы использовать собственный домен в качестве
authDomain:const firebaseConfig = { apiKey: "<api-key>", authDomain: "<the-domain-that-serves-your-app>", databaseURL: "<database-url>", projectId: "<project-id>", appId: "<app-id>" };
Добавьте новый
authDomainв список авторизованных URI перенаправления вашего поставщика OAuth. Способ зависит от поставщика, но в целом вы можете следовать инструкциям в разделе "Подготовка" для любого поставщика (например, Facebook). Обновленный URI для авторизации выглядит так:https://<the-domain-that-serves-your-app>/__/auth/handler. Обратите внимание на косую черту/__/auth/handlerв конце.Если вы используете поставщика SAML, добавьте новый
authDomainв URL SAML Assertion Consumer Service (ACS).Убедитесь, что ваш
continue_uriесть в списке авторизованных доменов.При необходимости повторно разверните приложение с помощью Firebase Hosting, чтобы получить самый актуальный файл конфигурации Firebase, размещенный по адресу
/__/firebase/init.json.
Вариант 2. Переход на signInWithPopup()
Используйте signInWithPopup() вместо signInWithRedirect(). Остальная часть кода приложения остается прежней, но объект UserCredential извлекается по-другому.
Web
// Before
// ==============
signInWithRedirect(auth, new GoogleAuthProvider());
// After the page redirects back
const userCred = await getRedirectResult(auth);
// After
// ==============
const userCred = await signInWithPopup(auth, new GoogleAuthProvider());
Web
// Before
// ==============
firebase.auth().signInWithRedirect(new firebase.auth.GoogleAuthProvider());
// After the page redirects back
var userCred = await firebase.auth().getRedirectResult();
// After
// ==============
var userCred = await firebase.auth().signInWithPopup(
new firebase.auth.GoogleAuthProvider());
```
Всплывающие окна не всегда удобны для пользователей. Иногда они блокируются устройством или платформой, а на мобильных устройствах могут работать некорректно. Если в вашем приложении нежелательно использовать всплывающие окна, выберите другой вариант.
Вариант 3. Прокси-запросы на аутентификацию в firebaseapp.com
Процесс signInWithRedirect начинается с перенаправления из домена вашего приложения в домен, указанный в параметре authDomain в конфигурации Firebase (по умолчанию authDomain размещает код помощника по входу, который перенаправляет пользователя к поставщику идентификационной информации, а тот, в случае успеха, – обратно в домен приложения.
Когда процесс аутентификации возвращается в домен приложения, выполняется доступ к локальному хранилищу браузера домена помощника по входу. Этот и следующий варианты (размещение кода на собственном сервере) позволяют избежать доступа к хранилищу из разных источников, который блокируется браузерами.
Настройте обратный прокси-сервер на сервере приложений, чтобы запросы GET/POST к
https://<app domain>/__/auth/перенаправлялись наhttps://<project>.firebaseapp.com/__/auth/. Убедитесь, что эта переадресация прозрачна для браузера. Этого нельзя добиться с помощью переадресации 302.Если вы используете nginx для обслуживания собственного домена, конфигурация обратного прокси-сервера будет выглядеть следующим образом:
# reverse proxy for signin-helpers for popup/redirect sign in. location /__/auth { proxy_pass https://<project>.firebaseapp.com; }Следуйте инструкциям в разделе Вариант 1, чтобы обновить авторизованные
redirect_uri, URL ACS иauthDomain. После повторного развертывания приложения доступ к хранилищу из разных источников должен прекратиться.
Вариант 4. Разместите код помощника по входу в своем домене
Ещё один способ устранить доступ к хранилищу из разных источников – разместить вспомогательный код входа Firebase на собственном сервере. Однако этот подход не работает для входа с аккаунтом Apple или SAML. Используйте этот вариант, только если вариант 3 с обратным прокси-сервером не подходит.
Чтобы разместить вспомогательный код, выполните следующие действия:
Скачайте файлы для размещения из местоположения
<project>.firebaseapp.com, выполнив следующие команды:mkdir signin_helpers/ && cd signin_helpers wget https://<project>.firebaseapp.com/__/auth/handler wget https://<project>.firebaseapp.com/__/auth/handler.js wget https://<project>.firebaseapp.com/__/auth/experiments.js wget https://<project>.firebaseapp.com/__/auth/iframe wget https://<project>.firebaseapp.com/__/auth/iframe.js wget https://<project>.firebaseapp.com/__/auth/links wget https://<project>.firebaseapp.com/__/auth/links.js wget https://<project>.firebaseapp.com/__/firebase/init.jsonРазместите указанные выше файлы в домене приложения. Убедитесь, что ваш веб-сервер может отвечать на запросы
https://<app domain>/__/auth/<filename>иhttps://<app domain>/__/firebase/init.json.Вот пример реализации сервера, который скачивает и размещает файлы.
Выполните действия из варианта 1, чтобы обновить авторизованные
redirect_uriиauthDomain. После повторного развертывания приложения доступ к хранилищу из разных источников должен прекратиться.
Вариант 5. Обработка входа в аккаунт поставщика услуг независимо
Firebase Authentication SDK предоставляет удобные методы signInWithPopup() и signInWithRedirect(), которые позволяют упростить логику и избежать необходимости использовать другой SDK. Вы можете полностью отказаться от использования обоих методов, выполнив вход у своего поставщика, а затем использовать signInWithCredential() для обмена учетных данных поставщика на учетные данные Firebase Authentication.
Например, вы можете использовать Google Sign In SDK и образец кода, чтобы получить учетные данные аккаунта Google, а затем создать экземпляр новых учетных данных Google, выполнив следующий код:
Web
// `googleUser` from the onsuccess Google Sign In callback.
// googUser = gapi.auth2.getAuthInstance().currentUser.get();
const credential = GoogleAuthProvider.credential(googleUser.getAuthResponse().id_token);
const result = await signInWithCredential(auth, credential);
Web
// `googleUser` from the onsuccess Google Sign In callback.
const credential = firebase.auth.GoogleAuthProvider.credential(
googleUser.getAuthResponse().id_token);
const result = await firebase.auth().signInWithCredential(credential);
После вызова signInWithCredential() остальные функции приложения будут работать так же, как и раньше.
Инструкции по получению учетных данных Apple приведены здесь.