获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Obsługa błędów uwierzytelniania platform Apple Firebase

Jeśli wywołanie zwrotne zakończenia metod uwierzytelniania otrzyma argument NSError , który nie jest nil, wystąpił błąd. Aby wysłać do odpowiedniej logiki obsługi błędów w kodzie produkcyjnym, sprawdź kod błędu pod kątem typowych błędów i błędów specyficznych dla metody wymienionych poniżej.

Niektóre błędy można rozwiązać za pomocą określonych działań użytkownika, na przykład FIRAuthErrorCodeUserTokenExpired można rozwiązać, logując użytkownika ponownie, a FIRAuthErrorCodeWrongPassword , prosząc użytkownika o podanie prawidłowego hasła.

Z wyjątkiem przypadku FIRAuthErrorCodeNetworkError lub FIRAuthErrorCodeTooManyRequests , ponowna próba operacji zakończonej niepowodzeniem z tymi samymi argumentami nigdy się nie powiedzie. Nie zakładaj, czy operacja odniosła skutek po stronie serwera.

Podczas badania lub rejestrowania błędów przejrzyj słownik userInfo . FIRAuthErrorNameKey zawiera międzyplatformowy ciąg nazwy błędu, którego można użyć do identyfikacji błędu. NSLocalizedDescriptionKey zawiera opis błędu. Ten opis jest przeznaczony dla programisty, a nie użytkownika. NSUnderlyingErrorKey zawiera błąd podstawowy, który spowodował dany błąd, jeśli występuje błąd podstawowy.

Oprócz głównych pól wymienionych powyżej, w słowniku userInfo mogą znajdować się inne pola, które mogą być przydatne podczas diagnozowania błędów.

Kody błędów wspólne dla wszystkich metod API

Kod Oznaczający
FIRAuthErrorCodeNetworkError Wskazuje, że podczas operacji wystąpił błąd sieci.
FIRAuthErrorCodeUserNotFound Wskazuje, że nie znaleziono konta użytkownika. Może się to zdarzyć, jeśli konto użytkownika zostało usunięte.
FIRAuthErrorCodeUserTokenExpired Wskazuje, że token bieżącego użytkownika wygasł, na przykład użytkownik mógł zmienić hasło do konta na innym urządzeniu. Musisz poprosić użytkownika o ponowne zalogowanie się na tym urządzeniu.
FIRAuthErrorCodeTooManyRequests Wskazuje, że żądanie zostało zablokowane po wysłaniu nieprawidłowej liczby żądań z urządzenia wywołującego do serwerów uwierzytelniania Firebase. Spróbuj ponownie za jakiś czas.
FIRAuthErrorCodeInvalidAPIKey Wskazuje, że aplikacja została skonfigurowana przy użyciu nieprawidłowego klucza API.
FIRAuthErrorCodeAppNotAuthorized Wskazuje, że aplikacja nie jest uprawniona do korzystania z uwierzytelniania Firebase za pomocą dostarczonego klucza API. przejdź do Konsoli API Google i sprawdź na karcie poświadczeń, czy klucz API, którego używasz, ma na białej liście identyfikator pakietu Twojej aplikacji.
FIRAuthErrorCodeKeychainError Wskazuje, że wystąpił błąd podczas uzyskiwania dostępu do pęku kluczy. Pola NSLocalizedFailureReasonErrorKey i NSUnderlyingErrorKey w słowniku NSError.userInfo będą zawierać więcej informacji o napotkanym błędzie.
FIRAuthErrorCodeInternalError Wskazuje, że wystąpił błąd wewnętrzny. Proszę zgłosić błąd z całym obiektem NSError .

Kody błędów specyficzne dla metody

FIRAuth

fetchProvidersForEmail:zakończenie:

Kod Oznaczający
FIRAuthErrorCodeInvalidEmail Wskazuje, że adres e-mail jest zniekształcony.

zaloguj się przez e-mail: hasło: ukończenie:

Kod Oznaczający
FIRAuthErrorCodeOperationNotAllowed Wskazuje, że konta e-mail i hasła nie są włączone. Włącz je w sekcji Auth konsoli Firebase .
FIRAuthErrorCodeInvalidEmail Wskazuje, że adres e-mail jest zniekształcony.
FIRAuthErrorCodeUserDisabled Wskazuje, że konto użytkownika jest wyłączone.
FIRAuthErrorCodeWrongPassword Wskazuje, że użytkownik próbował się zalogować przy użyciu nieprawidłowego hasła.

zaloguj się za pomocą poświadczeń: ukończenie:

