Passer au contenu principal
Vous pouvez configurer un fournisseur téléphonique personnalisé pour les messages SMS en utilisant un numéro de téléphone comme identifiant d’utilisateur. Un fournisseur téléphonique personnalisé utilise Actions pour acheminer les messages SMS vers le fournisseur de votre choix lors de la vérification des numéros de téléphone et de la réinitialisation des mots de passe. Vous pouvez configurer un fournisseur téléphonique personnalisé pour les cas d’utilisation suivants :
  • Utiliser différents fournisseurs de téléphonie selon le contexte de l’application, notamment dans différentes régions géographiques où le coût des messages peut varier considérablement d’un fournisseur à l’autre.
  • Utiliser différents fournisseurs de téléphonie selon le contexte de l’organisation, lorsque certains clients B2B exigent des fournisseurs précis.
Vous pouvez configurer un fournisseur téléphonique personnalisé avec le ou la .

​
Configurer un fournisseur téléphonique personnalisé avec l’Auth0 Dashboard ou la Management API

Pour configurer un fournisseur téléphonique personnalisé, vous devez utiliser le déclencheur d’Action custom-phone-provider, qui n’est pas offert dans l’éditeur Actions d’Auth0. Pour en savoir plus, consultez Exemple d’Action custom-phone-provider.

​
Ajouter un fournisseur téléphonique personnalisé avec Auth0 Dashboard

Pour configurer un nouveau fournisseur téléphonique personnalisé dans Auth0 Dashboard :
  1. Accédez à Branding > Phone Provider. Vous arriverez à la page Phone Message Provider. Par défaut, le fournisseur téléphonique Twilio est sélectionné.
  2. Sélectionnez l’option de fournisseur téléphonique Custom dans la section Phone Provider.
  3. Sélectionnez le Delivery Method:
    1. Texte : le code de vérification sera envoyé à vos utilisateurs par SMS.
    2. Voix : le code de vérification sera envoyé à vos utilisateurs par message vocal.
  4. Sous Provider Configuration, saisissez votre code Actions pour configurer un fournisseur téléphonique personnalisé :
    1. Consultez la documentation de votre fournisseur pour comprendre comment envoyer des messages à son API.
    2. Ajoutez tous les secrets requis pour vous authentifier auprès de l’API.
    3. (Facultatif) Vous pouvez modifier l’Action à l’aide de l’interface complète de l’éditeur Actions en cliquant sur le bouton Edit in Expanded Editor. Après avoir modifié votre Action dans l’éditeur Actions, cliquez sur Save et Deploy depuis cette interface. Cliquez sur le lien Back to Phone Provider en haut de la page de l’éditeur Actions pour revenir à la page Phone Message Provider. Vous devrez sélectionner de nouveau l’option de fournisseur téléphonique Custom dans la section Phone Provider.
  5. Cliquez sur le bouton Save au bas de la page.
Lorsque vous cliquez sur Save, l’Action est automatiquement enregistrée et déployée. Pour tester la configuration du fournisseur téléphonique personnalisé avant de l’utiliser dans un environnement de production, cliquez sur Send Test Message.
Vous ne pouvez pas cliquer sur Send Test Message pour tester votre fournisseur téléphonique personnalisé tant que vous n’avez pas enregistré sa configuration.

​
Modifier un fournisseur téléphonique personnalisé avec Auth0 Dashboard

Pour modifier un fournisseur téléphonique personnalisé existant dans Auth0 Dashboard :
  1. Accédez à Branding > Phone Provider. Vous arriverez à la page Phone Message Provider.
  2. Modifiez le code de l’Action sur la page Phone Message Provider, au besoin.
    1. (Facultatif) Vous pouvez modifier l’Action à l’aide de l’interface complète de l’éditeur Actions en cliquant sur le bouton Edit in Expanded Editor. Après avoir modifié votre Action dans l’éditeur Actions, cliquez sur Save et Deploy depuis cette interface. Cliquez ensuite sur le lien Back to Phone Provider en haut de la page de l’éditeur Actions.
  3. Cliquez sur le bouton Save au bas de la page.
Lorsque vous cliquez sur Save, l’Action est automatiquement enregistrée et déployée. Pour tester la configuration du fournisseur téléphonique personnalisé avant de l’utiliser dans un environnement de production, cliquez sur Send Test Message.
Un exemple de fournisseur téléphonique personnalisé que vous pouvez configurer est Twilio Verify. Pour en savoir plus, consultez Configurer un fournisseur téléphonique personnalisé avec Twilio Verify.

​
Exemple d’Action custom-phone-provider

Le déclencheur custom-phone-provider est différent du déclencheur send-phone-message, qui ne doit pas être utilisé pour configurer un fournisseur téléphonique personnalisé. Pour en savoir plus, consultez les ressources suivantes : L’exemple de code suivant montre une Action custom-phone-provider qui offre les mêmes fonctionnalités qu’une Action send-phone-message : 
/**
* 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) => {

  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.secret.SERVICE_URL, {
      method: 'POST',
      headers: {
        authorization: `Bearer ${event.secrets.TOKEN}`,
      },
      body: JSON.stringify(body),
    });

    console.log(response);
  }

  return;
};