Send Phone Message

SMS または Voice を多要素認証（MFA）の認証要素として使用する際に、登録およびチャレンジのプロセスで実行される Send Phone Message Actions について説明します。

send-phone-message トリガーは、SMS/Voice を多要素認証 (MFA) の認証要素として使用する際に実行されます。登録プロセスとチャレンジプロセス (event.message_options.action) の両方で実行され、Universal Login の New experience を使用している場合は、voice メッセージタイプ (event.message_options.message_type === 'voice') でも実行されます。メッセージの送信にカスタムプロバイダーを使用する場合、このトリガーはカスタムプロバイダーの設定に必要です。

このフローの Actions はブロッキング (同期) で実行されます。トリガーの処理の一部として実行され、Action が完了するまで Auth0 パイプラインの残りの処理は実行されません。

​

リファレンス

• イベントオブジェクト: 送信するメッセージ、およびchallenge の対象となるユーザーまたは登録するユーザーに関するコンテキスト情報を提供します。
• API オブジェクト: フローの動作を変更するためのメソッドを提供します。

​

一般的なユースケース

​

カスタムSMSプロバイダーを使用する

send-phone-message Actionを使用すると、カスタムSMSプロバイダー経由でMFAメッセージを送信できます。

const AWS = require("aws-sdk");

/**
 * @param {Event} event - ユーザー、およびログインが行われるコンテキストに関する詳細情報。
 */
exports.onExecuteSendPhoneMessage = async (event) => {
  const text = event.message_options.text;
  const recipient = event.message_options.recipient;

  const awsSNS = new AWS.SNS({
    apiVersion: "2010-03-31",
    region: event.secrets.AWS_REGION,
    credentials: new AWS.Credentials(event.secrets.AWS_ACCESS_KEY_ID, event.secrets.AWS_SECRET_ACCESS_KEY)
  });

  const params = { Message: text, PhoneNumber: recipient };

  return awsSNS
    .publish(params)
    .promise();
};

このActionが正しく実行されるには、AWS_REGION、AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEYという名前のsecretsが設定されており、aws-sdkのnpm packageにdependencyがある必要があります。