Kod Oznaczający
FIRAuthErrorCodeInvalidCredential Wskazuje, że podane poświadczenie jest nieprawidłowe. Może się to zdarzyć, jeśli wygasł lub jest zniekształcony.
FIRAuthErrorCodeInvalidEmail Wskazuje, że adres e-mail jest zniekształcony, jeśli poświadczenie jest typu EmailPasswordAuthCredential .
FIRAuthErrorCodeOperationNotAllowed Wskazuje, że konta z dostawcą tożsamości reprezentowanym przez poświadczenie nie są włączone. Włącz je w sekcji Auth konsoli Firebase .
FIRAuthErrorCodeEmailAlreadyInUse Wskazuje, że adres e-mail potwierdzony przez poświadczenie (np. adres e-mail w tokenie dostępu do serwisu Facebook) jest już używany przez istniejące konto, którego nie można uwierzytelnić za pomocą tej metody logowania. Wywołaj fetchProvidersForEmail , aby uzyskać adres e-mail tego użytkownika, a następnie poproś go o zalogowanie się przy użyciu dowolnego zwróconego dostawcy logowania. Ten błąd zostanie zgłoszony tylko wtedy, gdy ustawienie „Jedno konto na adres e-mail” jest włączone w konsoli Firebase w obszarze Ustawienia uwierzytelniania.
FIRAuthErrorCodeUserDisabled Wskazuje, że konto użytkownika jest wyłączone.
FIRAuthErrorCodeWrongPassword Wskazuje, że użytkownik próbował zalogować się przy użyciu nieprawidłowego hasła, jeśli poświadczenie jest typu EmailPasswordAuthCredential .

Zaloguj się Anonimowo Z Dokończeniem:

Kod Oznaczający
FIRAuthErrorCodeOperationNotAllowed Wskazuje, że konta anonimowe nie są włączone. Włącz je w sekcji Auth konsoli Firebase .

signInWithCustomToken:ukończenie:

Kod Oznaczający
FIRAuthErrorCodeInvalidCustomToken Wskazuje błąd weryfikacji z tokenem niestandardowym.
FIRAuthErrorCodeCustomTokenMismatch Wskazuje, że konto usługi i klucz API należą do różnych projektów.

createUserWithEmail:hasło:zakończenie:

Kod Oznaczający
FIRAuthErrorCodeInvalidEmail Wskazuje, że adres e-mail jest zniekształcony.
FIRAuthErrorCodeEmailAlreadyInUse Wskazuje, że adres e-mail użyty do próby rejestracji już istnieje. Wywołaj fetchProvidersForEmail , aby sprawdzić, z jakich mechanizmów logowania korzystał taki użytkownik, i poproś go o zalogowanie się za pomocą jednego z nich.
FIRAuthErrorCodeOperationNotAllowed Wskazuje, że konta e-mail i hasła nie są włączone. Włącz je w sekcji Uwierzytelnianie konsoli Firebase .
FIRAuthErrorCodeWeakPassword Wskazuje próbę ustawienia hasła, które jest uważane za zbyt słabe. Pole NSLocalizedFailureReasonErrorKey w obiekcie słownika NSError.userInfo będzie zawierało bardziej szczegółowe wyjaśnienie, które można wyświetlić użytkownikowi.

Wyloguj się:

Kod Oznaczający
FIRAuthErrorCodeKeychainError Wskazał, że wystąpił błąd podczas uzyskiwania dostępu do pęku kluczy. Pola NSLocalizedFailureReasonErrorKey i NSUnderlyingErrorKey w słowniku NSError.userInfo będą zawierać więcej informacji o napotkanym błędzie.

FIRUser

Typowe błędy dla operacji FIRUser

Kod Oznaczający
FIRAuthErrorCodeInvalidUserToken Wskazuje, że token odświeżania zalogowanego użytkownika, który przechowuje informacje o sesji, jest nieprawidłowy. Musisz poprosić użytkownika o ponowne zalogowanie się na tym urządzeniu.
FIRAuthErrorCodeUserDisabled Wskazuje, że konto użytkownika jest wyłączone i nie można już z niego korzystać, dopóki nie zostanie ponownie włączone w panelu Użytkownicy w konsoli Firebase.

ponowne uwierzytelnienie WithCredential: zakończenie:

