Post Change Password

Découvrez les Actions Post Change Password, qui s’exécutent après qu’un utilisateur d’une connexion à une base de données réinitialise ou modifie son mot de passe. Elles permettent d’aviser un autre système que le mot de passe de l’utilisateur a été modifié.

Le déclencheur post-change-password s’exécute après qu’un utilisateur d’une connexion à une base de données réinitialise ou modifie son mot de passe. Utilisez ce déclencheur pour envoyer un courriel à l’utilisateur après un changement de mot de passe ou pour aviser un autre système que le mot de passe de l’utilisateur a été modifié, afin de révoquer les autres sessions non gérées par Auth0. Plusieurs Actions peuvent être associées à ce déclencheur et s’exécutent dans l’ordre.

Les Actions de ce flux sont non bloquantes (asynchrones) : le pipeline Auth0 continue de s’exécuter sans attendre la fin de l’Action; le résultat de celle-ci n’a donc aucune incidence sur la transaction Auth0.

​

Références

• Objet Event : fournit des informations contextuelles sur l’utilisateur et la connexion associée au changement de mot de passe.
• Objet API : fournit des méthodes permettant de modifier le comportement du flux.

​

Cas d’utilisation courants

​

Invalider la session de l’utilisateur dans un autre système

Vous pouvez utiliser une Action post-change-password pour invalider la session de l’utilisateur dans un autre système :

const axios = require("axios");

/**
 * @param {Event} event - Renseignements sur l’utilisateur dont le mot de passe a été modifié.
 */
exports.onExecutePostChangePassword = async (event) => {
  axios.post("https://my-api.exampleco.com/revoke-session", { params: { email: event.user.email }});
};

Pour utiliser une bibliothèque npm comme axios, vous devez l’ajouter comme dépendance à l’Action. Pour en savoir plus, consultez la section « Ajouter une dépendance » dans Write Your First Action.

​

Envoyer un courriel après la modification du mot de passe de l’utilisateur

Une Action post-change-password peut servir à aviser l’utilisateur par courriel que son mot de passe a été modifié :

const axios = require("axios");

/**
 * @param {Event} event - Détails sur l’utilisateur dont le mot de passe a été modifié.
 */
exports.onExecutePostChangePassword = async (event) => {
  try {
    // https://sendgrid.api-docs.io/v3.0/mail-send
    axios.post('https://api.sendgrid.com/v3/mail/send',
      {
        personalizations: [{
          to: [{ email: event.user.email }]
        }],
        from: { email: '[e-mail]' },
        subject: 'Your password was changed',
        content: [{
          type: 'text/plain',
          value: 'The password for your ' + event.connection.name + ' account ' + event.user.email + ' was recently changed.'
        }]
      },
      {
        headers: {
          'Authorization': 'Bearer ' + event.secrets.SENDGRID_API_KEY
        },
      }
    );
  } catch (err) {
    console.log(`Error sending email to ${event.user.email}:`, err.message)
  }
};

Pour que cette Action s’exécute correctement, elle doit contenir un Secret nommé SENDGRID_API_KEY et dépendre du package axios de npm.