Authentifizierungsfehler der Firebase Apple-Plattform beheben

Wenn der Abschluss-Callback für Authentication-Methoden ein NSError-Argument empfängt, das nicht null ist, ist ein Fehler aufgetreten. Weiterleitung zur entsprechenden Fehlerbehandlung in Ihrem Produktionscode verwenden, prüfen Sie den Fehlercode auf häufige Fehler methodenspezifischen Fehlern, die unten aufgeführt sind.

Einige Fehler können durch bestimmte Nutzeraktionen behoben werden, z. B. FIRAuthErrorCodeUserTokenExpired kann durch Anmeldung des Nutzers behoben werden und FIRAuthErrorCodeWrongPassword indem er den Nutzer bittet, das richtige Passwort eingeben.

Außer bei FIRAuthErrorCodeNetworkError oder FIRAuthErrorCodeTooManyRequests ist es nicht möglich, einen fehlgeschlagenen Vorgang mit denselben Argumenten noch einmal auszuführen. Keine Annahmen darüber anstellen, ob der Vorgang auf der Serverseite in Kraft getreten ist.

Prüfen Sie beim Untersuchen oder Logging von Fehlern das Wörterbuch userInfo. FIRAuthErrorNameKey enthält einen plattformübergreifenden Fehlernamen-String, der zur Identifizierung des Fehlers verwendet werden kann. NSLocalizedDescriptionKey enthält eine Beschreibung des Fehlers. Dieses Die Beschreibung richtet sich an den Entwickler, nicht an den Nutzer. NSUnderlyingErrorKey enthält den zugrunde liegenden Fehler, der den Fehler verursacht hat in ob ein zugrunde liegender Fehler vorliegt.

Neben den oben aufgeführten Hauptfeldern können in der Spalte userInfo-Wörterbuch, das bei der Fehlerdiagnose nützlich sein kann.

Fehlercodes, die für alle API-Methoden gelten

Code Bedeutung
FIRAuthErrorCodeNetworkError Gibt an, dass während des Vorgangs ein Netzwerkfehler aufgetreten ist.
FIRAuthErrorCodeUserNotFound Gibt an, dass das Nutzerkonto nicht gefunden wurde. Das kann passieren, wenn das Nutzerkonto gelöscht wurde.
FIRAuthErrorCodeUserTokenExpired Gibt an, dass das Token des aktuellen Nutzers abgelaufen ist, z. B. wenn der Nutzer das Kontopasswort auf einem anderen Gerät geändert hat. Sie müssen den Nutzer auffordern, sich auf diesem Gerät noch einmal anzumelden.
FIRAuthErrorCodeTooManyRequests Gibt an, dass die Anfrage blockiert wurde, nachdem eine ungewöhnliche Anzahl von Anfragen vom Aufrufergerät an die Firebase Authentication-Server gesendet wurde. Versuchen Sie es später noch einmal.
FIRAuthErrorCodeInvalidAPIKey Gibt an, dass die Anwendung mit einem ungültigen API-Schlüssel konfiguriert wurde.
FIRAuthErrorCodeAppNotAuthorized Die App ist nicht autorisiert, die Firebase-Authentifizierung mit dem angegebenen API-Schlüssel zu verwenden. Rufen Sie die Google API Console auf und prüfen Sie auf dem Tab „Anmeldedaten“, ob die Bundle-ID Ihrer Anwendung für den verwendeten API-Schlüssel auf die Zulassungsliste gesetzt wurde.
FIRAuthErrorCodeKeychainError Gibt an, dass beim Zugriff auf den Schlüsselbund ein Fehler aufgetreten ist. Die Felder NSLocalizedFailureReasonErrorKey und NSUnderlyingErrorKey im Wörterbuch NSError.userInfo enthalten weitere Informationen zum aufgetretenen Fehler.
FIRAuthErrorCodeInternalError Gibt an, dass ein interner Fehler aufgetreten ist. Melden Sie den Fehler mit dem gesamten NSError-Objekt.

Methodenspezifische Fehlercodes

FIRAuth

AbrufProvidersForEmail:Vervollständigung:

Code Bedeutung
FIRAuthErrorCodeInvalidEmail Gibt an, dass die E-Mail-Adresse fehlerhaft ist.

signInWithEmail:password:complete:

Code Bedeutung
FIRAuthErrorCodeOperationNotAllowed Gibt an, dass E-Mail- und Passwortkonten nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole.
FIRAuthErrorCodeInvalidEmail Gibt an, dass die E-Mail-Adresse fehlerhaft ist.
FIRAuthErrorCodeUserDisabled Gibt an, dass das Konto des Nutzers deaktiviert ist.
FIRAuthErrorCodeWrongPassword Gibt an, dass der Nutzer versucht hat, sich mit einem falschen Passwort anzumelden.

signInWithCredential:Completion:

