Configurer la vérification par SMS avec Twilio SMS

Le connecteur officiel Logto pour le service de messages courts Twilio.

astuce:

Ce guide suppose que vous avez une compréhension de base des Connecteurs Logto. Pour ceux qui ne sont pas familiers, veuillez vous référer au guide des Connecteurs pour commencer.

Commencer

Twilio fournit des outils de communication programmables pour passer et recevoir des appels téléphoniques, envoyer et recevoir des messages texte, et d'autres fonctions de communication. Nous pouvons envoyer les messages texte de "code de vérification" via ses API de services web.

Créer un compte Twilio

Créez un nouveau compte sur Twilio. (Passez à l'étape suivante si vous en avez déjà un.)

Configurer les numéros de téléphone des expéditeurs

Allez sur la page de la console Twilio et connectez-vous avec votre compte Twilio.

Achetez un numéro de téléphone sous "Phone Numbers" -> "Manage" -> "Buy a number".

astuce:

Parfois, vous pouvez rencontrer la situation où le service SMS n'est pas pris en charge dans certains pays ou régions. Choisissez un numéro d'autres régions pour contourner ce problème.

Une fois que nous avons un numéro valide revendiqué, allez dans "Messaging" -> "Services". Créez un nouveau service de messagerie en cliquant sur le bouton.

Donnez un nom convivial au service et choisissez Notify my users comme objectif de notre service. À l'étape suivante, choisissez Phone Number comme Type d'expéditeur, et ajoutez le numéro de téléphone que nous venons de revendiquer à ce service en tant qu'expéditeur.

remarque:

Chaque numéro de téléphone ne peut être lié qu'à un seul service de messagerie.

Obtenir les identifiants de compte

Nous aurons besoin des identifiants API pour faire fonctionner le connecteur. Commençons par la page de la console Twilio.

Cliquez sur le menu "Account" dans le coin supérieur droit, puis allez à la page "API keys & tokens" pour obtenir votre Account SID et Auth token.

Retournez à la page des paramètres "Messaging" -> "Services" à partir de la barre latérale, et trouvez le Sid de votre service.

Composer le JSON du connecteur

Remplissez les champs accountSID, authToken et fromMessagingServiceSID avec Account SID, Auth token et Sid du service de messagerie correspondant.

Vous pouvez ajouter plusieurs modèles de connecteurs SMS pour différents cas. Voici un exemple d'ajout d'un seul modèle :

• Remplissez le champ content avec des contenus de type chaîne arbitraire. N'oubliez pas de laisser le placeholder {{code}} pour le code de vérification aléatoire.
• Remplissez le champ usageType avec soit Register, SignIn, ForgotPassword, Generic pour différents cas d'utilisation. Afin d'activer les flux utilisateur complets, les modèles avec usageType Register, SignIn, ForgotPassword et Generic sont requis.

Tester le connecteur SMS Twilio

Vous pouvez entrer un numéro de téléphone et cliquer sur "Send" pour voir si les paramètres fonctionnent avant "Save and Done".

C'est tout. N'oubliez pas de Activer le connecteur dans l'expérience de connexion.

Types de configuration

Nom	Type
accountSID	string
authToken	string
fromMessagingServiceSID	string
templates	Templates[]

Propriétés du modèle	Type	Valeurs énumérées
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Référence

Twilio - Dictionnaire des erreurs et avertissements