Najczęstsze pytania i rozwiązywanie problemów z uwierzytelnianiem

Jak mogę zapobiec nadużyciom SMS-ów podczas korzystania z uwierzytelniania telefonicznego?

Aby chronić projekt przed oszustwami z użyciem SMS-ów i nadużyciami interfejsów API, wykonaj te czynności:

Rozważ skonfigurowanie zasad dotyczących regionów SMS

1. Wyświetl wykorzystanie SMS-ów w regionie

   Wyszukaj regiony, w których wysłano bardzo dużo SMS-ów, a zweryfikowano bardzo mało SMS-ów (lub zero). Stosunek zweryfikowanych adresów do wysłanych to wskaźnik sukcesu. Odsetek udanych dostarczeń zwykle wynosi 70–85%, ponieważ SMS-y nie są protokołem gwarantującym dostarczenie, a w niektórych regionach może dochodzić do nadużyć. Wskaźniki sukcesu poniżej 50% oznaczają, że wysłano wiele SMS-ów, ale tylko niewielka liczba logowań zakończyła się powodzeniem. Jest to typowy wskaźnik działań nieuczciwych podmiotów i sztucznego zwiększania ruchu SMS-owego.

2. Użyj zasad dotyczących regionów SMS-ów, aby odrzucać regiony SMS-ów o niskim współczynniku powodzenia lub zezwalać tylko na określone regiony, jeśli aplikacja jest przeznaczona do dystrybucji tylko na określonych rynkach.

Ograniczanie autoryzowanych domen uwierzytelniania

Do zarządzania autoryzowanymi domenami używaj panelu ustawień uwierzytelniania. Domena localhost jest domyślnie dodawana do zatwierdzonych domen uwierzytelniania, aby uprościć proces tworzenia. Rozważ usunięcie domeny localhost z autoryzowanych domen w projekcie produkcyjnym, aby uniemożliwić osobom niepowołanym uruchamianie kodu w ich domenie localhost w celu uzyskania dostępu do projektu produkcyjnego.

Włączanie i wymuszanie App Check

Włącz App Check, aby chronić projekt przed nadużywaniem interfejsów API. Dzięki temu będziesz mieć pewność, że żądania pochodzą tylko z aplikacji powiązanych z Twoim projektem.

Aby korzystać z App Check w Firebase Authentication, musisz przejść na Firebase Authentication with Identity Platform.

Pamiętaj, że musisz wymusić App Check w przypadku Authentication w Firebase konsoli (przed wymuszeniem rozważ monitorowanie ruchu). Sprawdź też listę zatwierdzonych witryn reCAPTCHA Enterprise, aby upewnić się, że zawiera ona tylko witryny produkcyjne, a lista aplikacji zarejestrowanych w projekcie w App Check jest prawidłowa.

Pamiętaj, że App Check pomaga chronić przed automatycznymi atakami, potwierdzając, że połączenie pochodzi z jednej z zarejestrowanych aplikacji. Nie uniemożliwia użytkownikom korzystania z aplikacji w niezamierzony sposób (np. rozpoczynania i nigdy niekończenia procesów logowania w celu generowania wysłanych SMS-ów).

Czy numery telefonów przeniesione do nowego operatora są obsługiwane przez uwierzytelnianie za pomocą telefonu?

W tym czasie numery przeniesione między operatorami spowodują, że wszystkie SMS-y staną się niedostępne dla tych użytkowników. Nie ma obejścia tego problemu, a zespół Firebase pracuje nad jego rozwiązaniem.

Dlaczego w mojej aplikacji na Androida pojawia się ten błąd:
Google sign in failed?

Jeśli widzisz ten błąd, wykonaj instrukcje zawarte w tym artykule z odpowiedziami na najczęstsze pytania:

GoogleFragment: Google sign in failed
    com.google.android.gms.common.api.ApiException: 13: Unable to get token.
        at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)

