> ## Documentation Index > Fetch the complete documentation index at: https://docs-dev-feat-init-gt-translations.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Migrez la configuration de votre fournisseur de téléphonie vers Unified Phone Experience. # Utiliser Unified Phone Experience d’Auth0 pour l’authentification multifacteur Pour migrer vers Unified Phone Experience, vous devez : * avoir activé et configuré dans votre tenant les notifications SMS, appel vocal ou SMS+appel vocal pour l’authentification multifacteur (MFA), ou * avoir activé et configuré Passwordless SMS dans votre tenant Si vous n’avez configuré ni MFA ni Passwordless, consultez [Configurer Unified Phone Experience d’Auth0](/docs/fr-ca/customize/phone-messages/unified-phone/configure-unified-phone) pour partir du bon pied. Si vous utilisez à la fois MFA et Passwordless avec des fournisseurs différents, vous devez utiliser un [Custom Phone Provider](/docs/fr-ca/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider). Si vous utilisez Phone comme ID, vous utilisez déjà automatiquement Unified Phone Experience d’Auth0 et aucune autre action n’est requise. Unified Phone Experience centralise toutes les configurations de votre fournisseur de téléphonie à un seul endroit dans votre tenant. Vous n’avez pas à configurer un fournisseur de téléphonie plusieurs fois pour différents facteurs d’authentification par téléphone. Pour en savoir plus sur les facteurs téléphoniques pour l’MFA, consultez [Notifications SMS et vocales pour MFA](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-factors/configure-sms-voice-notifications-mfa). Si vous avez déjà configuré un fournisseur de téléphonie pour les [notifications SMS et vocales pour l’authentification multifacteur (MFA)](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-factors/configure-sms-voice-notifications-mfa), 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 bien été envoyé avec le fournisseur au niveau du tenant. Pour résoudre les problèmes, consultez les [journaux du tenant](/docs/fr-ca/deploy-monitor/logs).

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 vos facteurs d’authentification par téléphone et vos méthodes de livraison * Mettre à jour les endpoints de l’Management API * Mettre à jour les déclencheurs d’Auth0 Actions

Vérifier les paramètres actuels

