Le script Change Email (Modifier le courriel) met en œuvre la fonction définie lorsque l’adresse de courriel d’un utilisateur ou son statut de vérification de l’adresse courriel change. Nous recommandons de nommer cette fonction changeEmail (Modifier le courriel).
Le script est seulement utilisé dans un scénario d’authentification héritée, et est nécessaire si vous souhaitez mettre à jour l’adresse de courriel d’un utilisateur (et/ou le statut de vérification de l’adresse courriel) dans Auth0 et dans votre base de données externe au cours de la même opération.
Le script Modifier le courriel n’est pas configurable via Auth0 Dashboard. Pour gérer ce script, vous devez utiliser le point de terminaison de Management API Auth0 Créer une connexion ou Mettre à jour une connexion, ou l’outil Auth0 Deploy CLI.
Si vous gérez les scripts d’action de la base de données d’une connexion personnalisée via le Auth0 Dashboard (Tableau de bord Auth0), le script de changement de courriel sera automatiquement supprimé lors de l’enregistrement.Pour vous assurer que le script de modification de courriel n’est pas supprimé accidentellement, utilisez Management API Auth0 ou l’outil Auth0 Deploy CLI lorsque vous gérez la connexion.Si vous changez manuellement l’adresse courriel d’un utilisateur dans votre base de données personnalisée, vous devez patcher l’utilisateur séparément. Auth0 ne détectera pas automatiquement le changement.
Fonction changeEmail
La fonction changeEmail devrait :
- Mettre à jour de l’adresse courriel de l’utilisateur dans la base de données externe.
- Renvoyer une erreur si l’opération a échoué ou si une erreur s’est produite.
Définition
La fonction changeEmail accepte quatre paramètres et renvoi à une fonction de callback :
Exemple
Il s’agit d’un exemple pseudo-JavaScript de la manière dont vous pourriez implémenter la fonction changeEmail :
Fonction de rappel
La fonction de callback accepte deux paramètres et renvoie une fonction.
Définition
Retourne un succès
Si l’opération de modification de courriel est réussie, renvoyez la fonction de callback, et passez à une valeur null comme paramètre d’error et une valeur true comme paramètre operationResult :
Renvoyer un échec
Si l’opération de modification du courriel a échoué, renvoyez la fonction de callback, et passez à une valeur null comme paramètre d’error et une valeur false comme paramètre operationResult :
Renvoyer une erreur
Si une erreur survient, renvoyez la fonction de callback, et passer l’information pertinente concernant l’erreur comme paramètre error :
En savoir plus
