Рекомендации по использованию signInWithRedirect в браузерах, блокирующих доступ к стороннему хранилищу

В этом документе описаны рекомендации по использованию входа с перенаправлением в браузерах, которые блокируют сторонние файлы 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 и использовать собственный домен в качестве домена аутентификации, выполните следующие действия:

  1. Настройте 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>"
    };
    
  1. Добавьте новый authDomain в список авторизованных URI перенаправления вашего поставщика OAuth. Способ зависит от поставщика, но в целом вы можете следовать инструкциям в разделе "Подготовка" для любого поставщика (например, Facebook). Обновленный URI для авторизации выглядит так: https://<the-domain-that-serves-your-app>/__/auth/handler. Обратите внимание на косую черту /__/auth/handler в конце.

    Если вы используете поставщика SAML, добавьте новый authDomain в URL SAML Assertion Consumer Service (ACS).

  2. Убедитесь, что ваш continue_uri есть в списке авторизованных доменов.

  3. При необходимости повторно разверните приложение с помощью 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 (по умолчанию .firebaseapp.com). authDomain размещает код помощника по входу, который перенаправляет пользователя к поставщику идентификационной информации, а тот, в случае успеха, – обратно в домен приложения.

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

  1. Настройте обратный прокси-сервер на сервере приложений, чтобы запросы 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;
    }
    
  2. Следуйте инструкциям в разделе Вариант 1, чтобы обновить авторизованные redirect_uri, URL ACS и authDomain. После повторного развертывания приложения доступ к хранилищу из разных источников должен прекратиться.

Вариант 4. Разместите код помощника по входу в своем домене

Ещё один способ устранить доступ к хранилищу из разных источников – разместить вспомогательный код входа Firebase на собственном сервере. Однако этот подход не работает для входа с аккаунтом Apple или SAML. Используйте этот вариант, только если вариант 3 с обратным прокси-сервером не подходит.

Чтобы разместить вспомогательный код, выполните следующие действия:

  1. Скачайте файлы для размещения из местоположения <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
    
  2. Разместите указанные выше файлы в домене приложения. Убедитесь, что ваш веб-сервер может отвечать на запросы https://<app domain>/__/auth/<filename> и https://<app domain>/__/firebase/init.json.

    Вот пример реализации сервера, который скачивает и размещает файлы.

  3. Выполните действия из варианта 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 приведены здесь.