Utiliser Unified Phone Experience pour Passwordless

Découvrez comment configurer Unified Phone Experience pour l’authentification Passwordless.

Avant de commencer

Pour migrer vers Unified Phone Experience, vous devez :

• avoir activé et configuré les notifications SMS, vocales ou SMS+voix pour l’authentification multifacteur (MFA) dans votre locataire, ou
• avoir activé et configuré Passwordless SMS dans votre locataire

Si vous n’avez configuré ni MFA ni Passwordless, consultez Configurer Unified Phone Experience d’Auth0 pour partir de zéro.

Si vous avez des intégrations MFA et Passwordless avec des fournisseurs différents, vous devez utiliser un Custom Phone Provider.

Si vous utilisez Phone as ID, vous utilisez automatiquement Unified Phone Experience d’Auth0 et aucune autre action n’est requise.

Unified Phone Experience centralise toutes les configurations de vos fournisseurs de téléphone en un seul endroit dans votre locataire. Vous n’aurez pas à configurer un fournisseur de téléphone plusieurs fois pour différents facteurs d’authentification par téléphone. Pour en savoir plus sur les facteurs téléphoniques pour Passwordless, consultez Authentification Passwordless avec SMS.

Si vous avez déjà configuré un fournisseur de téléphone pour Passwordless, vous pouvez migrer cette configuration vers Unified Phone Experience et l’appliquer au niveau du locataire.

Auth0 n’indique pas à l’utilisateur final si un message téléphonique a été envoyé avec succès au moyen du fournisseur configuré au niveau du locataire. Pour résoudre les problèmes, consultez les journaux du locataire.

​

Mettre à jour votre fournisseur de téléphone

Pour utiliser Unified Phone Experience, vous devez :

• Vérifier les paramètres actuels

• Configurer votre fournisseur :

  • Configurer Twilio
  • Configurer un fournisseur de téléphone personnalisé

• Mettre à jour les méthodes d’envoi

​

Vérifier les paramètres actuels

1. Pour vérifier vos paramètres actuels de Passwordless, accédez à Auth0 Dashboard > Authentication > Passwordless > SMS.
2. Sélectionnez Phone Message.
3. Si vous pouvez utiliser Unified Phone Experience, une bannière vous indique de configurer un fournisseur au niveau du locataire :

Si vous devez utiliser l’expérience héritée pour configurer votre fournisseur de téléphone et que le bouton d’activation pour utiliser un fournisseur au niveau du locataire n’apparaît pas, communiquez avec Auth0 Support.

​

Configurer Twilio comme fournisseur au niveau du locataire

Si vous utilisez Twilio comme fournisseur de téléphone pour Passwordless, vous devez ajouter le SID Twilio et l’AuthToken à Unified Phone Experience. Vous pouvez copier le SID Twilio à partir de votre configuration existante, mais vous devrez obtenir la valeur de l’AuthToken auprès de Twilio.

1. Accédez à Image de marque > Fournisseur de téléphone.

2. Sélectionnez et configurez votre fournisseur :

   
   1. Choisissez Twilio comme fournisseur de téléphone.
   2. Choisissez vos méthodes d’envoi.
   3. Entrez les paramètres Twilio.

3. Enregistrez vos modifications.

4. Sélectionnez Envoyer un message de test pour tester le fournisseur au niveau du locataire avant de l’utiliser dans un environnement de production.

5. Activez un fournisseur au niveau du locataire.

   1. Accédez à Authentification > Passwordless > SMS.

   2. Sélectionnez Utiliser le fournisseur de messagerie au niveau du locataire

      Si aucun commutateur n’apparaît dans votre locataire, vous utilisez déjà Unified Phone Experience.

6. Enregistrez vos modifications.

​

Créer une nouvelle Action custom-phone-provider pour Passwordless

Unified Phone Experience n’utilise pas la passerelle SMS personnalisée que vous avez configurée pour Passwordless SMS. Vous pouvez utiliser le Auth0 Dashboard ou la Management API pour configurer un fournisseur de téléphone personnalisé avec Actions. Pour en savoir plus, consultez Configurer un fournisseur de téléphone personnalisé.

Configurer custom-phone-provider pour Passwordless

Pour configurer votre passerelle SMS personnalisée au moyen d’une Action de fournisseur de téléphone :

1. Accédez à Image de marque > Fournisseur de téléphone.

2. Sélectionnez votre fournisseur :

   1. Choisissez Personnalisé.
   2. Sous Configuration du fournisseur, ajoutez vos nouvelles Actions custom-phone-provider qui transmettent la notification Passwordless à une passerelle SMS personnalisée.

3. Enregistrez vos modifications.

4. Sélectionnez Envoyer un message de test pour tester le fournisseur au niveau du locataire avant de l’utiliser dans un environnement de production.

5. Accédez à Authentification > Passwordless > SMS pour activer Utiliser le fournisseur de messagerie au niveau du locataire.

6. Enregistrez vos modifications.

Exemple de passerelle SMS personnalisée pour custom-phone-provider

const request = require('<favorite_http_client>');
/**
* Gestionnaire à exécuter lors de l'envoi d'une notification téléphonique
* 
@param
 {Event} event - Détails sur l'utilisateur et le contexte dans lequel il se connecte.
* 
@param
 {CustomPhoneProviderAPI} api - Méthodes et utilitaires pour modifier le comportement de l'envoi d'une notification téléphonique.
*/
exports.onExecuteCustomPhoneProvider = async (event, api) => {
  const notificationType = event.notification.message_type;
  switch (notificationType) {
    case '<otp_verify>': {
      const req = {
        url: event.secrets.GATEWAY_URL,
        method: 'POST',
        headers: {
          'User-Agent': 'Auth0'
        },
        body: {
          recipient: event.notification.recipient,
          body: event.notification.as_text, // ou event.notification.as_voice
          sender: event.notification.from, // TODO : sender est manquant, nous devons vérifier si nous voulons l'ajouter.
          req: event.request || {}, // si non activé, la valeur sera undefined
        }
      }
      const response = await request(req);
      console.log(response.statusCode);
      return
    }
    default: {
      // gérer les autres notifications normalement
      return;
    }
  }
};

​

Mettre à jour les méthodes d’envoi

Facteurs de téléphone	Méthode d’envoi actuelle au niveau du locataire	Méthode d’envoi souhaitée au niveau du locataire	Action de l’utilisateur
SMS	SMS	SMS + Voix	Aucune
SMS	SMS	Voix	L’utilisateur doit mettre à jour les facteurs de téléphone Passwordless afin qu’ils forment un sous-ensemble des méthodes d’envoi activées pour le fournisseur au niveau du locataire
SMS	SMS + Voix	Voix	L’utilisateur doit mettre à jour les facteurs de téléphone Passwordless afin qu’ils forment un sous-ensemble des méthodes d’envoi activées pour le fournisseur au niveau du locataire
SMS	SMS + Voix	SMS	Aucune

​

Désactiver le fournisseur de téléphone

Si vous configurez Unified Phone Experience puis la désactivez, les intégrations existantes avec votre fournisseur de téléphone, y compris Passwordless, pourraient cesser de fonctionner.