多要素認証でAuth0のUnified Phone Experienceを使用する

​

電話プロバイダーを更新する

• 現在の設定を確認する
• プロバイダーを設定する:
  • Twilio を設定する
  • カスタム電話プロバイダーを設定する
• 電話認証要素と配信方法を更新する
• Management API エンドポイントを更新する
• Auth0 Actions のトリガーを更新する

​

現在の設定を確認する

1. 現在の MFA 設定を確認するには、Auth0 Dashboard > Security > Multi-factor Auth に移動します。
2. Phone Message を選択します。
3. 新しい Auth0 テナントでは Unified Phone Experience を利用でき、テナントの電話プロバイダーを設定するよう促すバナーが表示されます。
   

• 2025 年 3 月より前からある既存のテナントでは、Unified Phone Experience に加えて、多要素認証 (MFA) 用の SMS and Voice 通知も設定できます。
  

4. テナント設定を確認するには、Auth0 Dashboard > Tenant Settings に移動します。
5. Advanced を選択します。
6. Unified Phone Experience を探します。
   
7. 必要に応じて有効にします。

​

Twilio をテナントレベルのプロバイダーとして設定する

1. Branding > Phone Provider に移動します。
2. プロバイダーを選択して設定します。
   
   1. 電話プロバイダーとして Twilio を選択します。
   2. 配信方法を選択します。
   3. Twilio の設定を入力します。
      必要な MFA 認証要素は、テナントレベルで設定する配信方法のサブセットである必要があります。
3. 変更を保存します。
4. Send Test Message を選択して、本番環境で使用する前にテナントレベルのプロバイダーをテストします。
5. テナントレベルのプロバイダーを有効にします。
   1. MFA の場合は、Security > Multi-factor Auth > Phone Message. に移動します。
   2. Use Tenant-level Messaging Provider を選択します。
      テナントにこのトグルが表示されない場合は、すでに Unified Phone Experience を使用しています。
6. 変更を保存します。

​

Auth0 Actions を使用してカスタムプロバイダーを設定する

• メッセージタイプと通知タイプの間に 1:1 の対応関係はありません。
• send-phone-message トリガー に関連付けられた secrets や dependencies を移行すると、セキュリティ上の懸念が生じたり、テナントでの動作に影響が出たりする可能性があります。
• Actions は複数のトリガーをサポートできるため、移行が難しい場合があります。たとえば、Actions は send-phone-message トリガーと post-login トリガーの両方をサポートできます。
• send-phone-message トリガー と custom-phone-provider トリガー では、サポートされるイベントタイプが異なります。
  • send-phone-message は SMS and Voice のメッセージタイプをサポートします。詳しくは、Action triggers: send-phone-message Event Object を参照してください。
  • custom-phone-provider は、otp_verify、otp_enroll、blocked_account、change_password、password_breach の通知タイプをサポートします。詳しくは、Actions triggers: custom-phone-provider Event Object を参照してください。
• カスタム phone provider ごとに設定できる Action は 1 つだけです。すでにカスタム phone provider に Action を設定している場合は、新しい Action に関連付ける前に、必ず無効にする必要があります。

const { fetch } = require('undici');
/**
* 電話通知の送信中に実行されるハンドラー
* @param {Event} event - ユーザーおよびログイン時のコンテキストに関する詳細情報。
* @param {CustomPhoneProviderAPI} api - 電話通知の送信動作を変更するためのメソッドとユーティリティ。
*/
exports.onExecuteCustomPhoneProvider = async (event, api) => {

  if (event.notification.message_type.startsWith('otp')) {
    const body = {
      from: event.notification.from,
      action: event.notification.message_type === 'otp_verify' ? 'second-factor-authenticator' : 'enrollment',
      language: event.notification.locale,
      recipient: event.notification.recipient,
      message_type: event.notification.delivery_method,
      text: event.notification.as_text,
      code: event.notification.code,
    };

    const response = await fetch(event.secrets['MY_ENDPOINT'], {
      method: 'POST',
      headers: {
        authorization: `Bearer ${event.secrets['MY_SECRET']}`,
      },
      body: JSON.stringify(body),
    });

    console.log(response.status); // 200
    console.log(await response.text()); // リクエストのレスポンスボディ！
  }

  return;
};

​

MFA custom-phone-provider を設定する

1. Branding > Phone Provider に移動します。
2. プロバイダーを選択します。
   1. Custom を選択します。
   2. Provider Configuration で、埋め込みコードエディターに翻訳した send-phone-message Action コードを追加します。
3. 変更を Save します。
4. 本番環境で使用する前に、Send Test Message を選択してテナントレベルのプロバイダーをテストします。
5. Security > Multi-factor Auth > Phone Message に戻り、Use Tenant-level Messaging Provider を有効にします。
6. 変更を Save します。

​

MFA の 電話認証要素 と 配信方法 を更新する

Auth0 Dashboard でテナントレベルのプロバイダーを有効にしていない場合、MFA 用の電話認証要素である SMS と音声を設定することはできません。

​

Management API を使用して Guardian エンドポイントを更新する

​

電話プロバイダーを無効にする