Dépannage des bases de données personnalisées

Comment gérer les erreurs et résoudre les problèmes lorsque vous utilisez votre propre base de données comme fournisseur d’identité.

Il se peut que vous receviez des erreurs provenant de votre base de données personnalisée. Vous pouvez aussi renvoyer des erreurs depuis les scripts d’action de votre connexion à une base de données personnalisée à des fins de dépannage.

​

Types d’erreur pour les bases de données personnalisées

Les connexions de base de données peuvent renvoyer les erreurs suivantes :

Erreur	Script Login	Description
new WrongUsernameOrPasswordError( <email or user_id>, <message> )	Login	Se produit lorsque les identifiants de l’utilisateur ne sont pas valides. Si vous ne transmettez aucun argument ou si le premier argument est une valeur fausse, l’erreur sera consignée comme un événement fu (nom d’utilisateur/courriel invalide) avec une chaîne vide comme user_id. Si vous transmettez un premier argument ayant une valeur vraie, l’erreur sera consignée comme un événement fp (l’utilisateur existe, mais le mot de passe n’est pas valide) avec une valeur user_id de auth0|<first_argument>. Pour en savoir plus, consultez Log Event Type Codes.
new ValidationError( <user_exists>, <message> )	Create	Se produit lorsqu’un utilisateur existe déjà dans votre base de données.
callback(<null>,<false>)	Change Password	Se produit lorsque le mot de passe de l’utilisateur n’a pas été mis à jour.
callback(<null>)	Get User	Se produit lorsque l’utilisateur est introuvable.
new UnauthorizedError(<message>)	All Login Scripts	Se produit lorsqu’un problème survient pendant la tentative d’accès à la base de données. Il s’agit de la méthode privilégiée pour transmettre au frontal les erreurs provenant des bases de données personnalisées.
new Error(<message>)	All Login Scripts	Se produit lorsqu’un problème survient pendant la tentative d’accès à la base de données.
error code: auth0_idp_error; user already exists	Create	Se produit dans un magasin d’identité hérité lorsque vous tentez de créer un utilisateur qui existe déjà dans votre magasin d’identité hérité ou dans Auth0.
error code: auth0_idp_error; user already exists	Delete	Se produit dans un magasin d’identité hérité lorsque vous tentez de supprimer un utilisateur à l’aide de scripts de base de données personnalisée. L’erreur peut aussi se présenter sous la forme « Error! There was a problem deleting [e-mail] » ou « Sandbox Error: Please implement the Delete script for this database connection at https://manage.auth0.com/#/connections/database ».

​

Renvoyer des erreurs

Pour renvoyer une erreur, appelez la fonction callback() et passez error en premier paramètre :

callback(error);

Par exemple :

callback(new ValidationError('email-too-long', 'Email is too long.'));

​

Renvoyer des erreurs lors de l’utilisation de Lock

Si vous utilisez Lock, vous pouvez personnaliser les messages d’erreur en les ajoutant au dictionnaire.

​

Résolution des erreurs

Testez le script à l’aide du bouton Try.

Si vous n’obtenez pas le résultat attendu ou si vous recevez une erreur, consultez les journaux en temps réel des Actions, ajoutez des instructions console.log() à votre script, puis testez de nouveau la connexion. La sortie de console.log() s’affiche dans la fenêtre des journaux en temps réel des Actions.

Il se peut que vous rencontriez des erreurs lorsque vous utilisez des scripts d’action pour importer, créer ou supprimer des utilisateurs. Utilisez console.logs pour vérifier si l’erreur est causée par l’utilisation de scripts d’action. Pour en savoir plus, consultez les modèles de script d’action pour base de données personnalisée.