Code Bedeutung
FIRAuthErrorCodeInvalidCredential Gibt an, dass die angegebenen Anmeldedaten ungültig sind. Das kann passieren, wenn sie abgelaufen oder fehlerhaft ist.
FIRAuthErrorCodeInvalidEmail Gibt an, dass die E-Mail-Adresse fehlerhaft ist, wenn Anmeldedaten vom Typ EmailPasswordAuthCredential sind.
FIRAuthErrorCodeOperationNotAllowed Gibt an, dass Konten beim Identitätsanbieter, der durch die Anmeldedaten vertreten wird, nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole.
FIRAuthErrorCodeEmailAlreadyInUse Gibt an, dass die durch die Anmeldedaten (z.B. die E-Mail-Adresse in einem Facebook-Zugriffstoken) bestätigte E-Mail-Adresse bereits von einem vorhandenen Konto verwendet wird, das mit dieser Anmeldemethode nicht authentifiziert werden kann. Rufen Sie fetchProvidersForEmail auf, um die E-Mail-Adresse dieses Nutzers zu erhalten, und fordern Sie ihn auf, sich über einen der zurückgegebenen Anbieter anzumelden. Dieser Fehler tritt nur auf, wenn die Option "Ein Konto pro E-Mail-Adresse" ist in der Firebase-Konsole unter „Authentication“-Einstellungen aktiviert.
FIRAuthErrorCodeUserDisabled Gibt an, dass das Konto des Nutzers deaktiviert ist.
FIRAuthErrorCodeWrongPassword Gibt an, dass der Nutzer versucht hat, sich mit einem falschen Passwort anzumelden, wenn Anmeldedaten vom Typ EmailPasswordAuthCredential sind.

signInAnonymouslyWithCompletion:

Code Bedeutung
FIRAuthErrorCodeOperationNotAllowed Gibt an, dass anonyme Konten nicht aktiviert sind. Aktiviere sie im Bereich „Authentifizierung“ der Firebase-Konsole.

signInWithCustomToken:complete:

Code Bedeutung
FIRAuthErrorCodeInvalidCustomToken Gibt einen Validierungsfehler beim benutzerdefinierten Token an.
FIRAuthErrorCodeCustomTokenMismatch Gibt an, dass das Dienstkonto und der API-Schlüssel zu verschiedenen Projekten gehören.

createUserWithEmail:password:completion:

Code Bedeutung
FIRAuthErrorCodeInvalidEmail Gibt an, dass die E-Mail-Adresse fehlerhaft ist.
FIRAuthErrorCodeEmailAlreadyInUse Gibt an, dass die für die Registrierung verwendete E-Mail-Adresse bereits vorhanden ist. Rufen Sie fetchProvidersForEmail auf, um zu prüfen, welche Anmeldemechanismen der Nutzer verwendet hat, und fordern Sie den Nutzer auf, sich mit einem dieser Mechanismen anzumelden.
FIRAuthErrorCodeOperationNotAllowed Gibt an, dass E-Mail- und Passwortkonten nicht aktiviert sind. Sie können sie im Bereich „Authentication“ der Firebase-Konsole aktivieren.
FIRAuthErrorCodeWeakPassword Weist auf einen Versuch hin, ein Passwort festzulegen, das als zu schwach eingestuft wird. Das Feld NSLocalizedFailureReasonErrorKey im Wörterbuchobjekt NSError.userInfo enthält eine detailliertere Erklärung, die dem Nutzer angezeigt werden kann.

Abmelden:

Code Bedeutung
FIRAuthErrorCodeKeychainError Gibt an, dass beim Zugriff auf den Schlüsselbund ein Fehler aufgetreten ist. Die Felder NSLocalizedFailureReasonErrorKey und NSUnderlyingErrorKey im Wörterbuch NSError.userInfo enthalten weitere Informationen zum aufgetretenen Fehler.

FIRUser

Häufige Fehler bei FIRUser-Vorgängen

Code Bedeutung
FIRAuthErrorCodeInvalidUserToken Gibt an, dass das Aktualisierungstoken des angemeldeten Nutzers, das die Sitzungsinformationen enthält, ungültig ist. Sie müssen den Nutzer auffordern, sich auf diesem Gerät noch einmal anzumelden.
FIRAuthErrorCodeUserDisabled Gibt an, dass das Konto des Nutzers deaktiviert ist und erst wieder verwendet werden kann, wenn es im Bereich „Nutzer“ in der Firebase-Konsole wieder aktiviert wird.

reauthenticateWithCredential:completion:

