Configurer la vérification par SMS avec Aliyun Short Message Service

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

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

Aliyun est un fournisseur de services cloud majeur en Asie, offrant de nombreux services cloud, y compris le SMS (service de messages courts). Le connecteur SMS Aliyun est un plugin fourni par l'équipe Logto pour appeler le service SMS Aliyun, grâce auquel les utilisateurs finaux Logto peuvent s'inscrire et se connecter à leur compte Logto via un code de vérification SMS.

Configurer un service de messages courts dans la console SMS Aliyun

Créer un compte Aliyun

Rendez-vous sur le site web d'Aliyun et inscrivez-vous si vous n'avez pas encore de compte Aliyun.

Activer et configurer le service de messages courts Aliyun

1. Connectez-vous avec votre compte Aliyun sur le site web d'Aliyun et accédez à la page de console du service SMS.
2. Cliquez sur le bouton "Ouverture gratuite" (免费开通) en haut à gauche de la page du service SMS et commencez le processus de configuration.
3. Lisez et acceptez les "Conditions d'activation du service SMS" (短信服务开通条款) puis cliquez sur "Souscrire au service" (开通服务) pour continuer.
4. Vous êtes maintenant sur la page de console du service SMS, allez soit sur le bouton "Chine continentale" (国内消息) soit "Hors Chine continentale" (国际/港澳台消息) dans la barre latérale selon votre cas d'utilisation.
5. Ajoutez une signature et un modèle en suivant les instructions, et fournissez les documents ou informations requis pour la vérification.
   • N'oubliez pas de sélectionner "Message de code de vérification" (验证码) comme "Scénario" (适用场景) lors de la demande de signature et également "Message de code de vérification" (验证码) pour "Type" (模板类型) lors de la demande de vérification du modèle, car nous utilisons ces signatures et modèles pour envoyer des codes de vérification. Actuellement, nous ne prenons pas en charge l'envoi de messages SMS autres que ceux liés aux codes de vérification.
   • Utilisez également {{code}} comme espace réservé à l'endroit où vous souhaitez placer votre code de vérification numérique dans le contenu du modèle.
6. Après avoir soumis votre demande de signature et de modèle SMS, vous devez attendre qu'elle prenne effet. À ce stade, vous pouvez retourner à la page de console du service SMS et envoyer un SMS de test. Si vos signatures et modèles sont prêts à être utilisés, vous pouvez les essayer directement ; s'ils ne sont pas encore actifs, Aliyun propose également des modèles de test.
   • Il se peut que vous deviez recharger un petit montant avant d'envoyer des messages de test.
   • Il se peut également que l'on vous demande de lier un numéro de téléphone de test avant d'envoyer des messages de test. Pour plus de détails, allez dans l'onglet "Démarrage rapide" (快速学习) depuis la barre latérale de la page de console du service SMS.

Composer le JSON du connecteur

1. Depuis la page de console du service SMS, survolez votre avatar en haut à droite et allez dans "Gestion AccessKey" (AccessKey 管理), puis cliquez sur "Créer AccessKey" (创建 AccessKey). Vous obtiendrez une paire "AccessKey ID" et "AccessKey Secret" après avoir terminé la vérification de sécurité. Veuillez les conserver soigneusement.
2. Rendez-vous dans l'onglet "Chine continentale" (国内消息) ou "Hors Chine continentale" (国际/港澳台消息) que vous venez de visiter, vous pouvez facilement trouver "Signature" (签名名称) et "Code du modèle" (模板 CODE).
   • Si vous souhaitez utiliser la signature et le modèle de test uniquement, allez dans l'onglet "Démarrage rapide" (快速学习) à la place, et vous les trouverez sous "Signature & Modèles (Pour test uniquement)".
3. Remplissez les paramètres du connecteur SMS Aliyun :
   • Remplissez les champs accessKeyId et accessKeySecret avec les paires de clés d'accès obtenues à l'étape 1.
   • Remplissez le champ signName avec la "Signature" (签名名称) mentionnée à l'étape 2. Tous les modèles partageront ce nom de signature.
   • Vous pouvez ajouter plusieurs modèles de connecteur SMS pour différents cas. Voici un exemple d'ajout d'un seul modèle :
     • Remplissez le champ templateCode, qui permet de contrôler le contexte du SMS, avec le "Code du modèle" (模板 CODE) de l'étape 2.
     • Remplissez le champ usageType avec soit Register, SignIn, ForgotPassword ou Generic selon les cas d'utilisation. (usageType est une propriété Logto pour identifier le cas d'utilisation approprié.) Pour activer tous les flux utilisateurs, les modèles avec usageType Register, SignIn, ForgotPassword et Generic sont requis.
4. Configurer la "Vérification stricte du numéro de région téléphonique" :
   • Activez-la si vous devez envoyer des SMS à des numéros de téléphone étrangers (régions hors Chine continentale comme les États-Unis, HK, etc.). Lorsqu'elle est activée, le connecteur suppose que tous les numéros de téléphone incluent des indicatifs régionaux valides (par exemple, +1, +852) pour déterminer s'ils appartiennent à la Chine continentale.
   • Attention : Si vos utilisateurs existants ont des numéros de téléphone sans indicatif régional, l'activation de cette option peut affecter leur processus de connexion. Activez-la uniquement si nécessaire pour l'envoi de SMS à l'étranger.

Tester le connecteur SMS Aliyun

Vous pouvez saisir un numéro de téléphone et cliquer sur "Envoyer" pour vérifier si les paramètres fonctionnent avant de "Sauvegarder et terminer".

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

Types de configuration

Nom	Type
accessKeyId	string
accessKeySecret	string
signName	string
templates	Template[]

Propriétés du modèle	Type	Valeurs Enum
templateCode	string	N/A
usageType	enum string	'Register' / 'SignIn' / 'ForgotPassword' / 'Generic'

Références

Aliyun SMS - Démarrage rapide