メインコンテンツへスキップ
Auth0 が送信する多要素認証の SMS および音声メッセージをカスタマイズするには、次の手順に従います。
  1. Dashboard > Security > Multi-factor Auth に移動し、Phone Message をクリックします。
  2. Enrollment Template または Verification Template セクションで、メッセージをカスタマイズします。
  3. Save をクリックします。
Enrollment Template では、ユーザーが MFA を使用して初めて新しいデバイスを登録する際に送信されるメッセージを定義します。Verificiation Template では、ユーザーが登録後にログインする際に送信されるメッセージを定義します。

構文

SMS テンプレートでユーザー属性にアクセスする際に使用できるサポート対象のテンプレートエンジンは、Liquid 構文です。利用可能な属性は次のとおりです。
AttributeDescription
message_type送信されるメッセージの種類を示します: sms または voice
code登録/確認コード。音声メッセージを送信する場合は、音声メッセージプロバイダーが正確に発音できるよう、変数値の各数字の間にドットを入れて区切ります (1.2.3.4.5)。
localeUniversal Login または MFA API 用です。言語を指定します。
requestInfo.langClassic Login のローカライズ用です。ブラウザーの accept-language ヘッダーを示します。例: es-AR,es;q=8.0, en-US,en
tenant.friendlyNameDashboard > Tenant Settings で設定した Friendly Name
custom_domain.domainテナントのドメイン名。
custom_domain.domain_metadataカスタムドメインのメタデータフィールド (キーと値のペア) 。
Liquid 構文を使用して、言語ごとに音声メッセージと SMS で異なるメッセージを送信する例を次に示します。
{% 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 %}

ローカライズ

Auth0 Authentication API では、Code または Link の取得エンドポイント、MFA のチャレンジリクエストエンドポイント、および MFA の認証要素追加エンドポイントx-request-language ヘッダーがサポートされています。 これを使用するには、Tenant > SettingsSupported Languages でサポートする言語を設定します。x-request-lanuage ヘッダーが送信されると、そのロケールは MFA の電話メッセージテンプレート内の locale 変数で利用できます。詳細は、パスワードレスの多言語サポートを参照してください。

詳細はこちら