Créer des tickets d’inscription personnalisés

Découvrez comment créer un ticket d’inscription à l’aide de l’Auth0 MFA API.

Si vous souhaitez personnaliser et gérer les inscriptions à l’authentification multifacteur (MFA) de vos utilisateurs, vous pouvez utiliser les Custom Enrollment Tickets. Les Custom Enrollment Tickets d’Auth0 génèrent un lien à usage unique permettant à vos utilisateurs de s’inscrire à la MFA avec le ou les facteurs que vous spécifiez.

​

Cas d’utilisation

Utilisez les Custom Enrollment Tickets pour :

• intégrer de nouveaux utilisateurs
• configurer les paramètres des utilisateurs
• préciser les facteurs que vous voulez que les clients choisissent au moment de l’inscription
• permettre aux utilisateurs d’enregistrer plus d’un facteur

​

Configurer les Custom Enrollment Tickets

Effectuez une requête POST vers le point de terminaison /guardian/post_ticket de Management API.

Paramètre	Obligatoire	Description
allow_multiple_enrollments	Facultatif	Permet à un utilisateur déjà inscrit d’ajouter des facteurs supplémentaires, à l’exception du courriel.
factor	Facultatif	Indique le facteur que l’utilisateur doit configurer, à l’exception du courriel. Utilisé avec allow_multiple_enrollments, il peut préciser plus d’un facteur à l’inscription.

Ces paramètres ne peuvent être utilisés qu’avec Universal Login et ne peuvent pas être utilisés avec Classic Login ni avec des pages MFA personnalisées.

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 pourra 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.

​

Custom Enrollment Tickets avec Classic Login

Si vous utilisez l’expérience Classic Login et devez personnaliser l’apparence de la page lorsque l’utilisateur accède à ticket_url, vous pouvez modifier la page MFA.

1. Accédez à Dashboard > Branding > Universal Login > Advanced options > Multi-factor Authentication.
2. Si Customize MFA Page n’est pas sélectionné, activez cette option.
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

• Options de thème du widget MFA
• Référence des codes d’erreur de Guardian
• Auth0 MFA API