Passer au contenu principal
Si vous souhaitez personnaliser et gérer les inscriptions de vos utilisateurs à l’authentification multifacteur (MFA), vous pouvez utiliser des tickets d’inscription personnalisés. Les tickets d’inscription personnalisés d’Auth0 génèrent un lien à usage unique pour permettre à vos utilisateurs de s’inscrire à l’ avec le ou les facteurs que vous spécifiez.

Cas d’utilisation

Utilisez des tickets d’inscription personnalisés pour :
  • L’intégration de nouveaux utilisateurs
  • Configurer les paramètres utilisateur
  • Définir les facteurs que vous voulez proposer aux clients lors de l’inscription
  • Permettre aux utilisateurs d’inscrire plusieurs facteurs

Configurer des tickets d’inscription personnalisés

Effectuez un appel POST vers le point de terminaison /guardian/post_ticket de .
ParamètreObligatoireDescription
allow_multiple_enrollmentsFacultatifPermet à un utilisateur déjà inscrit de s’inscrire à d’autres facteurs, à l’exclusion du courriel.
factorFacultatifPrécise le facteur auquel l’utilisateur doit s’inscrire, à l’exclusion du courriel. Utilisé avec allow_multiple_enrollments, il permet de préciser plusieurs facteurs d’inscription.
Ces paramètres peuvent être utilisés uniquement avec Universal Login et ne peuvent pas être utilisés avec Classic Login ni avec des pages MFA personnalisées.
La Management API renvoie un ticket d’inscription contenant un ticket_id et un ticket_url. Le ticket_id est réservé à un usage interne. Transmettez le ticket_url à l’utilisateur à l’aide du paramètre send_email pour lancer le processus d’inscription. Les tickets expirent après 5 jours et sont à usage unique. Un utilisateur qui reçoit un ticket ne peut s’inscrire qu’une seule fois. Exemple de réponse :
{
  "ticket_id": "gten_8b2f5e90d2c848dc9230d34f",
  "ticket_url": "https://guardianadnrdoifcmtest0.eu.auth0.com/guardian/enroll?ticket=gten_8b2f5e90d2c848dc9230d34f"
}
Si vous activez Multiple Custom Domains, vous devez inclure l’en-tête HTTP auth0-custom-domain. Pour en savoir plus, consultez Multiple Custom Domains.

Tickets d’inscription personnalisés avec Classic Login

Si vous utilisez l’expérience Classic Login et devez personnaliser l’apparence de la page lorsque l’utilisateur est redirigé vers ticket_url, vous pouvez modifier la page MFA.
  1. Accédez à Dashboard > Image de marque > Universal Login > Options avancées > Authentification multifacteur.
  2. Si l’option Customize MFA Page n’est pas sélectionnée, activez-la.
  3. Mettez à jour la variable ticket. Exemple :
{% if ticket %}
<h4 class="message">Welcome, {{ userData.email }}, enroll your device below</h4>
{% else %}
<h4 class="message">Welcome back, {{ userData.email }}, authenticate below</h4>
{% endif %}

En savoir plus