Code Bedeutung
FIRAuthErrorCodeInvalidCredential Gibt an, dass die angegebenen Anmeldedaten ungültig sind. Das kann passieren, wenn sie abgelaufen oder fehlerhaft ist.
FIRAuthErrorCodeInvalidEmail Gibt an, dass die E-Mail-Adresse fehlerhaft ist, wenn Anmeldedaten vom Typ EmailPasswordAuthCredential sind.
FIRAuthErrorCodeWrongPassword Gibt an, dass der Nutzer versucht hat, sich mit einem falschen Passwort noch einmal zu authentifizieren, wenn die Anmeldedaten vom Typ EmailPasswordAuthCredential sind.
FIRAuthErrorCodeUserMismatch Gibt an, dass versucht wurde, sich mit einem Nutzer neu zu authentifizieren, der nicht der aktuelle Nutzer ist.
FIRAuthErrorCodeOperationNotAllowed Gibt an, dass Konten mit dem durch die Anmeldedaten repräsentierten Identitätsanbieter nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole.
FIRAuthErrorCodeEmailAlreadyInUse Gibt an, dass die durch die Anmeldedaten (z.B. die E-Mail-Adresse in einem Facebook-Zugriffstoken) bestätigte E-Mail-Adresse bereits von einem vorhandenen Konto verwendet wird, das mit dieser Anmeldemethode nicht noch einmal authentifiziert werden kann. Rufen Sie fetchProvidersForEmail auf, um die E-Mail-Adresse dieses Nutzers zu erhalten, und fordern Sie ihn auf, sich über einen der zurückgegebenen Anbieter anzumelden. Dieser Fehler tritt nur auf, wenn die Option "Ein Konto pro E-Mail-Adresse" ist in der Firebase-Konsole unter „Authentication“-Einstellungen aktiviert.
FIRAuthErrorCodeUserDisabled Gibt an, dass das Konto des Nutzers deaktiviert ist.

updateEmail:completion:

Code Bedeutung
FIRAuthErrorCodeEmailAlreadyInUse Gibt an, dass die E-Mail-Adresse bereits von einem anderen Konto verwendet wird.
FIRAuthErrorCodeInvalidEmail Gibt an, dass die E-Mail-Adresse fehlerhaft ist.
FIRAuthErrorCodeRequiresRecentLogin Das Aktualisieren der E-Mail-Adresse eines Nutzers ist ein sicherheitsrelevanter Vorgang, der eine aktuelle Anmeldung des Nutzers erfordert. Dieser Fehler gibt an, dass sich der Nutzer nicht vor Kurzem angemeldet hat. Authentifiziere den Nutzer noch einmal, indem du reauthenticateWithCredential:completion: auf FIRUser aufrufst.

updatePassword:Vervollständigung:

Code Bedeutung
FIRAuthErrorCodeOperationNotAllowed Gibt an, dass der Administrator die Anmeldung über den angegebenen Identitätsanbieter deaktiviert hat.
FIRAuthErrorCodeRequiresRecentLogin Die Aktualisierung eines Nutzerpassworts ist ein sicherheitsrelevanter Vorgang, für den eine kürzliche Anmeldung des Nutzers erforderlich ist. Dieser Fehler gibt an, dass sich der Nutzer nicht kürzlich angemeldet hat. Authentifiziere den Nutzer noch einmal, indem du reauthenticateWithCredential:completion: auf FIRUser aufrufst.
FIRAuthErrorCodeWeakPassword Weist auf einen Versuch hin, ein Passwort festzulegen, das als zu schwach eingestuft wird. Das Feld NSLocalizedFailureReasonErrorKey im Wörterbuchobjekt NSError.userInfo enthält eine detailliertere Erklärung, die dem Nutzer angezeigt werden kann.

linkWithCredential:completion:

Code Bedeutung
FIRAuthErrorCodeProviderAlreadyLinked Gibt an, dass versucht wurde, einen Anbieter eines Typs zu verknüpfen, der bereits mit diesem Konto verknüpft ist.
FIRAuthErrorCodeCredentialAlreadyInUse Weist auf einen Versuch hin, eine Verknüpfung mit einem Berechtigungsnachweis herzustellen, der bereits mit einem anderen Firebase-Konto verknüpft wurde.
FIRAuthErrorCodeOperationNotAllowed Gibt an, dass Konten mit dem durch die Anmeldedaten repräsentierten Identitätsanbieter nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole.

Diese Methode kann auch Fehlercodes zurückgeben, die mit updateEmail:completion: und updatePassword:completion: am FIRUser.

unlinkFromProvider:completion:

Code Bedeutung
FIRAuthErrorCodeNoSuchProvider Zeigt an, dass versucht wurde, die Verknüpfung eines Anbieters aufzuheben, der nicht mit dem Konto verknüpft ist.
FIRAuthErrorCodeRequiresRecentLogin Die Aktualisierung der E-Mail-Adresse ist ein sicherheitsrelevanter Vorgang, für den eine kürzliche Anmeldung des Nutzers erforderlich ist. Dieser Fehler gibt an, dass sich der Nutzer nicht kürzlich angemeldet hat. Authentifizierung des Nutzers durch Aufrufen von reauthenticateWithCredential:completion: auf FIRUser noch einmal, um das Problem zu beheben.

sendEmailVerificationWithCompletion:

Code Bedeutung
FIRAuthErrorCodeUserNotFound Gibt an, dass das Nutzerkonto nicht gefunden wurde.

deleteWithCompletion:

Code Bedeutung
FIRAuthErrorCodeRequiresRecentLogin Das Löschen eines Nutzerkontos ist ein sicherheitsrelevanter Vorgang, für den eine kürzliche Anmeldung des Nutzers erforderlich ist. Dieser Fehler gibt an, dass sich der Nutzer nicht vor Kurzem angemeldet hat. Authentifiziere den Nutzer noch einmal, indem du reauthenticateWithCredential:completion: auf FIRUser aufrufst.