Gérer les erreurs d'authentification des plates-formes Apple Firebase

Si le rappel de complétion sur les méthodes d'authentification reçoit un argument NSError qui n'est pas nil, une erreur s'est produite. Pour envoyer à la logique de gestion des erreurs appropriée dans votre code de production, vérifiez le code d'erreur par rapport aux erreurs courantes et aux erreurs spécifiques à la méthode répertoriées ci-dessous.

Certaines erreurs peuvent être résolues par des actions utilisateur particulières, par exemple, FIRAuthErrorCodeUserTokenExpired peut être résolu en reconnectant l'utilisateur, et FIRAuthErrorCodeWrongPassword en demandant à l'utilisateur de fournir le bon mot de passe.

Sauf dans le cas de FIRAuthErrorCodeNetworkError ou FIRAuthErrorCodeTooManyRequests , réessayer une opération ayant échoué avec les mêmes arguments ne réussira jamais. Ne présumez pas si l'opération a pris effet ou non côté serveur.

Lors de la recherche ou de la journalisation des erreurs, consultez le dictionnaire userInfo . FIRAuthErrorNameKey contient une chaîne de nom d'erreur multiplateforme qui peut être utilisée pour identifier l'erreur. NSLocalizedDescriptionKey contient une description de l'erreur. Cette description est destinée au développeur, pas à l'utilisateur. NSUnderlyingErrorKey contient l'erreur sous-jacente qui a causé l'erreur en question, si une erreur sous-jacente est présente.

En plus des champs principaux répertoriés ci-dessus, il peut y avoir d'autres champs dans le dictionnaire userInfo que vous pouvez trouver utiles lors du diagnostic d'erreurs.

Codes d'erreur communs à toutes les méthodes API

Code Sens
FIRAuthErrorCodeNetworkError Indique qu'une erreur réseau s'est produite pendant l'opération.
FIRAuthErrorCodeUserNotFound Indique que le compte d'utilisateur n'a pas été trouvé. Cela peut arriver si le compte utilisateur a été supprimé.
FIRAuthErrorCodeUserTokenExpired Indique que le jeton de l'utilisateur actuel a expiré, par exemple, l'utilisateur peut avoir changé le mot de passe du compte sur un autre appareil. Vous devez inviter l'utilisateur à se reconnecter sur cet appareil.
FIRAuthErrorCodeTooManyRequests Indique que la requête a été bloquée après qu'un nombre anormal de requêtes ont été effectuées depuis l'appareil appelant vers les serveurs Firebase Authentication. Réessayez après un certain temps.
FIRAuthErrorCodeInvalidAPIKey Indique que l'application a été configurée avec une clé API non valide.
FIRAuthErrorCodeAppNotAuthorized Indique que l'application n'est pas autorisée à utiliser l'authentification Firebase avec la clé API fournie. accédez à la console d'API Google et vérifiez sous l'onglet des informations d'identification que la clé d'API que vous utilisez a l'ID de bundle de votre application sur liste blanche.
FIRAuthErrorCodeKeychainError Indique qu'une erreur s'est produite lors de l'accès au trousseau. Les champs NSLocalizedFailureReasonErrorKey et NSUnderlyingErrorKey du dictionnaire NSError.userInfo contiendront plus d'informations sur l'erreur rencontrée.
FIRAuthErrorCodeInternalError Indique qu'une erreur interne s'est produite. Veuillez signaler l'erreur avec l'intégralité de l'objet NSError .

Codes d'erreur spécifiques à la méthode

FIRAuth

fetchProvidersForEmail : achèvement :

Code Sens
FIRAuthErrorCodeInvalidEmail Indique que l'adresse e-mail est mal formée.

se connecterAvecEmail:motdepasse:achèvement:

Code Sens
FIRAuthErrorCodeOperationNotAllowed Indique que les comptes de messagerie et de mot de passe ne sont pas activés. Activez-les dans la section Auth de la console Firebase .
FIRAuthErrorCodeInvalidEmail Indique que l'adresse e-mail est mal formée.
FIRAuthErrorCodeUserDisabled Indique que le compte de l'utilisateur est désactivé.
FIRAuthErrorCodeWrongPassword Indique que l'utilisateur a tenté de se connecter avec un mot de passe erroné.

signInWithCredential:achèvement:

Code Sens
FIRAuthErrorCodeInvalidCredential Indique que les informations d'identification fournies ne sont pas valides. Cela peut arriver s'il a expiré ou s'il est malformé.
FIRAuthErrorCodeInvalidEmail Indique que l'adresse e-mail est incorrecte, si les informations d'identification sont du type EmailPasswordAuthCredential .
FIRAuthErrorCodeOperationNotAllowed Indique que les comptes avec le fournisseur d'identité représenté par les informations d'identification ne sont pas activés. Activez-les dans la section Auth de la console Firebase .
FIRAuthErrorCodeEmailAlreadyInUse Indique que l'e-mail affirmé par les informations d'identification (par exemple, l'e-mail dans un jeton d'accès Facebook) est déjà utilisé par un compte existant, qui ne peut pas être authentifié avec cette méthode de connexion. Appelez fetchProvidersForEmail pour l'e-mail de cet utilisateur, puis invitez-le à se connecter avec l'un des fournisseurs de connexion renvoyés. Cette erreur ne sera générée que si le paramètre "Un compte par adresse e-mail" est activé dans la console Firebase , sous Paramètres d'authentification.
FIRAuthErrorCodeUserDisabled Indique que le compte de l'utilisateur est désactivé.
FIRAuthErrorCodeWrongPassword Indique que l'utilisateur a tenté de se connecter avec un mot de passe erroné, si les informations d'identification sont du type EmailPasswordAuthCredential .

signInAnonymouslyWithCompletion :

Code Sens
FIRAuthErrorCodeOperationNotAllowed Indique que les comptes anonymes ne sont pas activés. Activez-les dans la section Auth de la console Firebase .

signInWithCustomToken : achèvement :

Code Sens
FIRAuthErrorCodeInvalidCustomToken Indique une erreur de validation avec le jeton personnalisé.
FIRAuthErrorCodeCustomTokenMismatch Indique que le compte de service et la clé API appartiennent à des projets différents.

createUserWithEmail:password:completion :

Code Sens
FIRAuthErrorCodeInvalidEmail Indique que l'adresse e-mail est mal formée.
FIRAuthErrorCodeEmailAlreadyInUse Indique que l'e-mail utilisé pour tenter de s'inscrire existe déjà. Appelez fetchProvidersForEmail pour vérifier les mécanismes de connexion utilisés par cet utilisateur et invitez l'utilisateur à se connecter avec l'un d'entre eux.
FIRAuthErrorCodeOperationNotAllowed Indique que les comptes de messagerie et de mot de passe ne sont pas activés. Activez-les dans la section Authentification de la console Firebase .
FIRAuthErrorCodeWeakPassword Indique une tentative de définition d'un mot de passe considéré comme trop faible. Le champ NSLocalizedFailureReasonErrorKey dans l'objet dictionnaire NSError.userInfo contiendra une explication plus détaillée qui peut être montrée à l'utilisateur.

se déconnecter:

Code Sens
FIRAuthErrorCodeKeychainError A indiqué qu'une erreur s'est produite lors de l'accès au trousseau. Les champs NSLocalizedFailureReasonErrorKey et NSUnderlyingErrorKey du dictionnaire NSError.userInfo contiendront plus d'informations sur l'erreur rencontrée.

FIRUser

Erreurs courantes pour les opérations FIRUser

Code Sens
FIRAuthErrorCodeInvalidUserToken Indique que le jeton d'actualisation de l'utilisateur connecté, qui contient les informations de session, n'est pas valide. Vous devez inviter l'utilisateur à se reconnecter sur cet appareil.
FIRAuthErrorCodeUserDisabled Indique que le compte de l'utilisateur est désactivé et ne peut plus être utilisé tant qu'il n'est pas réactivé depuis le panneau Utilisateurs de la console Firebase.

reauthenticateWithCredential : achèvement :

