Sprawdzone metody korzystania z funkcji signInWithRedirect w przeglądarkach, które blokują dostęp do pamięci masowej innych firm

W tym dokumencie opisujemy sprawdzone metody korzystania z logowania przez przekierowanie w przeglądarkach, które blokują pliki cookie innych firm. Aby usługa signInWithRedirect() działała zgodnie z oczekiwaniami w środowiskach produkcyjnych we wszystkich przeglądarkach, musisz wybrać jedną z podanych tutaj opcji.

Przegląd

Aby proces signInWithRedirect() przebiegał bezproblemowo dla Ciebie i Twoich użytkowników, pakiet JavaScript SDK usługi Uwierzytelnianie Firebase używa elementu iframe współdzielenia, który łączy się z domeną hostowaną Hostingu Firebase Twojej aplikacji. Ten mechanizm nie działa jednak w przeglądarkach, które blokują dostęp do pamięci masowej innych firm.

Proszenie użytkowników o wyłączenie funkcji partycjonowania miejsca na dane w przeglądarce rzadko jest możliwe, dlatego w zależności od konkretnego przypadku użycia należy zastosować w aplikacji jedną z poniższych opcji konfiguracji.

  • Jeśli hostujesz aplikację w Hostingu Firebase w subdomenie firebaseapp.com, ten problem Cię nie dotyczy i nie musisz nic robić.
  • Jeśli hostujesz aplikację za pomocą Hostingu Firebase we własnej domenie lub subdomenie web.app, użyj opcji 1.
  • Jeśli hostujesz aplikację w usłudze innej niż Firebase, użyj opcji 2, opcji 3, opcji 4 lub opcji 5.

Opcja 1. Zaktualizuj konfigurację Firebase, aby używać własnej domeny jako authDomain

Jeśli hostujesz aplikację w Hostingu Firebase, używając domeny niestandardowej, możesz skonfigurować pakiet SDK Firebase tak, aby używał tej domeny jako authDomain. Dzięki temu aplikacja i element iframe uwierzytelniania będą używać tej samej domeny, co zapobiegnie problemowi z logowaniem. (Jeśli nie używasz Hostingu Firebase, musisz wybrać inną opcję). Upewnij się, że własna domena została skonfigurowana w tym samym projekcie, którego używasz do uwierzytelniania.

Aby zaktualizować konfigurację Firebase i używać własnej domeny jako domeny uwierzytelniania, wykonaj te czynności:

  1. Skonfiguruj pakiet Firebase JS SDK, aby używać własnej domeny jako authDomain:

    const firebaseConfig = {
      apiKey: "<api-key>",
      authDomain: "<the-domain-that-serves-your-app>",
      databaseURL: "<database-url>",
      projectId: "<project-id>",
      appId: "<app-id>"
    };
    
  1. Dodaj nowy authDomain do listy autoryzowanych identyfikatorów URI przekierowania dostawcy OAuth. Sposób wykonania tej czynności zależy od dostawcy, ale ogólnie możesz postępować zgodnie z instrukcjami w sekcji „Zanim zaczniesz” u dowolnego dostawcy (np. Facebooka). Zaktualizowany identyfikator URI do autoryzacji wygląda tak: https://<the-domain-that-serves-your-app>/__/auth/handler – ważny jest końcowy znak /__/auth/handler.

    Podobnie, jeśli korzystasz z dostawcy SAML, dodaj nowy authDomain do adresu URL usługi ACS SAML.

  2. Sprawdź, czy continue_uri znajduje się na liście autoryzowanych domen.

  3. W razie potrzeby przeprowadź ponowne wdrożenie za pomocą Hostingu Firebase, aby pobrać najnowszy plik konfiguracji Firebase hostowany na stronie /__/firebase/init.json.

Opcja 2. Przełącz się na signInWithPopup()

