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

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

astuce

Dans ce guide, nous supposons que vous avez des connaissances de base sur les Connecteurs Logto. Si ce n'est pas le cas, consultez le guide Configurer les 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 de Logto peuvent s'inscrire et se connecter à leur compte Logto via un code de vérification par SMS.

Configurer un service de messages courts dans la console SMS Aliyun

💡 Astuce

Vous pouvez ignorer certaines sections si vous avez déjà terminé.

Créer un compte Aliyun

Allez sur le site web d'Aliyun et enregistrez votre compte Aliyun si vous n'en avez pas.

Activer et configurer le service de messages courts Aliyun

1. Connectez-vous avec votre compte Aliyun sur le site web d'Aliyun et allez sur la page de la console du service SMS.
2. Cliquez sur le bouton "Open for free" (免费开通) en haut à gauche de la page du service SMS et commencez le processus de configuration.
3. Lisez et acceptez l'"Accord d'activation du service SMS" (短信服务开通条款) et cliquez sur "Souscrire à un service" (开通服务) pour continuer.
4. Vous êtes maintenant sur la page de la console du service SMS, allez soit sur le bouton "Chine continentale" (国内消息) soit sur "Hors de la Chine continentale" (国际/港澳台消息) dans la barre latérale selon votre cas d'utilisation.
5. Ajoutez une signature et un modèle en suivant les directives, et fournissez les documents ou informations requis pour l'examen.
   • N'oubliez pas de sélectionner "Message de vérification" (验证码) comme "Scénario" (适用场景) lors de la saisie de la demande de signature et également "Message de vérification" (验证码) pour "Type" (模板类型) lors de la demande d'examen 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é 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, nous pouvons revenir à la page de la 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 en vigueur, Aliyun fournit également des modèles de test.
   • Vous devrez peut-être recharger un petit montant d'argent avant d'envoyer des messages de test.
   • Il peut également vous être demandé de lier un numéro de téléphone de test avant d'envoyer des messages de test. Pour plus de détails, allez à l'onglet "Démarrage rapide" (快速学习) dans la barre latérale de la page de la console du service SMS.

Composer le JSON du connecteur

1. Depuis la page de la console du service SMS, survolez votre avatar dans le coin supérieur droit et allez à "Gestion des AccessKey" (AccessKey 管理), et 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 correctement.
2. Allez à l'onglet "Chine continentale" (国内消息) ou "Hors de la Chine continentale" (国际/港澳台消息) que vous venez de visiter, vous pouvez facilement trouver "Signature" (签名名称) et "Code du modèle" (模板 CODE).
   • Si vous souhaitez utiliser uniquement la signature et le modèle de test, allez plutôt à l'onglet "Démarrage rapide" (快速学习), 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 que vous avez obtenues à l'étape 1.
   • Remplissez le champ signName avec "Signature" (签名名称) mentionnée à l'étape 2. Tous les modèles partageront ce nom de signature.
   • 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 templateCode, qui est la façon dont vous pouvez contrôler le contexte SMS, avec "Code du modèle" (模板 CODE) de l'étape 2.
     • Remplissez le champ usageType avec soit Register, SignIn, ForgotPassword ou Generic pour différents cas d'utilisation. (usageType est une propriété Logto pour identifier le cas d'utilisation approprié.) Afin d'activer les flux utilisateur complets, les modèles avec usageType Register, SignIn, ForgotPassword et Generic sont requis.

Tester le connecteur SMS Aliyun

Vous pouvez taper un numéro de téléphone et cliquer sur "Envoyer" pour voir si les paramètres peuvent fonctionner avant "Enregistrer 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 énumérées
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Références

• Aliyun SMS - Démarrage rapide