Skip to main content

Avant de commencer

Pour migrer vers Unified Phone Experience, vous devez :
  • avoir activé et configuré dans votre tenant les notifications SMS, appel vocal ou SMS+appel vocal de l’authentification multifacteur (MFA), ou
  • avoir activé et configuré Passwordless SMS dans votre tenant
Si vous n’avez configuré ni MFA ni Passwordless, consultez Configure Auth0’s Unified Phone Experience pour partir du bon pied.Si vous avez à la fois des intégrations MFA et Passwordless avec des fournisseurs différents, vous devez utiliser un fournisseur téléphonique personnalisé.Si vous utilisez Phone comme ID, vous utilisez automatiquement Unified Phone Experience et aucune autre action n’est requise.
Unified Phone Experience centralise toutes les configurations de vos fournisseurs téléphoniques à un seul endroit dans votre tenant. Vous n’aurez pas à configurer plusieurs fois un fournisseur téléphonique pour différents facteurs d’authentification par téléphone. Pour en savoir plus sur les facteurs téléphoniques pour , consultez Passwordless Authentication with SMS. Si vous avez déjà configuré un fournisseur téléphonique pour Passwordless, vous pouvez migrer cette configuration vers Unified Phone Experience et l’appliquer au niveau du tenant.
Auth0 n’indique pas à l’utilisateur final si un message téléphonique a été envoyé avec succès au moyen du fournisseur au niveau du tenant. Pour résoudre les problèmes, consultez les journaux du tenant.

Mettez à jour votre fournisseur téléphonique

Pour utiliser Unified Phone Experience, vous devez :
  • Vérifier les paramètres actuels
  • Configurer votre fournisseur :
    • Configurer Twilio
    • Configurer un fournisseur téléphonique personnalisé
  • Mettre à jour les modes d’envoi

Vérifier les paramètres actuels

  1. Pour vérifier vos paramètres Passwordless actuels, accédez à Auth0 Dashboard > Authentication > Passwordless > SMS.
  2. Sélectionnez Phone Message.
  3. Si vous pouvez utiliser la fonctionnalité Unified Phone Experience, une bannière vous invite à configurer un fournisseur au niveau du tenant :
Dashboard > Authentication > Passwordless > SMS
Si vous devez utiliser l’expérience Legacy pour configurer votre fournisseur téléphonique et que la bascule permettant d’utiliser un fournisseur au niveau du tenant est absente, communiquez avec Auth0 Support.

Configurer Twilio comme fournisseur au niveau du tenant

Si vous utilisez Twilio comme fournisseur téléphonique pour Passwordless, vous devez ajouter le SID Twilio et l’AuthToken à l’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 à Branding > Fournisseur téléphonique.
  2. Sélectionnez et configurez votre fournisseur :
    Branding > Phone Provider > Twilio
    1. Choisissez Twilio comme fournisseur téléphonique.
    2. Choisissez vos modes d’envoi.
    3. Saisissez les paramètres Twilio.
  3. Enregistrez vos modifications.
  4. Sélectionnez Envoyer un message de test pour tester le fournisseur au niveau du tenant avant de l’utiliser dans un environnement de production.
    Les numéros de téléphone non valides renvoient une erreur. Pour en savoir plus sur la validation des numéros de téléphone, consultez Quelle validation est effectuée lors de l’utilisation du point de terminaison /passwordless/start pour SMS.
  5. Activez un fournisseur au niveau du tenant.
    1. Accédez à Authentication > Passwordless > SMS.
    2. Sélectionnez Use Tenant-level Messaging Provider
      Si aucune bascule n’existe dans votre tenant, vous utilisez déjà l’Unified Phone Experience.
  6. Enregistrez vos modifications.

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

L’expérience Unified Phone Experience n’utilise pas la passerelle SMS personnalisée que vous avez configurée pour Passwordless SMS. Vous pouvez utiliser le ou la pour configurer un fournisseur téléphonique personnalisé avec Auth0 Actions. Pour en savoir plus, consultez Configurer un fournisseur téléphonique personnalisé. Pour configurer votre fournisseur téléphonique Custom SMS Gateway à l’aide d’une Action de fournisseur de téléphone :
  1. Accédez à Branding > Fournisseur téléphonique.
  2. Sélectionnez votre fournisseur :
    1. Choisissez Custom.
    2. Sous Configuration du fournisseur, ajoutez vos nouvelles Actions custom-phone-provider qui transfèrent la notification Passwordless vers une passerelle SMS personnalisée.
  3. Enregistrer vos modifications.
  4. Sélectionnez Envoyer un message de test pour tester le fournisseur au niveau du tenant avant de l’utiliser dans un environnement de production.
  5. Accédez à Authentication > Passwordless > SMS pour activer Use Tenant-level Messaging Provider.
  6. Enregistrer vos modifications.

Mettre à jour les modes d’envoi

Désactiver le fournisseur téléphonique

Si vous configurez Unified Phone Experience, puis le désactivez, les intégrations existantes avec votre fournisseur téléphonique, y compris Passwordless, risquent de ne plus fonctionner.