Użyj signInWithPopup() zamiast signInWithRedirect(). Pozostała część kodu aplikacji pozostaje bez zmian, ale obiekt UserCredential jest pobierany w inny sposób.

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());
```

Logowanie się w wyskakującym okienku nie zawsze jest idealnym rozwiązaniem dla użytkowników – wyskakujące okienka są czasami blokowane przez urządzenie lub platformę, a proces jest mniej płynny dla użytkowników mobilnych. Jeśli używanie wyskakujących okienek jest problemem w Twojej aplikacji, musisz wybrać jedną z pozostałych opcji.

Opcja 3. Przekazywanie żądań uwierzytelniania do firebaseapp.com przez serwer proxy

Proces signInWithRedirect rozpoczyna się od przekierowania z domeny aplikacji do domeny określonej w parametrze authDomain w konfiguracji Firebase (domyślnie „.firebaseapp.com”). authDomain hostuje kod pomocnika logowania, który przekierowuje do dostawcy tożsamości, a ten po pomyślnym zalogowaniu przekierowuje z powrotem do domeny aplikacji.

Gdy proces uwierzytelniania powróci do domeny aplikacji, nastąpi dostęp do pamięci przeglądarki domeny pomocnika logowania. Ta opcja i następna (samodzielne hostowanie kodu) eliminują dostęp do pamięci masowej w ramach współdzielenia, który w przeciwnym razie jest blokowany przez przeglądarki.

  1. Skonfiguruj odwrotny serwer proxy na serwerze aplikacji, aby żądania GET/POST do https://<app domain>/__/auth/ były przekazywane do https://<project>.firebaseapp.com/__/auth/. Upewnij się, że to przekierowanie jest przejrzyste dla przeglądarki. Nie można tego zrobić za pomocą przekierowania 302.

    Jeśli do obsługi własnej domeny używasz nginx, konfiguracja odwrotnego serwera proxy będzie wyglądać tak:

    # reverse proxy for signin-helpers for popup/redirect sign in.
    location /__/auth {
      proxy_pass https://<project>.firebaseapp.com;
    }
    
  2. Wykonaj czynności opisane w sekcji Opcja 1, aby zaktualizować autoryzowane redirect_uri, adres URL usługi ACS i authDomain. Po ponownym wdrożeniu programu dostęp do współdzielenia pamięci masowej nie powinien już występować.

Opcja 4. Samodzielne hostowanie kodu asystenta logowania w domenie

Innym sposobem na wyeliminowanie dostępu do pamięci masowej w różnych domenach jest samodzielne hostowanie kodu pomocniczego logowania Firebase. To podejście nie działa jednak w przypadku logowania przez Apple ani SAML. Użyj tej opcji tylko wtedy, gdy konfiguracja zwrotnego serwera proxy w opcji 3 jest niemożliwa.

Hostowanie kodu pomocniczego obejmuje te kroki:

  1. Pobierz pliki do hostowania z lokalizacji <project>.firebaseapp.com, wykonując te polecenia:

    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. Hostuj powyższe pliki w domenie aplikacji. Upewnij się, że serwer WWW może odpowiadać na żądania https://<app domain>/__/auth/<filename> i https://<app domain>/__/firebase/init.json.

    Oto przykładowa implementacja serwera, który pobiera i hostuje pliki.

  3. Wykonaj czynności opisane w opcji 1, aby zaktualizować autoryzowane redirect_uri i authDomain. Po ponownym wdrożeniu programu dostęp do współdzielenia pamięci masowej nie powinien już występować.

Opcja 5. Samodzielne zarządzanie logowaniem u dostawcy

Pakiet SDK usługi Uwierzytelnianie Firebase udostępnia metody signInWithPopup() i signInWithRedirect(), które ułatwiają obsługę skomplikowanej logiki i eliminują konieczność korzystania z innego pakietu SDK. Możesz całkowicie uniknąć korzystania z obu metod, logując się niezależnie u dostawcy, a następnie używając signInWithCredential(), aby wymienić dane logowania dostawcy na dane logowania Uwierzytelniania Firebase. Możesz na przykład użyć pakietu SDK Logowania przez Google i przykładowego kodu, aby uzyskać dane logowania na konto Google, a następnie utworzyć instancję nowych danych logowania Google, uruchamiając ten kod:

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);

Po wywołaniu metody signInWithCredential() reszta aplikacji działa tak samo jak wcześniej.

Instrukcje uzyskiwania danych logowania Apple znajdziesz tutaj.