Skip to main content
Le script Get User implémente la fonction exécutée pour déterminer si un utilisateur existe ou non. Nous recommandons de nommer cette fonction getUser. Ce script est requis pour la migration automatique vers Auth0 et, lorsque la migration n’est pas activée, il peut être requis selon les opérations configurées pour la connexion. Auth0 recommande fortement que le user_id retourné dans le profil utilisateur soit permanent et cohérent : pour un utilisateur donné, le script Get User doit retourner le même user_id à chaque exécution. Consultez Retourner un user_id cohérent pour en savoir plus. Lorsque Import Users to Auth0 est activé, le script Get User s’exécute lorsqu’un utilisateur tente de s’inscrire afin de vérifier s’il existe déjà dans le magasin d’utilisateurs externe. Le script Get User s’exécute également lorsqu’un utilisateur tente de : Lorsque Import Users to Auth0 est désactivé, le script Get User s’exécute lorsqu’un utilisateur tente de s’inscrire afin de vérifier s’il existe déjà dans le magasin d’utilisateurs externe. Si l’utilisateur existe déjà dans le magasin d’utilisateurs externe, le script Create ne s’exécute pas. Le script Get User s’exécute également lorsqu’un utilisateur tente de :

Fonction Get User

La fonction getUser doit :
  • Envoyer l’identifiant de l’utilisateur à l’API de la base de données externe.
  • Retourner les données du profil de l’utilisateur si celui-ci a été trouvé.
  • Retourner une erreur s’il est impossible de déterminer si l’utilisateur existe ou non.

Définition

La fonction getUser accepte deux paramètres et renvoie une fonction callback :
Voici un pseudo-exemple en Javascript montrant comment vous pourriez implémenter la fonction getUser :

Fonction callback

La fonction callback sert à transmettre les données du profil utilisateur ou les données d’erreur dans le pipeline.

Définition

La fonction callback accepte jusqu’à deux paramètres et renvoie une fonction :

Retourner le profil de l’utilisateur (utilisateur trouvé)

Les données de profil renvoyées par le script Get User pour un utilisateur doivent être cohérentes avec celles renvoyées par le script Login.
Si l’utilisateur est trouvé, transmettez la valeur null au paramètre error et les données du profil de l’utilisateur au paramètre profile, sous forme normalisée :
En plus des champs standard, vous pouvez inclure les champs user_metadata, app_metadata et mfa_factors.

Retourner un user_id cohérent

Auth0 utilise le user_id retourné par le script Get User pour identifier l’utilisateur dans votre tenant. Pour un utilisateur donné, cette valeur doit être cohérente : le script Get User doit retourner le même user_id chaque fois qu’il s’exécute pour cet utilisateur. Générez le user_id à partir d’une propriété stable et permanente de l’enregistrement source (comme la clé primaire de la base de données), et non d’une valeur qui change d’une exécution à l’autre.
Retourner un user_id non cohérent peut créer des utilisateurs en double ou orphelins et interrompre les flows qui dépendent de la stabilité de l’identifiant.
Générez le user_id à partir d’une propriété stable de l’enregistrement source afin que le même utilisateur soit toujours mappé à la même valeur.
Ne générez pas de user_id nouveau ou aléatoire à chaque requête. Par exemple, ne retournez pas un UUID nouvellement généré. Cela produit un identifiant différent chaque fois que le script s’exécute pour un même utilisateur.

Ne retourner aucun profil utilisateur (utilisateur introuvable)

Si l’utilisateur est introuvable, transmettez une valeur null au paramètre error et omettez le paramètre profile :

Retourner une erreur

Si une erreur se produit, transmettez les données d’erreur au paramètre error avec les renseignements pertinents sur la cause du problème :
Pour en savoir plus, consultez Résoudre les problèmes liés aux bases de données personnalisées.

Exemples de scripts par langage

Auth0 fournit des scripts d’exemple pour les langages/technologies suivants :