Personnaliser les messages SMS et vocaux de l’authentification multifacteur

Découvrez comment personnaliser les messages SMS et vocaux envoyés par Auth0 lors de l’enrôlement et de la vérification.

Pour personnaliser les messages SMS et vocaux de l’authentification multifacteur envoyés par Auth0 :

1. Accédez à Dashboard > Sécurité > Multi-factor Auth, puis cliquez sur Phone Message.
2. Dans la section Enrollment Template ou Verification Template, personnalisez votre message.
3. Cliquez sur Save.

Le Enrollment Template définit le message envoyé lorsqu’un utilisateur enrôle un nouvel appareil pour la première fois avec la MFA. Le Verificiation Template définit le message envoyé lorsqu’un utilisateur se connecte après l’enrôlement.

​

Syntaxe

La syntaxe Liquid est le moteur de modèles pris en charge utilisé pour accéder aux attributs utilisateur dans les modèles SMS. Les attributs suivants sont disponibles :

Attribut	Description
message_type	Indique le type de message envoyé : sms ou voice.
code	Code d’enrôlement ou de vérification. Lors de l’envoi de messages vocaux, les valeurs de variable sont séparées par des points entre les chiffres (1.2.3.4.5) pour assurer une prononciation exacte par les fournisseurs de messages vocaux.
locale	Pour Universal Login ou MFA API. Désigne la langue.
requestInfo.lang	Pour la localisation de Classic Login. En-tête Accept-Language du navigateur. Par exemple : es-AR,es;q=8.0, en-US,en.
tenant.friendlyName	Le Friendly Name défini dans Dashboard > Tenant Settings.
custom_domain.domain	Le nom de domaine du tenant.
custom_domain.domain_metadata	Les champs de métadonnées du domaine personnalisé (sous forme de paires clé-valeur).

Voici un exemple d’utilisation de la syntaxe Liquid pour envoyer différents messages vocaux et SMS selon la langue :

{% 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 %}

​

Localisation

Dans l’Auth0 Authentication API, le endpoint Get Code or Link, le endpoint de demande de défi MFA et le endpoint Add an authenticator MFA prennent en charge le header x-request-language.

Pour l’utiliser, définissez vos langues prises en charge dans Tenant > Settings (sous Supported Languages). Lorsque le header x-request-lanuage est envoyé, cette locale est disponible dans la variable locale des modèles de messages téléphoniques MFA. Consultez la prise en charge multilingue de Passwordless pour en savoir plus.

​

Pour en savoir plus

• Authentification multifacteur (MFA)
• Configurer les notifications SMS et vocales pour l’authentification multifacteur
• Inscrire et défier les authentificateurs SMS et vocaux