1. Pour vérifier vos paramètres MFA actuels, accédez à [**Auth0 Dashboard > Sécurité > Multi-factor Auth**](https://manage.auth0.com/#/security/mfa). 2. Sélectionnez **Phone Message**. 3. Les nouveaux tenants Auth0 peuvent utiliser l’Unified Phone Experience; une bannière vous invite à configurer un fournisseur de téléphonie au niveau du tenant : * Les tenants existants d’avant mars 2025 peuvent configurer les notifications **SMS and Voice** pour l’authentification multifacteur (MFA), en plus de l’Unified Phone Experience. Auth0 recommande d’utiliser l’Unified Phone Experience. Si vous devez utiliser l’expérience [SMS and Voice notifications for Multi-Factor Authentication (MFA)](/docs/fr-ca/secure/multi-factor-authentication/multi-factor-authentication-factors/configure-sms-voice-notifications-mfa) pour configurer votre fournisseur de téléphonie et que la bascule **Use Tenant-Level Messaging Provider** n’apparaît pas, contactez [Auth0 Support](/docs/fr-ca/troubleshoot/customer-support). 4. Pour vérifier les paramètres de votre tenant, accédez à [**Dashboard > Tenant Settings**](https://manage.auth0.com/#/tenant/advanced). 5. Sélectionnez **Advanced**. 6. Repérez **Unified Phone Experience**. 7. Activez la bascule, au besoin.

Configurer Twilio comme fournisseur au niveau du tenant

Si vous utilisez Twilio comme fournisseur téléphonique pour l’authentification multifacteur, 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 à [**Image de marque > Fournisseur de téléphone**](https://manage.auth0.com/#/phone/templates/phone/provider). 2. Sélectionnez et configurez votre fournisseur : Image de marque > Fournisseur de téléphone > Twilio 1. Choisissez Twilio comme fournisseur téléphonique. 2. Choisissez vos modes de livraison. 3. Saisissez les paramètres Twilio. Les facteurs MFA souhaités doivent être un sous-ensemble des modes de livraison que vous configurez au niveau du tenant. 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. 5. Activez le fournisseur au niveau du tenant. 1. Pour la MFA, accédez à [**Sécurité > Authentification multifacteur > Message téléphonique**.](https://manage.auth0.com/#/security/mfa) 2. Sélectionnez **Utiliser le fournisseur de messagerie au niveau du tenant**. S’il n’y a aucune bascule dans votre tenant, vous utilisez déjà l’Unified Phone Experience. 6. **Enregistrez** vos modifications.

Configurer un fournisseur personnalisé avec Auth0 Actions

L’Unified Phone Experience utilise le déclencheur Actions `custom-phone-provider` pour les notifications téléphoniques, plutôt que le déclencheur Actions `send-phone-message` pour les notifications téléphoniques personnalisées. Vous ne pouvez pas migrer directement votre déclencheur Actions `send-phone-message` vers le déclencheur Actions `custom-phone-provider` pour les raisons suivantes : * Il n’existe pas de correspondance 1:1 entre les types de messages et les types de notifications. * La migration des secrets et des dépendances associés au déclencheur Actions `send-phone-message` pourrait soulever des enjeux de sécurité ou nuire à l’expérience du tenant. * Les Actions peuvent prendre en charge plusieurs déclencheurs et être difficiles à migrer. Par exemple, des Actions peuvent prendre en charge à la fois les déclencheurs `send-phone-message` et `post-login`. * Les déclencheurs Actions `send-phone-message` et `custom-phone-provider` prennent en charge différents types d’événements : * `send-phone-message` prend en charge les types de messages SMS et Voice. Pour en savoir plus, consultez [Action triggers: send-phone-message Event Object](/docs/fr-ca/customize/actions/explore-triggers/mfa-notifications-trigger/send-phone-message-event-object). * `custom-phone-provider` prend en charge les types de notifications `otp_verify`, `otp_enroll`, `blocked_account`, `change_password` et `password_breach`. Pour en savoir plus, consultez [Actions triggers: custom-phone-provider Event Object](/docs/fr-ca/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider/actions-triggers-custom-phone-provider-event-object). * Vous ne pouvez définir qu’une seule Action par fournisseur téléphonique personnalisé. Si vous avez déjà défini une Action pour un fournisseur téléphonique personnalisé, vous **devez** la désactiver avant de l’associer à une nouvelle Action. Par conséquent, vous devez convertir votre `send-phone-message` existant en un nouveau `custom-phone-provider` à l’aide des nouvelles variables contextuelles : | objet contextuel `send-phone-message` | objet contextuel `custom-phone-provider` | Statut | | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | `text` | `notification.as_text` and `notification.as_voice` | Mis à jour | | `message_type` | `notification.message_type` | Mis à jour | | `action` | `notification.delivery_method` | Mis à jour | | `language` | `notification.locale` | Mis à jour | | `code` | `notification.code` | Mis à jour | | `recipient` | `notification.recipient` | Mis à jour | | objet contextuel `send-phone-message` | objet contextuel du fournisseur au niveau du tenant | Statut | | ------------------------------------- | --------------------------------------------------- | ---------- | | `ip` | `ip` | Inchangé | | `user_agent` | `user_agent` | Inchangé | | `language` | `language` | Mis à jour | | `method` | `method` facultatif | Mis à jour | | `hostname` | `hostname` facultatif | Mis à jour | | `geoip` | `geoip` | Mis à jour | | objet contextuel `send-phone-message` | objet contextuel du fournisseur au niveau du tenant | Statut | | ------------------------------------- | --------------------------------------------------- | ---------- | | `tenant.id` | `tenant` | Mis à jour | | N/A | `tenant.home_url` | Nouveau | | N/A | `tenant.logo_url` | Nouveau | | N/A | `tenant.support_email` | Nouveau | | N/A | `tenant.support_url` | Nouveau | | objet contextuel `send-phone-message` | objet contextuel du fournisseur au niveau du tenant | Statut | | ------------------------------------- | --------------------------------------------------- | ---------- | | `client.client_metadata` | `client.metadata` | Mis à jour | | `client.client_id` | `client.client_id` | Inchangé | | `client.name` | `client.name` | Inchangé | | objet contextuel `send-phone-message` | objet contextuel du fournisseur au niveau du tenant | Statut | | ------------------------------------- | --------------------------------------------------- | -------- | | `user.user_id` | `user.user_id` | Inchangé | | `user.name` | `user.name` | Inchangé | | `user.email` | `user.email` | Inchangé | | `user.app_metadata` | `user.app_metadata` | Inchangé | | `user.user_metadata` | `user.user_metadata` | Inchangé | | `user.email_verified` | `user.email_verified` | Inchangé | | `user.phone_number` | `user.phone_number` | Inchangé | | `user.phone_verified` | `user.phone_verified` | Inchangé | | `user.picture` | `user.picture` | Inchangé | | `user.created_at` | `user.created_at` | Inchangé | | `user.updated_at` | `user.updated_at` | Inchangé | | `user.multifactor` | `user.multifactor` | Inchangé | | `user.identities` | N/A | Supprimé | | `user.family_name` | `user.family_name` | Inchangé | | `user.given_name` | `user.given_name` | Inchangé | | `user.nickname` | `user.nickname` | Inchangé | | `user.username` | `user.username` | Inchangé | | N/A | `user.login_count` | Nouveau | Pour obtenir la liste complète des variables contextuelles, consultez [Personnaliser les modèles de téléphone](/docs/fr-ca/customize/phone-messages/phone-templates/customize). Consultez l’exemple du fournisseur de téléphone personnalisé : ```javascript lines expandable theme={null} const { fetch } = require('undici'); /** * Handler à 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) => { if (event.notification.message_type.startsWith('otp')) { const body = { from: event.notification.from, action: event.notification.message_type === 'otp_verify' ? 'second-factor-authenticator' : 'enrollment', language: event.notification.locale, recipient: event.notification.recipient, message_type: event.notification.delivery_method, text: event.notification.as_text, code: event.notification.code, }; const response = await fetch(event.secrets['MY_ENDPOINT'], { method: 'POST', headers: { authorization: `Bearer ${event.secrets['MY_SECRET']}`, }, body: JSON.stringify(body), }); console.log(response.status); // 200 console.log(await response.text()); // corps de la réponse de la requête ! } return; }; ```

Configurer le déclencheur `custom-phone-provider` pour la MFA

Pour poursuivre et configurer votre déclencheur MFA `custom-phone-provider` : 1. Accédez à [**Image de marque > Fournisseur téléphonique**](https://manage.auth0.com/#/phone/templates/phone/provider). 2. Sélectionnez votre fournisseur : 1. Choisissez **Personnalisé**. 2. Sous **Configuration du fournisseur**, ajoutez le code traduit de votre action `send-phone-message` dans l’éditeur de code intégré. 3. **Enregistrez** vos modifications. 4. Sélectionnez **Envoyer un message test** pour tester le fournisseur au niveau du tenant avant de l’utiliser dans un environnement de production. 5. Revenez à [**Sécurité > Authentification multifacteur > Message téléphonique**](https://manage.auth0.com/#/security/mfa) pour activer **Utiliser le fournisseur de messagerie au niveau du tenant**. 6. **Enregistrez** vos modifications.

Mettre à jour les facteurs téléphoniques MFA et les méthodes de livraison

Si vous n’avez pas activé de provider au niveau du tenant dans l’Auth0 Dashboard, vous ne pourrez pas configurer les facteurs téléphoniques SMS et Voice pour la MFA. Avertissement : aucun provider au niveau du tenant configuré pour la MFA téléphonique unifiée Si vous souhaitez remplacer le ou les facteurs MFA de notification actuels par un autre type pendant la migration vers Unified Phone Experience, certains changements de configuration peuvent être nécessaires. | Facteurs téléphoniques MFA actuels | Facteurs MFA souhaités | Méthode de livraison au niveau du tenant | Action de l’utilisateur | | ---------------------------------- | ---------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | SMS | Voice | SMS | L’utilisateur doit mettre à jour le provider au niveau du tenant pour autoriser le facteur téléphonique MFA souhaité | | SMS | Voice | SMS + Voice | Aucune | | SMS | SMS + Voice | SMS | L’utilisateur doit mettre à jour le provider au niveau du tenant pour autoriser le facteur téléphonique MFA souhaité | | SMS | SMS + Voice | SMS + Voice | Aucune | | Voice | SMS | SMS + Voice | L’utilisateur doit mettre à jour le provider au niveau du tenant pour autoriser le facteur téléphonique MFA souhaité | | Voice | SMS | SMS + Voice | Aucune | | Voice | SMS + Voice | Voice | L’utilisateur doit mettre à jour le provider au niveau du tenant pour autoriser le facteur téléphonique MFA souhaité | | Voice | SMS + Voice | SMS + Voice | Aucune | | SMS + Voice | SMS | SMS + Voice | Aucune | | SMS + Voice | Voice | SMS + Voice | Aucune | Si vous souhaitez remplacer la ou les méthodes de livraison actuelles du tenant-level phone provider par un autre type pendant la migration vers Unified Phone Experience, certains changements de configuration peuvent être nécessaires. | Facteurs téléphoniques MFA | Méthode de livraison actuelle au niveau du tenant | Méthode de livraison souhaitée au niveau du tenant | Action de l’utilisateur | | -------------------------- | ------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SMS | SMS | SMS + Voice | Aucune | | SMS | SMS | Voice | L’utilisateur doit mettre à jour les facteurs téléphoniques MFA pour qu’ils constituent un sous-ensemble des méthodes de livraison activées pour le provider au niveau du tenant | | SMS | SMS + Voice | Voice | L’utilisateur doit mettre à jour les facteurs téléphoniques MFA pour qu’ils constituent un sous-ensemble des méthodes de livraison activées pour le provider au niveau du tenant | | SMS | SMS + Voice | SMS | Aucune | | Voice | Voice | SMS | L’utilisateur doit mettre à jour les facteurs téléphoniques MFA pour qu’ils constituent un sous-ensemble des méthodes de livraison activées pour le provider au niveau du tenant | | Voice | Voice | SMS + Voice | Aucune | | Voice | SMS + Voice | SMS | L’utilisateur doit mettre à jour les facteurs téléphoniques MFA pour qu’ils constituent un sous-ensemble des méthodes de livraison activées pour le provider au niveau du tenant | | Voice | SMS + Voice | Voice | Aucune | | SMS + Voice | SMS + Voice | SMS | Aucune | | SMS + Voice | SMS + Voice | Voice | Aucune |

Mettre à jour les points de terminaison Guardian avec Management API

Unified Phone Experience utilise des points de terminaison spécifiques pour les notifications. Si vous utilisiez déjà [Auth0 Guardian](/docs/fr-ca/secure/multi-factor-authentication/auth0-guardian) pour les notifications push et les mots de passe à usage unique, vous devez mettre à jour votre configuration pour utiliser les nouveaux points de terminaison Phone Provider Branding. Les points de terminaison Guardian suivants ne fonctionneront plus avec Unified Phone Experience : | Point de terminaison Guardian d’envoi de messages téléphoniques | Portée | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | | | `read:guardian_factors` | | | `read:guardian_factors` | | | `update:guardian_factors` | | | `update:guardian_factors` | | | `read:guardian_factors` | | | `update:guardian_factors` | Remplacez les points de terminaison Guardian par les nouveaux points de terminaison et les nouvelles portées Phone Provider Branding : | Point de terminaison Phone Provider Branding | Portée | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | | | `read:phone_providers` | | | `update:phone_providers` | | | `create:phone_providers` | | | `read:phone_templates` | | | `update:phone_templates` | | | `create:phone_templates` | | | `delete:phone_templates` | | | `delete:phone_providers` | Les points de terminaison Guardian suivants fonctionnent avec Unified Phone Experience et n’auront pas besoin d’être mis à jour : | Point de terminaison des facteurs téléphoniques de MFA | Portée | | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | | | `read:guardian_factors` | | | `update:guardian_factors` | | | `read:guardian_factors` | | | `update:guardian_factors` |

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 MFA, pourraient cesser de fonctionner.