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:
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>" };
Dodaj nowy
authDomaindo 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
authDomaindo adresu URL usługi ACS SAML.Sprawdź, czy
continue_uriznajduje się na liście autoryzowanych domen.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 „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.
Skonfiguruj odwrotny serwer proxy na serwerze aplikacji, aby żądania GET/POST do
https://<app domain>/__/auth/były przekazywane dohttps://<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; }Wykonaj czynności opisane w sekcji Opcja 1, aby zaktualizować autoryzowane
redirect_uri, adres URL usługi ACS iauthDomain. 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:
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.jsonHostuj powyższe pliki w domenie aplikacji. Upewnij się, że serwer WWW może odpowiadać na żądania
https://<app domain>/__/auth/<filename>ihttps://<app domain>/__/firebase/init.json.Oto przykładowa implementacja serwera, który pobiera i hostuje pliki.
Wykonaj czynności opisane w opcji 1, aby zaktualizować autoryzowane
redirect_uriiauthDomain. 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.