1. Sprawdź, czy logowanie Google jest prawidłowo włączone jako dostawca uwierzytelniania:

   1. W konsoli Firebase otwórz Authentication sekcję.

   2. Na karcie Metoda logowania wyłącz, a potem ponownie włącz metodę logowania Google (nawet jeśli jest już włączona):

      1. Otwórz metodę logowania Google, wyłącz ją i kliknij Zapisz.

      2. Otwórz ponownie metodę logowania Google, włącz ją, a następnie kliknij Zapisz.

2. Upewnij się, że Twoja aplikacja używa aktualnego pliku konfiguracyjnego Firebase (google-services.json).
   Pobierz plik konfiguracyjny aplikacji.

3. Sprawdź, czy błąd nadal występuje. Jeśli tak, przejdź do następnego kroku rozwiązywania problemu.

4. Sprawdź, czy wymagani klienci OAuth 2.0 są obecni.

   1. Na stronie Dane logowania w konsoli Google Cloud znajdź sekcję Identyfikatory klienta OAuth 2.0.

   2. Jeśli klientów OAuth 2.0 nie ma (i wykonano wszystkie powyższe czynności), skontaktuj się z zespołem pomocy.

Dlaczego w mojej aplikacji na platformę Apple pojawia się ten błąd:
You must specify <clientID> in <GIDConfiguration>?

Jeśli widzisz ten błąd, wykonaj instrukcje zawarte w tym artykule z odpowiedziami na najczęstsze pytania:

You must specify |clientID| in |GIDConfiguration|

1. Sprawdź, czy logowanie Google jest prawidłowo włączone jako dostawca uwierzytelniania:

   1. W konsoli Firebase otwórz Authentication sekcję.

   2. Na karcie Metoda logowania wyłącz, a potem ponownie włącz metodę logowania Google (nawet jeśli jest już włączona):

      1. Otwórz metodę logowania Google, wyłącz ją i kliknij Zapisz.

      2. Otwórz ponownie metodę logowania Google, włącz ją, a następnie kliknij Zapisz.

2. Upewnij się, że Twoja aplikacja używa aktualnego pliku konfiguracyjnego Firebase (GoogleService-Info.plist).
   Pobierz plik konfiguracyjny aplikacji.

3. Sprawdź, czy błąd nadal występuje. Jeśli tak, przejdź do następnego kroku rozwiązywania problemu.

4. Sprawdź, czy wymagani klienci OAuth 2.0 są obecni.

   1. Na stronie Dane logowania w konsoli Google Cloud znajdź sekcję Identyfikatory klienta OAuth 2.0.

   2. Jeśli klientów OAuth 2.0 nie ma (i wykonano wszystkie powyższe czynności), skontaktuj się z zespołem pomocy.

Dlaczego w mojej aplikacji internetowej pojawia się ten błąd:
AuthErrorCode.INVALID_OAUTH_CLIENT_ID?

Jeśli widzisz ten błąd, wykonaj instrukcje zawarte w tym artykule z odpowiedziami na najczęstsze pytania:

AuthErrorCode.INVALID_OAUTH_CLIENT_ID

1. Sprawdź, czy logowanie Google jest prawidłowo włączone jako dostawca uwierzytelniania:

   1. W konsoli Firebase otwórz Authentication sekcję.

   2. Na karcie Metoda logowania wyłącz, a potem ponownie włącz metodę logowania Google (nawet jeśli jest już włączona):

      1. Otwórz metodę logowania Google, wyłącz ją i kliknij Zapisz.

      2. Otwórz ponownie metodę logowania Google, włącz ją, a następnie kliknij Zapisz.

2. W sekcji Authentication konfiguracji dostawcy logowania Google sprawdź też, czy identyfikator klienta OAuth i tajny klucz klienta pasują do klienta internetowego wyświetlanego na stronie Dane logowania w konsoli Google Cloud (w sekcji Identyfikatory klientów OAuth 2.0).

Dlaczego w mojej aplikacji internetowej logowanie z przekierowaniami kończy się niepowodzeniem i wyświetla się ten błąd:
This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation?

