Post Change Password

データベース接続のユーザーがパスワードをリセットまたは変更した後に実行される Post Change Password Actions について説明します。これらを使用して、ユーザーのパスワードが変更されたことを別のシステムに通知できます。

post-change-password トリガーは、データベース接続のユーザーがパスワードをリセットまたは変更した後に実行されます。このトリガーを使用すると、パスワード変更後にユーザーにメールを送信したり、ユーザーのパスワードが変更されたことを別のシステムに通知したりできます。これにより、Auth0 で管理されていない他のセッションを取り消すことができます。このトリガーには複数の Action をバインドでき、Actions は順に実行されます。

このフロー内の Actions は非ブロッキング (非同期) です。Auth0 パイプラインは Action の完了を待たずに実行を継続するため、Action の結果は Auth0 トランザクションに影響しません。

​

参照

• イベントオブジェクト: パスワードが変更されたユーザーおよび接続に関するコンテキスト情報を提供します。
• APIオブジェクト: フローの動作を変更するためのメソッドを提供します。

​

一般的なユースケース

​

別のシステム上のユーザーセッションを無効化する

post-change-password Actionを使用すると、別のシステム上のユーザーセッションを無効化できます。

const axios = require("axios");

/**
 * @param {Event} event - パスワードが変更されたユーザーの情報。
 */
exports.onExecutePostChangePassword = async (event) => {
  axios.post("https://my-api.exampleco.com/revoke-session", { params: { email: event.user.email }});
};

axios などの npm ライブラリを使用するには、そのライブラリを Action の依存関係として追加する必要があります。詳しくは、Write Your First Action の「依存関係を追加する」セクションを参照してください。

​

ユーザーがパスワードを変更した後にメールを送信する

post-change-password Action を使用して、パスワードが変更されたことをメールでユーザーに通知できます。

const axios = require("axios");

/**
 * @param {Event} event - パスワードが変更されたユーザーの詳細。
 */
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)
  }
};

このActionを正しく実行するには、SENDGRID_API_KEYという名前のSecretを設定し、axios npmパッケージを依存関係として追加する必要があります。