Modifier le modèle de script de courriel

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.

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

Was this helpful?

/

Paramètre Type Description
email Chaîne Adresse courriel actuelle de l’utilisateur.
newEmail Chaîne Valeur à définir comme nouvelle adresse courriel de l’utilisateur dans la base de données externe.
verified Boolean Statut de vérification du courriel de la nouvelle adresse courriel.
callback Fonctionnalité 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);
  });

Was this helpful?

/

Fonction de rappel

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

Définition

callback(error, operationResult): function

Was this helpful?

/

Paramètre Type Requis Description
error Objet Requis Contient des données d’erreur.
operationResult Booléen Facultatif Indique 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);

Was this helpful?

/

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);

Was this helpful?

/

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."));

Was this helpful?

/

En savoir plus