多要素認証のSMSと音声メッセージのカスタマイズする

登録と検証中にAuth0から送られたSMSと音声メッセ―ジのカスタマイズ方法について説明します。

登録（Guardianにデバイスを関連付ける場合）や検証（デバイスに認証メッセージが送られた場合）中にAuth0から送られたSMSや音声メッセージをカスタマイズすることができます。

1. ［Dashboard］>［Security（セキュリティ）］>［Multi-factor Auth（多要素認証）］に移動し、 ［Phone Message（電話メッセ―ジ）］ をクリックします。
2. メッセージのテンプレートをカスタマイズし、 ［Save（保存）］ をクリックします。

2つのメッセージタイプにテンプレートをカスタマイズできます。

• ［Enrollment（登録）］ ：デバイスエンロールメント中にAuth0から送られたメッセージ。
• ［Verification（検証）］ ：デバイスの所有を検証するためにAuth0から送られたメッセージ。

​

構文

Liquid構文は、SMSテンプレートでユーザー属性にアクセスする際に使用するサポート対象のテンプレートエンジンのことです。次の属性を使用できます。

属性	説明
message_type	どの種類のメッセージが送信されるかを示します（smsまたはvoice）。
code	登録/検証コード。音声メッセージを送信する場合。変数の値は数字の間にドットを入れて区切ります（1.2.3.4.5）。これで、音声メッセージングプロバイダーによって正確に発音されます。
locale	ユニバーサルログインまたはMFA API用。言語を指定します。
requestInfo.lang	クラシックログインのローカリゼーション用。ブラウザーからのAccept-Languageヘッダー。例：es-AR,es;q=8.0、en-US,en
tenant.friendlyName	［Dashboard］>［Tenant Settings（テナント設定）］で設定されたフレンドリー名前。

​

例

{% if message_type == "voice" %}
  {% if locale contains "fr" %}
  Bonjour, vous avez demandé à recevoir un code de vérification pour vous enregister avec {{tenant.friendly_name}}. Votre code est: {{pause}} {{code}}. Je répète, votre code est: {{pause}}{{code}}.
  {% elsif locale contains "es" %}
  Usted ha requerido un código de verificación para inscribirse con {{tenant.friendly_name}}. Su código es: {{pause}}{{code}}. Repito, su código es: {{pause}}{{code}}.
  {% else %}
  Hello, you requested a verification code to enroll with {{tenant.friendly_name}}. Your code is: {{pause}}{{code}}. I repeat, your code is: {{pause}}{{code}}.
  {% endif %}
{% else %}
  {% if locale contains "fr" %}
  {{code}} est votre code de vérification pour vous enregistrer avec {{tenant.friendly_name}}.
  {% elsif locale contains "es" %}
  {{code}} es su código para inscribirse con {{tenant.friendly_name}}.
  {% else %}
  {{code}} is your verification code to enroll with {{tenant.friendly_name}}.
  {% endif %}
{% endif %}

​

ローカリゼーション

エンドポイントは、x-request-languageヘッダーをサポートし、それをロケールに送ることができます。詳細については、「多言語サポート」を参照してください。

MFA API（POST /mfa/associateとPOST /mfa/challengeエンドポイント）でもサポートされています。送られたら、そのロケールはMFA SMS/音声テンプレートのlocale変数で利用可能です。

これらを機能させるためには、 ［Tenant（テナント）］>［Settings（設定）］ （ ［Supported Languages（サポートされる言語）］ の下）から対象言語を選択する必要があります。

​

もっと詳しく

• 多要素認証（MFA）
• MFAにSMSと音声通知を設定する
• SMSおよび音声Authenticatorの登録とチャレンジ