Jeśli widzisz ten błąd, wykonaj instrukcje zawarte w tym artykule z odpowiedziami na najczęstsze pytania:

This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation.

Ten błąd jest najprawdopodobniej spowodowany tym, że domena przekierowania nie jest wymieniona jako autoryzowana domena w przypadku Firebase Authentication lub klucz API używany w usłudze Firebase Authentication jest nieprawidłowy.

Najpierw sprawdź, czy YOUR_REDIRECT_DOMAIN znajduje się na liście autoryzowanych domen w projekcie w Firebase. Jeśli domena przekierowania jest już na liście, przejdź do rozwiązywania problemu z nieprawidłowym kluczem interfejsu API.

Domyślnie pakiet SDK JavaScript korzysta z klucza interfejsu API projektu Firebase oznaczonego jako Browser key. Używa go do weryfikowania, czy adres URL przekierowania logowania jest prawidłowy zgodnie z listą autoryzowanych domen.Firebase Authentication Authentication uzyskuje ten klucz interfejsu API w zależności od sposobu dostępu do pakietu Authentication SDK:

• Jeśli do logowania użytkowników za pomocą Authentication pakietu SDK JS używasz Hostingpomocników uwierzytelniania udostępnianych przez Firebase, Firebase automatycznie pobiera klucz interfejsu API wraz z pozostałą częścią konfiguracji Firebase za każdym razem, gdy wdrażasz aplikację w Firebase Hosting. Upewnij się, że authDomainaplikacja internetowafirebaseConfig jest prawidłowo skonfigurowana do korzystania z jednej z domen Hosting witryny. Możesz to sprawdzić, przechodząc do https://authDomain__/firebase/init.json i upewniając się, że projectId jest zgodny z tym z firebaseConfig.

• Jeśli samodzielnie hostujesz kod logowania, możesz użyć pliku __/firebase/init.json, aby przekazać konfigurację Firebase do samodzielnie hostowanego narzędzia pomocniczego przekierowania pakietu SDK Authentication JS. Klucz API i projectId wymienione w tym pliku konfiguracji powinny być zgodne z aplikacją internetowąfirebaseConfig.

Sprawdź, czy ten klucz interfejsu API nie został usunięty: w Google Cloud konsoli otwórz panel Interfejsy API i usługi > Dane logowania, w którym są wymienione wszystkie klucze interfejsu API w Twoim projekcie.

• Jeśli Browser key nie został usunięty, sprawdź:

  • Upewnij się, że Firebase Authentication API znajduje się na liście dozwolonych interfejsów API, do których klucz ma dostęp (więcej informacji o ograniczeniach interfejsów API dotyczących kluczy interfejsu API).

  • Jeśli samodzielnie hostujesz kod logowania, upewnij się, że klucz interfejsu API wymieniony w pliku __/firebase/init.json jest zgodny z kluczem interfejsu API w konsoli Google Cloud. W razie potrzeby popraw klucz w pliku, a następnie ponownie wdróż aplikację.

  • Jeśli klucz API Browser key został usunięty, Firebase może wygenerować nowy klucz API: w konsoli Firebase kliknij kolejno settings > Ustawienia projektu, a następnie w sekcji Twoje aplikacje kliknij aplikację internetową. Spowoduje to automatyczne utworzenie klucza API, który będzie widoczny w sekcji Konfiguracja pakietu SDK w przypadku Twojej aplikacji internetowej.

  Pamiętaj, że w Google Cloud konsoli ten nowy klucz interfejsu API nie będzie się nazywać Browser key. Będzie miał taką samą nazwę jak pseudonim aplikacji internetowej Firebase. Jeśli zdecydujesz się dodać ograniczenia interfejsu API do tego nowego klucza, upewnij się, że interfejs API Firebase Authentication znajduje się na liście dozwolonych interfejsów API.

  Po utworzeniu nowego klucza interfejsu API wykonaj odpowiednie czynności poniżej:

  • Jeśli używasz zarezerwowanych adresów URL, wdróż ponownie aplikację w Firebase, aby mogła automatycznie uzyskać nowy klucz interfejsu API wraz z pozostałą częścią konfiguracji Firebase.Hosting

  • Jeśli samodzielnie hostujesz kod logowania, skopiuj nowy klucz interfejsu API i dodaj go do pliku __/firebase/init.json, a następnie ponownie wdróż aplikację.

