Passer au contenu principal
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 : 
changeEmail(email, newEmail, verified, callback): function
ParamètreTypeDescription
emailChaîneAdresse courriel actuelle de l’utilisateur.
newEmailChaîneValeur à définir comme nouvelle adresse courriel de l’utilisateur dans la base de données externe.
verifiedBooleanStatut de vérification du courriel de la nouvelle adresse courriel.
callbackFonctionnalitéUtilisée pour transmettre les données d’erreur à travers le pipeline.

​
Exemple

Il s’agit d’un exemple pseudo-JavaScript de la manière dont vous pourriez implémenter la fonction changeEmail : 
function (email, newEmail, verified, callback) {
  // Prepare the API call
  let options = {
    url: "https://example.com/api/users",
    action: "PATCH",
    body: {
      email: email,
      new_email: newEmail,
      email_verified: verified
    }
  };

  // Call the API
  send(options, err => {
    // Return `false` value in callback if operation failed
    if (err && err.id == "FAIL_CHANGE_EMAIL") {
      return callback(null, false);
    } else if (err) {
      // Return error in callback if unspecified error occurred
      return callback(new Error("My custom error message."));
    }

    // Return `true` value in callback if operation succeeded
    return callback(null, true);
  });

​
Fonction de rappel

La fonction de callback accepte deux paramètres et renvoie une fonction.

​
Définition

callback(error, operationResult): function
ParamètreTypeRequisDescription
errorObjetRequisContient des données d’erreur.
operationResultBooléenFacultatifIndique le résultat de l’opération de modification de courriel.

​
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 : 
return callback(null, true);

​
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 : 
return callback(null, false);

​
Renvoyer une erreur

Si une erreur survient, renvoyez la fonction de callback, et passer l’information pertinente concernant l’erreur comme paramètre error : 
return callback(new Error("My custom error message."));

​
En savoir plus