Code Sens
FIRAuthErrorCodeInvalidCredential Indique que les informations d'identification fournies ne sont pas valides. Cela peut arriver s'il a expiré ou s'il est malformé.
FIRAuthErrorCodeInvalidEmail Indique que l'adresse e-mail est incorrecte, si les informations d'identification sont du type EmailPasswordAuthCredential .
FIRAuthErrorCodeWrongPassword Indique que l'utilisateur a tenté de se réauthentifier avec un mot de passe incorrect, si les informations d'identification sont du type EmailPasswordAuthCredential .
FIRAuthErrorCodeUserMismatch Indique qu'une tentative a été faite pour se réauthentifier auprès d'un utilisateur qui n'est pas l'utilisateur actuel.
FIRAuthErrorCodeOperationNotAllowed Indique que les comptes avec le fournisseur d'identité représenté par les informations d'identification ne sont pas activés. Activez-les dans la section Auth de la console Firebase .
FIRAuthErrorCodeEmailAlreadyInUse Indique que l'e-mail affirmé par l'identifiant (par exemple, l'e-mail dans un jeton d'accès Facebook) est déjà utilisé par un compte existant, qui ne peut pas être réauthentifié avec cette méthode de connexion. Appelez fetchProvidersForEmail pour l'e-mail de cet utilisateur, puis invitez-le à se connecter avec l'un des fournisseurs de connexion renvoyés. Cette erreur ne sera générée que si le paramètre "Un compte par adresse e-mail" est activé dans la console Firebase , sous Paramètres d'authentification.
FIRAuthErrorCodeUserDisabled Indique que le compte de l'utilisateur est désactivé.

updateEmail : achèvement :

Code Sens
FIRAuthErrorCodeEmailAlreadyInUse Indique que l'e-mail est déjà utilisé par un autre compte.
FIRAuthErrorCodeInvalidEmail Indique que l'adresse e-mail est mal formée.
FIRAuthErrorCodeRequiresRecentLogin La mise à jour de l'e-mail d'un utilisateur est une opération sensible à la sécurité qui nécessite une connexion récente de l'utilisateur. Cette erreur indique que l'utilisateur ne s'est pas connecté assez récemment. Pour résoudre le problème, réauthentifiez l'utilisateur en reauthenticateWithCredential:completion: on FIRUser .

updatePassword:achèvement :

Code Sens
FIRAuthErrorCodeOperationNotAllowed Indique que l'administrateur a désactivé la connexion avec le fournisseur d'identité spécifié.
FIRAuthErrorCodeRequiresRecentLogin La mise à jour du mot de passe d'un utilisateur est une opération sensible à la sécurité qui nécessite une connexion récente de l'utilisateur. Cette erreur indique que l'utilisateur ne s'est pas connecté assez récemment. Pour résoudre le problème, réauthentifiez l'utilisateur en reauthenticateWithCredential:completion: on FIRUser .
FIRAuthErrorCodeWeakPassword Indique une tentative de définition d'un mot de passe considéré comme trop faible. Le champ NSLocalizedFailureReasonErrorKey dans l'objet dictionnaire NSError.userInfo contiendra une explication plus détaillée qui peut être montrée à l'utilisateur.

lienAvecCredential : achèvement :

Code Sens
FIRAuthErrorCodeProviderAlreadyLinked Indique une tentative de lier un fournisseur d'un type déjà lié à ce compte.
FIRAuthErrorCodeCredentialAlreadyInUse Indique une tentative d'association avec un identifiant qui a déjà été associé à un autre compte Firebase.
FIRAuthErrorCodeOperationNotAllowed Indique que les comptes avec le fournisseur d'identité représenté par les informations d'identification ne sont pas activés. Activez-les dans la section Auth de la console Firebase .

Cette méthode peut également renvoyer des codes d'erreur associés à updateEmail:completion: et updatePassword:completion: on FIRUser .

unlinkFromProvider : achèvement :

Code Sens
FIRAuthErrorCodeNoSuchProvider Indique une tentative de dissociation d'un fournisseur qui n'est pas lié au compte.
FIRAuthErrorCodeRequiresRecentLogin La mise à jour des e-mails est une opération sensible à la sécurité qui nécessite une connexion récente de l'utilisateur. Cette erreur indique que l'utilisateur ne s'est pas connecté assez récemment. Pour résoudre le problème, réauthentifiez l'utilisateur en reauthenticateWithCredential:completion: on FIRUser .

sendEmailVerificationWithCompletion :

Code Sens
FIRAuthErrorCodeUserNotFound Indique que le compte d'utilisateur n'a pas été trouvé.

deleteWithCompletion :

Code Sens
FIRAuthErrorCodeRequiresRecentLogin La suppression d'un compte d'utilisateur est une opération sensible à la sécurité qui nécessite une connexion récente de l'utilisateur. Cette erreur indique que l'utilisateur ne s'est pas connecté assez récemment. Pour résoudre le problème, réauthentifiez l'utilisateur en reauthenticateWithCredential:completion: on FIRUser .