Jak ręcznie utworzyć klienta usługi internetowej OAuth?

1. Otwórz stronę Dane logowania w konsoli Google Cloud.

2. U góry strony wybierz Utwórz dane logowania > Identyfikator klienta OAuth.

3. Jeśli pojawi się prośba o skonfigurowanie ekranu zgody, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, a następnie wykonaj kolejne czynności opisane w tym artykule z odpowiedziami na najczęstsze pytania.

4. Utwórz klienta usługi internetowej OAuth:

   1. Jako Typ aplikacji wybierz Aplikacja internetowa.

   2. W polu Autoryzowane źródła JavaScriptu dodaj te informacje:

      • http://localhost
      • http://localhost:5000
      • https://PROJECT_ID.firebaseapp.com
      • https://PROJECT_ID.web.app

   3. W sekcji Autoryzowane identyfikatory URI przekierowania dodaj te informacje:

      • https://PROJECT_ID.firebaseapp.com/__/auth/handler
      • https://PROJECT_ID.web.app/__/auth/handler

   4. Zapisz klienta OAuth.

5. Skopiuj nowy identyfikator klienta OAuth i tajny klucz klienta do schowka.

6. W konsoli Firebase otwórz Authentication sekcję.

7. Na karcie Metoda logowania otwórz dostawcę Logowanie przez Google, a następnie wklej identyfikator klienta serwera internetowego i tajny klucz, które zostały utworzone i skopiowane z Google Cloud konsoli. Kliknij Zapisz.

Jak jest określana wartość %APP_NAME% w szablonie e-maila z potwierdzeniem, który można wysłać do użytkownika, gdy zarejestruje się on za pomocą adresu e-mail i hasła?

Przed grudniem 2022 r. symbol %APP_NAME% w szablonie e-maila był wypełniany nazwą marki OAuth, która była automatycznie udostępniana za każdym razem, gdy w projekcie w Firebase rejestrowano aplikację na Androida. Marka OAuth jest udostępniana tylko wtedy, gdy włączone jest Logowanie przez Google. Poniżej opisujemy, jak określa się wartość %APP_NAME%:

• Jeśli nazwa marki OAuth jest dostępna, w szablonie e-maila w miejscu %APP_NAME% pojawi się nazwa marki OAuth (tak jak przed grudniem 2022 r.).

• Jeśli nazwa jednostki OAuth nie jest dostępna, wartość %APP_NAME% w szablonie e-maila jest określana w ten sposób:

  • W przypadku aplikacji internetowych %APP_NAME% będzie domyślną Firebase Hosting nazwą witryny (wartością poprzedzającą .firebaseapp.com i .web.app, zwykle identyfikatorem projektu w Firebase).

  • W przypadku aplikacji mobilnych:

    • Jeśli w żądaniu występuje nazwa pakietu na Androida lub identyfikator pakietu na iOS, %APP_NAME% będzie nazwą aplikacji używaną w Sklepie Play lub App Store (odpowiednio).

    • W przeciwnym razie %APP_NAME% będzie domyślną Firebase Hostingnazwą witryny (wartością poprzedzającą .firebaseapp.com i .web.app, zwykle identyfikatorem projektu w Firebase).

  Pamiętaj, że jeśli wyszukiwanie domyślnej nazwy witryny Firebase Hosting się nie powiedzie, ostatecznym rozwiązaniem zastępczym jest użycie identyfikatora projektu Firebase jako %APP_NAME%.