Kod Oznaczający
FIRAuthErrorCodeInvalidCredential Wskazuje, że podane poświadczenie jest nieprawidłowe. Może się to zdarzyć, jeśli wygasł lub jest zniekształcony.
FIRAuthErrorCodeInvalidEmail Wskazuje, że adres e-mail jest zniekształcony, jeśli poświadczenie jest typu EmailPasswordAuthCredential .
FIRAuthErrorCodeWrongPassword Wskazuje, że użytkownik próbował ponownie uwierzytelnić się z niepoprawnym hasłem, jeśli poświadczenie jest typu EmailPasswordAuthCredential .
FIRAuthErrorCodeUserMismatch Wskazuje, że podjęto próbę ponownego uwierzytelnienia użytkownika, który nie jest bieżącym użytkownikiem.
FIRAuthErrorCodeOperationNotAllowed Wskazuje, że konta z dostawcą tożsamości reprezentowanym przez poświadczenie nie są włączone. Włącz je w sekcji Auth konsoli Firebase .
FIRAuthErrorCodeEmailAlreadyInUse Wskazuje, że adres e-mail potwierdzony przez poświadczenie (np. adres e-mail w tokenie dostępu do serwisu Facebook) jest już używany przez istniejące konto, którego nie można ponownie uwierzytelnić za pomocą tej metody logowania. Wywołaj fetchProvidersForEmail , aby uzyskać adres e-mail tego użytkownika, a następnie poproś go o zalogowanie się przy użyciu dowolnego zwróconego dostawcy logowania. Ten błąd zostanie zgłoszony tylko wtedy, gdy ustawienie „Jedno konto na adres e-mail” jest włączone w konsoli Firebase w obszarze Ustawienia uwierzytelniania.
FIRAuthErrorCodeUserDisabled Wskazuje, że konto użytkownika jest wyłączone.

aktualizacjaE-mail:zakończenie:

Kod Oznaczający
FIRAuthErrorCodeEmailAlreadyInUse Wskazuje, że adres e-mail jest już używany przez inne konto.
FIRAuthErrorCodeInvalidEmail Wskazuje, że adres e-mail jest zniekształcony.
FIRAuthErrorCodeRequiresRecentLogin Aktualizacja adresu e-mail użytkownika jest operacją wrażliwą pod względem bezpieczeństwa, która wymaga niedawnego zalogowania się przez użytkownika. Ten błąd wskazuje, że użytkownik nie zalogował się wystarczająco niedawno. Aby rozwiązać problem, ponownie uwierzytelnij użytkownika, wywołując reauthenticateWithCredential:completion: on FIRUser .

aktualizacjaHasło:ukończenie:

Kod Oznaczający
FIRAuthErrorCodeOperationNotAllowed Wskazuje, że administrator wyłączył logowanie z określonym dostawcą tożsamości.
FIRAuthErrorCodeRequiresRecentLogin Aktualizacja hasła użytkownika jest operacją wrażliwą na bezpieczeństwo, która wymaga niedawnego zalogowania się przez użytkownika. Ten błąd wskazuje, że użytkownik nie zalogował się wystarczająco niedawno. Aby rozwiązać problem, ponownie uwierzytelnij użytkownika, wywołując reauthenticateWithCredential:completion: on FIRUser .
FIRAuthErrorCodeWeakPassword Wskazuje próbę ustawienia hasła, które jest uważane za zbyt słabe. Pole NSLocalizedFailureReasonErrorKey w obiekcie słownika NSError.userInfo będzie zawierało bardziej szczegółowe wyjaśnienie, które można wyświetlić użytkownikowi.

linkWithCredential:ukończenie:

Kod Oznaczający
FIRAuthErrorCodeProviderAlreadyLinked Wskazuje na próbę połączenia dostawcy typu już połączonego z tym kontem.
FIRAuthErrorCodeCredentialAlreadyInUse Wskazuje próbę połączenia z danymi uwierzytelniającymi, które zostały już połączone z innym kontem Firebase.
FIRAuthErrorCodeOperationNotAllowed Wskazuje, że konta z dostawcą tożsamości reprezentowanym przez poświadczenie nie są włączone. Włącz je w sekcji Auth konsoli Firebase .

Ta metoda może również zwracać kody błędów związane z updateEmail:completion: i updatePassword:completion: on FIRUser .

odłączenie od dostawcy: ukończenie:

Kod Oznaczający
FIRAuthErrorCodeNoSuchProvider Wskazuje próbę odłączenia dostawcy, który nie jest połączony z kontem.
FIRAuthErrorCodeRequiresRecentLogin Aktualizacja poczty e-mail to operacja wrażliwa pod względem bezpieczeństwa, która wymaga niedawnego zalogowania się przez użytkownika. Ten błąd wskazuje, że użytkownik nie zalogował się wystarczająco niedawno. Aby rozwiązać problem, ponownie uwierzytelnij użytkownika, wywołując reauthenticateWithCredential:completion: on FIRUser .

sendEmailVerification WithCompletion:

Kod Oznaczający
FIRAuthErrorCodeUserNotFound Wskazuje, że nie znaleziono konta użytkownika.

usuń z zakończeniem:

Kod Oznaczający
FIRAuthErrorCodeRequiresRecentLogin Usunięcie konta użytkownika jest operacją wrażliwą na bezpieczeństwo, która wymaga niedawnego zalogowania się przez użytkownika. Ten błąd wskazuje, że użytkownik nie zalogował się wystarczająco niedawno. Aby rozwiązać problem, ponownie uwierzytelnij użytkownika, wywołując reauthenticateWithCredential:completion: on FIRUser .